Rotate
Rotate objects about a point in 2D or an axis in 3D.
Syntax
model.component(<ctag>).geom(<tag>).create(<ftag>,"Rotate");
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>,"Rotate") to rotate geometry objects.
Use model.component(<ctag>).geom(<tag>).feature(<ftag>).selection("input") to select the objects to rotate. The default selection is empty.
The following properties are available:
Table 3-100: Valid Properties for Rotate
Name
Value
Default
Description
ax2
double[2]
{0,0}
Spherical angles theta and phi, used if axistype is spherical.
ax3
double[3]
{0,0,1}
Axis vector, used if axistype is cartesian.
axis
double[]
{0,0,1}
Rotation axis. Vector has length 3 if axistype is cartesian, and length 2 if axistype is spherical. Alias for ax2 and ax3.
axistype
x | y | z | cartesian | spherical
z
Coordinate system used for axis. Used if specify is set to axis.
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.
eulerang
double[3]
{0,0,0}
Intrinsic Z-X-Z Euler angles α, β, and γ, used if specify is set to eulerang.
input
Selection
 
Objects to rotate.
keep
on | off
off
Keep input objects.
pos
double[]
 
Center of rotation.
rot
double[]
0
Rotation angles for one or more rotations of the input objects, used if specify is set to axis.
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, in physics, materials, and so on; in part instances; or in 3D from a plane geometry. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
specify
axis | eulerang
axis
Specify an axis of rotation or Euler angles (Z-X-Z).
workplane
xyplane | work plane feature tag
xyplane
Work Plane feature that defines the coordinate system (in 3D only). The default, xyplane, is the global Cartesian coordinate system.
workplanesrc
this | Part Instance feature tag
this
Part Instance feature to take the work plane from (in 3D only).
For information about the selresult and contributeto properties, see Selections of Geometric Entities.
Compatibility
The possibility to set and get a rotation matrix has been removed.
The property out is no longer available.
Example
The commands below create and then rotate an ellipse by 10 degrees about (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("e1","Ellipse");
g.feature("e1").set("semiaxes","1 3");
g.create("r1","Rotate");
g.feature("r1").selection("input").set("e1");
g.feature("r1").set("rot",10);
g.feature("r1").set("pos", "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('e1','Ellipse');
g.feature('e1').set('semiaxes','1 3');
g.create('r1','Rotate');
g.feature('r1').selection('input').set('e1');
g.feature('r1').set('rot',10);
g.feature('r1').set('pos', '2 3');
g.run;
See Also
 Mirror, Move, Copy, Scale, RigidTransform