to X3D Resources
  

Extensible 3D (X3D) 3.0 Tooltips

  
to Web3D Consortium home page
The X3D tooltips provide summary descriptions and authoring hints for each X3D node (XML element) and field (XML attribute) found in the X3D Architecture Specification, version 3.0.

The X3D tooltips provide context-sensitive support for authors and are usable within tools (such as X3D-Edit). Each node's table entry also provides appropriate links to the X3D Abstract Specification, X3D Schema Documentation, X3D DOCTYPE Documentation, and the X3D JSON Documentation. Additional information about X3D nodes can be found in the X3D Scene Authoring Hints.
Complete support for the latest X3D specification can be found in the X3D Tooltips version 3.3 [with version 4.0 draft].
Anchor   Appearance   Arc2D   ArcClose2D   AudioClip   Background   Billboard   BooleanFilter   BooleanSequencer   BooleanToggle   BooleanTrigger   Box   Circle2D   Collision   Color   ColorInterpolator   ColorRGBA   component   Cone   connect   Contour2D   ContourPolyline2D   Coordinate   CoordinateDouble   CoordinateInterpolator   CoordinateInterpolator2D   Cylinder   CylinderSensor   DirectionalLight   Disk2D   ElevationGrid   EspduTransform   EXPORT   ExternProtoDeclare   Extrusion   field   fieldValue   FillProperties   Fog   FontStyle   GeoCoordinate   GeoElevationGrid   GeoLocation   GeoLOD   GeoMetadata   GeoOrigin   GeoPositionInterpolator   GeoTouchSensor   GeoViewpoint   Group   HAnimDisplacer   HAnimHumanoid   HAnimJoint   HAnimSegment   HAnimSite   head   ImageTexture   IMPORT   IndexedFaceSet   IndexedLineSet   IndexedTriangleFanSet   IndexedTriangleSet   IndexedTriangleStripSet   Inline   IntegerSequencer   IntegerTrigger   IS   KeySensor   LineProperties   LineSet   LoadSensor   LOD   Material   meta   MetadataDouble   MetadataFloat   MetadataInteger   MetadataSet   MetadataString   MovieTexture   MultiTexture   MultiTextureCoordinate   MultiTextureTransform   NavigationInfo   Normal   NormalInterpolator   NurbsCurve   NurbsCurve2D   NurbsOrientationInterpolator   NurbsPatchSurface   NurbsPositionInterpolator   NurbsSet   NurbsSurfaceInterpolator   NurbsSweptSurface   NurbsSwungSurface   NurbsTextureCoordinate   NurbsTrimmedSurface   OrientationInterpolator   PixelTexture   PlaneSensor   PointLight   PointSet   Polyline2D   Polypoint2D   PositionInterpolator   PositionInterpolator2D   ProtoBody   ProtoDeclare   ProtoInstance   ProtoInterface   ProximitySensor   ReceiverPdu   Rectangle2D   ROUTE   ScalarInterpolator   Scene   Script   Shape   SignalPdu   Sound   Sphere   SphereSensor   SpotLight   StaticGroup   StringSensor   Switch   Text   TextureBackground   TextureCoordinate   TextureCoordinateGenerator   TextureTransform   TimeSensor   TimeTrigger   TouchSensor   Transform   TransmitterPdu   TriangleFanSet   TriangleSet   TriangleSet2D   TriangleStripSet   Viewpoint   VisibilitySensor   WorldInfo   X3D  
  accessType and type   Credits and Translations   X3D Resources   to top
Anchor Anchor Anchor is a Grouping node that can contain most nodes. When the user selects any of the geometry contained by the Anchor node, the browser either jumps to another viewpoint (similar to HTML bookmark) or else loads content (such as X3D, an image or HTML) specified by the url field. Newly loaded content completely replaces current content, if the value of parameter field indicates using the same window.
Hint: insert a Shape node before adding geometry or Appearance.
Hint: X3D Architecture 20.2.1 Overview of pointing device sensors http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/pointingsensor.html#OverviewOfPointingDeviceSensors
Hint: X3D Architecture 20.2.3 Activating and manipulating pointing device sensors http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/pointingsensor.html#Activatingandmanipulating
Hint: apply containerField='watchList' when parent node is LoadSensor.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
children [children accessType inputOutput, type MFNode array, empty list] [X3DChildNode]
Grouping nodes contain an ordered list of children nodes.
Hint: Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
Hint: inputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
Hint: inputOnly MFNode removeChildren field can remove nodes from the children list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
Hint: X3D Architecture 10.2.1 Grouping and children node types, http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#GroupingAndChildrenNodes
description [description accessType inputOutput, type SFString CDATA #IMPLIED]
Author-provided text tooltip that tells users the expected action of this node.
Hint: many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as & for & ampersand character, or " for " quotation-mark character).
url [url accessType inputOutput, type MFString CDATA #IMPLIED]
Address of replacement world or #ViewpointDEFName, activated by clicking Anchor geometry.
Hint: jump to a world's internal viewpoint by appending viewpoint name (e.g. #ViewpointName, someOtherCoolWorld.x3d#GrandTour).
Hint: jump to a local viewpoint by only using viewpoint name (e.g. #GrandTour).
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is " (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Hint: pop up a new window with url value as follows: "JavaScript:window.open('somePage.html','popup','width=240,height=240');location.href='HelloWorld.x3d'"
Hint: X3D Scene Authoring Hints, urls http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls
parameter [parameter accessType inputOutput, type MFString CDATA #IMPLIED]
If provided, parameter tells the X3D player where to to redirect the loaded url.
Hint: set parameter value as target=_blank to load the target url into a new browser frame.
Hint: set parameter value as target=frame_name to load target url into another browser frame.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks. "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Interchange profile hint: this field may be ignored, applying the default value regardless.
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
containerField [containerField type NMTOKEN (children | watchList) "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Appearance Appearance Appearance specifies the visual properties of geometry by containing the Material, ImageTexture/MovieTexture/PixelTexture, FillProperties, LineProperties, programmable shader nodes (ComposedShader, PackagedShader, ProgramShader) and TextureTransform nodes.
Hint: insert a Shape node before adding geometry or Appearance.
Interchange profile hint: only Material and ImageTexture children are allowed.
Hint: DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
Hint: Advanced uses can contain MultiTexture or MultiTextureTransform.
Hint: X3D Architecture 12.2.2 Appearance node http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/shape.html#Appearancenode
Hint: X3D Architecture 17.2.2 Lighting model http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/lighting.html#Lightingmodel
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
containerField [containerField type NMTOKEN "appearance"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Arc2D Arc2D Arc2D is a line-based geometry node that defines a linear circular arc with center (0,0) in X-Y plane, with angles measured starting at positive x-axis and sweeping towards positive y-axis.
Hint: Material emissiveColor in corresponding Appearance is used for rendering lines.
Warning: lines are not lit, are not texture-mapped, and do not participate in collision detection.
Warning: use a different Material emissiveColor than the Background color, otherwise geometry is invisible.
Hint: adding LineProperties to the corresponding Appearance node can modify the rendering style of these lines.
Hint: insert a Shape node before adding geometry or Appearance.
Warning: requires X3D profile='Full' or else include <component name='Geometry2D' level='2'/>
Example: X3D Example Archives, X3D for Web Authors, Chapter 10 Geometry 2D https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter10Geometry2D
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
radius [radius accessType initializeOnly, type SFFloat CDATA "1"] (0,+∞)
circle radius, of which the arc is a portion.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
startAngle [startAngle accessType initializeOnly, type SFFloat CDATA "0"] [0,2pi]
Arc extends from startAngle counterclockwise to endAngle, in radians.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
Hint: https://en.wikipedia.org/wiki/Radian
endAngle [endAngle accessType initializeOnly, type SFFloat CDATA "1.570796"] [0,2pi]
Arc extends from startAngle counterclockwise to endAngle, in radians.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
Hint: https://en.wikipedia.org/wiki/Radian
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
ArcClose2D ArcClose2D ArcClose2D is a polygonal geometry node that defines a linear circular arc, closed by PIE or CHORD line segments, with center (0,0) in X-Y plane with angles measured starting at positive x-axis and sweeping towards positive y-axis.
Hint: insert a Shape node before adding geometry or Appearance.
Warning: requires X3D profile='Full' or else include <component name='Geometry2D' level='2'/>
Example: X3D Example Archives, X3D for Web Authors, Chapter 10 Geometry 2D https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter10Geometry2D
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
radius [radius accessType initializeOnly, type SFFloat CDATA "1"] (0,+∞)
circle radius, of which the arc is a portion.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
startAngle [startAngle accessType initializeOnly, type SFFloat CDATA "0"] [0,2pi]
Arc extends from startAngle counterclockwise to endAngle, in radians.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
Hint: https://en.wikipedia.org/wiki/Radian
endAngle [endAngle accessType initializeOnly, type SFFloat CDATA "1.570796"] [0,2pi]
Arc extends from startAngle counterclockwise to endAngle, in radians.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
Hint: https://en.wikipedia.org/wiki/Radian
closureType [closureType accessType initializeOnly, type SFString CDATA (PIE|CHORD) "PIE"]
Defines whether pair of line segments connect to center (PIE), or single line-segment chord connects arc endpoints (CHORD).
Warning: simple-geometry parameters cannot be changed after initial creation.
solid [solid accessType initializeOnly, type SFBool (true|false) "false"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
Warning: solid false not supported in VRML97.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
AudioClip AudioClip AudioClip provides audio data used by parent Sound nodes.
Hint: add a parent Sound node first.
Hint: utilize DEF/USE references for multiple copies of a single AudioClip sound file in order to avoid multiple-download delays, reduce memory requirements, and maintain synchronization.
Hint: authors can provide multiple audio formats for the same audio track, with each source address listed separately in the url field.
Hint: player support for .wav format is required, .midi format is recommended, other formats are optional.
Hint: X3D Scene Authoring Hints:Audio http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Audio
Hint: apply containerField='watchList' when parent node is LoadSensor.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
description [description accessType inputOutput, type SFString CDATA #IMPLIED]
Author-provided text tooltip that tells users the expected action of this node.
Hint: many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &#38; for & ampersand character, or &#34; for " quotation-mark character).
url [url accessType inputOutput, type MFString CDATA #IMPLIED]
Location and filename of sound file or stream. Support for .wav format is required, .midi format is recommended, other formats are optional.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks. "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Hint: X3D Scene Authoring Hints, urls http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls
loop [loop accessType inputOutput, type SFBool (true|false) "false"]
repeat indefinitely when loop=true, repeat only once when loop=false.
pitch [pitch accessType inputOutput, type SFFloat CDATA "1.0"] (0,+∞)
Multiplier for the rate at which sampled sound is played. Changing pitch also changes playback speed.
Hint: changing the pitch field does not trigger a duration_changed event. Playback interval may vary but duration of the original media data remains unmodified.
startTime [startTime accessType inputOutput, type SFTime CDATA "0"]
Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
Hint: ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
stopTime [stopTime accessType inputOutput, type SFTime CDATA "0"]
Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
Hint: ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
Warning: An active TimeSensor node ignores set_cycleInterval and set_startTime events.
Warning: An active TimeSensor node ignores set_stopTime event values less than or equal to startTime.
duration_changed [duration_changed accessType outputOnly, type SFTime CDATA #FIXED ""] [0,+∞)
or -1. duration_changed is length of time in seconds for one cycle of media stream.
Warning: duration value of -1 implies that media data has not yet loaded or is unavailable for some reason.
Warning: it is an error to define this transient outputOnly field in an X3D file.
Hint: duration_changed is an SFTime duration interval, normally nonnegative, and not an absolute clock time.
Hint: changing the pitch field does not trigger a duration_changed event. Playback interval may vary but duration of the original media data remains unmodified.
isActive [isActive accessType outputOnly, type SFBool #FIXED ""]
isActive true/false events are sent when playback starts/stops.
Warning: it is an error to define this transient outputOnly field in an X3D file.
isPaused [isPaused accessType outputOnly, type SFBool #FIXED ""]
isPaused true/false events are sent when AudioClip is paused/resumed.
Warning: it is an error to define this transient outputOnly field in an X3D file.
pauseTime [pauseTime accessType inputOutput, type SFTime CDATA "0"]
When time now >= pauseTime, isPaused becomes true and AudioClip becomes paused. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
Hint: ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
resumeTime [resumeTime accessType inputOutput, type SFTime CDATA "0"]
When resumeTime becomes <= time now, isPaused becomes false and AudioClip becomes active. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
Hint: ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
elapsedTime [elapsedTime accessType outputOnly, type SFTime CDATA #FIXED ""] [0,+∞)
Current elapsed time since AudioClip activated/running, cumulative in seconds, and not counting any paused time.
Warning: it is an error to define this transient outputOnly field in an X3D file.
Hint: elapsedTime is a nonnegative SFTime duration interval, not an absolute clock time.
containerField [containerField type NMTOKEN "source"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Background Background Background simulates ground and sky, using vertical arrays of wraparound color values. Background can also provide url addresses for backdrop textures on all six sides.
Hint: Background, Fog, NavigationInfo, TextureBackground and Viewpoint are bindable nodes, meaning that no more than one of each node type can be active at a given time.
Warning: results are undefined if a bindable node (Background, Fog, NavigationInfo, OrthoViewpoint, TextureBackground, Viewpoint) is a contained descendant node of either LOD or Switch.
Hint: X3D Example Archives, Basic, Universal Media Panoramas http://www.web3d.org/x3d/content/examples/Basic/UniversalMediaPanoramas
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
skyColor [skyColor accessType inputOutput, type MFColor CDATA "0 0 0"]
Color of the sky at various angles on the sky sphere. First value is color of sky at 0.0 radians representing the zenith (straight up).
Hint: setting the same color at two consecutive angles produces a solid color band.
Warning: you must have one more skyColor value than skyAngle values.
Interchange profile hint: only one color might be rendered, others can be ignored.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
skyAngle [skyAngle accessType inputOutput, type MFFloat CDATA #IMPLIED] [0,π]
The angle array values increase from 0.0 zenith (straight up) to π/2=1.570796 (horizon) to π=3.14159 (nadir).
Warning: you must have one more skyColor value than skyAngle values.
Warning: colors at skyAngle=0 are ignored.
Interchange profile hint: this field may be ignored, applying the default value regardless.
Hint: https://en.wikipedia.org/wiki/Radian
groundColor [groundColor accessType inputOutput, type MFColor CDATA #IMPLIED]
Color of the ground at the various angles on the ground partial sphere. First value is color of ground at 0.0 radians representing the nadir (straight down).
Hint: setting the same color at two consecutive angles produces a solid color band.
Warning: you must have one more groundColor value than groundAngle values.
Interchange profile hint: this field may be ignored, applying the default value regardless.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
groundAngle [groundAngle accessType inputOutput, type MFFloat CDATA #IMPLIED] [0,π/2]
The angle array values increase from 0.0 nadir (straight down) to π/2=1.570796 (horizon).
Warning: you must have one more groundColor value than groundAngle values.
Warning: colors at groundAngle=0 are ignored.
Interchange profile hint: this field may be ignored, applying the default value regardless.
Hint: https://en.wikipedia.org/wiki/Radian
frontUrl [frontUrl accessType inputOutput, type MFString CDATA #IMPLIED]
Image background panorama between ground/sky backdrop and scene's geometry.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Interchange profile hint: this field may be ignored, applying the default value regardless.
backUrl [backUrl accessType inputOutput, type MFString CDATA #IMPLIED]
Image background panorama between ground/sky backdrop and scene's geometry.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Interchange profile hint: this field may be ignored, applying the default value regardless.
leftUrl [leftUrl accessType inputOutput, type MFString CDATA #IMPLIED]
Image background panorama between ground/sky backdrop and scene's geometry.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Interchange profile hint: this field may be ignored, applying the default value regardless.
rightUrl [rightUrl accessType inputOutput, type MFString CDATA #IMPLIED]
Image background panorama between ground/sky backdrop and scene's geometry.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Interchange profile hint: this field may be ignored, applying the default value regardless.
topUrl [topUrl accessType inputOutput, type MFString CDATA #IMPLIED]
Image background panorama between ground/sky backdrop and scene's geometry.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Interchange profile hint: this field may be ignored, applying the default value regardless.
bottomUrl [bottomUrl accessType inputOutput, type MFString CDATA #IMPLIED]
Image background panorama between ground/sky backdrop and scene's geometry.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Interchange profile hint: this field may be ignored, applying the default value regardless.
set_bind [set_bind accessType inputOnly, type SFBool #FIXED ""]
Input event set_bind=true makes this node active, input event set_bind=false makes this node inactive. Thus setting set_bind true/false will pop/push (enable/disable) this node.
Hint: paired node operations can be established by connecting set_bind and isBound fields of corresponding bindable nodes.
Warning: it is an error to define this transient inputOnly field in an X3D file.
bindTime [bindTime accessType outputOnly, type SFTime CDATA #FIXED ""]
event sent when node becomes active/inactive.
Warning: it is an error to define this transient outputOnly field in an X3D file.
isBound [isBound accessType outputOnly, type SFBool #FIXED ""]
event true sent when node becomes active, event false sent when unbound by another node.
Hint: paired node operations can be established by connecting set_bind and isBound fields of corresponding bindable nodes.
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Billboard Billboard Billboard is a Grouping node that can contain most nodes. Contained child geometry faces the user, rotating about the specified axis. Set axisOfRotation=0 0 0 to fully face the user's camera.
Hint: Put Billboard as close to the geometry as possible, nested inside Transform for local coordinate system.
Warning: don't put Viewpoint inside a Billboard.
Hint: insert a Shape node before adding geometry or Appearance.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
children [children accessType inputOutput, type MFNode array, empty list] [X3DChildNode]
Grouping nodes contain an ordered list of children nodes.
Hint: Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
Hint: inputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
Hint: inputOnly MFNode removeChildren field can remove nodes from the children list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
Hint: X3D Architecture 10.2.1 Grouping and children node types, http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#GroupingAndChildrenNodes
axisOfRotation [axisOfRotation accessType inputOutput, type SFVec3f CDATA "0 1 0"]
axisOfRotation direction is relative to local coordinate system.
Hint: axis 0 0 0 always faces viewer.
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
BooleanFilter BooleanFilter BooleanFilter selectively passes true, false or negated events.
Hint: example scenes and authoring assets at http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting
Hint: X3D Event-Utility Node Diagrams http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting/X3dEventUtilityNodeEventDiagrams.pdf
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
set_boolean [set_boolean accessType inputOnly, type SFBool #FIXED ""]
set_boolean is the input value to be filtered.
Warning: it is an error to define this transient inputOnly field in an X3D file.
inputTrue [inputTrue accessType outputOnly, type SFBool #FIXED ""]
inputTrue only passes a true value, which occurs when set_boolean input is true.
Hint: inputTrue is an output event that can only provide a value of true.
inputFalse [inputFalse accessType outputOnly, type SFBool #FIXED ""]
inputFalse only passes a false value, which occurs when set_boolean is false.
Hint: inputFalse is an output event that can only provide a value of false.
inputNegate [inputNegate accessType outputOnly, type SFBool #FIXED ""]
inputNegate is an output event that provides an opposite value by negating set_boolean input.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
BooleanSequencer BooleanSequencer BooleanSequencer generates periodic discrete Boolean values. Authors can ROUTE value_changed output events to other Boolean attributes.
Hint: typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisInterpolatorDEF.set_fraction
Hint: typical output connection is ROUTE thisInterpolatorDEF.value_changed TO someDestinationNodeDEF.set_someAttribute.
Hint: example scenes and authoring assets at http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting
Hint: X3D Event-Utility Node Diagrams http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting/X3dEventUtilityNodeEventDiagrams.pdf
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
key [key accessType inputOutput, type MFFloat CDATA #IMPLIED]
Definition values for linear-interpolation function input intervals, in non-decreasing order and corresponding to a value in the keyValue array.
Warning: number of keys must match number of keyValues!
Warning: values in key array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
Hint: typical interval for values in key array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
keyValue [keyValue accessType inputOutput, type MFBool CDATA #IMPLIED]
Output values for linear interopolation, each corresponding to an input-fraction value in the key array.
Warning: number of keys must match number of keyValues!
set_fraction [set_fraction accessType inputOnly, type SFFloat CDATA #FIXED ""]
set_fraction selects input key for corresponding keyValue output.
Hint: set_fraction values are typically in same range interval as values in the key array. Response to an input set_fraction value less than minimum is equivalent to minimum key, and response to an input set_fraction value greater than maximum is equivalent to maximum key.
Warning: it is an error to define this transient inputOnly field in an X3D file.
value_changed [value_changed accessType outputOnly, type SFBool #FIXED ""]
Single intermittent output value determined by current key time and corresponding keyValue entry.
Warning: it is an error to define this transient outputOnly field in an X3D file.
previous [previous accessType inputOnly, type SFBool (true|false) ""]
Send previous output value in keyValue array, and reset internal fraction field to match corresponding value in key array.
Hint: this input event will "wrap around" boundary of keyValue array, i.e. continue from first to last if necessary.
Warning: it is an error to define this transient inputOnly field in an X3D file.
next [next accessType inputOnly, type SFBool (true|false) ""]
Send next output value in keyValue array, and reset internal fraction field to match corresponding value in key array.
Hint: this input event will "wrap around" boundary of keyValue array, i.e. continue from last to first if necessary.
Warning: it is an error to define this transient inputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
BooleanToggle BooleanToggle BooleanToggle maintains state and negates output when a true input is provided.
Hint: example scenes and authoring assets at http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting
Hint: X3D Event-Utility Node Diagrams http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting/X3dEventUtilityNodeEventDiagrams.pdf
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
set_boolean [set_boolean accessType inputOnly, type SFBool #FIXED ""]
If input event set_boolean is true, flip state by negating current value of the toggle field
Hint: for logical consistency, input event set_boolean false has no effect (under review as part of Mantis issue 519).
Warning: it is an error to define this transient inputOnly field in an X3D file.
toggle [toggle accessType inputOutput, type SFBool (true|false) "false"]
Persistent state value that gets toggled or reset.
Hint: directly setting a new value for the toggle field generates a corresponding toggle_changed output event.
toggle_changed [toggle_changed accessType outputOnly, type SFInt32 CDATA #FIXED ""]
toggle_changed provides boolean output event matching updated toggle value when input event set_boolean true is received.
Hint: directly setting a new value for the toggle field generates a corresponding toggle_changed output event.
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
BooleanTrigger BooleanTrigger BooleanTrigger converts time events to boolean true events.
Hint: example scenes and authoring assets at http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting
Hint: X3D Event-Utility Node Diagrams http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting/X3dEventUtilityNodeEventDiagrams.pdf
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
set_triggerTime [set_triggerTime accessType inputOnly, type SFTime CDATA #FIXED ""]
set_triggerTime provides input time event, typical event sent is TouchSensor touchTime.
Warning: it is an error to define this transient inputOnly field in an X3D file.
triggerTrue [triggerTrue accessType outputOnly, type SFBool #FIXED ""]
triggerTrue outputs a true value whenever a triggerTime event is received.
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Box Box Box is a geometry node specifying a rectangular cuboid.
Hint: Cuboid https://en.wikipedia.org/wiki/Cuboid
Hint: Parallelepiped https://en.wikipedia.org/wiki/Parallelepiped
Hint: insert a Shape node before adding geometry or Appearance.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
size [size accessType initializeOnly, type SFVec3f CDATA "2 2 2"] (0,+∞)
size x y z in meters.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
Warning: solid false not supported in VRML97.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Circle2D Circle2D Circle2D is a geometry node that defines a linear circle with center (0,0) in X-Y plane..
Hint: insert a Shape node before adding geometry or Appearance.
Warning: requires X3D profile='Full' or else include <component name='Geometry2D' level='2'/>
Example: X3D Example Archives, X3D for Web Authors, Chapter 10 Geometry 2D https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter10Geometry2D
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
radius [radius accessType initializeOnly, type SFFloat CDATA "1"] (0,+∞)
circle radius.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Collision Collision Collision detects camera-to-object contact using current view and NavigationInfo avatarSize. Collision is a Grouping node that handles collision detection for its children. Collision can contain a single proxy child node for substitute collision-detection geometry.
Hint: proxy geometry is not rendered.
Hint: PointSet, IndexedLineSet, LineSet and Text are not collidable geometry do not trigger collisions.
Hint: improve performance using proxy for simpler contact-calculation geometry.
Hint: NavigationInfo types '"WALK" "FLY"' support camera-to-object collision detection.
Hint: insert a Shape node before adding geometry or Appearance.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
children [children accessType inputOutput, type MFNode array, empty list] [X3DChildNode]
Grouping nodes contain an ordered list of children nodes.
Hint: Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
Hint: inputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
Hint: inputOnly MFNode removeChildren field can remove nodes from the children list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
Hint: X3D Architecture 10.2.1 Grouping and children node types, http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#GroupingAndChildrenNodes
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
enabled [enabled accessType inputOutput, type SFBool (true|false) "true"]
Enables/disables collision detection for children and all descendants.
Hint: former name "collide" in VRML97 specification.
isActive [isActive accessType outputOnly, type SFBool #FIXED ""]
isActive true/false events are sent when triggering the sensor. isActive=true when view-object collision occurs, isActive=false when view-object collision no longer occurs.
Warning: it is an error to define this transient outputOnly field in an X3D file.
collideTime [collideTime accessType outputOnly, type SFTime CDATA #FIXED ""]
Time of collision between camera (avatar) and geometry.
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Color Color Color node defines a set of RGB color values that apply either to a sibling Coordinate|CoordinateDouble node, or else to a parent ElevationGrid node. Color is only used by ElevationGrid, IndexedFaceSet, IndexedLineSet, LineSet, PointSet, Triangle* and IndexedTriangle* nodes.
Hint: colors are often controlled by Material instead.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
color [color accessType inputOutput, type MFColor CDATA #IMPLIED]
The color field defines an array of 3-tuple RGB colors.
containerField [containerField type NMTOKEN "color"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
ColorInterpolator ColorInterpolator ColorInterpolator generates a range of color values. Authors can ROUTE value_changed output events to various color fields of Material or Color nodes.
Hint: typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisInterpolatorDEF.set_fraction.
Hint: typical output connection is ROUTE thisInterpolatorDEF.value_changed TO someDestinationNodeDEF.set_someAttribute.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
key [key accessType inputOutput, type MFFloat CDATA #IMPLIED]
Definition values for linear-interpolation function input intervals, in non-decreasing order and corresponding to a value in the keyValue array.
Warning: number of keys must match number of keyValues!
Warning: values in key array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
Hint: typical interval for values in key array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
keyValue [keyValue accessType inputOutput, type MFColor CDATA #IMPLIED]
Output values for linear interopolation, each corresponding to an input-fraction value in the key array.
Warning: number of keys must match number of keyValues!
set_fraction [set_fraction accessType inputOnly, type SFFloat CDATA #FIXED ""]
set_fraction selects input key for corresponding keyValue output.
Hint: set_fraction values are typically in same range interval as values in the key array. Response to an input set_fraction value less than minimum is equivalent to minimum key, and response to an input set_fraction value greater than maximum is equivalent to maximum key.
Warning: it is an error to define this transient inputOnly field in an X3D file.
value_changed [value_changed accessType outputOnly, type SFColor CDATA #FIXED ""]
Linearly interpolated output value determined by current key time and corresponding keyValue pair.
Hint: X3D players might not send unchanging intermediate values, thus avoiding excessive superfluous events that have no effect.
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
ColorRGBA ColorRGBA ColorRGBA node defines a set of RGBA color values that apply either to a sibling Coordinate|CoordinateDouble node, or else to a parent ElevationGrid node. ColorRGBA is only used by ElevationGrid, IndexedFaceSet, IndexedLineSet, LineSet, PointSet, Triangle* and IndexedTriangle* nodes.
Hint: colors are often controlled by Material instead.
Hint: alpha channel may be ignored under Interchange profile.
Warning: ColorRGBA requires Rendering component level 3 (alpha fully supported), Rendering component level 1 (alpha optional), otherwise Full profile.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
color [color accessType inputOutput, type MFColorRGBA CDATA #IMPLIED] [0,1]
The color field defines an array of 4-tuple RGBA colors.
Warning: ColorRGBA requires Rendering component level 3 (alpha fully supported), Rendering component level 1 (alpha optional), otherwise Full profile.
containerField [containerField type NMTOKEN "color"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
component component Each added component statement indicates needed scene functionality above the given X3D profile.
Hint: component statements are optional secondary children of head statement (add a head statement first).
Hint: X3D XML Encoding http://www.web3d.org/documents/specifications/19776-1/V3.3/Part01/concepts.html#Header
Warning: the COMPONENT statement is capitalized in the ClassicVRML Encoding.
Hint: X3D Architecture 7.2.5.4 COMPONENT statement http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/core.html#COMPONENTStatement
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
name [name type ENUMERATION #REQUIRED]
Provides name of this component, as defined in corresponding X3D Specification component Introduction.
Example: X3D Architecture 10.1.1 Name for Grouping component http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#Name
Hint: all nodes, components and levels are already supported in Full profile.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
level [level type SFInt32 #REQUIRED]
Necessary level of support for this scene, as defined in corresponding Support table for a given node's component.
Hint: for example specification definitions, X3D Architecture Grouping component, 10.5 Support levels http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#SupportLevels
  accessType and type   Credits and Translations   X3D Resources   to top
Cone Cone Cone is a geometry node.
Hint: cone https://en.wikipedia.org/wiki/Cone
Hint: insert a Shape node before adding geometry or Appearance.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
height [height accessType initializeOnly, type SFFloat CDATA "2"] (0,+∞)
Size in meters.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
bottomRadius [bottomRadius accessType initializeOnly, type SFFloat CDATA "1"] (0,+∞)
Size in meters.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
side [side accessType initializeOnly, type SFBool (true|false) "true"]
Whether to draw sides (other inside faces are not drawn).
Warning: cannot be changed after initial creation.
bottom [bottom accessType initializeOnly, type SFBool (true|false) "true"]
Whether to draw bottom (other inside faces are not drawn).
Warning: cannot be changed after initial creation.
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
Warning: solid false not supported in VRML97.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
connect connect connect statements define event-routing connections between node fields defined inside a ProtoBody declaration back to corresponding ProtoInterface fields. To define each Prototype connection between a ProtoInterface field and a ProtoBody node field, add one or more connect statements within each IS statement.
Warning: IS/connect elements are only allowed within ProtoDeclare body definitions.
Warning: nodeField and protoField types must match.
Hint: any matching field type can be connected, including SFNode or MFNode.
Hint: see the IS and ProtoBody statements.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
nodeField [nodeField type NMTOKEN #REQUIRED]
Name of field within this node which IS CONNECTed to the ancestor ProtoDeclare field definition.
Warning: do not define a nodeField connection to an internal DEF, USE, class or containerField, since they are not fields in a node that can be modified by events at run time.
Warning: do not connect more than one interface protoField to a single field within this node.
Warning: nodeField and protoField types must match.
protoField [protoField type NMTOKEN #REQUIRED]
Name of parent ProtoDeclare field definition connecting to field in this node.
Hint: use multiple IS/connect elements for multiple fan-out from a single protoField interface.
Warning: nodeField and protoField types must match.
  accessType and type   Credits and Translations   X3D Resources   to top
Contour2D Contour2D Contour2D groups a set of curve segments into a composite contour. The children segments form a closed loop, with first point of first child repeated as last point of last child, and last point of segment repeated as first point of consecutive segments. The children segments are type NurbsCurve2D or ContourPolyline2D, enumerated in the consecutive order of contour topology.
Warning: Contour2D is not a renderable geometry node.
Hint: Contour2D is used as the trimmingContour field of the NurbsTrimmedSurface node.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
containerField [containerField type NMTOKEN "trimmingContour"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
ContourPolyline2D ContourPolyline2D ContourPolyline2D defines a linear curve segment as part of a trimming contour in the u-v domain of a NURBS surface. NurbsCurve2D and ContourPolyline2D nodes that together form a closed contour, defined in the u-v parametric space of a NURBS surface, may be used as children in a Contour2D node.
Warning: ContourPolyline2D is not a renderable geometry node.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
controlPoint [controlPoint accessType inputOutput, type MFVec2d CDATA #IMPLIED]
controlPoint specifies the end points of each segment of the piecewise linear curve.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Coordinate Coordinate Coordinate builds geometry by defining a set of 3D coordinate (triplet) point values. Coordinate is used by IndexedFaceSet, IndexedLineSet, LineSet, PointSet, Triangle* and IndexedTriangle* nodes. Coordinate is also used by HAnimHumanoid, HAnimSegment, and various Nurbs nodes. Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
point [point accessType inputOutput, type MFVec3f CDATA #IMPLIED]
point contains a set of 3D coordinate (triplet) point values.
containerField [containerField type NMTOKEN "coord"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
CoordinateDouble CoordinateDouble CoordinateDouble builds geometry by defining a set of 3D coordinate (triplet) point values. CoordinateDouble is used by IndexedFaceSet, IndexedLineSet, LineSet, PointSet, Triangle* and IndexedTriangle* nodes. CoordinateDouble is also used by NurbsPositionInterpolator and NurbsOrientationInterpolator.
Warning: CoordinateDouble requires NURBS component level 1, otherwise Full profile.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
point [point accessType inputOutput, type MFVec3d CDATA #IMPLIED]
point contains a set of 3D coordinate (triplet) point values.
containerField [containerField type NMTOKEN "coord"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
CoordinateInterpolator
CoordinateInterpolator
CoordinateInterpolator linearly interpolates among a list of 3-tuple MFVec3f arrays, producing a single MFVec3f array that is fractional average between two nearest arrays in the list. Authors can ROUTE value_changed output events to a <Coordinate> node's 'point' attribute or another MFVec3f attribute.
Hint: typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisInterpolatorDEF.set_fraction.
Hint: typical output connection is ROUTE thisInterpolatorDEF.value_changed TO someDestinationNodeDEF.set_someAttribute.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
key [key accessType inputOutput, type MFFloat CDATA #IMPLIED]
Definition values for linear-interpolation function input intervals, in non-decreasing order and corresponding to a value in the keyValue array.
Hint: number of keyValues must be an integer multiple of the number of keys!
Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
Warning: values in key array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
Hint: typical interval for values in key array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
keyValue [keyValue accessType inputOutput, type MFVec3f CDATA #IMPLIED]
Output values for linear interopolation, each corresponding to an input-fraction value in the key array.
Hint: number of keyValues must be an integer multiple of the number of keys!
Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
set_fraction [set_fraction accessType inputOnly, type SFFloat CDATA #FIXED ""]
set_fraction selects input key for corresponding keyValue output.
Hint: set_fraction values are typically in same range interval as values in the key array. Response to an input set_fraction value less than minimum is equivalent to minimum key, and response to an input set_fraction value greater than maximum is equivalent to maximum key.
Warning: it is an error to define this transient inputOnly field in an X3D file.
value_changed [value_changed accessType outputOnly, type MFVec3f CDATA #FIXED ""]
Linearly interpolated output value determined by current key time and corresponding keyValue pair.
Hint: X3D players might not send unchanging intermediate values, thus avoiding excessive superfluous events that have no effect.
Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
CoordinateInterpolator2D
CoordinateInterpolator2D
CoordinateInterpolator2D generates a series of SFVec2f or MFVec2f 2-tuple float values. Authors can ROUTE value_changed output events to a SFVec2f or MFVec2f attribute.
Hint: typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisInterpolatorDEF.set_fraction.
Hint: typical output connection is ROUTE thisInterpolatorDEF.value_changed TO someDestinationNodeDEF.set_someAttribute.
Warning: requires X3D profile='Full' or else include <component name='Interpolation' level='3'/>
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
key [key accessType inputOutput, type MFFloat CDATA #IMPLIED]
Definition values for linear-interpolation function input intervals, in non-decreasing order and corresponding to a value in the keyValue array.
Hint: number of keyValues must be an integer multiple of the number of keys!
Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
Warning: values in key array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
Hint: typical interval for values in key array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
keyValue [keyValue accessType inputOutput, type MFVec2f CDATA #IMPLIED]
Output values for linear interopolation, each corresponding to an input-fraction value in the key array.
Hint: number of keyValues must be an integer multiple of the number of keys!
Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
set_fraction [set_fraction accessType inputOnly, type SFFloat CDATA #FIXED ""]
set_fraction selects input key for corresponding keyValue output.
Hint: set_fraction values are typically in same range interval as values in the key array. Response to an input set_fraction value less than minimum is equivalent to minimum key, and response to an input set_fraction value greater than maximum is equivalent to maximum key.
Warning: it is an error to define this transient inputOnly field in an X3D file.
value_changed [value_changed accessType outputOnly, type MFVec2f CDATA #FIXED ""]
Linearly interpolated output value determined by current key time and corresponding keyValue pair.
Hint: X3D players might not send unchanging intermediate values, thus avoiding excessive superfluous events that have no effect.
Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Cylinder Cylinder Cylinder is a geometry node.
Hint: Cylinder https://en.wikipedia.org/wiki/Cylinder
Hint: insert a Shape node before adding geometry or Appearance.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
height [height accessType initializeOnly, type SFFloat CDATA "2"] (0,+∞)
Size in meters.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
radius [radius accessType initializeOnly, type SFFloat CDATA "1"] (0,+∞)
Size in meters.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
top [top accessType initializeOnly, type SFBool (true|false) "true"]
Whether to draw top (inside faces are never drawn).
Warning: cannot be changed after initial creation.
side [side accessType initializeOnly, type SFBool (true|false) "true"]
Whether to draw sides (inside faces are never drawn).
Warning: cannot be changed after initial creation.
bottom [bottom accessType initializeOnly, type SFBool (true|false) "true"]
Whether to draw bottom (inside faces are never drawn).
Warning: cannot be changed after initial creation.
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
Warning: solid false not supported in VRML97.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
CylinderSensor CylinderSensor CylinderSensor converts pointer motion (for example, a mouse or wand) into rotation values using an invisible cylinder aligned with local Y-axis.
Hint: this sensor detects user interactions affecting peer nodes and their child geometry.
Hint: add semi-transparent surrounding geometry to see the effect of the sensor.
Hint: initial relative bearing of pointer drag determines whether cylinder sides or end-cap disks are used for manipulation.
Hint: X3D Architecture 20.2.1 Overview of pointing device sensors http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/pointingsensor.html#OverviewOfPointingDeviceSensors
Hint: X3D Architecture 20.2.2 Drag sensors http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/pointingsensor.html#DragSensors
Hint: X3D Architecture 20.2.3 Activating and manipulating pointing device sensors http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/pointingsensor.html#Activatingandmanipulating
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
description [description accessType inputOutput, type SFString CDATA #IMPLIED]
Author-provided text tooltip that tells users the expected action of this node.
Hint: include space characters since a description is not a DEF identifier. Write short phrases that make descriptions clear and readable.
Hint: many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &#38; for & ampersand character, or &#34; for " quotation-mark character).
enabled [enabled accessType inputOutput, type SFBool (true|false) "true"]
Enables/disables the sensor node.
minAngle [minAngle accessType inputOutput, type SFFloat CDATA "0"]
clamps rotation_changed events within range of min/max values
Hint: if minAngle > maxAngle, rotation is not clamped.
Hint: https://en.wikipedia.org/wiki/Radian
maxAngle [maxAngle accessType inputOutput, type SFFloat CDATA "0"]
clamps rotation_changed events within range of min/max values
Hint: if minAngle > maxAngle, rotation is not clamped.
Hint: https://en.wikipedia.org/wiki/Radian
diskAngle [diskAngle accessType inputOutput, type SFFloat CDATA "0.262" (15 degrees)]
Help decide rotation behavior from initial relative bearing of pointer drag: acute angle whether cylinder sides or end-cap disks of virtual-geometry sensor are used for manipulation.
Hint: diskAngle 0 forces disk-like behavior, diskAngle 1.570796 (90 degrees) forces cylinder-like behavior.
autoOffset [autoOffset accessType inputOutput, type SFBool (true|false) "true"]
determines whether previous offset values are remembered/accumulated.
offset [offset accessType inputOutput, type SFFloat CDATA "0"]
Sends event and remembers last value sensed.
isActive [isActive accessType outputOnly, type SFBool #FIXED ""]
Select geometry by activating the pointing device (e.g. clicking the mouse) to generate isActive events. Output event isActive=true is sent when geometry is selected (e.g. when primary mouse button is pressed), output event isActive=false is sent when geometry is deselected (e.g. when primary mouse button is released).
Warning: it is an error to define this transient outputOnly field in an X3D file.
isOver [isOver accessType outputOnly, type SFBool #FIXED ""]
Hover over geometry by aiming the mouse (or pointing device) to generate isOver events. Sensor sends output event isOver=true event when pointing device moves over sensor's geometry, and later sends output event isOver=false event when pointing device moves off.
Warning: it is an error to define this transient outputOnly field in an X3D file.
rotation_changed [rotation_changed accessType outputOnly, type SFRotation CDATA #FIXED ""]
rotation_changed events equal sum of relative bearing changes plus offset value about Y-axis in local coordinate system.
Warning: it is an error to define this transient outputOnly field in an X3D file.
trackPoint_changed [trackPoint_changed accessType outputOnly, type SFVec3f CDATA #FIXED ""]
trackPoint_changed events give intersection point of bearing with sensor's virtual geometry.
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
DirectionalLight DirectionalLight DirectionalLight defines parallel light rays that illuminate geometric shapes. Lighting illuminates all geometry except lines and points. By default, light scope only illuminates peer geometry and children nodes within the scene graph hierarchy. No source location is needed since rays are parallel from an infinitely distant source. DirectionalLight nodes do not attenuate with distance. Lights have no visible shape themselves and lighting effects continue through any intermediate geometry.
Hint: animate direction to simulate time-of-day sunlight effects.
Hint: the bound NavigationInfo controls whether headlight is enabled on/off.
Interchange profile hint: light might not be scoped by parent Group or Transform.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
on [on accessType inputOutput, type SFBool (true|false) "true"]
Enables/disables this light source.
color [color accessType inputOutput, type SFColor CDATA "1 1 1"] [0,1]
color of light, applied to colors of objects.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
direction [direction accessType inputOutput, type SFVec3f CDATA "0 0 -1"]
Orientation vector of light relative to local coordinate system.
Hint: animate direction to simulate time-of-day sunlight effects.
intensity [intensity accessType inputOutput, type SFFloat CDATA "1"] [0,1]
Brightness of direct emission from the light.
ambientIntensity [ambientIntensity accessType inputOutput, type SFFloat CDATA "0"] [0,1]
Brightness of ambient (nondirectional background) emission from the light.
Interchange profile hint: this field may be ignored, applying the default value regardless.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Disk2D Disk2D Disk2D is a geometry node that defines a filled (or partially filled) planar circle with center (0,0) in X-Y plane.
Hint: insert a Shape node before adding geometry or Appearance.
Warning: requires X3D profile='Full' or else include <component name='Geometry2D' level='2'/>
Example: X3D Example Archives, X3D for Web Authors, Chapter 10 Geometry 2D https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter10Geometry2D
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
innerRadius [innerRadius accessType initializeOnly, type SFFloat CDATA "0"] [0,+∞)
Inner circle radius, greater than or equal to 0.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
outerRadius [outerRadius accessType initializeOnly, type SFFloat CDATA "1"] (0,+∞)
Outer radius of circle, greater than or equal to inner radius.
Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for size animation use an ancestor Transform scale instead.
solid [solid accessType initializeOnly, type SFBool (true|false) "false"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
Warning: solid false not supported in VRML97.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
ElevationGrid ElevationGrid ElevationGrid is a geometry node defining a rectangular height field, with default values for a 1m by 1m square at height 0. Vertices corresponding to ElevationGrid height values define quadrilaterals, which are placed above or below a flat surface.
Hint: the height array defines (xDimension-1)*(zDimension-1) quadrilaterals.
Warning: generated quadrilaterals can be nonplanar. Tessellation splits quadrilaterals into triangles along seam starting at initial vertex of the quadrilateral and proceeding to opposite vertex.
Hint: positive direction for normal of each triangle is on same side of the quadrilateral. Triangles are defined either counterclockwise or clockwise depending on value of ccw field.
Hint: ElevationGrid can contain Color|ColorRGBA, Normal and TextureCoordinate nodes.
Hint: insert a Shape node before adding geometry or Appearance.
Hint: for advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
xDimension [xDimension accessType initializeOnly, type SFInt32 CDATA "2"] [0,+∞)
Number of elements in the height array along X direction.
Hint: total horizontal x-axis distance equals (xDimension-1) * xSpacing.
Warning: xDimension < 2 means that ElevationGrid contains no quadrilaterals.
zDimension [zDimension accessType initializeOnly, type SFInt32 CDATA "2"] [0,+∞)
Number of elements in the height array along Z direction.
Hint: total horizontal z-axis distance equals (zDimension-1) * zSpacing.
Warning: zDimension < 2 means that ElevationGrid contains no quadrilaterals.
xSpacing [xSpacing accessType initializeOnly, type SFFloat CDATA "1.0"] (0,+∞)
Meters distance between grid-array vertices along X direction.
Hint: total horizontal x-axis distance equals (xDimension-1) * xSpacing.
zSpacing [zSpacing accessType initializeOnly, type SFFloat CDATA "1.0"] (0,+∞)
Meters distance between grid-array vertices along Z direction.
Hint: total lateral z-axis distance equals (zDimension-1) * zSpacing.
height [height accessType initializeOnly, type MFFloat CDATA "0 0 0 0"]
Grid array of height vertices with upward direction along +Y axis, with xDimension rows and zDimension columns.
Hint: height array values are given in row-major order from left to right along X axis, then back to front along Z axis.
set_height [set_height accessType inputOnly, type MFFloat CDATA #FIXED ""]
Grid array of height vertices with upward direction along +Y axis, with xDimension rows and zDimension columns.
Hint: height array values are given in row-major order from left to right along X axis, then back to front along Z axis.
Warning: it is an error to define this transient inputOnly field in an X3D file.
ccw [ccw accessType initializeOnly, type SFBool (true|false) "true"]
ccw = counterclockwise: ordering of vertex coordinates orientation, according to Right-Hand Rule (RHR).
Hint: ccw false can reverse solid (backface culling) and normal-vector orientation. Note that consistency of left-handed or right-handed point sequences is important throughout.
creaseAngle [creaseAngle accessType initializeOnly, type SFFloat CDATA "0"] [0,+∞)
creaseAngle defines angle (in radians) for determining whether adjacent polygons are drawn with sharp edges or smooth shading. If angle between normals of two adjacent polygons is less than creaseAngle, smooth shading is rendered across the shared line segment.
Hint: creaseAngle=0 means render all edges sharply, creaseAngle=3.14159 means render all edges smoothly.
Hint: https://en.wikipedia.org/wiki/Radian
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
colorPerVertex [colorPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Color node color values are applied to each point vertex (true) or per quadrilateral (false).
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
normalPerVertex [normalPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Normal node vector values are applied to each point vertex (true) or per quadrilateral (false).
Hint: if no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
EspduTransform EspduTransform EspduTransform is a networked Transform node that can contain most nodes. If activated, EspduTransform can send or receive Entity State Protocol Data Unit (PDU) packets using the IEEE Distributed Interactive Simulation (DIS) protocol. EspduTransform integrates functionality for the following DIS PDUs: EntityStatePdu, CollisionPdu, DetonatePdu, FirePdu, CreateEntity and RemoveEntity packets.
Hint: insert a Shape node before adding geometry or Appearance.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/DistributedInteractiveSimulation.pdf
Warning: requires X3D profile='Full' or else include <component name='DIS' level='1'/>
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
enabled [enabled accessType inputOutput, type SFBool (true|false) "true"]
Enables/disables the sensor node.
marking [marking accessType inputOutput, type SFString CDATA #IMPLIED]
Maximum of 11 characters for simple entity label.
entityID [entityID accessType inputOutput, type SFInt32 CDATA "0"]
entityID is unique ID for entity within that application.
applicationID [applicationID accessType inputOutput, type SFInt32 CDATA "1"]
applicationID is unique for application at that site. Each simulation application that can respond to simulation management PDUs needs to have a unique applicationID.
siteID [siteID accessType inputOutput, type SFInt32 CDATA "0"]
siteID of the participating LAN or organization.
forceID [forceID accessType inputOutput, type SFInt32 CDATA "0"]
forceID determines the team membership of the issuing entity, and whether FRIENDLY OPPOSING or NEUTRAL or OTHER.
entityKind [entityKind accessType inputOutput, type SFInt32 CDATA "0"]
Integer enumerations value for whether entity is a PLATFORM, MUNITION, LIFE_FORM, ENVIRONMENTAL, CULTURAL_FEATURE, SUPPLY, RADIO, EXPENDABLE, SENSOR_EMITTER or OTHER.
entityDomain [entityDomain accessType inputOutput, type SFInt32 CDATA "0"]
Integer enumerations value for domain in which the entity operates: LAND, AIR, SURFACE, SUBSURFACE, SPACE or OTHER.
entityCountry [entityCountry accessType inputOutput, type SFInt32 CDATA "0"]
Integer enumerations value for country to which the design of the entity or its design specification is attributed.
entityCategory [entityCategory accessType inputOutput, type SFInt32 CDATA "0"]
Integer enumerations value for main category that describes the entity, semantics of each code varies according to domain. See DIS Enumerations values.
entitySubCategory [entitySubCategory accessType inputOutput, type SFInt32 CDATA "0"]
Integer enumerations value for particular subcategory to which an entity belongs based on the Category field. See DIS Enumerations values.
entitySpecific [entitySpecific accessType inputOutput, type SFInt32 CDATA "0"]
Specific information about an entity based on the Subcategory field. See DIS Enumerations values.
entityExtra [entityExtra accessType inputOutput, type SFInt32 CDATA "0"]
Any extra information required to describe a particular entity. The contents of this field shall depend on the type of entity represented.
readInterval [readInterval accessType inputOutput, type SFTime CDATA "0.1"] [0,+∞)
Seconds between read updates, 0 means no reading.
Hint: readInterval is a nonnegative SFTime duration interval, not an absolute clock time.
writeInterval [writeInterval accessType inputOutput, type SFTime CDATA "1.0"] [0,+∞)
Seconds between write updates, 0 means no writing (sending).
Hint: writeInterval is a nonnegative SFTime duration interval, not an absolute clock time.
networkMode [networkMode accessType inputOutput, type SFString CDATA ( standAlone | networkReader | networkWriter ) standAlone]
Whether this entity is ignoring the network, sending DIS packets to the network, or receiving DIS packets from the network. (1) standAlone: ignore network but still respond to events in local scene. (2) networkReader: listen to network and read PDU packets at readInterval, act as remote copy of entity. (3) networkWriter: send PDU packets to network at writeInterval, act as master entity. Default value "standAlone" ensures that DIS network activation within a scene as networkReader or networkWriter is intentional.
Warning: do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
isStandAlone [isStandAlone accessType outputOnly, type SFBool #FIXED ""]
Whether networkMode="local" (ignore network but still respond to local events)
Warning: it is an error to define this transient outputOnly field in an X3D file.
isNetworkReader [isNetworkReader accessType outputOnly, type SFBool #FIXED ""]
Whether networkMode="remote" (listen to network as copy of remote entity)
Warning: it is an error to define this transient outputOnly field in an X3D file.
isNetworkWriter [isNetworkWriter accessType outputOnly, type SFBool #FIXED ""]
Whether networkMode="master" (output to network as master entity at writeInterval)
Warning: it is an error to define this transient outputOnly field in an X3D file.
address [address accessType inputOutput, type SFString CDATA localhost]
Multicast network address, or else "localhost"
Example: 224.2.181.145.
port [port accessType inputOutput, type SFInt32 CDATA "0"]
Network connection port number (EXAMPLE 62040) for sending or receiving DIS messages.
Example: 62040.
multicastRelayHost [multicastRelayHost accessType inputOutput, type SFString CDATA #IMPLIED]
Fallback server address if multicast not available locally.
Example: track.nps.edu.
multicastRelayPort [multicastRelayPort accessType inputOutput, type SFInt32 CDATA "0"]
Fallback server port if multicast not available locally.
Example: 8010.
rtpHeaderExpected [rtpHeaderExpected accessType initializeOnly, type SFBool (true|false) "false"]
Whether RTP headers are prepended to DIS PDUs.
isRtpHeaderHeard [isRtpHeaderHeard accessType outputOnly, type SFBool #FIXED ""]
Whether incoming DIS packets have an RTP header prepended.
Warning: it is an error to define this transient outputOnly field in an X3D file.
isActive [isActive accessType outputOnly, type SFBool #FIXED ""]
Have we received a network update recently?
Warning: it is an error to define this transient outputOnly field in an X3D file.
timestamp [timestamp accessType outputOnly, type SFTime CDATA #FIXED ""]
DIS timestamp received from latest PDU update, converted to X3D SFTime units.
Warning: it is an error to define this transient outputOnly field in an X3D file.
translation [translation accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Position of children relative to local coordinate system, usually read from (or written to) remote, networked EspduTransform nodes.
rotation [rotation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Orientation of children relative to local coordinate system, usually read from (or written to) remote, networked EspduTransform nodes.
center [center accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Translation offset from origin of local coordinate system.
scale [scale accessType inputOutput, type SFVec3f CDATA "1 1 1"]
Non-uniform x-y-z scale of child coordinate system, adjusted by center and scaleOrientation.
scaleOrientation [scaleOrientation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Preliminary rotation of coordinate system before scaling (to allow scaling around arbitrary orientations).
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
linearVelocity [linearVelocity accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Velocity of the entity relative to the rotating Earth in either world or entity coordinates, depending on the dead reckoning algorithm used.
linearAcceleration [linearAcceleration accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Acceleration of the entity relative to the rotating Earth in either world or entity coordinates, depending on the dead reckoning algorithm used.
deadReckoning [deadReckoning accessType inputOutput, type SFInt32 CDATA "0"]
Dead reckoning algorithm being used to project position/orientation with velocities/accelerations.
isCollided [isCollided accessType outputOnly, type SFBool #FIXED ""]
Has a matching CollisionPDU reported a collision?
Warning: it is an error to define this transient outputOnly field in an X3D file.
collideTime [collideTime accessType outputOnly, type SFTime CDATA #FIXED ""]
When were we collided with?
Warning: it is an error to define this transient outputOnly field in an X3D file.
isDetonated [isDetonated accessType outputOnly, type SFBool #FIXED ""]
Has a matching DetonationPDU reported a detonation?
Warning: it is an error to define this transient outputOnly field in an X3D file.
detonateTime [detonateTime accessType outputOnly, type SFTime CDATA #FIXED ""]
When were we detonated?
fired1 [fired1 accessType inputOutput, type SFBool (true|false) "false"]
Has the primary weapon (Fire PDU) been fired?
fired2 [fired2 accessType inputOutput, type SFBool (true|false) "false"]
Has the secondary weapon (Fire PDU) been fired?
firedTime [firedTime accessType outputOnly, type SFTime CDATA #FIXED ""]
When did we shoot a weapon (Fire PDU)?
Warning: it is an error to define this transient outputOnly field in an X3D file.
fireMissionIndex [fireMissionIndex accessType inputOutput, type SFInt32 CDATA #FIXED ""]
munitionEntityID [munitionEntityID accessType inputOutput, type SFInt32 CDATA "0"]
munitionEntityID is unique ID for entity firing munition within that application.
munitionApplicationID [munitionApplicationID accessType inputOutput, type SFInt32 CDATA "1"]
munitionApplicationID, unique for application at that site. Each simulation application that can respond to simulation management PDUs needs to have a unique applicationID.
munitionSiteID [munitionSiteID accessType inputOutput, type SFInt32 CDATA "0"]
Munition siteID of the participating LAN or organization.
munitionStartPoint [munitionStartPoint accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Initial point of the munition path from firing weapon to detonation or impact, in exercise coordinates.
munitionEndPoint [munitionEndPoint accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Final point of the munition path from firing weapon to detonation or impact, in exercise coordinates.
warhead [warhead accessType inputOutput, type SFInt32 CDATA "0"]
Integer enumerations value for type of warhead on the munition.
fuse [fuse accessType inputOutput, type SFInt32 CDATA "0"]
Integer enumerations value for type of fuse on the munition.
munitionQuantity [munitionQuantity accessType inputOutput, type SFInt32 CDATA "0"]
Quantity of munitions fired.
firingRate [firingRate accessType inputOutput, type SFInt32 CDATA "0"]
Rate at which munitions are fired.
firingRange [firingRange accessType inputOutput, type SFFloat CDATA "0"]
Range (three dimension, straight-line distance) that the firing entity's fire control system has assumed for computing the fire control solution if a weapon and if the value is known
collisionType [collisionType accessType inputOutput, type SFInt32 CDATA "0"]
Integer enumeration for type of collision: ELASTIC or INELASTIC.
detonationLocation [detonationLocation accessType inputOutput, type SFVec3f CDATA "0 0 0"]
World coordinates for detonationLocation
detonationRelativeLocation [detonationRelativeLocation accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Relative coordinates for detonation location
detonationResult [detonationResult accessType inputOutput, type SFInt32 CDATA "0"]
Integer enumeration for type of detonation and result that occurred., if any.
eventApplicationID [eventApplicationID accessType inputOutput, type SFInt32 CDATA "1"]
Simulation/exercise eventApplicationID is unique for events generated from application at that site. Each simulation application that can respond to simulation management PDUs needs to have a unique applicationID.
eventEntityID [eventEntityID accessType inputOutput, type SFInt32 CDATA "0"]
For a given event, simulation/exercise entityID is a unique ID for a single entity within that application.
eventNumber [eventNumber accessType inputOutput, type SFInt32 CDATA "0"]
Sequential number of each event issued by an application.
Warning: reuse of numbers may be necessary during long simulation exercises.
eventSiteID [eventSiteID accessType inputOutput, type SFInt32 CDATA "0"]
Simulation/exercise siteID of the participating LAN or organization.
articulationParameterCount [articulationParameterCount accessType inputOutput, type SFInt32 CDATA "0"]
Number of articulated parameters attached to this entity state PDU.
articulationParameterDesignatorArray [articulationParameterDesignatorArray accessType inputOutput, type MFInt32 CDATA #IMPLIED]
Array of designators for each articulated parameter.
articulationParameterChangeIndicatorArray [articulationParameterChangeIndicatorArray accessType inputOutput, type MFInt32 CDATA #IMPLIED]
Array of change counters, each incremented when an articulated parameter is updated.#IMPLIED]
articulationParameterIdPartAttachedToArray [articulationParameterIdPartAttachedToArray accessType inputOutput, type MFInt32 CDATA #IMPLIED]
Array of ID parts that each articulated parameter is attached to.
articulationParameterTypeArray [articulationParameterTypeArray accessType inputOutput, type MFInt32 CDATA #IMPLIED]
Array of type enumerations for each articulated parameter element.
articulationParameterArray [articulationParameterArray accessType inputOutput, type MFFloat CDATA #IMPLIED]
Information required for representation of the entity's visual appearance and position of its articulated parts.
Hint: renamed as Variable Parameter in IEEE DIS 2012 revised standard.
set_articulationParameterValue0 [set_articulationParameterValue0 accessType inputOnly, type SFFloat CDATA #FIXED ""]
Set element of user-defined payload array.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_articulationParameterValue1 [set_articulationParameterValue1 accessType inputOnly, type SFFloat CDATA #FIXED ""]
Set element of user-defined payload array.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_articulationParameterValue2 [set_articulationParameterValue2 accessType inputOnly, type SFFloat CDATA #FIXED ""]
Set element of user-defined payload array.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_articulationParameterValue3 [set_articulationParameterValue3 accessType inputOnly, type SFFloat CDATA #FIXED ""]
Set element of user-defined payload array.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_articulationParameterValue4 [set_articulationParameterValue4 accessType inputOnly, type SFFloat CDATA #FIXED ""]
Set element of user-defined payload array.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_articulationParameterValue5 [set_articulationParameterValue5 accessType inputOnly, type SFFloat CDATA #FIXED ""]
Set element of user-defined payload array.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_articulationParameterValue6 [set_articulationParameterValue6 accessType inputOnly, type SFFloat CDATA #FIXED ""]
Set element of user-defined payload array.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_articulationParameterValue7 [set_articulationParameterValue7 accessType inputOnly, type SFFloat CDATA #FIXED ""]
Set element of user-defined payload array.
Warning: it is an error to define this transient inputOnly field in an X3D file.
articulationParameterValue0_changed [articulationParameterValue0_changed accessType outputOnly, type SFFloat CDATA #FIXED ""]
Get element of user-defined payload array.
Warning: it is an error to define this transient outputOnly field in an X3D file.
articulationParameterValue1_changed [articulationParameterValue1_changed accessType outputOnly, type SFFloat CDATA #FIXED ""]
Get element of user-defined payload array.
Warning: it is an error to define this transient outputOnly field in an X3D file.
articulationParameterValue2_changed [articulationParameterValue2_changed accessType outputOnly, type SFFloat CDATA #FIXED ""]
Get element of user-defined payload array.
articulationParameterValue3_changed [articulationParameterValue3_changed accessType outputOnly, type SFFloat CDATA #FIXED ""]
Get element of user-defined payload array.
Warning: it is an error to define this transient outputOnly field in an X3D file.
articulationParameterValue4_changed [articulationParameterValue4_changed accessType outputOnly, type SFFloat CDATA #FIXED ""]
Get element of user-defined payload array.
Warning: it is an error to define this transient outputOnly field in an X3D file.
articulationParameterValue5_changed [articulationParameterValue5_changed accessType outputOnly, type SFFloat CDATA #FIXED ""]
Get element of user-defined payload array.
Warning: it is an error to define this transient outputOnly field in an X3D file.
articulationParameterValue6_changed [articulationParameterValue6_changed accessType outputOnly, type SFFloat CDATA #FIXED ""]
Get element of user-defined payload array.
Warning: it is an error to define this transient outputOnly field in an X3D file.
articulationParameterValue7_changed [articulationParameterValue7_changed accessType outputOnly, type SFFloat CDATA #FIXED ""]
Get element of user-defined payload array.
Warning: it is an error to define this transient outputOnly field in an X3D file.
geoSystem [geoSystem accessType initializeOnly, type MFString CDATA "GD" "WE"]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
Hint: X3D Architecture 25.2.2 Spatial reference frames http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Spatialreferenceframes
Hint: X3D Architecture 25.2.4 Specifying geospatial coordinates http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Specifyinggeospatialcoords
Hint: UTM is Universal Transverse Mercator coordinate system https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system
Warning: deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
geoCoords [geoCoords accessType inputOutput, type SFVec3d CDATA "0 0 0"]
Geographic location (specified in current geoSystem coordinates) for children geometry (specified in relative coordinate system, in meters).
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
EXPORT EXPORT EXPORT exposes a local node for ROUTE passing of event values when the current Scene is included via Inline by a parent external world. These connections allow event values to be exchanged via ROUTE statements between a parent model and a child Inline model.
Hint: you can place EXPORT statements after Scene tag to show interfaces at top.
Hint: see IMPORT statement for corresponding functionality in the parent external world.
Warning: EXPORT statements are not allowed in prototype declarations.
Warning: corresponding parent-scene IMPORT and child Inline-scene EXPORT statements are necessary in order to ROUTE values between a parent model and a child Inline model.
Hint: X3D Architecture 4.4.6 Import/Export semantics http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#ImportExportsemantics
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
localDEF [localDEF type IDREF #REQUIRED]
localDEF is the DEF name of the local node to be EXPORTed.
AS #IMPLIED]
rename localDEF node AS a different name when exporting.
Hint: optional, default is to use same localDEF name.
  accessType and type   Credits and Translations   X3D Resources   to top
ExternProtoDeclare ExternProtoDeclare ExternProtoDeclare refers to a ProtoDeclare node declaration provided in another file. ExternProtoDeclare interfaces are defined by <field> statements (without IS/connect statements).
Hint: ExternProtoDeclare is a definition only, add corresponding ProtoInstance nodes to create new instances.
Hint: ExternProtoDeclare url is of the form http://www.web3d.org/x3d/someWorld.x3d#ProtoName
Hint: X3D Scene Authoring Hints, Inlines and Prototypes http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#InlinesPrototypes
Warning: do not include a <ProtoInterface> element.
Warning: setting a value is not allowed for ExternProtoDeclare field declarations, since original ProtoDeclare initializations or local ProtoInstance fieldValue initializations take precedence.
Hint: X3D Architecture 7.2.5.9 EXTERNPROTO statement http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/core.html#EXTERNPROTOStatement
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
name [name type NMTOKEN #REQUIRED]
name of the ExternProtoDeclare (External Prototype Declaration) being referenced.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
url [url accessType initializeOnly, type MFString CDATA #IMPLIED]
Location and filename of ProtoDeclare source declaration of interest. Multiple locations are more reliable, and including a Web address lets e-mail attachments work.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Hint: X3D Scene Authoring Hints, urls http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls
appinfo [appinfo type SFString CDATA #IMPLIED]
Application information to provide simple description usable as a tooltip, similar to XML Schema appinfo tag.
documentation [documentation type SFString CDATA #IMPLIED]
Documentation url for further information, similar to XML Schema documentation tag.
  accessType and type   Credits and Translations   X3D Resources   to top
Extrusion Extrusion Extrusion is a geometry node that sequentially stretches a 2D cross section along a 3D-spine path in the local coordinate system, creating an outer hull. Scaling and rotating the crossSection 2D outline at each control point can modify the outer hull of the Extrusion to produce a wide variety of interesting shapes.
Warning: take care to avoid defining parameter combinations that create self-intersecting, impossible or inverted geometry.
Hint: Extrusion https://en.wikipedia.org/wiki/Extrusion
Hint: insert a Shape node before adding geometry or Appearance.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
spine [spine accessType initializeOnly, type MFVec3f CDATA "0 0 0, 0 1 0"]
spine is a list of 3D points for a piecewise-linear curve forming a series of connected vertices, open or closed. This is the path along which the crossSection is extruded.
Hint: number of values must all match for 3-tuple spine points, 2-tuple scale values, and 4-tuple orientation values.
Warning: take care if creating loops or spirals, otherwise self-intersecting, impossible or inverted geometry can result!
crossSection [crossSection accessType initializeOnly, type MFVec2f CDATA "1 1, 1 -1, -1 -1, -1 1, 1 1"]
An ordered set of 2D points drawing a piecewise-linear curve and forming an X-Y planar series of connected vertices. The crossSection array defines a silhouette outline of the outer Extrusion surface.
Hint: the crossSection array can be open or closed (closed means that endpoints are coincident).
Hint: number of values must all match for 3-tuple spine points, 2-tuple scale values, and 4-tuple orientation values.
Warning: match clockwise/counterclockwise, otherwise self-intersecting, impossible or inverted geometry can result!
Warning: avoid self-intersecting polygon line segments, otherwise defined geometry is irregular and rendering results are undefined. , particularly for end caps.
scale [scale accessType initializeOnly, type MFVec2f CDATA "1 1"] (0,+∞)
scale is a list of 2D-scale parameters applied at each spine-aligned cross-section plane.
Hint: number of values must all match for 3-tuple spine points, 2-tuple scale values, and 4-tuple orientation values.
Hint: if the scale array contains one value, it is applied at all spine-aligned crossSection planes.
Warning: zero or negative scale values not allowed.
orientation [orientation accessType initializeOnly, type MFRotation CDATA "0 0 1 0"]
The orientation array is a list of axis-angle 4-tuple values applied at each spine-aligned cross-section plane.
Hint: if the orientation array contains a single 4-tuple value, it is applied at all spine-aligned crossSection planes.
Hint: number of values must all match for 3-tuple spine points, 2-tuple scale values, and 4-tuple orientation values.
beginCap [beginCap accessType initializeOnly, type SFBool (true|false) "true"]
Whether beginning cap is drawn (similar to Cylinder top cap).
Warning: cannot be changed after initial creation.
endCap [endCap accessType initializeOnly, type SFBool (true|false) "true"]
Whether end cap is drawn (similar to Cylinder bottom cap).
Warning: cannot be changed after initial creation.
ccw [ccw accessType initializeOnly, type SFBool (true|false) "true"]
ccw = counterclockwise: ordering of vertex-coordinates orientation.
Hint: ccw false can reverse solid (backface culling) and normal-vector orientation. Note that consistency of left-handed or right-handed point sequences is important throughout.
convex [convex accessType initializeOnly, type SFBool (true|false) "true"]
Whether all polygons in a shape are convex (true), or possibly concave (false). A convex polygon is planar, does not intersect itself, and has all interior angles < 180 degrees.
Warning: concave or inverted geometry may be invisible when using default value convex=true.
creaseAngle [creaseAngle accessType initializeOnly, type SFFloat CDATA "0.0"] [0,+∞)
creaseAngle defines angle (in radians) where adjacent polygons are drawn with sharp edges or smooth shading. If angle between normals of two adjacent polygons is less than creaseAngle, smooth shading is rendered across the shared line segment.
Hint: creaseAngle=0 means render all edges sharply, creaseAngle=3.14159 means render all edges smoothly.
Hint: https://en.wikipedia.org/wiki/Radian
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
set_crossSection [set_crossSection accessType inputOnly, type MFVec2f CDATA #FIXED ""]
An ordered set of 2D points drawing a piecewise-linear curve and forming an X-Y planar series of connected vertices. The crossSection array defines a silhouette outline of the outer Extrusion surface.
Warning: match clockwise/counterclockwise, otherwise self-intersecting, impossible or inverted geometry can result!
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_orientation [set_orientation accessType inputOnly, type MFRotation CDATA #FIXED ""]
The orientation array is a list of axis-angle 4-tuple values applied at each spine-aligned cross-section plane.
Hint: if the orientation array contains a single 4-tuple value, it is applied at all spine-aligned crossSection planes.
Hint: number of values must all match for 3-tuple spine points, 2-tuple scale values, and 4-tuple orientation values.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_scale [set_scale accessType inputOnly, type MFVec2f CDATA #FIXED ""] (0,+∞)
scale is a list of 2D-scale parameters applied at each spine-aligned cross-section plane.
Hint: number of values must all match for 3-tuple spine points, 2-tuple scale values, and 4-tuple orientation values.
Warning: zero or negative scale values not allowed.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_spine [set_spine accessType inputOnly, type MFVec3f CDATA #FIXED ""]
spine is a list of 3D points for a piecewise-linear curve forming a series of connected vertices, open or closed. This is the path along which the crossSection is extruded.
Hint: number of values must all match for 3-tuple spine points, 2-tuple scale values, and 4-tuple orientation values.
Warning: take care if creating loops or spirals, otherwise self-intersecting, impossible or inverted geometry can result!
Warning: it is an error to define this transient inputOnly field in an X3D file.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
field field A field statement defines an interface attribute or node.
Hint: first add a parent Script node or ProtoDeclare/ProtoInterface statements before defining a new field.
Hint: in addition to defining a simple-type value attribute, a field statement can alternatively hold initializing SFNode/MFNode values as contained node(s).
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
name [name type NMTOKEN #REQUIRED]
Name of this field declaration.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
accessType [accessType , type NMTOKEN #REQUIRED]
Event-model semantics for field set/get capabilities.
Hint: renamed accessType correspondences for X3D from VRML97 are inputOnly=eventIn, outputOnly=eventOut, initializeOnly=field, inputOutput=exposedField.
Warning: inputOutput=exposedField not allowed in VRML97 Script nodes, use initializeOnly=field for backwards compatibility.
Hint: an accessType value is required and must be provided.
Hint: X3D Architecture 4.4.2.2 Field semantics, http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#FieldSemantics
Hint: X3D XML Encoding 4.3.7 Prototype and field declaration syntax, http://www.web3d.org/documents/specifications/19776-1/V3.3/Part01/concepts.html#PrototypeAndFieldDeclarationSyntax
type [type NMTOKEN #REQUIRED]
Base type of this field variable.
Hint: a type value is required and must be provided.
value [value type CDATA #IMPLIED]
Provide default initialization value for this field variable (which may be re-initialized later by instantiation value of a named ProtoInstance fieldValue).
Hint: SFNode/MFNode fields are initialized using contained node content, instead of this value attribute.
Hint: value is required for Script and ProtoDeclare unless MF-type array initialization is empty list, SFString initialization is empty string, or SFNode is being initialized.
Hint: SFNode/MFNode fields are initialized by contained node element(s), if any.
Warning: setting a value is not allowed for ExternProtoDeclare field declarations, since original ProtoDeclare initializations or local ProtoInstance fieldValue initializations take precedence.
Warning: not allowed for field variables with accessType inputOnly or outputOnly.
appinfo [appinfo type SFString CDATA #IMPLIED]
Application information to provide simple description usable as a tooltip, similar to XML Schema appinfo tag.
documentation [documentation type SFString CDATA #IMPLIED]
Documentation url for further information, similar to XML Schema documentation tag.
  accessType and type   Credits and Translations   X3D Resources   to top
fieldValue fieldValue A fieldValue statement re-initializes the default value of a field in a parent ProtoInstance. Note that a field statement with a matching name must be already defined by the corresponding ProtoDeclare or ExternProtoDeclare statement.
Hint: first add a parent ProtoInstance node before defining a new fieldValue.
Warning: fieldValue content type must match the content type defined in the corresponding ProtoDeclare or ExternProtoDeclare field statement.
Hint: in addition to defining a simple-type value attribute, a fieldValue statement can alternatively hold initializing SFNode/MFNode values as contained node(s).
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
name [name type NMTOKEN #REQUIRED]
Name of the ProtoInstance field being re-initialized (corresponding to field name already defined in ProtoDeclare or ExternProtoDeclare).
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
value [value type CDATA #IMPLIED]
Initial value for this field (overrides default initialization value in original ProtoDeclare).
Hint: initialize SFNode/MFNode field value using contained content element(s), instead of a simple attribute value.
  accessType and type   Credits and Translations   X3D Resources   to top
FillProperties FillProperties FillProperties indicates whether appearance is filled or hatched for associated geometry nodes inside the same Shape. Hatches are applied on top of the already rendered appearance of the node, and are not affected by lighting.
Hint: DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
Warning: requires X3D profile='Full' or else include <component name='Shape' level='3'/>
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
filled [filled accessType inputOutput, type SFBool (true|false) "true"]
Whether or not associated geometry is filled.
hatched [hatched accessType inputOutput, type SFBool (true|false) "true"]
Whether or not associated geometry is hatched.
hatchStyle [hatchStyle accessType inputOutput, type SFInt32 CDATA "1"]
hatchStyle selects a hatch pattern from International Register of Graphical Items. 1=Horizontal equally spaced parallel lines. 2=Vertical equally spaced parallel lines. 3=Positive slope equally spaced parallel lines. 4=Negative slope equally spaced parallel lines. 5=Horizontal/vertical crosshatch. 6=Positive slope/negative slope crosshatch. 7=(cast iron or malleable iron and general use for all materials). 8=(steel). 9=(bronze, brass, copper, and compositions). 10=(white metal, zinc, lead, babbit, and alloys). 11=(magnesium, aluminum, and aluminum alloys). 12=(rubber, plastic, and electrical insulation). 13=(cork, felt, fabric, leather, and fibre). 14=(thermal insulation). 15=(titanium and refi-actory material). 16=(marble, slate, porcelain, glass, etc.). 17=(earth). 18=(sand). 19=(repeating dot).
Hint: detailed descriptions of hatchstyle values are found at the ISO/IEC International Register of Graphical Items http://www.iso.org/jtc1/sc24/register (may require login)
hatchColor [hatchColor accessType inputOutput, type SFColor CDATA "1 1 1"] [0,1]
Color of the hatch pattern.
containerField [containerField type NMTOKEN "fillProperties"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Fog Fog Fog simulates atmospheric effects by blending distant objects with fog color.
Hint: Background, Fog, NavigationInfo, TextureBackground and Viewpoint are bindable nodes, meaning that no more than one of each node type can be active at a given time.
Warning: results are undefined if a bindable node (Background, Fog, NavigationInfo, OrthoViewpoint, TextureBackground, Viewpoint) is a contained descendant node of either LOD or Switch.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
color [color accessType inputOutput, type SFColor CDATA "1 1 1"] [0,1]
Fog color.
Hint: match Background color to make objects fade away.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
fogType [fogType accessType inputOutput, type SFString CDATA (LINEAR|EXPONENTIAL) LINEAR]
Specifies algorithm for rate of increasing Fog, either LINEAR or EXPONENTIAL.
Hint: EXPONENTIAL is more natural but also more computationally expensive.
Warning: do not wrap "quotation" "marks" around this SFString value.
visibilityRange [visibilityRange accessType inputOutput, type SFFloat CDATA "0.0"]
Distance in meters where objects are totally obscured by the fog, using local coordinate system.
Hint: visibilityRange 0 disables Fog.
set_bind [set_bind accessType inputOnly, type SFBool #FIXED ""]
Receiving event set_bind=true activates and binds this node at the top of the binding stack. Receiving event set_bind=false deactivates and unbinds this node from the top of the binding stack. Thus setting set_bind to true/false will enable/disable the effect of this node.
Hint: paired node operations can be established by connecting set_bind and isBound fields of corresponding bindable nodes.
Warning: it is an error to define this transient inputOnly field in an X3D file.
bindTime [bindTime accessType outputOnly, type SFTime CDATA #FIXED ""]
Event sent reporting timestamp when node becomes active/inactive.
Warning: it is an error to define this transient outputOnly field in an X3D file.
isBound [isBound accessType outputOnly, type SFBool #FIXED ""]
Output event true gets sent when node becomes bound and activated, otherwise output event false gets sent when node becomes unbound and deactivated.
Hint: paired node operations can be established by connecting set_bind and isBound fields of corresponding bindable nodes.
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
FontStyle FontStyle FontStyle is an X3DFontStyleNode that defines the size, family, justification and other styles used by Text nodes.
Hint: full internationalization (i18n) and localization (l10n) features are available for any written language.
Hint: DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes.
Hint: relates to Internationalization (i18n) http://www.w3.org/standards/webdesign/i18n
Hint: first add a Text node as a parent node for FontStyle.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
family [family accessType initializeOnly, type MFString CDATA ( SERIF | SANS | TYPEWRITER ) "SERIF"]
Array of quoted font family names in preference order, browsers use the first supported family.
Hint: example family array might be "Times" "SERIF"
Warning: font family support often varies.
Hint: values with guaranteed support include "SERIF" "SANS" "TYPEWRITER".
Hint: SERIF and SANS are variable-width fonts (for example, Times Roman and Arial).
Hint: TYPEWRITER is a fixed-width font (for example, Courier).
Hint: MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
Hint: see 15.2.2.2 Font family and style http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/text.html#Fontfamilyandstyle for details.
Hint: relates to Internationalization (i18n) http://www.w3.org/standards/webdesign/i18n
style [style accessType initializeOnly, type SFString CDATA ( PLAIN | BOLD | ITALIC | MIDDLE ) PLAIN]
Pick one of four values for text style.
Warning: do not wrap "quotation" "marks" around this SFString value.
Hint: see 15.2.2.2 Font family and style http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/text.html#Fontfamilyandstyle for details.
justify [justify accessType initializeOnly, type MFString CDATA ( BEGIN | END | FIRST | MIDDLE ) "BEGIN" or "BEGIN" "END"]
The justify field determines alignment of the above text layout relative to the origin of the object coordinate system.
Hint: preferred value is usually justify=' "MIDDLE" "MIDDLE" ' for centered justification horizontally and vertically.
Warning: exactly two string values are provided for major and minor axis alignment.
Warning: do not use illegal values such as LEFT RIGHT TOP BOTTOM or CENTER.
Hint: MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
Hint: see 15.2.2.3 Direction and justification http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification for details.
size [size accessType initializeOnly, type SFFloat CDATA "1.0"] (0,+∞)
Nominal height (in local coordinate system) of text glyphs Also sets default spacing between adjacent lines of text.
spacing [spacing accessType initializeOnly, type SFFloat CDATA "1.0"] [0,+∞)
Adjustment factor for line spacing between adjacent lines of text.
language [language accessType initializeOnly, type SFString CDATA #IMPLIED]
Language codes consist of a primary code and a (possibly empty) series of subcodes. [ language-code = primary-code ( "-" subcode )* ] Two-letter primary codes are reserved for language abbreviations.
Hint: see RFC3066 Tags for the Identification of Languages http://tools.ietf.org/html/rfc3066 Two-letter primary codes include en (English), fr (French), de (German), it (Italian), nl (Dutch), el (Greek), es (Spanish), pt (Portuguese), ar (Arabic), he (Hebrew), ru (Russian), zh (Chinese), ja (Japanese), hi (Hindi), ur (Urdu), and sa (Sanskrit). Any two-letter subcode is understood to be a country code.
Warning: do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
Hint: see ISO639.2 Codes for the Representation of Names of Languages http://www.loc.gov/standards/iso639-2/php/code_list.php
Hint: see RFC3066 Tags for the Identification of Languages http://tools.ietf.org/html/rfc3066
Hint: see ISO3166 or http://xml.coverpages.org/languageIdentifiers.html
Hint: relates to Internationalization (i18n) http://www.w3.org/standards/webdesign/i18n
horizontal [horizontal accessType initializeOnly, type SFBool (true|false) "true"]
Whether text direction is horizontal (true) or vertical (false).
Hint: see 15.2.2.3 Direction and justification http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification for details.
Hint: relates to Internationalization (i18n) http://www.w3.org/standards/webdesign/i18n
leftToRightll [leftToRightl accessType initializeOnly, type SFBool (true|false) "true"]
Whether text direction is left-to-right (true) or right-to-left (false).
Hint: see 15.2.2.3 Direction and justification http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification for details.
Hint: relates to Internationalization (i18n) http://www.w3.org/standards/webdesign/i18n
topToBottom [topToBottom accessType initializeOnly, type SFBool (true|false) "true"]
Whether text direction is top-to-bottom (true) or bottom-to-top (false).
Hint: see 15.2.2.3 Direction and justification http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification for details.
Hint: relates to Internationalization (i18n) http://www.w3.org/standards/webdesign/i18n
containerField [containerField type NMTOKEN "fontStyle"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
GeoCoordinate GeoCoordinate GeoCoordinate builds geometry as a set of geographic 3D coordinates. These are transformed into a geocentric, curved-earth representation. GeoCoordinate is only used by IndexedFaceSet, IndexedLineSet, LineSet and PointSet. GeoCoordinate can contain a GeoOrigin node.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
geoSystem [geoSystem accessType initializeOnly, type MFString CDATA "GD" "WE"]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
Hint: X3D Architecture 25.2.2 Spatial reference frames http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Spatialreferenceframes
Hint: X3D Architecture 25.2.4 Specifying geospatial coordinates http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Specifyinggeospatialcoords
Hint: UTM is Universal Transverse Mercator coordinate system https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system
Warning: deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
point [point accessType inputOutput, type MFVec3d CDATA #IMPLIED]
point contains a set of actual 3D geographic coordinates, provided in geoSystem format can split strings if desired: "x1 y1 z1 x2 y2 z2" or "x1 y1 z1", "x2 y2 z2"
containerField [containerField type NMTOKEN "coord"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
GeoElevationGrid GeoElevationGrid GeoElevationGrid is a geometry node defining a rectangular height field, with default values for a 1m by 1m square at height 0. Vertices corresponding to GeoElevationGrid height values define quadrilaterals, which are placed above or below a curved geospatial surface using geographic coordinates.
Hint: the height array defines (xDimension-1)*(zDimension-1) quadrilaterals.
Warning: generated quadrilaterals can be nonplanar. Tessellation splits quadrilaterals into triangles along seam starting at initial vertex of the quadrilateral and proceeding to opposite vertex.
Hint: positive direction for normal of each triangle is on same side of the quadrilateral. Triangles are defined either counterclockwise or clockwise depending on value of ccw field.
Hint: GeoElevationGrid can contain GeoOrigin, Color|ColorRGBA, Normal and TextureCoordinate nodes.
Hint: insert a Shape node before adding geometry or Appearance.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Warning: avoid having GeoLocation or GeoTransform as a parent or ancestor node of GeoElevationGrid, since multiple geospatial transformations then occur with unpredictable results.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
geoSystem [geoSystem accessType initializeOnly, type MFString CDATA "GD" "WE"]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
Hint: X3D Architecture 25.2.2 Spatial reference frames http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Spatialreferenceframes
Hint: X3D Architecture 25.2.4 Specifying geospatial coordinates http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Specifyinggeospatialcoords
Hint: UTM is Universal Transverse Mercator coordinate system https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system
Warning: deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
geoGridOrigin [geoGridOrigin accessType initializeOnly, type SFVec3d CDATA "0 0 0"]
Geographic coordinate for southwest (lower-left) corner of height dataset.
xDimension [xDimension accessType initializeOnly, type SFInt32 CDATA "2"] [0,+∞)
Number of elements in the height array along east-west X direction.
Hint: total horizontal x-axis distance equals (xDimension-1) * xSpacing.
Warning: xDimension < 2 means that ElevationGrid contains no quadrilaterals.
zDimension [zDimension accessType initializeOnly, type SFInt32 CDATA "2"] [0,+∞)
Number of elements in the height array along north-south Z direction.
Hint: total lateral z-axis distance equals (zDimension-1) * zSpacing.
Warning: zDimension < 2 means that ElevationGrid contains no quadrilaterals.
xSpacing [xSpacing accessType initializeOnly, type SFDouble CDATA "1.0"] (0,+∞)
Distance between grid-array vertices along east-west X direction.
Hint: when geoSystem is GDC, xSpacing is number of degrees of longitude.
Hint: when geoSystem is UTM, xSpacing is number of eastings (meters).
zSpacing [zSpacing accessType initializeOnly, type SFDouble CDATA "1.0"] (0,+∞)
Distance between grid-array vertices along north-south Z direction.
Hint: when geoSystem is GDC, zSpacing is number of degrees of latitude.
Hint: when geoSystem is UTM, zSpacing is number of northings (meters).
yScale [yScale accessType inputOutput, type SFFloat CDATA "1.0"] [0,+∞)
Vertical exaggeration of displayed data produced from the height array.
height [height accessType initializeOnly, type MFDouble CDATA "0 0 0 0"]
Contains xDimension rows * zDimension columns floating-point values for elevation above ellipsoid.
Hint: height array values are in row-major order from west to east, south to north.
Hint: geoGridOrigin is in southwest (lower-left) corner of height dataset.
set_height [set_height accessType initializeOnly, type MFDouble CDATA #FIXED ""]
Contains xDimension rows * zDimension columns floating-point values for elevation above ellipsoid.
Hint: height array values are in row-major order from west to east, south to north.
Hint: geoGridOrigin is in southwest (lower-left) corner of height dataset.
Warning: it is an error to define this transient inputOnly field in an X3D file.
ccw [ccw accessType initializeOnly, type SFBool (true|false) "true"]
ccw = counterclockwise: ordering of vertex coordinates orientation, according to Right-Hand Rule (RHR).
Hint: ccw false can reverse solid (backface culling) and normal-vector orientation. Note that consistency of left-handed or right-handed point sequences is important throughout.
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
creaseAngle [creaseAngle accessType initializeOnly, type SFDouble CDATA "0"] [0,+∞)
creaseAngle defines angle (in radians) for determining whether adjacent polygons are drawn with sharp edges or smooth shading. If angle between normals of two adjacent polygons is less than creaseAngle, smooth shading is rendered across the shared line segment.
Hint: creaseAngle=0 means render all edges sharply, creaseAngle=3.14159 means render all edges smoothly.
Hint: https://en.wikipedia.org/wiki/Radian
colorPerVertex [colorPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Color node color values are applied to each point vertex (true) or per quadrilateral (false).
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
normalPerVertex [normalPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Normal node vector values are applied to each point vertex (true) or per quadrilateral (false).
Hint: if no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
GeoLocation GeoLocation GeoLocation positions a regular X3D model onto earth's surface. GeoLocation can contain children and GeoOrigin nodes.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Warning: avoid having GeoLocation or GeoTransform as a parent or ancestor node of each other, since multiple geospatial transformations then occur with unpredictable results.
Hint: GeoLocation adjusts orientation of children models appropriately: +Y axis is up direction for that local area (i.e. normal to tangent plane on the geospatial ellipsoid), -Z axis points towards north pole, and +X axis points east.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
geoSystem [geoSystem accessType initializeOnly, type MFString CDATA "GD" "WE"]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
Hint: X3D Architecture 25.2.2 Spatial reference frames http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Spatialreferenceframes
Hint: X3D Architecture 25.2.4 Specifying geospatial coordinates http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Specifyinggeospatialcoords
Hint: UTM is Universal Transverse Mercator coordinate system https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system
Warning: deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
geoCoords [geoCoords accessType inputOutput, type SFVec3d CDATA "0 0 0"]
Geographic location (specified in current geoSystem coordinates) for children geometry (specified in relative coordinate system, in meters).
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
GeoLOD GeoLOD GeoLOD provides quadtree level-of-detail loading/unloading for multi-resolution terrains. GeoLOD can contain children and GeoOrigin nodes.
Hint: children nodes expose the scene graph for the currently loaded set of nodes.
Hint: rootNode specifies the geometry of the root tile.
Warning: do not use rootUrl and rootNode simultaneously, since each specifies the root tile.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Warning: nested LOD (and/or GeoLOD) nodes with overlapping range intervals can lead to unexpected or undefined behavior.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
geoSystem [geoSystem accessType initializeOnly, type MFString CDATA "GD" "WE"]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
Hint: X3D Architecture 25.2.2 Spatial reference frames http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Spatialreferenceframes
Hint: X3D Architecture 25.2.4 Specifying geospatial coordinates http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Specifyinggeospatialcoords
Hint: UTM is Universal Transverse Mercator coordinate system https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system
Warning: deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
rootUrl [rootUrl accessType initializeOnly, type MFString CDATA #IMPLIED]
url for scene providing geometry for the root tile.
Warning: either rootNode or rootUrl can specify root tile, but specifying both is an error.
child1Url [child1Url accessType initializeOnly, type MFString CDATA #IMPLIED]
quadtree geometry loaded when viewer is within range.
child2Url [child2Url accessType initializeOnly, type MFString CDATA #IMPLIED]
quadtree geometry loaded when viewer is within range.
child3Url [child3Url accessType initializeOnly, type MFString CDATA #IMPLIED]
quadtree geometry loaded when viewer is within range.
child4Url [child4Url accessType initializeOnly, type MFString CDATA #IMPLIED]
quadtree geometry loaded when viewer is within range.
range [range accessType initializeOnly, type SFFloat CDATA #IMPLIED] (0,+∞)
Viewer range from geographic-coordinates center triggers quadtree loading/unloading.
Hint: not setting range values indicates that level switching can be optimized automatically based on performance.
center [center accessType initializeOnly, type SFVec3d CDATA "0 0 0"]
Viewer range from geographic-coordinates center triggers quadtree loading/unloading.
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
GeoMetadata GeoMetadata GeoMetadata includes a generic subset of metadata about the geographic data.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Hint: apply containerField='watchList' when parent node is LoadSensor.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
url [url accessType inputOutput, type MFString CDATA #IMPLIED]
Hypertext link to an external, complete metadata description.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Hint: X3D Scene Authoring Hints, urls http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls
data #IMPLIED]
DEF list of all nodes that implement this data. If no specific geospatial nodes identified, then this GeoMetadata node pertains to entire scene.
summary [summary accessType inputOutput, type MFString CDATA #IMPLIED]
The summary string array contains a set of keyword/value pairs, with each keyword and its subsequent value contained in separate strings.
Hint: example <GeoMetadata summary=' "title" "San Francisco, California USA" '/>.
Hint: Table 25.5, GeoMetadata keywords and values http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#t-keywordsandvalues
Hint: there should always be an even (or zero) number of strings to match key-value pairs.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
GeoOrigin GeoOrigin GeoOrigin specifies local geospatial coordinate system for parent node, enabling increased geographic precision during scene rendering (by mitigating potential floating-point roundoff errors). GeoOrigin can be contained by other Geospatial component nodes, typically via DEF/USE to ensure consistency.
Hint: only one geospatial coordinate system is allowed per scene, thus DEF-ing and later USE-ing only one GeoOrigin node per scene is recommended.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Warning: GeoOrigin is deprecated, discouraged and not legal in X3D v3.3. GeoOrigin can be ignored in X3D v3.2 and below.
Hint: GeoOrigin is likely to be restored in X3D v4.0 for special use on devices with limited floating-point resolution.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
geoSystem [geoSystem accessType initializeOnly, type MFString CDATA "GD" "WE"]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
Hint: X3D Architecture 25.2.2 Spatial reference frames http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Spatialreferenceframes
Hint: X3D Architecture 25.2.4 Specifying geospatial coordinates http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Specifyinggeospatialcoords
Hint: UTM is Universal Transverse Mercator coordinate system https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system
Warning: deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
geoCoords [geoCoords accessType inputOutput, type SFVec3d CDATA "0 0 0"]
Defines absolute geographic location (and implicit local coordinate frame).
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
rotateYUp [rotateYUp accessType initializeOnly, type SFBool (true|false) "false"]
Whether to rotate coordinates of nodes using this GeoOrigin so that local-up direction aligns with VRML Y axis rotateYUp false means local up-direction is relative to planet surface rotateYUp true allows proper operation of NavigationInfo modes FLY, WALK.
containerField [containerField type NMTOKEN "geoOrigin"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
GeoPositionInterpolator
GeoPositionInterpolator
GeoPositionInterpolator animates objects within a geographic coordinate system. GeoPositionInterpolator can contain a GeoOrigin node.
Hint: typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisInterpolatorDEF.set_fraction
Hint: typical output connection is ROUTE thisInterpolatorDEF.value_changed TO someDestinationNodeDEF.set_someAttribute.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
geoSystem [geoSystem accessType initializeOnly, type MFString CDATA "GD" "WE"]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
Hint: X3D Architecture 25.2.2 Spatial reference frames http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Spatialreferenceframes
Hint: X3D Architecture 25.2.4 Specifying geospatial coordinates http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Specifyinggeospatialcoords
Hint: UTM is Universal Transverse Mercator coordinate system https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system
Warning: deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
key [key accessType inputOutput, type MFFloat CDATA #IMPLIED]
Definition values for linear-interpolation function input intervals, in non-decreasing order and corresponding to a value in the keyValue array.
Warning: number of keys must match number of keyValues!
Warning: values in key array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
Hint: typical interval for values in key array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
keyValue [keyValue accessType inputOutput, type MFVec3d CDATA #IMPLIED]
Output values for linear interopolation, each corresponding to an input-fraction value in the key array.
Warning: number of keys must match number of keyValues!
set_fraction [set_fraction accessType inputOnly, type SFFloat CDATA #FIXED ""]
set_fraction selects input key for corresponding keyValue output.
Hint: set_fraction values are typically in same range interval as values in the key array. Response to an input set_fraction value less than minimum is equivalent to minimum key, and response to an input set_fraction value greater than maximum is equivalent to maximum key.
Warning: it is an error to define this transient inputOnly field in an X3D file.
value_changed [value_changed accessType outputOnly, type SFVec3f CDATA #FIXED ""]
Linearly interpolated output value determined by current key time and corresponding keyValue pair.
Hint: X3D players might not send unchanging intermediate values, thus avoiding excessive superfluous events that have no effect.
Warning: it is an error to define this transient outputOnly field in an X3D file.
geovalue_changed [geovalue_changed accessType outputOnly, type SFVec3d CDATA #FIXED ""]
interpolated coordinate in the geographic coordinate system specified by geoSystem
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
GeoTouchSensor GeoTouchSensor GeoTouchSensor returns geographic coordinates for the object being selected. GeoTouchSensor can contain a GeoOrigin node.
Hint: this sensor detects user interactions affecting peer nodes and their child geometry.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
geoSystem [geoSystem accessType initializeOnly, type MFString CDATA "GD" "WE"]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
Hint: X3D Architecture 25.2.2 Spatial reference frames http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Spatialreferenceframes
Hint: X3D Architecture 25.2.4 Specifying geospatial coordinates http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Specifyinggeospatialcoords
Hint: UTM is Universal Transverse Mercator coordinate system https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system
Warning: deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
enabled [enabled accessType inputOutput, type SFBool (true|false) "true"]
Enables/disables the sensor node.
description [description accessType inputOutput, type SFString CDATA #IMPLIED]
Author-provided text tooltip that tells users the expected action of this node.
Hint: include space characters since a description is not a DEF identifier. Write short phrases that make descriptions clear and readable.
Hint: many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &#38; for & ampersand character, or &#34; for " quotation-mark character).
isActive [isActive accessType inputOutput, type SFBool #FIXED ""]
Select geometry by activating the pointing device (e.g. clicking the mouse) to generate isActive events. Output event isActive=true is sent when geometry is selected (e.g. when primary mouse button is pressed), output event isActive=false is sent when geometry is deselected (e.g. when primary mouse button is released).
Warning: it is an error to define this transient outputOnly field in an X3D file.
hitGeoCoord_changed [hitGeoCoord_changed accessType outputOnly, type SFVec3d CDATA #FIXED ""]
Output event containing 3D point on surface of underlying geometry, given in GeoTouchSensor's local coordinate system.
Warning: it is an error to define this transient outputOnly field in an X3D file.
hitPoint_changed [hitPoint_changed accessType outputOnly, type SFVec3f CDATA #FIXED ""]
Output event containing 3D point on surface of underlying geometry, given in geometry coordinates (not geographic coordinates).
Warning: it is an error to define this transient outputOnly field in an X3D file.
hitNormal_changed [hitNormal_changed accessType outputOnly, type SFVec3f CDATA #FIXED ""]
Output event containing surface normal vector at the hitGeoCoordinate.
Warning: it is an error to define this transient outputOnly field in an X3D file.
hitTexCoord_changed [hitTexCoord_changed accessType outputOnly, type SFVec2f CDATA #FIXED ""]
Output event containing texture coordinates of surface at the hitGeoCoordinate.
Warning: it is an error to define this transient outputOnly field in an X3D file.
isOver [isOver accessType outputOnly, type SFBool #FIXED ""]
Is pointing device over sensor's geometry?.
Warning: it is an error to define this transient outputOnly field in an X3D file.
touchTime [touchTime accessType outputOnly, type SFTime CDATA #FIXED ""]
Time event generated when touched.
Hint: touchTime event is generated when following three conditions are all met: (a) pointing device was pointing towards geometry when initially activated (isActive=true), (b) pointing device is currently pointing towards the geometry (isOver=true), and (c) pointing device selection is deactivated/deselected by user (isActive=false event is also generated).
Warning: it is an error to define this transient outputOnly field in an X3D file.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
GeoViewpoint GeoViewpoint GeoViewpoint specifies viewpoints using geographic coordinates. GeoViewpoint can contain a GeoOrigin node. Since GeoViewpoint must navigate smoothly inside a curved geographic coordinate system, it includes both Viewpoint and NavigationInfo attributes.
Hint: alternatively can use GeoLocation or GeoTransform as parent of a Viewpoint node to orient geospatial views.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf
Warning: requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
Hint: Regardless of viewpoint jump value at bind time, the relative viewing transformation between user's view and defined position/orientation is stored for later use when un-jumping (returning to the viewpoint when subsequent viewpoint is unbound).
Hint: customizable design pattern for dedicated Viewpoint/NavigationInfo pair: <Viewpoint DEF='SpecialView'/> <NavigationInfo DEF='SpecialNav'/> <ROUTE fromNode='SpecialView' fromField='isBound' toNode='SpecialNav' toField='set_bind'/>
Warning: avoid having GeoLocation or GeoTransform as a parent or ancestor node of GeoViewpoint, since multiple geospatial transformations then occur with unpredictable results.
Hint: X3D Scene Authoring Hints, Viewpoints http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Viewpoints
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
geoSystem [geoSystem accessType initializeOnly, type MFString CDATA "GD" "WE"]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
Hint: X3D Architecture 25.2.2 Spatial reference frames http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Spatialreferenceframes
Hint: X3D Architecture 25.2.4 Specifying geospatial coordinates http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geodata.html#Specifyinggeospatialcoords
Hint: UTM is Universal Transverse Mercator coordinate system https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system
Warning: deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
description [description accessType inputOutput, type SFString CDATA #IMPLIED]
Author-provided text tooltip that tells users the expected action of this node.
Hint: include space characters since a description is not a DEF identifier. Write short phrases that make descriptions clear and readable.
Hint: many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &#38; for & ampersand character, or &#34; for " quotation-mark character).
position [position accessType initializeOnly, type SFVec3d CDATA "0 0 100000"]
Position relative to local georeferenced coordinate system, in proper format.
orientation [orientation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Rotation of Viewpoint, relative to default -Z axis direction in local coordinate system.
Warning: for VR/AR/MAR users wearing a head-mounted display (HMD), animating this field may induce motion sickness.
Hint: this is orientation _change_ from default direction (0 0 -1) +Y axis is the up vector for the local area (the normal to the tangent plane on the ellipsoid), -Z points towards the north pole, and +X is east 1 0 0 -1.570796 always looks down.
navType [navType accessType inputOutput, type MFString CDATA "EXAMINE" "ANY"]
Enter one or more Strings: "EXAMINE" "WALK" "FLY" "LOOKAT" "EXPLORE" "ANY" "NONE".
Hint: usability often improves with type="EXAMINE" "ANY".
headlight [headlight accessType inputOutput, type SFBool (true|false) "true"]
Enable/disable directional light that always points in the direction the user is looking
fieldOfView [fieldOfView accessType inputOutput, type SFFloat CDATA "0.7854"]]
jump [jump accessType inputOutput, type SFBool (true|false) "true"]
Whether to transition instantly by jumping, or else smoothly animate to this Viewpoint.
speedFactor [speedFactor accessType initializeOnly, type SFFloat CDATA "1"] [0,+∞)
speedFactor is a multiplier to modify the original elevation-based speed that is set automatically by the browser.
Hint: speedFactor is a relative value and not an absolute speed as defined by NavigationInfo.
set_bind [set_bind accessType inputOnly, type SFBool #FIXED ""]
set_bind true makes this node active, set_bind false makes this node inactive.
set_position [set_position accessType inputOnly, type SFVec3d CDATA #FIXED ""]
Position relative to local georeferenced coordinate system, in proper format.
set_orientation [set_orientation accessType inputOnly, type SFRotation CDATA #FIXED ""]
Rotation of Viewpoint, relative to default -Z axis direction in local coordinate system.
Warning: for VR/AR/MAR users wearing a head-mounted display (HMD), animating this field may induce motion sickness.
Hint: this is orientation _change_ from default direction (0 0 -1) +Y axis is the up vector for the local area (the normal to the tangent plane on the ellipsoid), -Z points towards the north pole, and +X is east 1 0 0 -1.570796 always looks down.
bindTime [bindTime accessType outputOnly, type SFTime CDATA #FIXED ""]
Event sent reporting timestamp when node becomes active/inactive.
isBound [isBound accessType outputOnly, type SFBool #FIXED ""]
Output event true gets sent when node becomes bound and activated, otherwise output event false gets sent when node becomes unbound and deactivated.
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Group Group Group is a Grouping node that can contain most nodes.
Hint: insert a Shape node before adding geometry or Appearance.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
children [children accessType inputOutput, type MFNode array, empty list] [X3DChildNode]
Grouping nodes contain an ordered list of children nodes.
Hint: Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
Hint: inputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
Hint: inputOnly MFNode removeChildren field can remove nodes from the children list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
Hint: X3D Architecture 10.2.1 Grouping and children node types, http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#GroupingAndChildrenNodes
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
containerField [containerField type NMTOKEN (children | proxy | rootNode | shape | skin) "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
HAnimDisplacer HAnimDisplacer HAnimDisplacer nodes alter the shape of coordinate-based geometry within parent HAnimJoint or HAnimSegment nodes. Displacer effects are scaled by the corresponding weight field.
Hint: HAnimDisplacer can be used in three different ways: (a) identify vertices corresponding to a particular feature in a parent HAnimSegment node, (b) represent a particular muscular action for a parent HAnimJoint node by displacing corresponding HAnimHumanoid skin vertices in various directions (linearly or radially), or (c) represent a complete configuration of coordinate vertices in a parent HAnimSegment node or parent HAnimJoint/HAnimHumanoid nodes. For example, in the case of a face, there might be a separate HAnimDisplacer node for each facial expression.
Warning: allowed name suffixes include _feature, _action and _config.
Hint: multiple HAnimDisplacer nodes must appear consecutively inside parent HAnimSegment.
Hint: H-Anim Specification http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/HAnimArchitecture.html
Hint: H-Anim Specification, Displacer http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/ObjectInterfaces.html#Displacer
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/HumanoidAnimation.pdf
Warning: requires X3D profile='Full' or else include <component name='H-Anim' level='1'/>
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
name [name accessType inputOutput, type NMTOKEN #REQUIRED]
Unique name attribute must be defined so that HAnimDisplacer node can be identified at run time for animation purposes.
Warning: allowed name suffixes include _feature, _action and _config.
Warning: name prefix must match ancestor HAnimHumanoid name followed by underscore character, for example 'Nancy_' prepended before location name.
Warning: name is not included if this instance is a USE node.
Examples: sellion r_infraorbitale etc. as listed in H-Anim Specification.
Hint: H-Anim Feature Points http://www.web3d.org/x3d/content/examples/Basic/HumanoidAnimation/tables/HAnimSurfaceFeaturePoints19774V1.0.txt
Hint: H-Anim Specification, Feature points for the human body http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/FeaturePoints.html
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
coordIndex [coordIndex accessType inputOutput, type MFInt32 CDATA #IMPLIED] [0,+∞)
Defines index values into the parent HAnimSegment or HAnimBody/HAnimHumanoid coordinate array for the mesh of vertices affected by this HAnimDisplacer. Values start at index 0.
Warning: -1 sentinel values are not allowed.
displacements [displacements accessType inputOutput, type MFVec3f CDATA #IMPLIED]
displacements are a set of SFVec3f values added to neutral/resting position of each of the corresponding HAnimSegment vertices (or HAnimJoint/HAnimHumanoid vertices) referenced by coordIndex field.
Hint: Individual displacement values are scaled by the weight factor, if present.
weight [weight accessType inputOutput, type SFFloat CDATA 0.0]
The weigh factor has typical range [0,1] and defines the scale factor applied to displacement values before adding them to neutral vertex positions.
Hint: apply a non-zero weight factor to see the effect of HAnimDisplacer displacements.
containerField [containerField type NMTOKEN "displacers"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
HAnimHumanoid HAnimHumanoid The HAnimHumanoid node is used to: (a) store references to the joints, segments, sites, skeleton, optional skin, and fixed viewpoints, (b) serve as a container for the entire humanoid, (c) provide a convenient way of moving the humanoid through its environment, and (d) store human-readable metadata such as name, version, author, copyright, age, gender and other information. HAnimHumanoid contains a skeleton consisting of HAnimJoint, HAnimSegment and HAnimSite nodes. HAnimHumanoid can also contain an optional skin consisting of an IndexedFaceSet mesh with corresponding skinCoord Coordinate|CoordinateDouble vertices and skinNormal Normal vectors.
Hint: MFNode arrays for the joints, segments, sites, and viewpoints fields provide lists for all HAnim nodes found in the skeleton hierarchy and thus only contain USE node references.
Hint: H-Anim Specification http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/HAnimArchitecture.html
Hint: H-Anim Specification, Humanoid http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/ObjectInterfaces.html#Humanoid
Hint: the viewpoints field connects internal Site nodes that in turn hold relative Viewpoint nodes, such as HAnimSite USE='ObserveFaceSite_view' containerField='viewpoints'/> which has corresponding counterpart nodes <HAnimSite DEF='ObserveFaceSite_view' name='ObserveFaceSite_view' containerField='children'> <Viewpoint description='look at me!'/> </HAnimSite>.
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/HumanoidAnimation.pdf
Warning: requires X3D profile='Full' or else include <component name='H-Anim' level='1'/>
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
name [name accessType inputOutput, type NMTOKEN #REQUIRED]
Unique name attribute must be defined so that each HAnimHumanoid node in a scene can be identified at run time for animation purposes.
Hint: this same name is a required name prefix for all other HAnim nodes within the HAnimHumanoid.
Warning: name is not included if this instance is a USE node.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
version [version accessType inputOutput, type SFString #REQUIRED]
HAnimHumanoid version, where value is 2.0 for standardized ISO 19774 initial version from 2006, and value is 2.2 for draft ISO 19774 version from 2018.
Warning: prior versions of HAnim nodes might not validate correctly due to small changes in the contained-node content model.
info [info accessType inputOutput, type MFString CDATA #IMPLIED]
Contains metadata keyword=value pairs, where approved keyword terms are humanoidVersion authorName authorEmail copyright creationDate usageRestrictions age gender height and weight.
Hint: alternate metadata keywords are also allowed.
translation [translation accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Position of children relative to local coordinate system.
rotation [rotation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Orientation of children relative to local coordinate system.
scale [scale accessType inputOutput, type SFVec3f CDATA "1 1 1"]
Non-uniform x-y-z scale of child coordinate system, adjusted by center and scaleOrientation.
scaleOrientation [scaleOrientation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Preliminary rotation of coordinate system before scaling (to allow scaling around arbitrary orientations).
center [center accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Translation offset from origin of local coordinate system.
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
containerField [containerField type NMTOKEN "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
HAnimJoint HAnimJoint HAnimJoint node can represent each joint in a body.
Hint: HAnimJoint may only get inserted as one (or more) root nodes of HAnimHumanoid skeleton field, as a child of another HAnimJoint node, or as a USE node in the HAnimHumanoid joints field.
Hint: HAnimJoint can only contain nodes HAnimJoint, HAnimSegment, HAnimSite with containerField='children' and also HAnimDisplacer nodes with containerField='displacers'.
Hint: visualization shapes for HAnimJoint nodes can be placed in child HAnimSegment or HAnimSite nodes.
Warning: an HAnimJoint may not be a child of an HAnimSegment.
Hint: H-Anim Specification http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/HAnimArchitecture.html
Hint: H-Anim Specification, Joint http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/ObjectInterfaces.html#Joint
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/HumanoidAnimation.pdf
Warning: requires X3D profile='Full' or else include <component name='H-Anim' level='1'/>
Warning: the number of contained <HAnimJoint USE='*' containerField='joints'/> nodes at top level of HAnimHumanoid needs to match the number of corresponding HAnimJoint node instances found within the preceding skeleton hierarchy.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
name [name accessType inputOutput, type NMTOKEN #REQUIRED]
Unique name attribute must be defined so that HAnimJoint node can be identified at run time for animation purposes.
Warning: name prefix must match ancestor HAnimHumanoid name followed by underscore character, for example 'Nancy_' prepended before location name.
Warning: name is not included if this instance is a USE node.
Examples: HumanoidRoot sacroiliac l_hip l_knee l_ankle etc. as listed in H-Anim Specification.
Hint: H-Anim Humanoid Joint Names http://www.web3d.org/x3d/content/examples/Basic/HumanoidAnimation/tables/HAnimJointNames19774V1.0.txt
Hint: H-Anim Specification, Humanoid Joint-Segment Hierarchy http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/concepts.html#Hierarchy
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
center [center accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Translation offset from origin of local coordinate system.
Hint: usually HAnimJoint position is controlled by the center field, not the translation field.
translation [translation accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Position of children relative to local coordinate system.
Warning: usually HAnimJoint position is controlled by the center field, not the translation field.
ulimit [ulimit accessType inputOutput, type MFFloat CDATA #IMPLIED]
Upper limit for maximum joint rotation.
Hint: always contains 3 values, one for each local axis.
llimit [llimit accessType inputOutput, type MFFloat CDATA #IMPLIED]
Lower limit for minimum joint rotation.
Hint: always contains 3 values, one for each local axis.
limitOrientation [limitOrientation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Orientation of upper/lower rotation limits, relative to HAnimJoint center.
skinCoordIndex [skinCoordIndex accessType inputOutput, type MFInt32 CDATA #IMPLIED] [0,+∞)
Coordinate index values referencing which vertices are influenced by the HAnimJoint.
Warning: -1 sentinel values are not allowed.
Hint: corresponding skinCoord Coordinate and skinNormal Normal nodes are directly contained within the ancestor HAnimHumanoid node for this HAnimJoint.
skinCoordWeight [skinCoordWeight accessType inputOutput, type MFFloat CDATA #IMPLIED]
Weight deformation values for the corresponding values in the skinCoordIndex field.
stiffness [stiffness accessType inputOutput, type MFFloat CDATA "1 1 1"] [0,1] Axial values (0,1)
indicating willingness of joint to move (about local X, Y, Z axes), larger stiffness values means greater resistance.
Hint: used by inverse kinematics (IK) systems.
rotation [rotation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Orientation of children relative to local coordinate system.
scale [scale accessType inputOutput, type SFVec3f CDATA "1 1 1"]
Non-uniform x-y-z scale of child coordinate system, adjusted by center and scaleOrientation.
scaleOrientation [scaleOrientation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Preliminary rotation of coordinate system before scaling (to allow scaling around arbitrary orientations).
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
containerField [containerField type NMTOKEN (children | skeleton | joints) "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
HAnimSegment HAnimSegment HAnimSegment node contains Shape geometry for each body segment. HAnimSegment contains Coordinate|CoordinateDouble with containerField='coord', HAnimDisplacer with containerField='displacers' and Shape or grouping nodes with containerField='children'.
Hint: HAnimSegment displays geometry between parent HAnimJoint and sibling HAnimJoint nodes.
Hint: H-Anim Specification http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/HAnimArchitecture.html
Hint: H-Anim Specification, Segment http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/ObjectInterfaces.html#Segment
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/HumanoidAnimation.pdf
Warning: requires X3D profile='Full' or else include <component name='H-Anim' level='1'/>
Warning: the number of contained <HAnimSegment USE='*' containerField='segments'/> nodes at top level of HAnimHumanoid needs to match the number of corresponding HAnimJoint node instances found within the preceding skeleton hierarchy.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
name [name accessType inputOutput, type NMTOKEN #REQUIRED]
Unique name attribute must be defined so that HAnimSegment node can be identified at run time for animation purposes.
Warning: name prefix must match ancestor HAnimHumanoid name followed by underscore character, for example 'Nancy_' prepended before location name.
Warning: name is not included if this instance is a USE node.
Examples: sacrum pelvis l_thigh l_calf etc. as listed in H-Anim Specification.
Hint: for abitrary humanoids, HAnimSegment name can describe geometry between parent HAnimJoint and sibling HAnimJoint nodes (for example LeftHip_to_LeftKnee).
Hint: H-Anim Humanoid Segment Names H-Anim Specification, Humanoid Joint-Segment Hierarchy http://www.web3d.org/x3d/content/examples/Basic/HumanoidAnimation/tables/HAnimSegmentNames19774V1.0.txt
Hint: H-Anim Specification, Humanoid Joint-Segment Hierarchy http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/concepts.html#Hierarchy
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
mass [mass accessType inputOutput, type SFFloat CDATA "0"]
Total mass of the segment, 0 if not available, defined in mass base units (default is kilograms).
Hint: https://en.wikipedia.org/wiki/Kilogram
Hint: X3D Architecture 4.3.6 Standard units and coordinate system http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#Standardunitscoordinates
centerOfMass [centerOfMass accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Location within segment of center of mass.
momentsOfInertia [momentsOfInertia accessType inputOutput, type MFFloat CDATA "0 0 0 0 0 0 0 0 0"]
3x3 moments of inertia matrix. default: 0 0 0 0 0 0 0 0 0.
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
containerField [containerField type NMTOKEN (children | segments) "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
HAnimSite HAnimSite An HAnimSite node serves three purposes: (a) define an "end effector" location which can be used by an inverse kinematics system, (b) define an attachment point for accessories such as jewelry and clothing, and (c) define a location for a Viewpoint virtual camera in the reference frame of an HAnimSegment (such as a view "through the eyes" of the humanoid for use in multi-user worlds).
Hint: HAnimSite nodes are stored as children of an HAnimSegment node.
Hint: H-Anim Specification http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/HAnimArchitecture.html
Hint: H-Anim Specification, Site http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/ObjectInterfaces.html#Site
Hint: H-Anim Specification, Annex B, Feature points for the human body http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/FeaturePoints.html
Hint: X3D for Advanced Modeling (X3D4AM) slideset http://x3dgraphics.com/slidesets/X3dForAdvancedModeling/HumanoidAnimation.pdf
Warning: requires X3D profile='Full' or else include <component name='H-Anim' level='1'/>
Warning: the number of contained <HAnimSite USE='*' containerField='sites, skeleton or viewpoints'/> nodes at top level of HAnimHumanoid needs to match the number of corresponding HAnimSite node instances found within the preceding skeleton hierarchy.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
name [name accessType inputOutput, type NMTOKEN #REQUIRED]
Unique name attribute must be defined so that HAnimSite nodecan be identified at run time for animation purposes.
Warning: name is not included if this instance is a USE node.
Examples: skull_tip sellion etc. as listed in H-Anim Specification.
Hint: H-Anim Humanoid Site Names LOA-3 http://www.web3d.org/x3d/content/examples/Basic/HumanoidAnimation/tables/HAnimSiteLoa3Names19774V1.0.txt
Hint: H-Anim Specification, LOA-3 default Site object translations http://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/BodyDimensionsAndLOAs.html#LOA3DefaultSiteTranslations
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
translation [translation accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Position of children relative to local coordinate system.
rotation [rotation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Orientation of children relative to local coordinate system.
scale [scale accessType inputOutput, type SFVec3f CDATA "1 1 1"]
Non-uniform x-y-z scale of child coordinate system, adjusted by center and scaleOrientation.
scaleOrientation [scaleOrientation accessType inputOutput, type SFRotation CDATA "0 0 1 0"]
Preliminary rotation of coordinate system before scaling (to allow scaling around arbitrary orientations).
center [center accessType inputOutput, type SFVec3f CDATA "0 0 0"]
Translation offset from origin of local coordinate system.
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
containerField [containerField type NMTOKEN (children | sites | skeleton | viewpoints) "children"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
head head head can contain component, unit, and author-defined meta (metadata) elements.
Hint: design for this element matches the <head> tag in HTML.
Warning: head is optional first child of X3D statement, and must precede the Scene statement.
Warning: in order to pass XML validation, these contained optional statements must appear in order: first component statements, then unit statements, then meta statements.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
  accessType and type   Credits and Translations   X3D Resources   to top
ImageTexture ImageTexture ImageTexture maps a 2D-image file onto a geometric shape. Texture maps have a 2D coordinate system (s, t) horizontal and vertical, with (s, t) values in range [0.0, 1.0] for opposite corners of the image.
Hint: insert Shape and Appearance nodes before adding texture.
Warning: bright Material emissiveColor values can wash out some textures.
Hint: authors can provide multiple image formats for the same image, with each source address listed separately in the url field.
Hint: player support is required for .png and .jpg formats, support is suggested for .gif format. Other image formats are optionally supported.
Hint: X3D Scene Authoring Hints, Images http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Images
Warning: see ComposedCubeMapTexture and TextureBackground for special containerField values.
Hint: if a texture is opaque, omitting values in the alpha channel can help avoid rendering artifacts related to transparency and reduce file size by 25%.
Hint: Texture mapping https://en.wikipedia.org/wiki/Texture_mapping
Hint: X3D Architecture 17.2.2 Lighting model http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/lighting.html#Lightingmodel
Hint: apply containerField='watchList' when parent node is LoadSensor.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
url [url accessType inputOutput, type MFString CDATA #IMPLIED]
Location and filename of image. Multiple locations are more reliable, and including a Web address lets e-mail attachments work.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Hint: X3D Scene Authoring Hints, urls http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls
repeatS [repeatS accessType initializeOnly, type SFBool (true|false) "true"]
Whether to horizontally repeat texture along S axis.
repeatT [repeatT accessType initializeOnly, type SFBool (true|false) "true"]
Whether to vertically repeat texture along T axis.
containerField [containerField type NMTOKEN (texture | back | bottom | front | left | right | top) "texture"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
IMPORT IMPORT IMPORT provides ROUTE access to a node that has a corresponding EXPORT statement within an Inline scene. These connections allow event values to be passed via ROUTE statements between a parent model and a child Inline model.
Hint: it is good practice to place IMPORT statements next to corresponding Inline scenes for readability.
Hint: see EXPORT statement for corresponding functionality within the related Inline model.
Warning: corresponding parent-scene IMPORT and child Inline-scene EXPORT statements are necessary in order to ROUTE values between a parent model and a child Inline model.
Hint: X3D Architecture 4.4.6 Import/Export semantics http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#ImportExportsemantics
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
inlineDEF [inlineDEF type IDREF #REQUIRED]
inlineDEF is the DEF name of Inline node in the same scene as this IMPORT statement.
Warning: the inlineDEF Inline scene must similarly include a corresponding EXPORT statement.
importedDEF #REQUIRED]
importedDEF is DEF name of the node of interest that is contained in the remote inlineDEF scene.
Hint: required.
AS #IMPLIED]
map importedDEF name AS a new name in current scene.
Hint: optional, default export is importedDEF node name.
  accessType and type   Credits and Translations   X3D Resources   to top
IndexedFaceSet IndexedFaceSet IndexedFaceSet defines polygons using index lists corresponding to vertex coordinates. IndexedFaceSet is a geometry node containing a Coordinate|CoordinateDouble node, and can also contain Color|ColorRGBA, Normal and TextureCoordinate nodes.
Hint: Polygon https://en.wikipedia.org/wiki/Polygon
Hint: insert a Shape node before adding geometry or Appearance.
Hint: for advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
Warning: rendering characteristics are undefined if polygons are not planar.
Warning: avoid self-intersecting polygon line segments, otherwise defined geometry is irregular and rendering results are undefined.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
coordIndex [coordIndex accessType initializeOnly, type MFInt32 CDATA #IMPLIED] [-1,+∞)
coordIndex indices provide the order in which coordinates are applied to construct each polygon face. Order starts at index 0, commas are optional between sets.
Hint: sentinel value -1 is used to separate indices for each successive polygon.
Warning: coordIndex is required in order to connect contained coordinate point values.
ccw [ccw accessType initializeOnly, type SFBool (true|false) "true"]
ccw = counterclockwise: ordering of vertex coordinates orientation, according to Right-Hand Rule (RHR).
Hint: ccw false can reverse solid (backface culling) and normal-vector orientation. Note that consistency of left-handed or right-handed point sequences is important throughout.
convex [convex accessType initializeOnly, type SFBool (true|false) "true"]
Whether all polygons in a shape are convex (true), or possibly concave (false) A convex polygon is planar, does not intersect itself, and has all interior angles < 180 degrees.
Interchange profile hint: only convex=true IndexedFaceSets have guaranteed supported.
Warning: concave or inverted geometry may be invisible when using default value convex=true.
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
creaseAngle [creaseAngle accessType initializeOnly, type SFFloat CDATA "0"] [0,+∞)
creaseAngle defines angle (in radians) for determining whether adjacent polygons are drawn with sharp edges or smooth shading. If angle between normals of two adjacent polygons is less than creaseAngle, smooth shading is rendered across the shared line segment.
Interchange profile hint: only 0 and π radians supported.
Hint: creaseAngle=0 means render all edges sharply, creaseAngle=3.14159 means render all edges smoothly.
Hint: https://en.wikipedia.org/wiki/Radian
colorPerVertex [colorPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Color|ColorRGBA values are applied to each point vertex (true) or to each polygon face (false).
Warning: if child Color|ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
colorIndex [colorIndex accessType initializeOnly, type MFInt32 CDATA #IMPLIED] [-1,+∞)
colorIndex values define the order in which Color|ColorRGBA values are applied to polygons (or vertices).
Hint: if colorIndex array is not provided, then Color|ColorRGBA values are indexed according to the coordIndex field.
Hint: If colorPerVertex='false' then one index is provided for each polygon defined by the coordIndex array. No sentinel -1 values are included.
Hint: If colorPerVertex='true' then a matching set of indices is provided, each separated by sentinel -1, that exactly corresponds to individual values in the coordIndex array polygon definitions.
Warning: if child Color|ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
normalPerVertex [normalPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Normal node vector values are applied to each point vertex (true) or to each polygon face (false).
Hint: if no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
normalIndex [normalIndex accessType initializeOnly, type MFInt32 CDATA #IMPLIED] [-1,+∞)
normalIndex values define the order in which normal vectors are applied to polygons (or vertices).
Warning: if normalIndex array is not provided, then Normal values are indexed according to the coordIndex field.
Hint: If normalPerVertex='false' then one index is provided for each polygon defined by the coordIndex array. No sentinel -1 values are included.
Hint: If normalPerVertex='true' then a matching set of indices is provided, each separated by sentinel -1, that exactly corresponds to individual values in the coordIndex array polygon definitions.
Hint: if no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
Interchange profile hint: this field may be ignored, applying the default value regardless.
texCoordIndex [texCoordIndex accessType initializeOnly, type MFInt32 CDATA #IMPLIED] [-1,+∞)
List of texture-coordinate indices mapping attached texture to corresponding coordinates.
Hint: if texCoordIndex array is not provided, then TextureCoordinate values are indexed according to the coordIndex field.
Hint: use a tool!
set_coordIndex [set_coordIndex accessType inputOnly, type MFInt32 CDATA #FIXED ""]
coordIndex indices provide the order in which coordinates are applied to construct each polygon face. Order starts at index 0, commas are optional between sets.
Hint: sentinel value -1 is used to separate indices for each successive polygon.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_colorIndex [set_colorIndex accessType initializeOnly, type MFInt32 CDATA #FIXED ""]
colorIndex values define the order in which Color|ColorRGBA values are applied to polygons (or vertices).
Hint: if colorIndex array is not provided, then Color|ColorRGBA values are indexed according to the coordIndex field.
Hint: If colorPerVertex='false' then one index is provided for each polygon defined by the coordIndex array. No sentinel -1 values are included.
Hint: If colorPerVertex='true' then a matching set of indices is provided, each separated by sentinel -1, that exactly corresponds to individual values in the coordIndex array polygon definitions.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_normalIndex [set_normalIndex accessType inputOnly, type MFInt32 CDATA #FIXED ""] [-1,+∞)
normalIndex values define the order in which normal vectors are applied to polygons (or vertices).
Interchange profile hint: this field may be ignored, applying the default value regardless.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_texCoordIndex [set_texCoordIndex accessType inputOnly, type MFInt32 CDATA #FIXED ""] [-1,+∞)
List of texture-coordinate indices mapping attached texture to corresponding coordinates.
Hint: use a tool!
Warning: it is an error to define this transient inputOnly field in an X3D file.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
IndexedLineSet IndexedLineSet IndexedLineSet defines polyline segments using index lists corresponding to vertex coordinates. IndexedLineSet is a geometry node that can contain a Coordinate|CoordinateDouble node and optionally a Color|ColorRGBA node.
Hint: Polygonal chain https://en.wikipedia.org/wiki/Polygonal_chain
Hint: either values in a contained Color node, or else Material emissiveColor in corresponding Appearance node, are used for rendering lines and points.
Warning: lines are not lit, are not texture-mapped, and do not participate in collision detection.
Warning: use a different color (or Material emissiveColor) than the Background color, otherwise geometry is invisible.
Hint: adding LineProperties to the corresponding Appearance node can modify the rendering style of these lines.
Hint: if rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat each initial vertex to close each polygon outline.
Hint: step-wise variation or linear interpolation of color values can be used as a good scientific visualization technique to map arbitrary function values to a color map.
Hint: insert a Shape node before adding geometry or Appearance.
Hint: for advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
Hint: consider including Fog (with Fog color matching Background color) to provide further depth cueing for IndexedLineSet (ILS).
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
coordIndex [coordIndex accessType initializeOnly, type MFInt32 CDATA #IMPLIED] [-1,+∞)
coordIndex indices provide the order in which coordinates are applied to construct each polygon face. Order starts at index 0, commas are optional between sets, use -1 to separate indices for each polyline.
Hint: if rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat initial each initial vertex to close the polygons.
Hint: sentinel value -1 is used to separate indices for each successive polyline.
Warning: coordIndex is required in order to connect contained coordinate point values.
colorPerVertex [colorPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Color node color values are applied to each point vertex (true) or per polyline (false).
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
colorIndex [colorIndex accessType initializeOnly, type MFInt32 CDATA #IMPLIED] [-1,+∞)
colorIndex values define the order in which Color|ColorRGBA values are applied to polygons (or vertices).
Hint: if colorIndex array is not provided, then Color|ColorRGBA values are indexed according to the coordIndex field.
Hint: If colorPerVertex='false' then one index is provided for each polygon defined by the coordIndex array. No sentinel -1 values are included.
Hint: If colorPerVertex='true' then a matching set of indices is provided, each separated by sentinel -1, that exactly corresponds to individual values in the coordIndex array polygon definitions.
Hint: if rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat initial each initial vertex to close the polygons.
Warning: if child Color|ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
set_coordIndex [set_coordIndex accessType inputOnly, type MFInt32 CDATA #FIXED ""]
coordIndex indices provide the order in which coordinates are applied to construct each polygon face. Order starts at index 0, commas are optional between sets.
Hint: sentinel value -1 is used to separate indices for each successive polygon.
Warning: it is an error to define this transient inputOnly field in an X3D file.
set_colorIndex [set_colorIndex accessType initializeOnly, type MFInt32 CDATA #FIXED ""]
colorIndex values define the order in which Color|ColorRGBA values are applied to polygons (or vertices).
Hint: if colorIndex array is not provided, then Color|ColorRGBA values are indexed according to the coordIndex field.
Hint: If colorPerVertex='false' then one index is provided for each polygon defined by the coordIndex array. No sentinel -1 values are included.
Hint: If colorPerVertex='true' then a matching set of indices is provided, each separated by sentinel -1, that exactly corresponds to individual values in the coordIndex array polygon definitions.
Warning: it is an error to define this transient inputOnly field in an X3D file.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
IndexedTriangleFanSet
IndexedTriangleFanSet
IndexedTriangleFanSet is a geometry node containing a Coordinate|CoordinateDouble node, and can also contain Color|ColorRGBA, Normal and TextureCoordinate nodes.
Hint: color, normal and texCoord values are applied in the same order as coord values.
Hint: insert a Shape node before adding geometry or Appearance.
Hint: for advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
index [index accessType initializeOnly, type MFInt32 CDATA #IMPLIED] [-1,+∞)
index list specifies triangles by connecting Coordinate vertices, each individual fan separated by -1 sentinel value.
Hint: first indexed coordinate in each sequence is fan center.
ccw [ccw accessType initializeOnly, type SFBool (true|false) "true"]
ccw = counterclockwise: ordering of vertex coordinates orientation, according to Right-Hand Rule (RHR).
Hint: ccw false can reverse solid (backface culling) and normal-vector orientation. Note that consistency of left-handed or right-handed point sequences is important throughout.
colorPerVertex [colorPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Color|ColorRGBA values are applied to each point vertex (true) or to each polygon face (false).
Warning: if child Color|ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
normalPerVertex [normalPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Normal node vector values are applied to each point vertex (true) or to each polygon face (false).
Hint: if no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
IndexedTriangleSet IndexedTriangleSet IndexedTriangleSet is a geometry node containing a Coordinate|CoordinateDouble node, and can also contain Color|ColorRGBA, Normal and TextureCoordinate nodes.
Hint: color, normal and texCoord values are applied in the same order as coord values.
Hint: insert a Shape node before adding geometry or Appearance.
Hint: for advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
index [index accessType initializeOnly, type MFInt32 CDATA #IMPLIED] [0,+∞)
index list specifies triangles by connecting Coordinate vertices.
Warning: -1 sentinel values are not allowed.
ccw [ccw accessType initializeOnly, type SFBool (true|false) "true"]
ccw = counterclockwise: ordering of vertex coordinates orientation, according to Right-Hand Rule (RHR).
Hint: ccw false can reverse solid (backface culling) and normal-vector orientation. Note that consistency of left-handed or right-handed point sequences is important throughout.
colorPerVertex [colorPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Color|ColorRGBA values are applied to each point vertex (true) or to each polygon face (false).
Warning: if child Color|ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
normalPerVertex [normalPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Normal node vector values are applied to each point vertex (true) or to each polygon face (false).
Hint: if no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
IndexedTriangleStripSet
IndexedTriangleStripSet
IndexedTriangleStripSet is a geometry node containing a Coordinate|CoordinateDouble node, and can also contain Color|ColorRGBA, Normal and TextureCoordinate nodes.
Hint: color, normal and texCoord values are applied in the same order as coord values.
Hint: insert a Shape node before adding geometry or Appearance.
Hint: for advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
index [index accessType initializeOnly, type MFInt32 CDATA #IMPLIED] [-1,+∞)
index list specifies triangles by connecting Coordinate vertices for each individual strip, separated by -1 sentinel values.
ccw [ccw accessType initializeOnly, type SFBool (true|false) "true"]
ccw = counterclockwise: ordering of vertex coordinates orientation, according to Right-Hand Rule (RHR).
Hint: ccw false can reverse solid (backface culling) and normal-vector orientation. Note that consistency of left-handed or right-handed point sequences is important throughout.
colorPerVertex [colorPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Color|ColorRGBA values are applied to each point vertex (true) or to each polygon face (false).
Warning: if child Color|ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
Hint: X3D Scene Authoring Hints, Color http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
normalPerVertex [normalPerVertex accessType initializeOnly, type SFBool (true|false) "true"]
Whether Normal node vector values are applied to each point vertex (true) or to each polygon face (false).
Hint: if no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
solid [solid accessType initializeOnly, type SFBool (true|false) "true"]
Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
Warning: default value true can completely hide geometry if viewed from wrong side!
Hint: if in doubt, use solid='false' for maximum visibility.
containerField [containerField type NMTOKEN "geometry"]
containerField is a field-label prefix indicating this node's field relationship to its parent node, for example <Transform><Shape containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases, so the need to override default containerField values is rare.
Hint: example values include containerField='geometry' for Box node, containerField='children' for Group node, containerField='proxy' for hidden proxy shape within a Collision node, etc.
Hint: containerField attribute is part of XML encoding for X3D scenes, and corresponds to the always-declared field labels in the ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#containerField
class [class type CDATA #IMPLIED]
The class attribute is a space-separated list of classes, reserved for use by CSS cascading stylesheets.
Warning: currently the class attribute is only supported in XML encoding of X3D scenes.
Hint: W3C Cascading Style Sheets https://www.w3.org/Style/CSS
  accessType and type   Credits and Translations   X3D Resources   to top
Inline Inline Inline can load another X3D or VRML model into the current scene via url. Inline is an X3DBoundedObject node that has bounding-box dimensions.
Hint: you cannot ROUTE values into an Inline scene, use IMPORT/EXPORT (or ExternProtoDeclare and ProtoInstance) instead.
Hint: X3D Scene Authoring Hints, Inlines and Prototypes http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#InlinesPrototypes
Hint: apply containerField='watchList' when parent node is LoadSensor.
Search
mail lists or
Mantis issues
X3D validation:
XML Schema, DOCTYPE, JSON Schema, Java SAI, X3DJSAIL
DEF [DEF type ID #IMPLIED]
DEF defines a unique ID name for this node, referenceable by other nodes.
Hint: descriptive DEF names improve clarity and help document a model.
Hint: well-defined names can simplify design and debugging through improved author understanding.
Hint: X3D Scene Authoring Hints, Naming Conventions http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions
USE [USE type IDREF #IMPLIED]
USE means reuse an already DEF-ed node ID, excluding all child nodes and all other attributes (except for containerField, which can have a different value).
Hint: USE references to previously defined DEF geometry (instead of duplicating nodes) can improve performance.
Warning: do NOT include any child nodes, a DEF attribute, or any other attribute values (except for containerField) when defining a USE attribute.
Warning: each USE value must match a corresponding DEF value that is defined earlier in the scene.
load [load accessType inputOutput, type SFBool (true|false) "true"]
load=true means load immediately, load=false means defer loading or unload contained scene.
Hint: use LoadSensor to detect when loading is complete.
url [url accessType inputOutput, type MFString CDATA #IMPLIED]
Address of X3D world to load into current scene.
Hint: MFString arrays can have multiple values, so separate each individual string by quote marks "http://www.web3d.org" "http://www.web3d.org/about" "etc."
Hint: alternative XML encoding for quotation mark " is &quot; (which is an example of a character entity).
Warning: strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https url addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
Hint: can replace embedded blank(s) in url queries with %20 for each blank character.
Hint: X3D Scene Authoring Hints, urls http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls
bboxCenter [bboxCenter accessType initializeOnly, type SFVec3f CDATA "0 0 0"]
Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
Hint: X3D Architecture, 10.2.2 Bounding boxes http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/group.html#BoundingBoxes
bboxSize [bboxSize accessType initializeOnly, type SFVec3f CDATA "-1 -1 -1"]
Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
Hint: can be useful for collision computations or inverse-kinematics (IK) engines.
Hint: precomputation and inclusion of bounding box information can speed u