RigidTransform

Perform a rigid transform (translation and rotation) of 3D geometry objects. You can use this feature to position and orient geometry objects by matching a coordinate system (work plane) with another coordinate system (work plane) and then optionally performing a rotation and translation in the work plane’s coordinate system.

Syntax

model.component(<ctag>).geom(<tag>).create(<ftag>,"RigidTransform");

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

model.component(<ctag>).geom(<tag>).feature(<ftag>).setAttribute(attribute,<value>);

model.component(<ctag>).geom(<tag>).feature(<ftag>).getAttribute(attribute);

Description

Use model.component(<ctag>).geom(<tag>).create(<ftag>,"RigidTransform") to make a rigid transform of 3D geometry objects.

Use model.component(<ctag>).geom(<tag>).feature(<ftag>).selection("input") to select the objects for which to perform a rigid transform. The default selection is empty.

The following properties are available:

Table 3-147: Valid Properties for RigidTransform
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.
displ	double[3]	{0,0,0}	Displacement.
edge	Selection		Edge selection. Used when specify is set to edge.
eulerang	double[3]	{0,0,0}	Intrinsic Z-X-Z Euler angles α, β, and γ, used if specify is set to eulerang.
input	object selection		Geometry objects to perform a rigid transformation of.
keep	on \| off	off	Keep input objects.
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. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
specify	axis \| eulerang \| edge	axis	Specify an axis of rotation, Euler angles (Z-X-Z), or a straight edge.
workplane	xyplane \| work-plane feature tag	xyplane	Work-plane feature that defines the coordinate system. The default, xyplane, is the global Cartesian coordinate system.
workplaneobj	xyplane \| work-plane feature tag	xyplane	The work plane for the geometry objects.
workplanesrc	this \|part-instance feature tag	this	The source to take the work plane from.

For information about the selresult and contributeto properties, see Selections of Geometric Entities.

The following attributes are available:

Table 3-148: Valid attributes
Name	Value	Default	Description
construction	on \| off \| inherit	inherit	Designate the resulting objects as construction geometry. Use inherit to set the construction geometry attribute only if all input objects are construction geometry.