Move, Copy
Move or copy geometry objects by translation.
Syntax
model.component(<ctag>).geom(<tag>).create(<ftag>,"Move");
model.component(<ctag>).geom(<tag>).create(<ftag>,"Copy");
model.component(<ctag>).geom(<tag>).feature(<ftag>).selection(property);
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>,"Move") to move geometry objects.
Use model.component(<ctag>).geom(<tag>).create(<ftag>,"Copy") to move a copy of geometry objects.
Use model.component(<ctag>).geom(<tag>).feature(<ftag>).selection("input") to select the objects to move or copy. The default selection is empty.
The following properties are available:
Table 3-80: Valid Properties
Name
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.
customcolor
RGB-triplet
Next available theme color
The color to use. Active when color is set to custom.
displx
double[]
0
x displacement. Used when specify is displ.
disply
double[]
0
y displacement. Used when specify is displ.
displz
double[]
0
z displacement. Used when specify is displ.
newpos
vertices | coord
vertices
The new (destination) position. Used when specify is pos.
newposvertices
Selection
 
Vertices to move to. Used when newpos is vertices.
newposx
double[]
0
x-coordinates of new positions. Used when newpos is coord.
newposy
double[]
0
y-coordinates of new positions. Used when newpos is coord.
newposz
double[]
0
z-coordinates of new positions. Used when newpos is coord.
oldpos
vertex | coord
vertex
The old (original) position. Used when specify is pos.
oldposvertex
Selection
 
Vertex to move to. Used when oldpos is vertex.
oldposcoord
double[sdim]
0
Coordinates of old position. Used when oldpos is coord.
selresult
on | off
off
Create selections of all resulting objects.
selresultshow
all | obj | dom | bnd | edg | pnt | 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.
specify
displ | pos
displ
Specify displacement vector or positions.
workplanesrc
this | Part Instance feature
this
Part Instance feature to take the work plane from (in 3D only).
workplane
xyplane | Work plane feature
xyplane
Work Plane feature that defines the coordinate system (in 3D only). The default, xyplane, is the global Cartesian coordinate system.
If displ is a one-dimensional array, a single copy of each input object is created using the translation vector displ. If displ is a two-dimensional array, several copies can be created, where the nth copy has translation displ[i][n] in the i:th coordinate.
For information about the selresult and contributeto properties, see Selections of Geometric Entities.
Example
The sequence below moves a circle from the origin to (2, 3):
Code for Use with Java
Model model = ModelUtil.create("Model1");
model.component().create("comp1");
GeomSequence g = model.component("comp1").geom().create("geom1",2);
g.create("c1","Circle");
g.create("m1","Move");
g.feature("m1").selection("input").set("c1");
g.feature("m1").set("displ", new double[][]{{2},{3}});
g.run();
Code for Use with MATLAB
model = ModelUtil.create('Model1');
model.component.create('comp1');
g = model.component('comp1').geom.create('geom1',2);
g.create('c1','Circle');
g.create('m1','Move');
g.feature('m1').selection('input').set('c1');
g.feature('m1').set('displ', [2,3]);
g.run;
See Also
 Array, Mirror, Rotate, Scale, RigidTransform