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-22: Valid Property/Value Pairs 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)