CollisionSpace holds collection of objects considered together for resolution of inter-object collisions. Contains multiple CollidableShape, CollidableOffset, or CollisionSpace nodes (containerField='collidables').

The CollisionSpace node belongs to the RigidBodyPhysics component and requires at least level 1, its default container field is children. It is available from X3D version 3.2 or higher.


+ X3DNode
  + X3DNBodyCollisionSpaceNode (X3DBoundedObject)*
    + CollisionSpace

* Derived from multiple interfaces.


SFNode [in, out] metadata NULL [X3DMetadataObject]

Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.


SFBool [in, out] enabled TRUE

Enables/disables node operation.

SFBool [in, out] useGeometry FALSE

useGeometry indicates whether collision-detection code checks down to level of geometry, or only make approximations using geometry bounds.


  • Testing against object bounds is usually sufficient.


  • Using geometry is more accurate but slower.

SFBool [in, out] visible TRUE

Whether or not renderable content within this node is visually displayed.


  • The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
  • Content must be visible to be collidable and to be pickable.

SFBool [in, out] bboxDisplay FALSE

Whether to display bounding box for associated geometry, aligned with world coordinates.


  • The bounding box is displayed regardless of whether contained content is visible.

SFVec3f [ ] bboxSize -1 -1 -1 [0,∞) or −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.


  • Can be useful for collision computations or inverse-kinematics (IK) engines.
  • Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
  • X3D Architecture, 10.2.2 Bounding boxes /Part01/components/grouping.html#BoundingBoxes
  • X3D Architecture, 10.3.1 X3DBoundedObject /Part01/components/grouping.html#X3DBoundedObject

SFVec3f [ ] bboxCenter 0 0 0 (-∞,∞)

Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.


MFNode [in, out] collidables [ ] [X3DNBodyCollisionSpaceNode,X3DNBodyCollidableNode]

Collection of collidable objects as well as nested CollisionSpace collections



  • Content must be visible to be collidable and to be pickable.

See Also

This post is licensed under CC BY 4.0 by the author.