This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.


Create new vrworld object associated with virtual world


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



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.


Argument to create a virtual world associated with filename.


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.


myworld = vrworld('vrpend.wrl')

Method Summary

addexternprotoAdd externproto declaration to virtual world.
closeClose virtual world
deleteRemove virtual world from memory
editOpen virtual world file in external virtual world 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 virtual world 3D file
saveWrite virtual world to virtual world 3D file
setChange property values of vrworld object
viewView virtual world

Introduced before R2006a

Was this topic helpful?