CutLine2D, CutLine3D
Create a 2D or 3D cut line dataset.
Syntax
model.result().dataset().create(<dtag>,"CutLine2D");
model.result().dataset().create(<dtag>,"CutLine3D");
model.result().dataset(<dtag>).set(property,<value>);
Description
model.result().dataset().create(<dtag>,"CutLine2D") creates a 2D cut line dataset feature named <dtag>.
model.result().dataset().create(<dtag>,"CutLine3D") creates a 3D cut line dataset feature named <dtag>.
The following properties are available:
Table 7-24: Valid Properties for cut line Datasets.
Property
Value
Default
Description
bndsnap
Boolean
false
If true, each point is snapped to the closest boundary. For Cut Line 3D datasets only.
bounded
on | off
on
Active when method equals twopoint, this property specifies if the line should be bounded by the two points or extend infinitely.
data
none | dataset name
First compatible dataset
The dataset this feature refers to.
genparaactive
on | off
off
Decides if parallel lines should be drawn.
genparadist
double array
{}
Active when genparaactive is on, this property contains the distances from the extra parallel lines to the base line.
genpoints
double matrix
{{0, 0, 0}, {1,0,0}}
Active when method equals twopoint, this property contains the coordinates of the two points in the two rows of the matrix.
method
twopoint | pointdir
twopoint
Decides if the line should be specified by two points or through one point and a direction.
normal
String array of length 2
{"cln1nx", "cln1ny"} for the first Cut Line 2D dataset
For Cut Line 2D datasets only: Variables for the normal to the cut line.
orthvec
String array of length 3
{"0","1","0"}
Used in 3D when genparaactive is true: The direction that together with the cut line’s direction spans the plane that contains the parallel lines.
pddir
String array
Zero string vector
Active when method equals pointdir, this property contains the direction.
pdpoint
String array
Zero string vector
Active when method equals pointdir, this property contains the coordinates of the point.
snapping
none | boundary | edge
none
No snapping, snap to closest boundary, or snap to closest edge (for CutLine3D only).
spacevars
String array of length 1
Created from the feature tag.
The name of the variable that evaluates to the line’s parameterization.
tangent
String array of length 2 or 3
{"cln1tx", "cln1ty"} for the first Cut Line 2D dataset
Variables for the tangent to the cut line.
Attribute
Selection (Dataset Attribute)
See Also
LineGraph