Scripting Command MARUI_Navigation

Query and edit VR navigation (a.k.a Locomotion).

Parameters:

-reset (-rst)
Reset current navigation.

-translation (-trn) <float: x> <float: y> <float: z> [-relative (-rel)]
Set navigation tanslation (absolute or relative) x, y, z.
Add the -rel flag to make the navigation transformations relative (default is absolute).

-rotation (-rot) <float: pan> <float: tilt> <float: roll> [-relative (-rel)]
Set navigation rotation (absolute or relative) pan, tilt, roll.
Add the -rel flag to make the navigation transformations relative (default is absolute).

-scale (-scl) <float: scale> [-relative (-rel)]
Set navigation scale (absolute or relative).
Add the -rel flag to make the navigation transformations relative (default is absolute).

-mode (-m) <int>
Setting navigation mode. 0=none/disable, 1=grab-the-air, 2=tumble, 3=joystick, or -1=toggle/next.

-lockUp (-lu) <int>
Lock “up” axis in navigation. 1=on, 0=off, -1=toggle.

-lockRotation (-lr) <int>
Lock rotation in navigation. 1=on, 0=off, -1=toggle.

-lockAltitude (-la) <int>
Lock height / z-translation in navigation. 1=on, 0=off, -1=toggle.

-lockTranslation (-lt) <int>
Lock position/translation in navigation. 1=on, 0=off, -1=toggle.

-lockScale (-ls) <int>
Lock navigation scale axis in navigation. 1=on, 0=off, -1=toggle.

-autoFitScene (-afs)
Apply automatic fitting of the origin (in the world) to fit the content in the work space. (Re)sets navigation.

-autoFitObjects (-afo) [-direction (-dir) <string>]
Transform navigation matrix to fit the currently selected objects in the work space. (Re)sets navigation.
Optionally, the -dir flag can be used to determine from which direction to look at the objects. Valid directions are “back”, “front”, “left”, “right”, “up” and “down”.

-level (-lvl)
Apply automatic rotation of the origin in order to make z face upwards again.

-scaleUnits (-su) <float> <string>
Set origin scaling to represent Maya units as a multiple of real-world units. Real-world units can be “mm”, “cm”, “m”, “km”, “in”, “ft”, “yd” and “mile”.

-lookThroughSelected (-lts) <string>
Switch to / back from “look through selected object”. Possible values are “on”, “off”, and “toggle”.

-savepointList (-spt)
List all available Navigation Savepoints.

–savepointNew (-spn)
Create a new Navigation Savepoint at the current position.
Returns the name of the new navigation savepoint.

-savepointRename (-spr) <string: old name> <string: new name>
Rename navigation savepoint.

-savepointUpdate (-spu) <string: savepoint name>
Update existion navigation savepoint to current position.

-savepointApply (-spa) <string: savepoint name>
Return to existing savepoint, apply it as current navigation.

-savepointGet (-spg) <string: savepoint name>
Get navigation savepoint matrix.

-savepointDelete (-spd) <string: savepoint name>
Delete navigation savepoint.

-savepointClear (-spc)
Delete all navigation savepoints.

-savepointSave (-sps)
Save navigation savepoints to Maya scene as nodes.

-savepointLoad (-spl)
Load navigation savepoints from Maya scene nodes.