create_section_views

Code Template

var groupHandle = "SAMPLE_LINE_GROUP_HANDLE";
var startStation = double.NaN;
var endStation = double.NaN;
var viewNamePrefix = "VIEW_NAME_PREFIX";
var styleName = "SECTION_VIEW_STYLE_NAME";
var bandSetStyleName = "SECTION_VIEW_BAND_SET_STYLE_NAME";
var originX = 0.0;
var originY = 0.0;
var columns = 3;
var gapX = 10.0;
var gapY = 10.0;
var viewLimit = 25;
var tolerance = 1e-6;

var isHandle = new Func<string, bool>(value =>
    !string.IsNullOrWhiteSpace(value)
    && System.Text.RegularExpressions.Regex.IsMatch(value, "^[0-9A-Fa-f]{1,16}$")
    && long.TryParse(value, System.Globalization.NumberStyles.HexNumber,
        System.Globalization.CultureInfo.InvariantCulture, out var parsed) && parsed > 0);
var isName = new Func<string, bool>(value =>
    !string.IsNullOrWhiteSpace(value) && value == value.Trim() && value.Length <= 200 && !value.Any(char.IsControl));
if (!isHandle(groupHandle)) return new { success = false, error = "Configure a positive hexadecimal groupHandle." };
if (!Double.IsFinite(startStation) || !Double.IsFinite(endStation) || endStation < startStation)
    return new { success = false, error = "Configure a finite, ordered station range." };
if (!isName(viewNamePrefix) || viewNamePrefix == "VIEW_NAME_PREFIX"
    || !isName(styleName) || styleName == "SECTION_VIEW_STYLE_NAME"
    || !isName(bandSetStyleName) || bandSetStyleName == "SECTION_VIEW_BAND_SET_STYLE_NAME")
    return new { success = false, error = "Configure explicit view-prefix and existing style names." };
if (!Double.IsFinite(originX) || !Double.IsFinite(originY) || !Double.IsFinite(gapX) || !Double.IsFinite(gapY)
    || gapX < 0 || gapY < 0 || columns < 1 || columns > 10 || viewLimit < 1 || viewLimit > 50)
    return new { success = false, error = "Grid coordinates/gaps must be finite, gaps nonnegative, columns 1..10 and viewLimit 1..50." };

// Host access starts here.
ObjectId groupId;
try { groupId = Database.GetObjectId(false, new Handle(Convert.ToInt64(groupHandle, 16)), 0); }
catch { return new { success = false, error = "groupHandle does not resolve in this drawing." }; }
var group = Transaction.GetObject(groupId, OpenMode.ForRead) as SampleLineGroup;
if (group == null || group.IsErased || group.IsReferenceObject)
    return new { success = false, error = "An existing local SampleLineGroup is required." };
var alignment = Transaction.GetObject(group.ParentAlignmentId, OpenMode.ForRead) as Alignment;
if (alignment == null || alignment.IsReferenceObject || alignment.StationEquations.Count != 0
    || startStation < alignment.StartingStation || endStation > alignment.EndingStation)
    return new { success = false, error = "The local parent alignment must contain this range and have no station equations." };
var ids = group.GetSampleLineIds();
if (ids.Count > 5000) return new { success = false, error = "The group exceeds this recipe's 5000-sample preflight bound." };
var selected = new List<SampleLine>();
foreach (ObjectId id in ids)
{
    var line = Transaction.GetObject(id, OpenMode.ForRead) as SampleLine;
    if (line == null || line.IsErased) continue;
    if (line.Station < startStation || line.Station > endStation) continue;
    if (!Double.IsFinite(line.Station) || line.IsReferenceObject || line.GetSectionIds().Count == 0)
        return new { success = false, error = "Every selected sample line must be local and have existing section data." };
    if (line.GetSectionViewIds().Count != 0)
        return new { success = false, error = "A selected sample line already has section views; this recipe does not duplicate or modify them." };
    selected.Add(line);
    if (selected.Count > viewLimit)
        return new { success = false, error = "The selection exceeds viewLimit; narrow the station range before writing." };
}
selected = selected.OrderBy(line => line.Station).ThenBy(line => line.Handle.ToString(), StringComparer.Ordinal).ToList();
if (selected.Count == 0) return new { success = false, error = "No sampled local lines match the selected range." };
ObjectId styleId;
ObjectId bandSetId;
try
{
    styleId = CivilDoc.Styles.SectionViewStyles[styleName];
    bandSetId = CivilDoc.Styles.SectionViewBandSetStyles[bandSetStyleName];
}
catch { return new { success = false, error = "The named section-view or band-set style is unavailable." }; }
if (styleId.IsNull || bandSetId.IsNull)
    return new { success = false, error = "Both existing styles must resolve to valid IDs." };

var views = new List<(SectionView view, SampleLine line, Extents3d bounds)>();
foreach (var line in selected)
{
    var name = viewNamePrefix + "-" + line.Handle.ToString();
    var id = SectionView.Create(name, line.ObjectId, new Point3d(originX, originY, 0));
    var view = Transaction.GetObject(id, OpenMode.ForWrite) as SectionView;
    if (view == null) throw new InvalidOperationException("Section-view creation returned no readable view.");
    view.StyleId = styleId;
    view.Bands.ImportBandSetStyle(bandSetId);
    var bounds = view.GeometricExtents;
    var width = bounds.MaxPoint.X - bounds.MinPoint.X;
    var height = bounds.MaxPoint.Y - bounds.MinPoint.Y;
    if (!Double.IsFinite(width) || !Double.IsFinite(height) || width <= tolerance || height <= tolerance)
        throw new InvalidOperationException("A view has no usable styled extents; grid placement was refused before commit.");
    views.Add((view, line, bounds));
}
var rowCount = (views.Count + columns - 1) / columns;
var columnWidths = new double[columns];
var rowHeights = new double[rowCount];
for (var i = 0; i < views.Count; i++)
{
    columnWidths[i % columns] = Math.Max(columnWidths[i % columns], views[i].bounds.MaxPoint.X - views[i].bounds.MinPoint.X);
    rowHeights[i / columns] = Math.Max(rowHeights[i / columns], views[i].bounds.MaxPoint.Y - views[i].bounds.MinPoint.Y);
}
var created = new List<object>();
for (var i = 0; i < views.Count; i++)
{
    var item = views[i];
    var column = i % columns;
    var row = i / columns;
    var targetLeft = originX + columnWidths.Take(column).Sum() + column * gapX;
    var targetTop = originY - rowHeights.Take(row).Sum() - row * gapY;
    if (!Double.IsFinite(targetLeft) || !Double.IsFinite(targetTop))
        throw new InvalidOperationException("Grid placement overflowed; no partial grid may be committed.");
    item.view.Location = item.view.Location + new Vector3d(
        targetLeft - item.bounds.MinPoint.X, targetTop - item.bounds.MaxPoint.Y, 0);
    var actual = item.view.GeometricExtents;
    if (item.view.SampleLineId != item.line.ObjectId || item.view.StyleId != styleId
        || Math.Abs(actual.MinPoint.X - targetLeft) > tolerance || Math.Abs(actual.MaxPoint.Y - targetTop) > tolerance)
        throw new InvalidOperationException("A section view failed its parent/style/placement postconditions: "
            + "handle=" + item.view.Handle.ToString() + ", requestedLeft=" + targetLeft
            + ", actualLeft=" + actual.MinPoint.X + ", requestedTop=" + targetTop
            + ", actualTop=" + actual.MaxPoint.Y + ".");
    created.Add(new {
        handle = item.view.Handle.ToString(), name = item.view.Name,
        sampleLineHandle = item.line.Handle.ToString(), station = item.line.Station,
        style = item.view.StyleName, row, column,
        bounds = new { minX = actual.MinPoint.X, minY = actual.MinPoint.Y, maxX = actual.MaxPoint.X, maxY = actual.MaxPoint.Y }
    });
}
return new {
    success = true, groupHandle = group.Handle.ToString(), groupName = group.Name,
    selected = selected.Count, created = created.Count, columns, rowCount, gapX, gapY,
    requestedBandSet = bandSetStyleName, units = CivilDoc.Settings.DrawingSettings.UnitZoneSettings.DrawingUnits.ToString(),
    views = created
};