rhinodoc-objects

RhinoDoc — Document Object System

Core Concept: Geometry vs Document Objects

• Rhino.Geometry.* — pure math (no layer, color, GUID). Lives in memory.
• Rhino.DocObjects.RhinoObject — geometry + attributes in the document. Has a GUID.

Always duplicate geometry before modifying it; never edit geometry still referenced by the document.

Accessing the Active Document

using Rhino;
using Rhino.DocObjects;

// In a Command:
RhinoDoc doc = RhinoDoc.ActiveDoc;
// Or via the RunCommand parameter:
protected override Result RunCommand(RhinoDoc doc, RunMode mode) { ... }

Adding Geometry to the Document

// Returns Guid.Empty on failure
Guid id = doc.Objects.AddPoint(new Point3d(0, 0, 0));
Guid id = doc.Objects.AddLine(new Line(pt1, pt2));
Guid id = doc.Objects.AddArc(new Arc(circle, angle));
Guid id = doc.Objects.AddCircle(new Circle(plane, radius));
Guid id = doc.Objects.AddCurve(curve);
Guid id = doc.Objects.AddSurface(surface);
Guid id = doc.Objects.AddBrep(brep);
Guid id = doc.Objects.AddMesh(mesh);
Guid id = doc.Objects.AddExtrusion(extrusion);
Guid id = doc.Objects.AddTextDot("label", point);

// With attributes
ObjectAttributes attr = new ObjectAttributes();
attr.LayerIndex = doc.Layers.FindName("MyLayer").Index;
attr.ColorSource = ObjectColorSource.ColorFromObject;
attr.ObjectColor = System.Drawing.Color.Red;
attr.Name = "MyObject";
Guid id = doc.Objects.AddBrep(brep, attr);

Finding Objects

// By GUID (most reliable)
RhinoObject obj = doc.Objects.Find(guid);
if (obj == null) return; // object was deleted

// By name
ObjectEnumeratorSettings settings = new ObjectEnumeratorSettings();
settings.NameFilter = "MyObject";
foreach (RhinoObject ro in doc.Objects.GetObjectList(settings)) { ... }

// All objects of a type
settings.ObjectTypeFilter = ObjectType.Brep;
var breps = doc.Objects.GetObjectList(settings);

// Selected objects
RhinoObject[] selected = doc.Objects.GetSelectedObjects(includeLights: false, includeGrips: false);

// Objects on layer
int layerIndex = doc.Layers.FindName("MyLayer").Index;
settings.LayerIndexFilter = layerIndex;