Scene Services
X3DExecutionContext
This section lists the methods available in the X3DExecutionContext object, which allows scripts to get access to the scene graph.
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
specificationVersion
The string represent the basic specification version used by the parsed file in decimal format. For example, a scene conforming to this specification returns a value such as “4.0”. This property is read only.
encoding
The encoding is represented as a string that describes the data encoding used. Valid values are “ASCII”, “VRML”, “XML”, “BINARY”, “SCRIPTED”, “BIFS”, “NONE”. This property is read only.
profile
A reference to the ProfileInfo object used by this execution context. This property is read only.
components
A reference to the ComponentInfoArray object used by this execution context. This property is read only.
worldURL
A string containing the URL of this execution context. This property is read only.
baseURL
A string containing the URL against which relative URLs are resolved. This property is read only.
units
A reference to the UnitInfoArray object used by this execution context. This property is read only.
namedNodes
A reference to the NamedNodesArray object used by this execution context. This property is read only.
importedNodes
A reference to the ImportedNodesArray object used by this execution context. This property is read only.
rootNodes
When used inside a prototype instance, this property is not writable. The MFNode object instance is also not be writable. When used anywhere else, it is writable.
protos
A reference to the ProtoDeclarationArray object used by this execution context. This property is read only.
externprotos
A reference to the ExternProtoDeclarationArray object used by this execution context. This property is read only.
routes
A reference to the RouteArray object used by this execution context. This property is read only.
Methods
SFNode createNode (String typeName)
Creates a new default instance of the node given by the typeName string containing the name of an X3D node type.
SFNode createProto (String protoName)
Creates a new default instance of the prototype given by the protoName string containing the name of an prototype or extern prototype of this execution context.
SFNode getNamedNode (String name)
Returns a reference to the named node named by the string name. If no named node with the name name exists an exception is throw.
void addNamedNode (String name, SFNode node)
Creates the named node referenced by name. This will give node a new name.
void updateNamedNode (String name, SFNode node)
Creates or updates the named node referenced by name. This will give node a new name.
void removeNamedNode (String name)
Removes the named node name.
SFNode getImportedNode (String importedName)
Returns a reference to the imported node named by the string importedName. If no imported node with the imported name importedName exists an exception is throw.
void addImportedNode (SFNode inlineNode, String exportedName, String importedName)
Creates the imported node importedName. If not importedName is given exportedName is used as imported name. The node to import must be an exported node named by exportedName in inlineNode.
void updateImportedNode (SFNode inlineNode, String exportedName, String importedName)
Creates or updates the imported node importedName. If not importedName is given exportedName is used as imported name. The node to import must be an exported node named by exportedName in inlineNode.
void removeImportedNode (String importedName)
Removes the imported node importedName.
X3DRoute addRoute (SFNode sourceNode, String sourceField, SFNode destinationNode, String destinationField)
Add a route from the passed sourceField to the passed destinationField. The return value is an X3DRoute object.
void deleteRoute (X3DRoute route)
Remove the route if it is connected.
void deleteRoute (SFNode sourceNode, String sourceField, SFNode destinationNode, String destinationField)
Remove the route between the passed sourceField and passed destinationField, if one exists.
X3DScene
A scene is an extension of the execution context services with additional services provided.
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
exportedNodes
A reference to the ExportedNodesArray object used by this execution context. This property is read only.
Methods
void setProfile (ProfileInfo profile)
Replaces the profile of this scene by the given profile. A profile of null is equivalent to a ‘Full’ profile.
void addComponent (ComponentInfo component)
Adds the component to the list of components.
void updateComponent (ComponentInfo component)
Updates the component.
void removeComponent (String name)
Removes the component with the given name.
void updateUnit (String category, String name, Number conversionFactor)
Updates the name and the conversion factor of the unit specified by category.
UnitInfo getUnit (String category)
Returns the UnitInfo object with the given category.
Array<string> getMetaData (String name)
Returns the metadata values array associated with name.
void setMetaData (String name, String value)
Creates or updates the metadata with name and value.
void setMetaData (String name, Array<string> values)
Creates or updates the metadata with name and values. There must be at least one value in values.
void addMetaData (String name, String value)
Adds the metadata with name and value.
void removeMetaData (String name)
Removes the metadata name.
void addRootNode (SFNode node)
Adds node to the list of root nodes. If the node already exists, the function silently returns.
void removeRootNode (SFNode node)
Removes node from the list of root nodes.
SFNode getExportedNode (String exportedName)
Returns a reference to the node with the exported name exportedName. If no exported node exportedName is found an exception is thrown.
void addExportedNode (String exportedName, SFNode node)
Creates the exported node exportedName.
void updateExportedNode (String exportedName, SFNode node)
Creates or updates the exported node exportedName.
void removeExportedNode (String exportedName)
Removes the exported node exportedName.
String toVRMLString ([options])
Returns the X3D VRML-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this scene.
Options
An object with one or more of these properties:
- style: String, output style, one of: “TIDY”, “COMPACT”, “SMALL”, “CLEAN”
- indent: String, initial indent, default: “”
- precision: Integer, float precision, default: 7
- doublePrecision: Integer, double precision, default: 15
- html: Boolean, HTML style, default: false
- closingTags: Boolean, use closing tags, default: false
String toXMLString ([options])
Returns the X3D XML-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this scene.
For options see X3DScene.toVRMLString.
String toJSONString ([options])
Returns the X3D JSON-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this scene.
For options see X3DScene.toVRMLString.
ProfileInfo
This object stores information about a particular X3D profile.
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
name
A string of the formal name of this profile. This property is read only.
title
A generic, freeform title string provided by the browser manufacturer. This property is read only.
providerURL
If provided, the URL to the entity that wrote this component. This assumes that extensions to the browser may not necessarily be provided by the browser writer’s themselves. This property is read only.
components
An ComponentInfoArray object of the ComponentInfo object instances that make up this profile. This property is read only.
Methods
None.
ComponentInfo
The ComponentInfo object stores information about a particular X3D component. The object consists solely of read-only properties. It does not define any additional functions.
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
name
A string of the formal name of this profile. This property is read only.
level
A number of the level of support of this instance. This property is read only.
title
A generic, freeform title string provided by the browser manufacturer. This property is read only.
providerURL
If provided, the URL to the entity that wrote this component. This assumes that extensions to the browser may not necessarily be provided by the browser writer’s themselves. This property is read only.
Methods
None.
UnitInfo
The UnitInfo object stores information about a particular unit declaration. The object consists solely of read-only properties. It does not define any additional functions.
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
category
The category of default unit being modified as defined in the table. This property is read only.
Standard units
| Category | Initial base unit |
|---|---|
| angle | radian |
| force | newton |
| length | metre |
| mass | kilogram |
The base unit of time is seconds and cannot be changed.
Additional units, called derived units are used in this International Standard. A derived unit depends on the current base units. The value for a derived unit can be calculated using the appropriate formula from the table below.
Derived Units
| Category | Initial base unit |
|---|---|
| acceleration | length/second2 |
| angular_rate | angle/second |
| area | length2 |
| speed | length/second |
| volume | length3 |
The standard color space used by this International Standard is RGB where each color component has the range [0.,1.].
name
A string of the name assigned to the new default unit. This property is read only.
conversionFactor
The double-precision number needed to convert from the new default unit to the initial default unit. This property is read only.
Methods
None.
X3DImportedNode
The X3DImportedNode object stores information about a particular import declaration. The object consists solely of read-only properties. It does not define any additional functions.
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
inlineNode
The SFNode object of the Inline node. This property is read only.
exportedName
A string of the exported name. This property is read only.
exportedNode
The SFNode object of the exported node. This property is read only.
importedName
A string of the imported name. This property is read only.
X3DExportedNode
The X3DExportedNode object stores information about a particular export declaration. The object consists solely of read-only properties. It does not define any additional functions.
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
exportedName
A string of the exported name. This property is read only.
localNode
The SFNode object of the corresponding node. This property is read only.
ProfileInfoArray
ProfileInfoArray is an object that represents an array of ProfileInfo objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. profileInfoArrayName[index], where index is an integer-valued expression with 0<=index<length and length is the number of elements in the array).
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
length
An integer containing the number of elements in the array. This property is read only.
Methods
None
ComponentInfoArray
ComponentInfoArray is an object that represents an array of ComponentInfo objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. componentInfoArrayName[index], where index is an integer-valued expression with 0<=index<length and length is the number of elements in the array).
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
length
An integer containing the number of elements in the array. This property is read only.
Methods
None
UnitInfoArray
UnitInfoArray is an object that represents an array of UnitInfo objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. unitInfoArrayName[index], where index is an integer-valued expression with 0<=index<length and length is the number of elements in the array).
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
length
An integer containing the number of elements in the array. This property is read only.
Methods
None
ImportedNodesArray
ImportedNodesArray is an object that represents an array of X3DImportedNode objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. importedNodesArrayName[index], where index is an integer-valued expression with 0<=index<length and length is the number of elements in the array).
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
length
An integer containing the number of elements in the array. This property is read only.
Methods
None
ExportedNodesArray
ExportedNodesArray is an object that represents an array of X3DExportedNode objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. exportedNodesArrayName[index], where index is an integer-valued expression with 0<=index<length and length is the number of elements in the array).
Instance Creation Method(s)
None. This object cannot be instantiated by the user.
Properties
length
An integer containing the number of elements in the array. This property is read only.
Methods
None