LineSegment
Create line segments in 2D and 3D.
Syntax
model.component(<ctag>).geom(<tag>).create(<ftag>,"LineSegment");
model.component(<ctag>).geom(<tag>).feature(<ftag>).set(property,<value>);
model.component(<ctag>).geom(<tag>).feature(<ftag>).getType(property);
Description
Use model.component(<ctag>).geom(<tag>).create(<ftag>,"LineSegment") to create a line segment. The following properties are available:
Table 3-74: Valid Property/Value Pairs for LineSegment
Property
Value
Default
Description
color
none | custom | integer between 1 and the number of colors in the current theme
none
The color of the selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolor property. Coloring is only available when selresult in active.
contributeto
String
none
Tag of cumulative selection to contribute to.
coord1
double[]
zero vector
Coordinates for starting point (with specify1 set to coord).
coord2
double[]
zero vector
Coordinates for endpoint (with specify2 set to coord).
customcolor
RGB-triplet
Next available theme color
The color to use. Active when color is set to custom.
p2
Selection
1
Endpoint (with specify2 set to vertex).
selresult
on | off
off
Create selections of all resulting objects.
selresultshow
all | obj | dom | bnd | off
dom
Show selections, if selresult is on, of resulting objects in physics, materials, and so on, or in part instances. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
specify1
vertex | coord
vertex
Type of starting point specification.
specify2
vertex | coord
vertex
Type of endpoint specification.
vertex1
Selection
0
Starting point (with specify1 set to vertex).
workplanesrc
this | Part Instance feature
this
Part Instance feature to take the work plane from (in 3D and for coordinates only).
workplane
xyplane | Work plane feature
xyplane
Work Plane feature that defines the coordinate system (in 3D and for coordinates only). The default, xyplane, is the global Cartesian coordinate system.
For information about the selresult and contributeto properties, see Selections of Geometric Entities.
Additional properties are available with the Design Module, see LineSegment.
Example
The following commands create a block in 3D and a line segment from a vertex in that block to a point with the coordinates (0, 1, 2):
Code for Use with Java
Model model = ModelUtil.create("Model");
model.component().create("comp1");
GeomSequence g = model.component("comp1").geom().create("geom1", 3);
g.create("blk1", "Block");
g.create("ls1", "LineSegment");
g.feature("ls1").set("specify1", "vertex");
g.feature("ls1").set("specify2", "coord");
g.feature("ls1").selection("vertex1").set("blk1(1)", new int[]{1});
g.feature("ls1").set("coord2", new double[]{0, 1, 2});
g.run();
Code for Use with MATLAB
model = ModelUtil.create('Model');
model.component.create('comp1');
g = model.component('comp1').geom.create('geom1', 3);
g.create('blk1', 'Block');
g.create('ls1', 'LineSegment');
g.feature('ls1').set('specify1', 'vertex');
g.feature('ls1').set('specify2', 'coord');
g.feature('ls1').selection('vertex1').set('blk1(1)', 1);
g.feature('ls1').set('coord2', [0, 1, 2]);
g.run;
See Also
 BezierPolygon