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

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