A view tool that translates, rotates, and scales the selected node(s).

More...

Inherits :

• QObject
  • DzBase
    • DzViewTool
      • DzPickTool
        • DzTransformTool

Inherited By : DzUniversalRotateTool, DzUniversalScaleTool and DzUniversalTranslateTool

Since:

• 4.11.0.53

---

: CoordinateSpace

The coordinate spaces that this tool is capable of operating in.

• WorldSpace - The coordinate space of the world.
• LocalSpace - The coordinate space of the primary selected node.
• ObjectSpace - The coordinate space of the object that the primary selected node participates in; e.g., for a bone, this would be the skeleton.
• CameraSpace - The coordinate space of the current view/camera; i.e., the two dimensional plane that is perpendicular to the line of sight.
• GimbalSpace - The coordinate space of the world, with rotations in the coordinate space of the primary selected node.

---

CoordinateSpace : getAdjustedCoordinateSpace( DzNode node )

Parameter(s):

• node - The node to get the adjusted coordinate space for.

Return Value:

• The coordinate space that the tool is operating in, for the given node.

Attention:

• When node is in the hierarchy of a DzSkeleton (but not a DzSkeleton itself), and the current coordinate space is set to ObjectSpace, the coordinate space of node is adjusted to be LocalSpace.

---

CoordinateSpace : getCoordinateSpace()

Return Value:

• The coordinate space that the tool is operating in.

---

Color : getGuidesColor()

Return Value:

• The color of the guides (if any); the default is Color( 0, 255, 255 ).

---

Boolean : getRotateSecondaryNodes()

Return Value:

• true if rotation of secondary nodes is active, otherwise false.

---

Boolean : getScaleSecondaryNodes()

Return Value:

• true if scaling of secondary nodes is active, otherwise false.

---

Boolean : getShowGuides()

Return Value:

• true if the guides option is active, otherwise false.

---

Boolean : getShowHomeMenu()

Return Value:

• true if the home menu should be shown, otherwise false.

---

Boolean : getShowPinsMenu()

Return Value:

• true if the pins menu should be shown, otherwise false.

---

Boolean : getShowRotateFreeHandle()

Return Value:

• true if showing the free rotate handle on the rotate gizmo is enabled, otherwise false.

---

Boolean : getShowRotateGizmo()

Return Value:

• true if the rotate gizmo is enabled, otherwise false.

---

Boolean : getShowRotateScreenHandle()

Return Value:

• true if showing the handle for the axes that correspond with “screen space” on the rotate gizmo is enabled, otherwise false.

---

Boolean : getShowRotateXHandle()

Return Value:

• true if showing the X axis handle on the rotate gizmo is enabled, otherwise false.

---

Boolean : getShowRotateYHandle()

Return Value:

• true if showing the Y axis handle on the rotate gizmo is enabled, otherwise false.

---

Boolean : getShowRotateZHandle()

Return Value:

• true if showing the Z axis handle on the rotate gizmo is enabled, otherwise false.

---

Boolean : getShowScaleGizmo()

Return Value:

• true if the scale gizmo is enabled, otherwise false.

---

Boolean : getShowScaleUniformHandle()

Return Value:

• true if showing the uniform scale handle on the scale gizmo is enabled, otherwise false.

---

Boolean : getShowScaleXHandle()

Return Value:

• true if showing the X axis handle on the scale gizmo is enabled, otherwise false.

---

Boolean : getShowScaleYHandle()

Return Value:

• true if showing the Y axis handle on the scale gizmo is enabled, otherwise false.

---

Boolean : getShowScaleZHandle()

Return Value:

• true if showing the Z axis handle on the scale gizmo is enabled, otherwise false.

---

Boolean : getShowTranslateGizmo()

Return Value:

• true if the translate gizmo is enabled, otherwise false.

---

Boolean : getShowTranslateScreenHandle()

Return Value:

• true if showing the screen handle on the translate gizmo is enabled, otherwise false.

---

Boolean : getShowTranslateXHandle()

Return Value:

• true if showing the X axis handle on the translate gizmo is enabled, otherwise false.

---

Boolean : getShowTranslateYHandle()

Return Value:

• true if showing the Y axis handle on the translate gizmo is enabled, otherwise false.

---

Boolean : getShowTranslateZHandle()

Return Value:

• true if showing the Z axis handle on the translate gizmo is enabled, otherwise false.

---

Boolean : getSnapRotation()

Return Value:

• true if “snapping” for rotation is active, otherwise false.

---

Number : getSnapRotationValue()

Return Value:

• The interval (in degrees) for rotations performed using the manipulator to “snap” to.

---

Boolean : getSnapScale()

Return Value:

• true if snapping for scale is active, otherwise false.

---

Number : getSnapScaleValue()

Return Value:

• The interval (in percent) for scaling performed using the manipulator to “snap” to.

---

Boolean : getSnapTranslation()

Return Value:

• true if “snapping” for translation is active, otherwise false.

---

Number : getSnapTranslationValue()

Return Value:

• The interval (in centimeters) for translations performed using the manipulator to “snap” to.

---

Boolean : getTransformSecondaryNodes()

Return Value:

• true if transforms of secondary nodes is active, otherwise false.

---

Boolean : getTranslateSecondaryNodes()

Return Value:

• true if translation of secondary nodes is active, otherwise false.

---

Boolean : providesGuide()

Return Value:

• true if this tool provides a guide, otherwise false.

---

Boolean : providesRotation()

Return Value:

• true if this tool provides the ability to rotate nodes, otherwise false.

---

Boolean : providesScale()

Return Value:

• true if this tool provides the ability to scale nodes, otherwise false.

---

Boolean : providesTranslation()

Return Value:

• true if this tool provides the ability to translate nodes, otherwise false.

---

void : setCoordinateSpace( CoordinateSpace space )

Sets the coordinate space that the tool is operating in.

Parameter(s):

• space - The coordinate space to set.

---

void : setGuidesColor( Color color )

Sets the color of guides.

Parameter(s):

• color - The color to set.

See Also:

• providesGuide()

---

void : setRotateSecondaryNodes( Boolean yesNo )

Sets whether or not to apply rotation of the primary selection to secondary nodes.

Parameter(s):

• yesNo - If true, rotation of the primary selection is applied to secondary nodes.

Attention:

• Whether or not the transform is actually applied to secondary nodes is contingent on whether or not the corresponding properties on the secondary nodes allows the values to be modified.

See Also:

• providesRotation()

---

void : setScaleSecondaryNodes( Boolean yesNo )

Sets whether or not to apply scaling of the primary selection to secondary nodes.

Parameter(s):

• yesNo - If true, scaling of the primary selection is applied to secondary nodes.

Attention:

• Whether or not the transform is actually applied to secondary nodes is contingent on whether or not the corresponding properties on the secondary nodes allows the values to be modified.

See Also:

• providesScale()

---

void : setShowGuides( Boolean yesNo )

Sets whether or not to show guides.

Parameter(s):

• yesNo - If true, guides will be shown.

See Also:

• providesGuide()

---

void : setShowHomeMenu( Boolean yesNo )

Sets whether or not to show the home menu.

Parameter(s):

• yesNo - If true, the home menu is shown.

---

void : setShowPinsMenu( Boolean yesNo )

Sets whether or not to show the pins menu.

Parameter(s):

• yesNo - If true, the pins menu is shown.

---

void : setShowRotateFreeHandle( Boolean yesNo )

Sets whether or not to show the free rotate handle on the rotate gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding properties on the primary selection allows the values to be modified.

See Also:

• providesRotation()

---

void : setShowRotateGizmo( Boolean yesNo )

Sets whether or not to show the rotate gizmo.

Parameter(s):

• yesNo - If true, the rotate gizmo will be shown.

Attention:

• Whether or not the gizmo is actually displayed in the viewport is contingent on whether or not the individual axis option is activated and whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesRotation()

---

void : setShowRotateScreenHandle( Boolean yesNo )

Sets whether or not to show the handle for the axes that correspond with “screen space” on the rotate gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding properties on the primary selection allows the values to be modified.

See Also:

• providesRotation()

---

void : setShowRotateXHandle( Boolean yesNo )

Sets whether or not to show the X axis handle on the rotate gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesRotation()

---

void : setShowRotateYHandle( Boolean yesNo )

Sets whether or not to show the Y axis handle on the rotate gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesRotation()

---

void : setShowRotateZHandle( Boolean yesNo )

Sets whether or not to show the Z axis handle on the rotate gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesRotation()

---

void : setShowScaleGizmo( Boolean yesNo )

Sets whether or not to show the scale gizmo.

Parameter(s):

• yesNo - If true, the scale gizmo will be shown.

Attention:

• Whether or not the gizmo is actually displayed in the viewport is contingent on whether or not the individual axis option is activated and whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesScale()

---

void : setShowScaleUniformHandle( Boolean yesNo )

Sets whether or not to show the uniform scale handle.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding properties on the primary selection allows the values to be modified.

See Also:

• providesScale()

---

void : setShowScaleXHandle( Boolean yesNo )

Sets whether or not to show the X axis handle on the scale gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesScale()

---

void : setShowScaleYHandle( Boolean yesNo )

Sets whether or not to show the Y axis handle on the scale gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesScale()

---

void : setShowScaleZHandle( Boolean yesNo )

Sets whether or not to show the Z axis handle on the scale gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesScale()

---

void : setShowTranslateGizmo( Boolean yesNo )

Sets whether or not to show the translate gizmo.

Parameter(s):

• yesNo - If true, the translate gizmo will be shown.

Attention:

• Whether or not the gizmo is actually displayed in the viewport is contingent on whether or not the individual axis option is activated and whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesTranslation()

---

void : setShowTranslateScreenHandle( Boolean yesNo )

Sets whether or not to show the translate handles for the axis that correspond with “screen space.”

Parameter(s):

• yesNo - If true, the handles will be shown.

Attention:

• Whether or not the handles are actually displayed in the viewport is contingent on whether or not the corresponding properties on the primary selection allows the values to be modified.

See Also:

• providesTranslation()

---

void : setShowTranslateXHandle( Boolean yesNo )

Sets whether or not to show the X axis handle on the translate gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesTranslation()

---

void : setShowTranslateYHandle( Boolean yesNo )

Sets whether or not to show the Y axis handle on the translate gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesTranslation()

---

void : setShowTranslateZHandle( Boolean yesNo )

Sets whether or not to show the Z axis handle on the translate gizmo.

Parameter(s):

• yesNo - If true, the handle will be shown.

Attention:

• Whether or not the handle is actually displayed in the viewport is contingent on whether or not the corresponding property on the primary selection allows the value to be modified.

See Also:

• providesTranslation()

---

void : setSnapRotation( Boolean yesNo )

Sets whether or not snapping for rotation values is active.

Parameter(s):

• yesNo - If true, rotation values set by the tool will be “snapped” to specific intervals.

See Also:

• getSnapRotationValue()
• setSnapRotationValue()
• providesRotation()

---

void : setSnapRotationValue( Number value )

Sets the interval for snappping rotation values.

Parameter(s):

• value - The value to set.

See Also:

• providesRotation()

---

void : setSnapScale( Boolean yesNo )

Sets whether or not snapping for scale values is active.

Parameter(s):

• yesNo - If true, scale values set by the tool will be “snapped” to specific intervals.

See Also:

• getSnapScaleValue()
• setSnapScaleValue()
• providesScale()

---

void : setSnapScaleValue( Number value )

Sets the interval for snappping scale values.

Parameter(s):

• value - The value to set.

See Also:

• providesScale()

---

void : setSnapTranslation( Boolean yesNo )

Sets whether or not snapping for translation values is active.

Parameter(s):

• yesNo - If true, translation values set by the tool will be “snapped” to specific intervals.

See Also:

• getSnapTranslationValue()
• setSnapTranslationValue()
• providesTranslation()

---

void : setSnapTranslationValue( Number value )

Sets the interval for snappping translation values.

Parameter(s):

• value - The value to set.

See Also:

• providesTranslation()

---

void : setTransformSecondaryNodes( Boolean yesNo )

Sets whether or not to apply manipulation of the primary selection to secondary nodes.

Parameter(s):

• yesNo - If true, manipulation of the primary selection is applied to secondary nodes.

Attention:

• Whether or not the transform is actually applied to secondary nodes is contingent on whether or not the corresponding properties on the secondary nodes allows the values to be modified.

---

void : setTranslateSecondaryNodes( Boolean yesNo )

Sets whether or not to apply translation of the primary selection to secondary nodes.

Parameter(s):

• yesNo - If true, translation of the primary selection is applied to secondary nodes.

Attention:

• Whether or not the transform is actually applied to secondary nodes is contingent on whether or not the corresponding properties on the secondary nodes allows the values to be modified.

See Also:

• providesTranslation()

---

void : coordinateSpaceChanged( CoordinateSpace space )

Signature:“coordinateSpaceChanged(int)”

Emitted when the coordinate space for this tool has changed.

Parameter(s):

• space - The new coordinate space.

---

void : guidesColorChanged( Color color )

Signature:“guidesColorChanged(const QColor&)”

Emitted when the color for guides on this tool has changed.

Parameter(s):

• color - The new color.

---

void : rotateSecondaryNodesChanged( Boolean yesNo )

Signature:“rotateSecondaryNodesChanged(bool)”

Emitted when the state of rotations being applied to secondary nodes for this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : scaleSecondaryNodesChanged( Boolean yesNo )

Signature:“scaleSecondaryNodesChanged(bool)”

Emitted when the state of scaling being applied to secondary nodes for this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showGuidesChanged( Boolean yesNo )

Signature:“showGuidesChanged(bool)”

Emitted when the state of showing guides on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showHomeMenuChanged( Boolean yesNo )

Signature:“showHomeMenuChanged(bool)”

Emitted when the state of the Home Menu option for this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showPinsMenuChanged( Boolean yesNo )

Signature:“showPinsMenuChanged(bool)”

Emitted when the state of the Pins Menu option for this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showRotateFreeHandleChanged( Boolean yesNo )

Signature:“showRotateFreeHandleChanged(bool)”

Emitted when the state of showing the free rotate handle on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showRotateGizmoChanged( Boolean yesNo )

Signature:“showRotateGizmoChanged(bool)”

Emitted when the state of showing the rotate gizmo for this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showRotateScreenHandleChanged( Boolean yesNo )

Signature:“showRotateScreenHandleChanged(bool)”

Emitted when the state of showing the rotate handle for screen space on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showRotateXHandleChanged( Boolean yesNo )

Signature:“showRotateXHandleChanged(bool)”

Emitted when the state of showing the rotate handle for the X axis on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showRotateYHandleChanged( Boolean yesNo )

Signature:“showRotateYHandleChanged(bool)”

Emitted when the state of showing the rotate handle for the Y axis on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showRotateZHandleChanged( Boolean yesNo )

Signature:“showRotateZHandleChanged(bool)”

Emitted when the state of showing the rotate handle for the Z axis on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showScaleGizmoChanged( Boolean yesNo )

Signature:“showScaleGizmoChanged(bool)”

Emitted when the state of showing the scale gizmo for this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showScaleUniformHandleChanged( Boolean yesNo )

Signature:“showScaleUniformHandleChanged(bool)”

Emitted when the state of showing the uniform scale handle on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showScaleXHandleChanged( Boolean yesNo )

Signature:“showScaleXHandleChanged(bool)”

Emitted when the state of showing the scale handle for the X axis on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showScaleYHandleChanged( Boolean yesNo )

Signature:“showScaleYHandleChanged(bool)”

Emitted when the state of showing the scale handle for the Y axis on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showScaleZHandleChanged( Boolean yesNo )

Signature:“showScaleZHandleChanged(bool)”

Emitted when the state of showing the scale handle for the Z axis on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showTranslateGizmoChanged( Boolean yesNo )

Signature:“showTranslateGizmoChanged(bool)”

Emitted when the state of showing the translate gizmo for this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showTranslateScreenHandleChanged( Boolean yesNo )

Signature:“showTranslateScreenHandleChanged(bool)”

Emitted when the state of showing the translate handle for screen space on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showTranslateXHandleChanged( Boolean yesNo )

Signature:“showTranslateXHandleChanged(bool)”

Emitted when the state of showing the translate handle for the X axis on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showTranslateYHandleChanged( Boolean yesNo )

Signature:“showTranslateYHandleChanged(bool)”

Emitted when the state of showing the translate handle for the Y axis on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : showTranslateZHandleChanged( Boolean yesNo )

Signature:“showTranslateZHandleChanged(bool)”

Emitted when the state of showing the translate handle for the Z axis on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : snapRotationChanged( Boolean yesNo )

Signature:“snapRotationChanged(bool)”

Emitted when the state of snapping rotation values on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : snapRotationValueChanged( Number value )

Signature:“snapRotationValueChanged(float)”

Emitted when the value for rotation snapping on this tool has changed.

Parameter(s):

• value - The new value for the option.

---

void : snapScaleChanged( Boolean yesNo )

Signature:“snapScaleChanged(bool)”

Emitted when the state of snapping scale values on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : snapScaleValueChanged( Number value )

Signature:“snapScaleValueChanged(float)”

Emitted when the value for scale snapping on this tool has changed.

Parameter(s):

• value - The new value for the option.

---

void : snapTranslationChanged( Boolean yesNo )

Signature:“snapTranslationChanged(bool)”

Emitted when the state of snapping translation values on this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : snapTranslationValueChanged( Number value )

Signature:“snapTranslationValueChanged(float)”

Emitted when the value for translation snapping on this tool has changed.

Parameter(s):

• value - The new value for the option.

---

void : transformSecondaryNodesChanged( Boolean yesNo )

Signature:“transformSecondaryNodesChanged(bool)”

Emitted when the state of transforms being applied to secondary nodes for this tool has changed.

Parameter(s):

• yesNo - The new state of the option.

---

void : translateSecondaryNodesChanged( Boolean yesNo )

Signature:“translateSecondaryNodesChanged(bool)”

Emitted when the state of translations being applied to secondary nodes for this tool has changed.

Parameter(s):

• yesNo - The new state of the option.