Vizard 7 » Command Index » Vizard objects » link » <link>.reset
7.7

<link>.reset

Reset link

<link>.reset(  
flag  
)  
flag
A combination of the following values:

Reset flags

viz.RESET_X

Recenter the link to the current X position of the source.

viz.RESET_Y

Recenter the link to the current Y position of the source.

viz.RESET_Z

Recenter the link to the current Z position of the source.

viz.RESET_POS

Recenter the link to the current position of the source. This is equal to (viz.RESET_X|viz.RESET_Y|viz.RESET_Z)

viz.RESET_ORI_LOCAL

Reset orientation so that subsequent movements are relative to the local coordinate system of the source.

viz.RESET_ORI_WORLD

Reset orientation so that subsequent movements are relative to the world coordinate system of the source.

viz.RESET_ORI_HEADING

Reset orientation so that the current heading is virtual north. The pitch, and roll will not be affected.

viz.RESET_ORI_RAW

Reset orientation to use the raw values from the source.

viz.RESET_OPERATORS

Remove all operators from link.

Remarks

The viz.RESET_ORI_* flags will internally create an operator to apply the offset. The operator is added to the ori operator list with a priority of -10. Existing ori operators with a priority less than or equal to -10 will be taken into account when computing the reset offset. If you reset the orientation and subsequently use viz.RESET_OPERATORS, the orientation offsets will be cleared.

The positional reset flags are applied to the link offset. Using viz.RESET_POS and subsequently calling setOffset, or vice versa, will affect the offset.

Return Value

None