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.