Scripting

You can use Maya MEL or MaxScript to automate the set-up of VCAT.

To initialize VCAT, you must call one of either of the following two commands:
MARUI.VCAT.StartSteamVR()
or:
MARUI.VCAT.StartOculus()
whichever VR app you wish to use.
※This call must be executed before any other scripting command.

You can then use scripting commands to perform the actions you would usually do manually in the MARUI menu:
Set the global scene position/offset, rotation, and scale:
MARUI.VCAT.SetScenePosition [10, -20, 30]
MARUI.VCAT.SetSceneRotation 45
MARUI.VCAT.SetSceneScale 1.23
MARUI.VCAT.SetPauseTracking true
MARUI.VCAT.SetPauseTracking false
You can use the scripting methods on the individual VR device objects to attach 3ds Max objects and set the rotation offsets:
$Headset.VCAT.AttachObject $Box001
$Headset.VCAT.SetRotationOffset [45, 90, 180]

You can also register a callback listener for controller interaction to customize the user interface.
The callback function should have the following signature:
function myEventListener device target event x y =
(
    case event of
    (
        “Press”:
        (
            print (target + ” pressed on ” + device)
        )
        “Release”:
        (
            print (target + ” released on ” + device)
        )
        “Touch”:
        (
            print (target + ” touched on ” + device + ” at ” + x as string + “, ” + y as string)
        )
    )
)
In this function, target is the button or part of the controller that the user interacted with can can be “TouchPad”, “MenuButton”, “Trigger”, “GripButton”, “ThumbStick” and so on, depending on which VR controller you’re using.
The device parameter is a string that identifies the VR device that the user is interacting with. This can be “RightController” or “LeftController”.
The event parameter is a string describing what kind of interaction just happened and can be “Press”, “Release” or “Touch”.
Finally, the x and y parameters are floating point variables that provide additional information such as where on the touch pad the user is touching or in which direction the thumb stick is pressed.

To register the event callback listener:
MARUI.VCAT.SetEventListener “myEventListener”
Note that when a even callback listener is registered, the usual controller interaction is disabled.
To un-register the event callback listener:
MARUI.VCAT.SetEventListener null
As soon as you de-register the event listener, the default controller interaction is activated again.