The chains, their surfaces and the diagnostics of one realization. It is read and not changed.
Optionaloptions: IAutoMovieSampleConstructionCurves.IOptions
phases is the samples per ring, default 48. steps is the subdivisions of each station interval along a guide and the axis, default 8.
The curves of every chain, in the documented order.
Sample the construction lines of every lofted chain of a realization as polylines in metres: its section rings, its four guide rails and its axis, so an inspection can draw what a form was built from.
Each chain is read through the surface of its own name, a map from station in millimetres and phase in radians to a point in millimetres, through
pointwhen the surface has one andjet(...).potherwise. The chain's owned station range is the surface'sdomain, or its first to last layer when the surface names none. Points are divided byAutoMovieConstructionViews.SCALE, so they come out in metres in the construction tree's frame.A
sectionis the closed ring at one principal layer station inside the owned range, sampled atoptions.phasesuniform phases starting at phase 0, and its id carries the layer's ordinal in the chain. Aguideis the open rail at one quarter phase,0,pi / 2,piand3 pi / 2for quarters 0 to 3. Theaxisis the open line through the mean of each ring's samples. Guides and axis share one station list: both ends of the owned range, every layer station inside it, andoptions.stepsequal subdivisions of each interval between consecutive ones, in ascending order. A guide point is its ring's sample at that quarter, so guide 0 passes through the first point of every section.The axis is the centroid line of the sampled rings, the plain mean of uniform-phase samples. It is not the authored frame origin of the chain, which a section need not surround evenly, and it is neither the arc-length nor the area centroid of the ring.
A sample with a non-finite component is left out and flags its curve. An axis point is left out, and the axis flagged, whenever its ring has such a sample. A curve left with fewer than two points is not returned. Every curve of a chain whose name equals a diagnostic's
nodeis flagged. Curves come chain by chain in the realization's order: sections in layer order, guides 0 to 3, then the axis.It throws a named
Errorforphasesthat is not a whole number of at least 8 that four divides, forstepsthat is not a positive whole number, for a chain with no surface of its name, and for a chain whose owned range is not finite and ordered. An error thrown by the surface itself propagates.