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-81: 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.

Additional properties are available with the Design Module, see Move, and Copy.

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}});