vrworld

Create new vrworld object associated with virtual world

Syntax

myworld = vrworld(filename)
myworld = vrworld(filename,'reuse')
myworld = vrworld(filename, 'new')
myworld = vrworld
myworld = vrworld('')
myworld = vrworld([])

Arguments

filename	String containing the name of the virtual world 3D file from which the virtual world is loaded. You can specify .wrl, .x3d, or .x3dv). If no file extension is specified, the file extension .wrl is assumed.
'new'	Argument to create a virtual world associated with filename.

Description

myworld = vrworld(filename) creates a virtual world associated with the virtual world 3D file filename and returns its handle. If the virtual world already exists, a handle to the existing virtual world is returned. Specify the file name as a string.

myworld = vrworld(filename,'reuse') has the same functionality as myworld = vrworld(filename).

myworld = vrworld('filename', 'new') creates a virtual world associated with the virtual world 3D file filename and returns its handle. It always creates a new virtual world object, even if another vrworld object associated with the same file already exists.

myworld = vrworld creates an invalid vrworld handle

myworld = vrworld('') creates an empty vrworld object that is not associated with any virtual world 3D file

myworld = vrworld([]) returns an empty array of 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 handle to the existing virtual world is returned. A second virtual world is not loaded into memory. If the virtual world does not exist in memory, it is loaded from the associated virtual world 3D 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

myworld = vrworld('vrpend.wrl')

Method Summary

Method	Description
addexternproto	Add externproto declaration to virtual world.
close	Close virtual world
delete	Remove virtual world from memory
edit	Open virtual world file in external virtual world editor
get	Property value of vrworld object
isvalid	1 if vrworld object is valid, 0 if not
nodes	List nodes available in virtual world
open	Open virtual world
reload	Reload virtual world from virtual world 3D file
save	Write virtual world to virtual world 3D file
set	Change property values of vrworld object
view	View virtual world
optimize	Change geometries to reduce number of vertices

Version History

Introduced before R2006a