Virtual Reality Toolbox    
vrworld

Create a new vrworld object associated with a virtual world

Syntax

Arguments

vrml_file.wrl
Name of the VRML file from which the virtual world is loaded. If no file extension is specified, the file extension .wrl is assumed.

Description

myworld = vrworld('vrml_file.wrl') creates a handle to a vrworld object that is associated with the specified VRML file.

myworld = vrworld creates an empty vrworld handle that does not refer to any virtual world.

myworld = vrworld([]) returns an empty array of vrworld handles.

A vrworld object identifies a virtual world in a way very similar to a handle. All functions that affect virtual worlds accept a vrworld object as an argument to identify the virtual world.

If the given virtual world already exists in memory, the new vrworld object is associated with the existing virtual world. That is, a second virtual world is not loaded into memory. If the virtual world does not exist in memory, it is loaded from the associated VRML file. The newly loaded virtual world is closed and must be opened before you can use it.

The vrworld object associated with a virtual world remains valid until you use either delete or vrclear.

Examples

See Also

vrworld/open, vrworld/delete, vrworld/close


  vrworld Object Methods vrworld/close