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 VRML file from which the virtual world is loaded. 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 VRML 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 VRML file filename and returns its handle. It always creates a new virtual world object, even if another vrworld object associated with the same VRML file already exists.

myworld = vrworld creates an invalid vrworld handle

myworld = vrworld('') creates an empty vrworld object that is not associated with any VRML 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 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

myworld = vrworld('vrpend.wrl')

Method Summary

MethodDescription
addexternprotoAdd externproto declaration to virtual world.
closeClose virtual world
deleteRemove virtual world from memory
editOpen virtual world file in external VRML editor
getProperty value of vrworld object
isvalid1 if vrworld object is valid, 0 if not
nodesList nodes available in virtual world
openOpen virtual world
reloadReload virtual world from VRML file
saveWrite virtual world to VRML file
setChange property values of vrworld object
viewView virtual world

Was this topic helpful?