Post

EnvironmentLight

Overview

EnvironmentLight …

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

Info: Please note that this node is still experimental, i.e. the functionality of this node may change in the future. This node is available in X_ITE.

Hierarchy

1
2
3
4
+ X3DNode
  + X3DChildNode
    + X3DLightNode
      + EnvironmentLight

Fields

SFNode [in, out] metadata NULL [X3DMetadataObject]

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

Hint

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.

Warning

  • DirectionalLight default global=false to limit scope and avoid inadvertently illuminating every object in a large scene. PointLight and SpotLight default global=true since their effects are each limited by maximum radius value.

SFBool [in, out] on TRUE

Enables/disables this light source.

SFColor [in, out] color 1 1 1 [0,1]

color of light, applied to colors of objects.

Hint

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

Brightness of direct emission from the light.

SFFloat [in, out] ambientIntensity 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.

SFRotation [in, out] rotation 0 0 1 0 [-1,1] or (-∞,∞)

SFNode [in, out] diffuseTexture NULL [X3DEnvironmentTextureNode]

MFFloat [in, out] diffuseCoefficients [ ]

SFNode [in, out] specularTexture NULL [X3DEnvironmentTextureNode]

SFBool [in, out] shadows FALSE

shadows field indicates whether or not this light casts a shadow behind illuminated X3DShapeNode geometry.

SFColor [in, out] shadowColor 0 0 0 [0,1] non standard

Color of shadow, applied to colors of objects.

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

shadowIntensity field defines how much light is obscured by shapes that cast shadows, ranging from 0 (light not obscured, no visible shadows) to 1 (light completely obscured, full-intensity shadows).

SFFloat [in, out] shadowBias 0.005 [0,1] non standard

The shadowBias value controls the visibility of shadow acne.

SFInt32 [ ] shadowMapSize 1024 [0,∞) non standard

Size of the shadow map in pixels, must be power of two.

See Also

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