Titania X3D Editor

It starts with you!

Titania v3.0.4

It starts with you!

X3D Reference



DirectionalLight creates parallel light rays to illuminate geometric shapes. Light is scoped and only illuminates geometry within its enclosing parent group! 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 shine through occluding geometry.

The DirectionalLight node belongs to the Lighting component and its container field is children. It is available since X3D version 3.0 or later.



SFNode [in, out] metadata NULL [X3DMetadataObject]

Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.

SFBool [in, out] global FALSE

Global lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.

SFBool [in, out] on TRUE

Enables/disables this light source.

SFFloat [in, out] intensity 1 [0,1]

Brightness of direct emission from the light.

SFFloat [in, out] ambientIntensity [0,1]

Brightness of ambient (nondirectional background) emission from the light. Interchange profile hint: this field may be ignored, applying the default value regardless.

SFVec3f [in, out] direction 0 0 -1 (-∞,∞)

Orientation vector of light relative to local coordinate system.


Animate direction to simulate time-of-day sunlight effects.

SFColor [in, out] shadowColor 0 0 0

Input/Output field shadowColor.

SFFloat [in, out] shadowIntensity

Input/Output field shadowIntensity.

SFFloat [in, out] shadowDiffusion

Input/Output field shadowDiffusion.

SFInt32 [ ] shadowMapSize 1024

Field shadowMapSize.



  • Animate direction to simulate time-of-day sunlight effects.
  • HeadLight enabled on/off is controlled by NavigationInfo. Interchange profile hint: light might not be scoped by parent Group or Transform.

Browser Compatibility

Titania X_ITE
yes yes

External Links