Core

Core functions and types that can be used by Lua scripts and plugins.

Classes

Type	Name
struct	MULTI Documentation helper for multi-return functions. Example usage: pos, rot, scale = vrNodeDecomposeTransform(node)

Functions

Type	Name
void	vrAbortScript(string name) Aborts a suspended script.
void	vrActivate(vrnode Self, vrnode Other =nil) Invokes the Activate event of a Node optionally setting the __Other register.
void	vrAddEventObserver(string uniqueID, string eventType, vrnode node, Any callback) Adds an observer and callback function to execute for events (e.g. 'Activate', 'Touch', 'Break', 'Click', 'DoubleClick', etc.)
void	vrAddGlobalEventObserver(string uniqueID, string eventType, Any callback) Adds an observer and callback function to execute for global events (e.g. 'KeyPress', 'KeyRelease', 'PoseEntered', 'PoseLeft', etc.)
void	vrAddMetaNodeObserver(string uniqueID, string metaNode, table callbacks) Adds an observer of events from a MetaNode. This notifies the script whenever a node of type metaNode is created.
void	vrAddNodeObserver(string uniqueID, node node, table callbacks) Adds an observer of events from a node. This notifies the script in certain circumstances - see the callbacks parameter.
void	vrAddSettingObserver(string key, Any callback, string settingPath, vrnode user =nil) Adds an observer of a setting. This notifies the script whenever the setting changes.
void	vrAddTransformNodeObserver(string uniqueID, Any transformCallback, Any enabledCallback, vrnode node, vrnode user =nil) Add an observer to the SGNode of a vrtree node.
void	vrAppCommandAdd(string commandName) Adds an app command and binds a lua function call to it.
void	vrAppCommandBind(string commandName, Any func) Binds a lua function to an app command.
string	vrAppDir() Gets the Visionary Render application directory.
void	vrArrange(vrnode targetNode, string type) Arranges assemblies into a grid based on their bounds.
void	vrBuildCurveViewConfig(number radius, number angle, number height, number segments, boolean smoothCurve, vrnode user =nil, vrnode camera, vrnode screens =nil, vrnode viewportLayout) Creates or updates the PhysicalScreen and Viewport nodes for a curved screen.
void	vrCaptureCleanState() Captures the current state of the Lua global environment.
void	vrCaptureViewpoint(vrnode viewpoint, number size, string captureComplete, string textureCreate =0) Captures the view from a specified viewpoint into a texture.
boolean	vrClearSelection(vrnode selectionGroup) Clears the selection in the specified selection group.
void	vrClusterMaster() Returns true if the local user is a cluster master.
void	vrClusterSlave() Returns true if the local user is a cluster slave.
boolean	vrConfigModeAvailable(number mode =CM_MODE_COUNT) Returns true or false if the specified mode is available.
void	vrConstrainNodeToBounds(vrnode node =nil, vrbox bbox =nil) Constrains a node with a TransformLimit to a bounding box.
void	vrCopyBitmap(vrnode node) Copies the texture data from a node onto the Windows clipboard.
void	vrCopySelectionToClipboard(vrnode selectionToCopy) Copies the specified selection group to the clipboard.
void	vrCopyToClipboard(vrnode nodeToCopy) Copies the specified node to the clipboard.
void	vrCreateGradient() Creates a new gradient.
void	vrCreateSequence() Adds a child sequence to a selected node or the Scenes node.
vrnode	vrCreateShape(string type, vrnode parent) Creates a new shape and attaches it to a parent node.
vrnode	vrCreateShapeData(string type, vrnode parent) Creates vertex and index nodes of a shape and adds them to the Mesh node passed in.
void	vrCreateUserInterface(vrnode uinode) Create the user interface components from the user interface metanode.
vrnode	vrCreateViewpoint(vrnode parent =nil, string name =0) Creates a viewpoint at the current camera position.
void	vrCursorGetTouchedAssembly() Gets the first assembly currently under the mouse cursor.
void	vrCursorGetTouchedGeoGroup() Gets the first geogroup currently under the mouse cursor.
void	vrCursorGetTouchedModel() Gets the first model currently under the mouse cursor.
void	vrCursorGetTouchedVisual() Gets the first visual currently under the mouse cursor.
void	vrCursorIgnoreNode(vrnode node, boolean ignore) Makes the specified node unpickable with the cursor.
string	vrDataFile(string path) Gets the specified file path from the Visionary Render application data directory, or an empty string if it does not exist.
void	vrDisableNetwork() Disables networking capabilities.
void	vrEnableNetwork() Enables networking capabilities.
void	vrEnableNodeWhenConfigModeAvailable(vrnode node, number mode =CM_MODE_COUNT) Makes a button available when the specified mode is avaliable.
void	vrEnableNodeWhenOculusAvailable(vrnode node) Makes a button available when an Oculus Rift is connected. Note: this function is for the legacy Oculus mode without Touch controllers.
void	vrEnableNodeWhenOculusTouchAvailable(vrnode node) Makes a button available when an Oculus Touch is connected.
void	vrEnableNodeWhenOpenVRAvailable(vrnode node) Makes a button available when an OpenVR HMD is connected.
void	vrEnableNodeWhenZSpaceAvailable(vrnode node) Makes a button available when a zSpace device is detected.
void	vrExtractBinaryAssets(vrnode fromNode, string path, boolean overwrite =true, ...) Extracts binary data from Texture or AudioBuffer nodes.
boolean	vrFileExists(string path) Returns true if the specified file exists.
void	vrFindAndOptimizeModels(vrnode node) Finds and optimises model nodes.
boolean	vrFolderExists(string path) Returns true if the specified folder exists.
void	vrForkApp() Forks the application into another process.
void	vrGenerateQRCodeFile(string content, string filename, number border =4, number pixelsPerModule =32, number errorCorrection =0) Generates a QR code and saves it to a file.
void	vrGenLightning() Generates a lightning polyline.
void	vrGeometryOp(string type, vrnode node) Performs a geometry operation.
vrnode	vrGetActivatorNode() Gets the node which activated the event.
MULTI< boolean, string >	vrGetAllDocHelp(boolean doxyFormat =false, string outputPath =0) Gets the entire Lua API reference, either to a string or a file.
vrnode	vrGetClipboardNode() Returns the node containing the clipboard content, or nil if nothing is on the clipboard.
boolean	vrGetCommandLineSwitch(string name) Returns whether or not a command line switch was specified.
string	vrGetCommandLineSwitchValue(string name) Returns the value of a command line switch.
table	vrGetContactPoints(vrnode nodeA, vrnode nodeB) Returns a list of contact points and normals between two nodes.
vrvec3	vrGetCursorPosition() Get the mouse cursor's current position.
void	vrGetGradientColourAt(vrnode gradientNode, number value) Gets the gradient colour (as RGB value) at the specified position.
vrnode	vrGetHoldingUser(vrnode node) Return the user that is holding the node.
vrnode	vrGetIconsLibrary(boolean create =true) Gets the library in which browser icons are stored.
table	vrGetImporterFileExtensions(string importerName) Gets the file extensions associated with an importer plugin.
table	vrGetImporterList() Gets the names of all installed data importer plugins.
vrvec3	vrGetLastClickedCursorPosition(vrnode user =nil) Get the position of the cursor when the mouse was last clicked.
string	vrGetLastOpenDir() Returns the last directory selected.
vrnode	vrGetLastViewSelectionGroup() Returns the selection group that was added to.
table	vrGetRecentFileList() Returns the list of recent files.
table	vrGetRecentFolderList() Returns the list of recent folders.
table	vrGetRecentImportFileList() Returns the list of recent import files.
table	vrGetRecentImportFolderList() Returns the list of recent import folders.
vrnode	vrGetTrackedEyeNode() Gets the current tracked eye node.
vrnode	vrGetTrackedHandNode(number index =-1) Gets the current tracked hand node.
vrvec3	vrGetUserOffset(boolean world =true, boolean atHeadHeight =false) Gets the offset from the body to the user's standing position.
vrnode	vrGetViewportLayout(vrnode userNode =nil) Gets the user's current viewport layout.
string	vrGetVisRenRevision() Returns the revision number of Visionary Render being used.
string	vrGetVisRenVersion() Returns the version number of Visionary Render being used.
void	vrGrabObjectWithTrackedHand(vrnode target, boolean moveToHand =true, boolean rotateToHand =true, boolean scaleToHand =true, boolean releaseOthers =true, number handIndex =-1, vrnode user =nil) Attaches a target node to the hand.
void	vrGroupAddMember(vrnode groupNode, vrnode memberNode) Adds a node to the specified group.
void	vrGroupHasNodeOfType(vrnode groupNode, string metaType) Checks whether a group contains a node of a specified type.
void	vrGroupRemoveMember(vrnode groupNode, vrnode memberNode) Removes a node from the specified group.
vrnode	vrGroupSnapshot(vrnode groupNode) Creates a snapshot of the specified group.
vrnode	vrGroupsRoot(boolean noCreate =false) Gets the Groups root node under the Scenes tree.
void	vrHasLicenceFeature(string featureName) Checks whether a licence feature is available.
boolean	vrHasPermission(string permission, vrnode originatorNode =nil) Queries whether or not we have a named permission.
void	vrHistoryAddMark() Adds an undo point in to the History.
void	vrHistoryClear() Erases the undo history.
void	vrHistoryStepBack() Undoes the history to the previous history mark.
void	vrHistoryStepForward() Redoes the history to the next history mark.
void	vrImportAssetLibrary(string file) Imports an asset library.
boolean	vrInCoroutine(string script) Executes the specified piece of Lua in a coroutine.
void	vrIsClustered() Returns true if running in a cluster configuration.
void	vrIsDebugBuild() Returns true if the DEBUG compilation flag was defined.
boolean	vrIsEditableScriptNode(vrnode node) Returns true if the supplied node contains a script property supported by the script editor.
boolean	vrIsStereoAvailable(number mode =0) Returns true if stereo 3D is available in the current instance of Visionary Render.
boolean	vrIsSystemNode(vrnode node) Returns true if the system node is an ancestor of node.
boolean	vrIsToolEnabled(string toolName, vrnode userNode =nil) Tests whether a named Tool is enabled.
boolean	vrIsTrackingEnabled() Gets the enabled state of the user's tracking.
boolean	vrLaunchProcess(string cmdline, boolean pipeOutput =false, number timeout =0.0) Launches a command or application asynchronously.
void	vrLinkNetwork(string host, number port) Links to another application instance forming a Peer-To-Peer network.
string	vrListExports() List all Lua VR extension functions.
table	vrListSleepingScripts(boolean details =false) Lists the scripts currently suspended, awaiting resume.
void	vrLoadAvatarFromFile(vrnode parent, string filename) Loads an avatar from a file and places it as a child to parent node.
void	vrLoadAvatarFromFileToEdit(vrnode parent, string filename) Loads an avatar from a file and places it in a scene to edit. Can be saved by using Developer->Save Avatar.
void	vrLoadPlugin(string pluginName, string pluginVersion, string pluginInternalName, string pluginDir)
vrnode	vrLocalUserNode() Returns the local user's node.
vrnode	vrMakeArrow(vrnode parent, string name, number length, number width, number centreBias) Creates an arrow shape.
vrnode	vrMakeBox(vrnode parent, string name, number width, number height, number depth) Creates a box shape.
vrnode	vrMakeCylinder(vrnode parent, string name, number bottomRadius, number topRadius, number height) Creates a cylinder shape.
vrnode	vrMakeEllipsoid(vrnode parent, string name, number radiusX, number radiusY, number radiusZ) Creates an ellipsoid shape.
vrnode	vrMakePlane(vrnode parent, string name, number hsize, number vsize) Creates a plane shape.
vrnode	vrMakeTorus(vrnode parent, string name, number radius, number rez, number ringRadius, number ringRez) Creates a torus shape.
boolean	vrModifierPressed(number id) Tests whether any modifier keys are pressed.
void	vrNetworkSetRetryConnect(boolean allowRetry) Sets whether failed calls to vrLinkNetwork should retry until the user manual aborts them.
table	vrParseJSON(string data) Parse JSON data into a Lua table.
table	vrParseXML(string xml) Converts an XML string into a hierarchy of nested LUA tables.
void	vrPasteAsChild(vrnode targetNode) Pastes the contents of the clipboard as a child to the target node.
void	vrPasteAsChildToSelection(vrnode viewSelection) Pastes the contents of the clipboard as a child to the selection group.
void	vrPasteAsLinkToSelection(vrnode selectionGroup, string targetMetaNodeName, string targetPropertyName) Pastes the nodes on the clipboard as a link into the target property of the specified selection group.
void	vrPasteAsSibling(vrnode targetNode) Pastes the contents of the clipboard as a sibling to the specified node.
void	vrPasteAsSiblingToSelection(vrnode selectionGroup) Pastes the contents of the clipboard as a sibling to the specified selection group.
void	vrPastePropagateLink(vrnode selectionGroup, string targetMetaNodeName, string targetPropertyName) Pastes the nodes on the clipboard as a link into all matching nodes and target properties.
string	vrPluginsDir() Gets the Visionary Render plugins directory.
void	vrPostCommand(string cmd, string param =0, vrnode user =nil) Posts a command to be processed by Visionary Render.
void	vrPrimaryUserNode() Returns the cluster master's user node, or the local user node if unclustered.
void	vrPushRecentFile(string file) Adds a file to the end of the list of recent files and its folder to the end of the list of recent folders.
void	vrPushRecentImportFile(string file) Adds a file to the end of the list of recent imports and its folder to the end of the list of recent import folders.
void	vrReleaseObjectFromTrackedHand(vrnode target =nil, number handIndex =-1, vrnode user =nil) Releases a node attached to the hand. This works in conjunction with vrGrabObjectWithTrackedHand and the TrackedManipulatorTool.
void	vrReloadAudio(vrnode node) Finds audio nodes and reloads the audio data from the associated files.
void	vrReloadTextures(vrnode node) Recursively finds texture nodes and reloads the texture data from the associated files.
void	vrRemoveObserver(string uniqueID) Removes an observer.
void	vrRemoveRecentItem(string file, string nodeName) Removes a recent file, folder or import from the corresponding list.
void	vrRemoveTransformLimits(vrnode node, string type) Removes the TransformLimits on a node.
string	vrRequestFolder(string caption =0, string initialDir =0) Invokes a dialog to select a folder.
string	vrRequestLoadFile(string caption =0, string initialDir =0, string filterStr =0, string defaultExt =0) Invokes a dialog to load a file.
string	vrRequestSaveFile(string caption =0, string initialDir =0, string filterStr =0, string defaultExt =0, string defaultFile =0) Invokes a dialog to save a file.
void	vrRescalePRSManipulator() Refreshes the scale of the PRS manipulator.
void	vrRevertToCleanState() Restores the captured state of the Lua global environment.
void	vrSearchView(string view, string searchString) Sets the search query for a specified view.
void	vrSetAppQuitHook(string luaFunc) Specify a lua function to be called when user tries to quit the application.
void	vrSetConfigMode(number mode =CM_MODE_COUNT) Sets the config to the specified mode, if its available.
void	vrSetScriptIdentifier(string name) Sets an identifier for the Lua execution.
void	vrSetScriptTimeout(number time) Overrides the default Lua timeout for scripts, until the next script event is triggered.
void	vrSetToolEnabled(string toolName, boolean enabled, vrnode userNode =nil) Sets the Enabled state of a named Tool.
void	vrSetTrackedEyeNode(vrnode node =nil) Sets the tracked eye to the specified node.
void	vrSetTrackedHandNode(vrnode node =nil, number index =1) Sets the tracked hand to the specified node.
void	vrSetTransformLimits(vrnode node, string type, string limitType, boolean x, boolean y, boolean z) Adds transform limits onto a node.
void	vrSetViewportLayout(vrnode viewportLayoutNode, vrnode userNode =nil) Sets the user's current viewport layout.
boolean	vrShouldSaveCamera() Returns true if the camera position should be saved into documents.
void	vrSnapshotApply(vrnode snapNode) Applies the specified snapshot.
MULTI< string, string, string >	vrSplitFilePath(string path) Returns file directory, name, and extension.
void	vrSplitVirtalisHubURL(string url) Identifies a Virtalis Hub URL and splits out the server name, artifact ID and artifact name.
table	vrSubDirs(string path) Gets the subdirectories of a directory.
void	vrToggleProjection() Toggles the current viewport between perspective and orthographic views.
void	vrToggleToolEnabled(string toolName, vrnode userNode =nil) Toggles the Enabled state of a named Tool.
void	vrTrackedCursorGetTouchedAssembly() Gets the first assembly currently under the tracked cursor.
void	vrUnloadPlugin(string pluginInfo)
string	vrUserDocumentsDir() Gets the current user's documents directory.
string	vrUserPluginsDir() Gets the current applications users plug-ins directory.
vrnode	vrUsersNode() Returns the 'Users' node from the tree.
boolean	vrUsingHMD() Returns whether or not we are using a HMD.
void	vrYield(number time =0.0) Yields the Lua execution back to the application for the (approximate) specified time.

Functions Documentation

vrAbortScript

void vrAbortScript(
    string name
)

Aborts a suspended script.

Parameters:

• name The name of the script (reported by vrListSleepingScripts)

vrActivate

void vrActivate(
    vrnode Self,
    vrnode Other =nil
)

Invokes the Activate event of a Node optionally setting the __Other register.

Parameters:

• Self The node to put in the __Self register of the activated event
• Other The node to put in the __Other register of the activated event

vrAddEventObserver

void vrAddEventObserver(
    string uniqueID,
    string eventType,
    vrnode node,
    Any callback
)

Adds an observer and callback function to execute for events (e.g. 'Activate', 'Touch', 'Break', 'Click', 'DoubleClick', etc.)

Parameters:

• uniqueID A unique ID for use in vrRemoveObserver()
• eventType The type of event to observe, such as 'Activate' or 'Touch'
• node The node to observe for new events
• callback A Lua function to call when events are activated. This function should have a signature of function(). It can be a string name of a global function or a Lua function object

vrAddGlobalEventObserver

void vrAddGlobalEventObserver(
    string uniqueID,
    string eventType,
    Any callback
)

Adds an observer and callback function to execute for global events (e.g. 'KeyPress', 'KeyRelease', 'PoseEntered', 'PoseLeft', etc.)

Parameters:

• uniqueID A unique ID for use in vrRemoveObserver()
• eventType The type of global event to observe, such as 'KeyPress' or 'PoseEntered'
• callback A Lua function to call when global events are activated. This function should have a signature of function(). It can be a string name of a global function or a Lua function object

vrAddMetaNodeObserver

void vrAddMetaNodeObserver(
    string uniqueID,
    string metaNode,
    table callbacks
)

Adds an observer of events from a MetaNode. This notifies the script whenever a node of type metaNode is created.

Parameters:

• uniqueID A unique ID for this observer. Use this with vrRemoveObserver.

• metaNode The type of node to observe.

• callbacks Table of callbacks. Each value can be a string name of a global function or a lua function object. Possible keys are:

• nodeCreated - called when a node is created. This function should have a signature of function(meta, newnode).

• nodeRenamed - called when a node's name is changed. This function should have a signature of function(meta, node).

• nodeParentChanged - called when a node's parent is changed. This function should have a signature of function(meta, node, oldParent, newParent).

• nodeAddingToRecycleBin - called when a node is added to the recycle bin. This function should have a signature of function(meta, node).

• nodeRestoredFromRecycleBin - called when a node is restored from the recycle bin, e.g. with an undo command. This function should have a signature of function(meta, node).

• nodeDestroying - called when a node is finally deleted, usually when closing the scene. You are more likely to want nodeAddingToRecycleBin. This function should have a signature of function(meta, node).

vrAddNodeObserver

void vrAddNodeObserver(
    string uniqueID,
    node node,
    table callbacks
)

Adds an observer of events from a node. This notifies the script in certain circumstances - see the callbacks parameter.

Parameters:

• uniqueID A unique ID for this observer. Use this with vrRemoveObserver.

• node The node to observe.

• callbacks Table of callbacks. Each value can be a string name of a global function, or a lua function object, and should have a signature of function(node). Possible keys are:

• valuesChanged - called when any of the node values change.

• addingToRecycleBin - called when the node is sent to the recycle bin.

• restoredFromRecycleBin - called when the node is restored from the recycle bin, e.g. with an undo command.

• destroying - called when the node is finally deleted, usually when closing the scene. You are more likely to want addingToRecycleBin.

vrAddSettingObserver

void vrAddSettingObserver(
    string key,
    Any callback,
    string settingPath,
    vrnode user =nil
)

Adds an observer of a setting. This notifies the script whenever the setting changes.

Parameters:

• key A unique key for this observer. Use this with vrRemoveObserver
• callback Lua function to call when a node is created. This function should have a signature of function(value). This can be a string name of a global function, or a Lua function object
• settingPath Path to the setting to observe (relative to the registry root)
• user The user that this observer belongs to (defaults to the current user)

vrAddTransformNodeObserver

void vrAddTransformNodeObserver(
    string uniqueID,
    Any transformCallback,
    Any enabledCallback,
    vrnode node,
    vrnode user =nil
)

Add an observer to the SGNode of a vrtree node.

Parameters:

• uniqueID A unique ID for this observer. Use this with vrRemoveObserver.
• transformCallback Lua function to call when the nodes transform changes. This function should have a signature of function(node, transform). This can be a string name of a global function, or a lua function object
• enabledCallback Lua function to call when the nodes enabled state changes. This function should have a signature of function(node, enabled). This can be a string name of a global function, or a lua function object
• node The node to observe.
• user THe user associated with this observer.

vrAppCommandAdd

void vrAppCommandAdd(
    string commandName
)

Adds an app command and binds a lua function call to it.

vrAppCommandBind

void vrAppCommandBind(
    string commandName,
    Any func
)

Binds a lua function to an app command.

vrAppDir

string vrAppDir()

Gets the Visionary Render application directory.

Return: Absolute path to the folder containing visren-app.exe

vrArrange

void vrArrange(
    vrnode targetNode,
    string type
)

Arranges assemblies into a grid based on their bounds.

Parameters:

• targetNode ViewSelectionContainer holding a selection of nodes to arrange

• type Type of grid (alignment):

• gridXY

• gridXZ

• gridYZ

vrBuildCurveViewConfig

void vrBuildCurveViewConfig(
    number radius,
    number angle,
    number height,
    number segments,
    boolean smoothCurve,
    vrnode user =nil,
    vrnode camera,
    vrnode screens =nil,
    vrnode viewportLayout
)

Creates or updates the PhysicalScreen and Viewport nodes for a curved screen.

Parameters:

• radius The radius of the curve in metres
• angle The curvature of the screen in degrees
• height The height of the screen in metres
• segments The number of viewports to split the curve into
• smoothCurve Whether to apply distortion to wrap the image onto a smoothly curved screen, or leave the segments facetted
• user The user to create the configuration for

vrCaptureCleanState

void vrCaptureCleanState()

Captures the current state of the Lua global environment.

vrCaptureViewpoint

void vrCaptureViewpoint(
    vrnode viewpoint,
    number size,
    string captureComplete,
    string textureCreate =0
)

Captures the view from a specified viewpoint into a texture.

Parameters:

• viewpoint Viewpoint node to capture
• size Size of image to capture to (square)
• captureComplete Name of a Lua function to call with the complete catured texture
• textureCreate Name of a Lua function to call to create a texture node

vrClearSelection

boolean vrClearSelection(
    vrnode selectionGroup
)

Clears the selection in the specified selection group.

Parameters:

• selectionGroup The selection group to clear

Return: true if the selection was cleared

vrClusterMaster

void vrClusterMaster()

Returns true if the local user is a cluster master.

vrClusterSlave

void vrClusterSlave()

Returns true if the local user is a cluster slave.

vrConfigModeAvailable

boolean vrConfigModeAvailable(
    number mode =CM_MODE_COUNT
)

Returns true or false if the specified mode is available.

Parameters:

• mode Immersive mode value

Return: true if the mode is available

vrConstrainNodeToBounds

void vrConstrainNodeToBounds(
    vrnode node =nil,
    vrbox bbox =nil
)

Constrains a node with a TransformLimit to a bounding box.

Parameters:

• node The node to Constrain

vrCopyBitmap

void vrCopyBitmap(
    vrnode node
)

Copies the texture data from a node onto the Windows clipboard.

Parameters:

• node Texture node to copy

vrCopySelectionToClipboard

void vrCopySelectionToClipboard(
    vrnode selectionToCopy
)

Copies the specified selection group to the clipboard.

vrCopyToClipboard

void vrCopyToClipboard(
    vrnode nodeToCopy
)

Copies the specified node to the clipboard.

vrCreateGradient

void vrCreateGradient()

Creates a new gradient.

vrCreateSequence

void vrCreateSequence()

Adds a child sequence to a selected node or the Scenes node.

vrCreateShape

vrnode vrCreateShape(
    string type,
    vrnode parent
)

Creates a new shape and attaches it to a parent node.

Parameters:

• type Type of shape to create:

• plane

• cube

• sphere

• cubicsphere

• disc

• cone

• cylinder

• arrow

• sponge^3

• sponge^4

• torus

• knot

• room

• room2

• axis

  • parent Parent of the new node

Return: The new assembly node referencing the new shape model

vrCreateShapeData

vrnode vrCreateShapeData(
    string type,
    vrnode parent
)

Creates vertex and index nodes of a shape and adds them to the Mesh node passed in.

Parameters:

• type Type of shape to create:

• plane

• cube

• sphere

• cubicsphere

• disc

• cone

• cylinder

• arrow

• torus

• knot

  • parent Mesh node onto which the data should be added

Return: The Mesh node passed in

vrCreateUserInterface

void vrCreateUserInterface(
    vrnode uinode
)

Create the user interface components from the user interface metanode.

Parameters:

• uinode The user interface metanode

vrCreateViewpoint

vrnode vrCreateViewpoint(
    vrnode parent =nil,
    string name =0
)

Creates a viewpoint at the current camera position.

Parameters:

• parent Parent of the new viewpoint node. If not specified, viewpoint is created under the root ViewpointList node in the scenes tree
• name The name of the new viewpoint

Return: The new viewpoint node

vrCursorGetTouchedAssembly

void vrCursorGetTouchedAssembly()

Gets the first assembly currently under the mouse cursor.

vrCursorGetTouchedGeoGroup

void vrCursorGetTouchedGeoGroup()

Gets the first geogroup currently under the mouse cursor.

vrCursorGetTouchedModel

void vrCursorGetTouchedModel()

Gets the first model currently under the mouse cursor.

vrCursorGetTouchedVisual

void vrCursorGetTouchedVisual()

Gets the first visual currently under the mouse cursor.

vrCursorIgnoreNode

void vrCursorIgnoreNode(
    vrnode node,
    boolean ignore
)

Makes the specified node unpickable with the cursor.

Parameters:

• ignore True makes it unpickable, false makes it pickable.

vrDataFile

string vrDataFile(
    string path
)

Gets the specified file path from the Visionary Render application data directory, or an empty string if it does not exist.

Parameters:

• path Path to the data file relative to the application data directory

Return: Absolute path to the specified data file

vrDisableNetwork

void vrDisableNetwork()

Disables networking capabilities.

vrEnableNetwork

void vrEnableNetwork()

Enables networking capabilities.

vrEnableNodeWhenConfigModeAvailable

void vrEnableNodeWhenConfigModeAvailable(
    vrnode node,
    number mode =CM_MODE_COUNT
)

Makes a button available when the specified mode is avaliable.

Parameters:

• node Button node to enable
• mode Immersive mode value

vrEnableNodeWhenOculusAvailable

void vrEnableNodeWhenOculusAvailable(
    vrnode node
)

Makes a button available when an Oculus Rift is connected. Note: this function is for the legacy Oculus mode without Touch controllers.

Parameters:

• node Button node to enable

vrEnableNodeWhenOculusTouchAvailable

void vrEnableNodeWhenOculusTouchAvailable(
    vrnode node
)

Makes a button available when an Oculus Touch is connected.

Parameters:

• node Button node to enable

vrEnableNodeWhenOpenVRAvailable

void vrEnableNodeWhenOpenVRAvailable(
    vrnode node
)

Makes a button available when an OpenVR HMD is connected.

Parameters:

• node Button node to enable

vrEnableNodeWhenZSpaceAvailable

void vrEnableNodeWhenZSpaceAvailable(
    vrnode node
)

Makes a button available when a zSpace device is detected.

Parameters:

• node Button node to enable

vrExtractBinaryAssets

void vrExtractBinaryAssets(
    vrnode fromNode,
    string path,
    boolean overwrite =true, 
    ...
)

Extracts binary data from Texture or AudioBuffer nodes.

Parameters:

• fromNode The node to extract from - may be a single node or a library to search
• path Directory or file to save data to
• overwrite Whether to overwrite existing files on disk
• ... Types to search for ('Texture' or 'AudioBuffer'); only required if fromNode is a different type

vrFileExists

boolean vrFileExists(
    string path
)

Returns true if the specified file exists.

Parameters:

• path Relative or absolute path to test

Return: True if the file exists

vrFindAndOptimizeModels

void vrFindAndOptimizeModels(
    vrnode node
)

Finds and optimises model nodes.

vrFolderExists

boolean vrFolderExists(
    string path
)

Returns true if the specified folder exists.

Parameters:

• path Relative or absolute path to test

Return: True if the folder exists

vrForkApp

void vrForkApp()

Forks the application into another process.

vrGenerateQRCodeFile

void vrGenerateQRCodeFile(
    string content,
    string filename,
    number border =4,
    number pixelsPerModule =32,
    number errorCorrection =0
)

Generates a QR code and saves it to a file.

Parameters:

• content The content of the QR code
• filename Where to save the generated QR code
• border The border size in modules, between 0 and 16 (optional, default: 4)
• pixelsPerModule The number of image pixels per module of the QR code, between 1 and 64 (optional, default: 32)
• errorCorrection The minimum level of error correction to include, between 0 (low) and 3 (high) (optional, default: 0)

vrGenLightning

void vrGenLightning()

Generates a lightning polyline.

vrGeometryOp

void vrGeometryOp(
    string type,
    vrnode node
)

Performs a geometry operation.

Parameters:

• type The type of operation:

• weld

• normals

• tangents

• uv

• tess

• sort

• invert

• optimise

• split

• explode

• prune

• sieve

• recentre

• transform

• merge

  • node The node to perform the operation on

vrGetActivatorNode

vrnode vrGetActivatorNode()

Gets the node which activated the event.

vrGetAllDocHelp

MULTI< boolean, string > vrGetAllDocHelp(
    boolean doxyFormat =false,
    string outputPath =0
)

Gets the entire Lua API reference, either to a string or a file.

Parameters:

• doxyFormat Whether to format the API docs in doxygen format
• outputPath Path to file to write to instead of returning the string

Return:

• Success status
• Lua API Documentation

vrGetClipboardNode

vrnode vrGetClipboardNode()

Returns the node containing the clipboard content, or nil if nothing is on the clipboard.

vrGetCommandLineSwitch

boolean vrGetCommandLineSwitch(
    string name
)

Returns whether or not a command line switch was specified.

Parameters:

• name The name of the command line switch

Return: True if the command line option is present

vrGetCommandLineSwitchValue

string vrGetCommandLineSwitchValue(
    string name
)

Returns the value of a command line switch.

Parameters:

• name The name of the command line switch

vrGetContactPoints

table vrGetContactPoints(
    vrnode nodeA,
    vrnode nodeB
)

Returns a list of contact points and normals between two nodes.

Return: Array of contact information.

vrGetCursorPosition

vrvec3 vrGetCursorPosition()

Get the mouse cursor's current position.

Return: World position of the mouse cursor

vrGetGradientColourAt

void vrGetGradientColourAt(
    vrnode gradientNode,
    number value
)

Gets the gradient colour (as RGB value) at the specified position.

vrGetHoldingUser

vrnode vrGetHoldingUser(
    vrnode node
)

Return the user that is holding the node.

Parameters:

• node The node that is being held

Return: The user that is holding the object

vrGetIconsLibrary

vrnode vrGetIconsLibrary(
    boolean create =true
)

Gets the library in which browser icons are stored.

Parameters:

• create Whether to create the library if it doesn't already exist

vrGetImporterFileExtensions

table vrGetImporterFileExtensions(
    string importerName
)

Gets the file extensions associated with an importer plugin.

Return: Array of file extension names

vrGetImporterList

table vrGetImporterList()

Gets the names of all installed data importer plugins.

Return: Array of importer names

vrGetLastClickedCursorPosition

vrvec3 vrGetLastClickedCursorPosition(
    vrnode user =nil
)

Get the position of the cursor when the mouse was last clicked.

Parameters:

• user The user to obtain the last click of. Uses the local user if not specified.

Return: World position where the mouse was last clicked

vrGetLastOpenDir

string vrGetLastOpenDir()

Returns the last directory selected.

vrGetLastViewSelectionGroup

vrnode vrGetLastViewSelectionGroup()

Returns the selection group that was added to.

vrGetRecentFileList

table vrGetRecentFileList()

Returns the list of recent files.

Return: Array of paths to recently opened files

vrGetRecentFolderList

table vrGetRecentFolderList()

Returns the list of recent folders.

Return: Array of paths to folders from which files have recently been opened

vrGetRecentImportFileList

table vrGetRecentImportFileList()

Returns the list of recent import files.

Return: Array of paths to files that have recently been imported

vrGetRecentImportFolderList

table vrGetRecentImportFolderList()

Returns the list of recent import folders.

Return: Array of paths to folders from which files have recently been imported

vrGetTrackedEyeNode

vrnode vrGetTrackedEyeNode()

Gets the current tracked eye node.

vrGetTrackedHandNode

vrnode vrGetTrackedHandNode(
    number index =-1
)

Gets the current tracked hand node.

Parameters:

• index -1 or nil for default, 0, for left hand, 1 for right hand

vrGetUserOffset

vrvec3 vrGetUserOffset(
    boolean world =true,
    boolean atHeadHeight =false
)

Gets the offset from the body to the user's standing position.

vrGetViewportLayout

vrnode vrGetViewportLayout(
    vrnode userNode =nil
)

Gets the user's current viewport layout.

Parameters:

• userNode user whose viewport should be queried (defaults to local user)

vrGetVisRenRevision

string vrGetVisRenRevision()

Returns the revision number of Visionary Render being used.

vrGetVisRenVersion

string vrGetVisRenVersion()

Returns the version number of Visionary Render being used.

Return: Version string formatted Major.Minor.Patch

vrGrabObjectWithTrackedHand

void vrGrabObjectWithTrackedHand(
    vrnode target,
    boolean moveToHand =true,
    boolean rotateToHand =true,
    boolean scaleToHand =true,
    boolean releaseOthers =true,
    number handIndex =-1,
    vrnode user =nil
)

Attaches a target node to the hand.

Parameters:

• target The node to attach to the hand
• moveToHand Whether to match the position of the grabbed object to the hand
• rotateToHand Whether to match the rotation of the grabbed object to the hand
• scaleToHand Whether to match the scale of the grabbed object to the hand
• releaseOthers Whether to release any other objects that were in the hand
• handIndex -1 or nil for default, 0, for left hand, 1 for right hand
• user The user whose hand the object should be attached to, or nil for the current user

vrGroupAddMember

void vrGroupAddMember(
    vrnode groupNode,
    vrnode memberNode
)

Adds a node to the specified group.

Parameters:

• groupNode The group node
• memberNode The node to add to the group

vrGroupHasNodeOfType

void vrGroupHasNodeOfType(
    vrnode groupNode,
    string metaType
)

Checks whether a group contains a node of a specified type.

Parameters:

• groupNode The group node
• metaType The type of node to find

vrGroupRemoveMember

void vrGroupRemoveMember(
    vrnode groupNode,
    vrnode memberNode
)

Removes a node from the specified group.

Parameters:

• groupNode The group node
• memberNode The node to remove from the group

vrGroupSnapshot

vrnode vrGroupSnapshot(
    vrnode groupNode
)

Creates a snapshot of the specified group.

Parameters:

• groupNode The group node

Return: The snapshot node that was created/updated

vrGroupsRoot

vrnode vrGroupsRoot(
    boolean noCreate =false
)

Gets the Groups root node under the Scenes tree.

Parameters:

• noCreate When true, the root node will not be created if it does not exist

vrHasLicenceFeature

void vrHasLicenceFeature(
    string featureName
)

Checks whether a licence feature is available.

Parameters:

• featureName The name of the licence feature

vrHasPermission

boolean vrHasPermission(
    string permission,
    vrnode originatorNode =nil
)

Queries whether or not we have a named permission.

Parameters:

• permission The permission to query
• originatorNode The originator

Return: true if the permission is present

vrHistoryAddMark

void vrHistoryAddMark()

Adds an undo point in to the History.

vrHistoryClear

void vrHistoryClear()

Erases the undo history.

vrHistoryStepBack

void vrHistoryStepBack()

Undoes the history to the previous history mark.

vrHistoryStepForward

void vrHistoryStepForward()

Redoes the history to the next history mark.

vrImportAssetLibrary

void vrImportAssetLibrary(
    string file
)

Imports an asset library.

Parameters:

• file Path to the asset library file

vrInCoroutine

boolean vrInCoroutine(
    string script
)

Executes the specified piece of Lua in a coroutine.

Parameters:

• script Lua code to execute

Return: true if the coroutine is started successfully

vrIsClustered

void vrIsClustered()

Returns true if running in a cluster configuration.

vrIsDebugBuild

void vrIsDebugBuild()

Returns true if the DEBUG compilation flag was defined.

vrIsEditableScriptNode

boolean vrIsEditableScriptNode(
    vrnode node
)

Returns true if the supplied node contains a script property supported by the script editor.

Parameters:

• node node to check

vrIsStereoAvailable

boolean vrIsStereoAvailable(
    number mode =0
)

Returns true if stereo 3D is available in the current instance of Visionary Render.

Parameters:

• mode Stereo mode to check. Default (0) checks for quad buffered stereo support. All other values return true

vrIsSystemNode

boolean vrIsSystemNode(
    vrnode node
)

Returns true if the system node is an ancestor of node.

vrIsToolEnabled

boolean vrIsToolEnabled(
    string toolName,
    vrnode userNode =nil
)

Tests whether a named Tool is enabled.

Parameters:

• toolName The name of the tool that is tested
• userNode The user the tool belongs to. If none is specified, the current user is used

Return: true if it is enabled

vrIsTrackingEnabled

boolean vrIsTrackingEnabled()

Gets the enabled state of the user's tracking.

Return: true if it is enabled

vrLaunchProcess

boolean vrLaunchProcess(
    string cmdline,
    boolean pipeOutput =false,
    number timeout =0.0
)

Launches a command or application asynchronously.

Parameters:

• cmdline The command to execute.
• pipeOutput True if the process should pipe its output to the log.
• timeout A maximum time in seconds the process can run for before being force-terminated.

Return: True if the process started successfully.

vrLinkNetwork

void vrLinkNetwork(
    string host,
    number port
)

Links to another application instance forming a Peer-To-Peer network.

Parameters:

• host IP address or hostname to connect to
• port TCP port to connect to

vrListExports

string vrListExports()

List all Lua VR extension functions.

Return: List of function names separated by new lines

vrListSleepingScripts

table vrListSleepingScripts(
    boolean details =false
)

Lists the scripts currently suspended, awaiting resume.

Parameters:

• details Whether to display additional details about each script

Return: Array of script identifiers

vrLoadAvatarFromFile

void vrLoadAvatarFromFile(
    vrnode parent,
    string filename
)

Loads an avatar from a file and places it as a child to parent node.

vrLoadAvatarFromFileToEdit

void vrLoadAvatarFromFileToEdit(
    vrnode parent,
    string filename
)

Loads an avatar from a file and places it in a scene to edit. Can be saved by using Developer->Save Avatar.

vrLoadPlugin

void vrLoadPlugin(
    string pluginName,
    string pluginVersion,
    string pluginInternalName,
    string pluginDir
)

vrLocalUserNode

vrnode vrLocalUserNode()

Returns the local user's node.

vrMakeArrow

vrnode vrMakeArrow(
    vrnode parent,
    string name,
    number length,
    number width,
    number centreBias
)

Creates an arrow shape.

vrMakeBox

vrnode vrMakeBox(
    vrnode parent,
    string name,
    number width,
    number height,
    number depth
)

Creates a box shape.

vrMakeCylinder

vrnode vrMakeCylinder(
    vrnode parent,
    string name,
    number bottomRadius,
    number topRadius,
    number height
)

Creates a cylinder shape.

vrMakeEllipsoid

vrnode vrMakeEllipsoid(
    vrnode parent,
    string name,
    number radiusX,
    number radiusY,
    number radiusZ
)

Creates an ellipsoid shape.

vrMakePlane

vrnode vrMakePlane(
    vrnode parent,
    string name,
    number hsize,
    number vsize
)

Creates a plane shape.

vrMakeTorus

vrnode vrMakeTorus(
    vrnode parent,
    string name,
    number radius,
    number rez,
    number ringRadius,
    number ringRez
)

Creates a torus shape.

vrModifierPressed

boolean vrModifierPressed(
    number id
)

Tests whether any modifier keys are pressed.

Parameters:

• id Modifier ID. 0 = Ctrl, 1 = Shift, 2 = Alt

Return: true if the modifier key is currently being pressed

vrNetworkSetRetryConnect

void vrNetworkSetRetryConnect(
    boolean allowRetry
)

Sets whether failed calls to vrLinkNetwork should retry until the user manual aborts them.

Parameters:

• allowRetry Whether to retry failed calls to vrLinkNetwork

vrParseJSON

table vrParseJSON(
    string data
)

Parse JSON data into a Lua table.

Parameters:

• data JSON data

Return: The parsed data in Lua tables matching the original JSON structure

vrParseXML

table vrParseXML(
    string xml
)

Converts an XML string into a hierarchy of nested LUA tables.

Parameters:

• xml The XML to parse

Return: Table representing the document structure

vrPasteAsChild

void vrPasteAsChild(
    vrnode targetNode
)

Pastes the contents of the clipboard as a child to the target node.

vrPasteAsChildToSelection

void vrPasteAsChildToSelection(
    vrnode viewSelection
)

Pastes the contents of the clipboard as a child to the selection group.

vrPasteAsLinkToSelection

void vrPasteAsLinkToSelection(
    vrnode selectionGroup,
    string targetMetaNodeName,
    string targetPropertyName
)

Pastes the nodes on the clipboard as a link into the target property of the specified selection group.

vrPasteAsSibling

void vrPasteAsSibling(
    vrnode targetNode
)

Pastes the contents of the clipboard as a sibling to the specified node.

vrPasteAsSiblingToSelection

void vrPasteAsSiblingToSelection(
    vrnode selectionGroup
)

Pastes the contents of the clipboard as a sibling to the specified selection group.

vrPastePropagateLink

void vrPastePropagateLink(
    vrnode selectionGroup,
    string targetMetaNodeName,
    string targetPropertyName
)

Pastes the nodes on the clipboard as a link into all matching nodes and target properties.

vrPluginsDir

string vrPluginsDir()

Gets the Visionary Render plugins directory.

Return: Absolute path to the plugins directory in the application install folder

vrPostCommand

void vrPostCommand(
    string cmd,
    string param =0,
    vrnode user =nil
)

Posts a command to be processed by Visionary Render.

Parameters:

• cmd The command to post
• param Parameter to pass to the command
• user User to run the command as (default: local user)

vrPrimaryUserNode

void vrPrimaryUserNode()

Returns the cluster master's user node, or the local user node if unclustered.

vrPushRecentFile

void vrPushRecentFile(
    string file
)

Adds a file to the end of the list of recent files and its folder to the end of the list of recent folders.

vrPushRecentImportFile

void vrPushRecentImportFile(
    string file
)

Adds a file to the end of the list of recent imports and its folder to the end of the list of recent import folders.

vrReleaseObjectFromTrackedHand

void vrReleaseObjectFromTrackedHand(
    vrnode target =nil,
    number handIndex =-1,
    vrnode user =nil
)

Releases a node attached to the hand. This works in conjunction with vrGrabObjectWithTrackedHand and the TrackedManipulatorTool.

Parameters:

• target The node to release, or nil to release all objects from the specified hand(s)
• handIndex -1 for any hand, 0, for left hand, 1 for right hand
• user The user holding the node, or nil to deduce the user automatically

vrReloadAudio

void vrReloadAudio(
    vrnode node
)

Finds audio nodes and reloads the audio data from the associated files.

vrReloadTextures

void vrReloadTextures(
    vrnode node
)

Recursively finds texture nodes and reloads the texture data from the associated files.

Parameters:

• node The node to start searching from. Can be an individual texture node.

vrRemoveObserver

void vrRemoveObserver(
    string uniqueID
)

Removes an observer.

Parameters:

• uniqueID The unique ID specified when adding the observer.

vrRemoveRecentItem

void vrRemoveRecentItem(
    string file,
    string nodeName
)

Removes a recent file, folder or import from the corresponding list.

Parameters:

• file The filename to remove
• nodeName Either 'RecentFiles' or 'RecentFolders'

vrRemoveTransformLimits

void vrRemoveTransformLimits(
    vrnode node,
    string type
)

Removes the TransformLimits on a node.

Parameters:

• node The node to remove the limits from.
• type The Type of TransformLimit to remove. Arguments are: "Position", "Rotation", "Scale".

vrRequestFolder

string vrRequestFolder(
    string caption =0,
    string initialDir =0
)

Invokes a dialog to select a folder.

Parameters:

• caption Caption to present on the dialog
• initialDir Path to the initial directory to browse (default: the last directory something was opened from)

Return: Absolute path to the selected folder

vrRequestLoadFile

string vrRequestLoadFile(
    string caption =0,
    string initialDir =0,
    string filterStr =0,
    string defaultExt =0
)

Invokes a dialog to load a file.

Parameters:

• caption Caption to present on the dialog (optional, default: 'Select File')
• initialDir Path to the initial directory to browse (optional, default: the last directory something was opened from)
• filterStr Windows-style file filter string with | in place of null chars (optional, default: 'All Files (.)|.|'
• defaultExt Default file extension to filter by (optional, no effect when using default filterStr)

Return: Absolute path to the file selected by the user in the dialog

vrRequestSaveFile

string vrRequestSaveFile(
    string caption =0,
    string initialDir =0,
    string filterStr =0,
    string defaultExt =0,
    string defaultFile =0
)

Invokes a dialog to save a file.

Parameters:

• caption Caption to present on the dialog (optional, default: 'Select File')
• initialDir Path to the initial directory to browse. (optional, default: the last directory something was opened from)
• filterStr Windows-style file filter string with | in place of null chars. (optional, default: 'All Files (.)|.|'
• defaultExt Default file extension to filter by (optional, no effect when using default filterStr)
• defaultFile Default file name to provide in the file name control on the dialog (optional)

Return: Absolute path to the file selected by the user in the dialog (this file may not exist)

vrRescalePRSManipulator

void vrRescalePRSManipulator()

Refreshes the scale of the PRS manipulator.

vrRevertToCleanState

void vrRevertToCleanState()

Restores the captured state of the Lua global environment.

vrSearchView

void vrSearchView(
    string view,
    string searchString
)

Sets the search query for a specified view.

Parameters:

• view The name of the view
• searchString The string to insert into the search box

vrSetAppQuitHook

void vrSetAppQuitHook(
    string luaFunc
)

Specify a lua function to be called when user tries to quit the application.

Parameters:

• luaFunc Name of the Lua function. This function should return false if it wants to block the exit.

vrSetConfigMode

void vrSetConfigMode(
    number mode =CM_MODE_COUNT
)

Sets the config to the specified mode, if its available.

Parameters:

• mode Immersive mode value

vrSetScriptIdentifier

void vrSetScriptIdentifier(
    string name
)

Sets an identifier for the Lua execution.

Parameters:

• name Name to identify the current Lua execution

vrSetScriptTimeout

void vrSetScriptTimeout(
    number time
)

Overrides the default Lua timeout for scripts, until the next script event is triggered.

Parameters:

• time Number of seconds to wait before timing out. A value of 0 means it never times out.

vrSetToolEnabled

void vrSetToolEnabled(
    string toolName,
    boolean enabled,
    vrnode userNode =nil
)

Sets the Enabled state of a named Tool.

Parameters:

• toolName The name of the tool that its Enabled state is being changed
• enabled The state that we are applying to the tool (true/false)
• userNode The user the tool belongs to. If none is specified, the current user is used

vrSetTrackedEyeNode

void vrSetTrackedEyeNode(
    vrnode node =nil
)

Sets the tracked eye to the specified node.

vrSetTrackedHandNode

void vrSetTrackedHandNode(
    vrnode node =nil,
    number index =1
)

Sets the tracked hand to the specified node.

Parameters:

• index 0 for left hand, 1 for right hand

vrSetTransformLimits

void vrSetTransformLimits(
    vrnode node,
    string type,
    string limitType,
    boolean x,
    boolean y,
    boolean z
)

Adds transform limits onto a node.

Parameters:

• node The node to add the limits to.
• type The Type of TransformLimit to add. Arguments are: "Position", "Rotation", "Scale".
• limitType The Type of constraint to set. Arguments are "Lock", "Limit", "Step".

vrSetViewportLayout

void vrSetViewportLayout(
    vrnode viewportLayoutNode,
    vrnode userNode =nil
)

Sets the user's current viewport layout.

Parameters:

• userNode user whose viewport should be updated (defaults to local user)

vrShouldSaveCamera

boolean vrShouldSaveCamera()

Returns true if the camera position should be saved into documents.

vrSnapshotApply

void vrSnapshotApply(
    vrnode snapNode
)

Applies the specified snapshot.

vrSplitFilePath

MULTI< string, string, string > vrSplitFilePath(
    string path
)

Returns file directory, name, and extension.

Parameters:

• path Relative or absolute path to test

Return:

• File Directory
• File Name
• File Extension

vrSplitVirtalisHubURL

void vrSplitVirtalisHubURL(
    string url
)

Identifies a Virtalis Hub URL and splits out the server name, artifact ID and artifact name.

Parameters:

• url The Virtalis Hub URL

vrSubDirs

table vrSubDirs(
    string path
)

Gets the subdirectories of a directory.

Parameters:

• path Path to the directory to scan

Return: Array of subdirectory names

vrToggleProjection

void vrToggleProjection()

Toggles the current viewport between perspective and orthographic views.

vrToggleToolEnabled

void vrToggleToolEnabled(
    string toolName,
    vrnode userNode =nil
)

Toggles the Enabled state of a named Tool.

Parameters:

• toolName The name of the tool that its Enabled state is being toggled
• userNode The user the tool belongs to. If none is specified, the current user is used

vrTrackedCursorGetTouchedAssembly

void vrTrackedCursorGetTouchedAssembly()

Gets the first assembly currently under the tracked cursor.

vrUnloadPlugin

void vrUnloadPlugin(
    string pluginInfo
)

vrUserDocumentsDir

string vrUserDocumentsDir()

Gets the current user's documents directory.

Return: Absolute path to the user's Visionary Render documents folder

vrUserPluginsDir

string vrUserPluginsDir()

Gets the current applications users plug-ins directory.

Return: Absolute path to the plugins directory in the user's documents folder

vrUsersNode

vrnode vrUsersNode()

Returns the 'Users' node from the tree.

vrUsingHMD

boolean vrUsingHMD()

Returns whether or not we are using a HMD.

vrYield

void vrYield(
    number time =0.0
)

Yields the Lua execution back to the application for the (approximate) specified time.

Parameters:

• time Number of seconds before resuming execution of this script, or 0 for one frame