vrnode

Create node or handle to existing node

Syntax

mynode = vrnode
mynode = vrnode([])
mynode = vrnode(vrworld_object,'node_name')
mynode = vrnode(vrworld_object, 'node_name','node_type')
mynode = vrnode(vrworld_object, 'USE', othernode)
mynode = vrnode(parent_node,'parent_field', 'node_name', 
'node_type')
mynode = vrnode(parent_node,'parent_field', 'USE', 
'othernode')

Arguments

vrworld_object	Name of a vrworld object representing a virtual world.
node_name	Name of the node.
node_type	Type of the node.
parent_node	Name of the parent node that is a vrnode object.
parent_field	Name of the field of the parent node.
'USE'	Enables a USE reference to another node.
othernode	Name of another node for a USE reference.

Description

mynode = vrnode creates an empty vrnode handle that does not reference any node.

mynode = vrnode([]) creates an empty array of vrnode handles.

mynode = vrnode(vrworld_object,'node_name') creates a handle to an existing named node in the virtual world.

mynode = vrnode(vrworld_object, 'node_name','node_type') creates a new node called node_name of type node_type on the root of the virtual world. It returns the handle to the newly created node.

mynode = vrnode(vrworld_object, 'USE', othernode) creates a USE reference to the node othernode on the root of the world vrworld_object. It returns the handle to the virtual world to the original node.

mynode = vrnode(parent_node,'parent_field', 'node_name','node_type') creates a new node called node_name of type node_type that is a child of the parent_node and resides in the field parent_field. It returns the handle to the newly created node.

mynode = vrnode(parent_node,'parent_field', 'USE', 'othernode') creates a USE reference to the node othernode as a child of node parentnode and resides in the field parentfield. It returns the handle to the original node.

A vrnode object identifies a virtual world node in a way very similar to a handle. If you apply the vrnode method to a node that does not exist, the method creates a node, the vrnode object, and returns the handle to the vrnode object. If you apply the vrnode method to an existing node, the method returns the handle to the vrnode object associated with this node.

Method Summary

Method	Description
delete	Remove vrnode object
fields	Virtual world field summary of node object
isfield	Returns true if field is name of vrnode object field
get	Property value of vrnode object
getfield	Field value of vrnode object
isvalid	1 if vrnode object is valid, 0 if not
interpolate	Interpolate field value of vrnode object
set	Change property of virtual world node
setfield	Change field value of vrnode object
sync	Enable or disable synchronization of virtual world fields with client
optimize	Change geometries to reduce number of vertices

Version History

Introduced before R2006a