Post

EnvironmentLight

EnvironmentLight

Overview

EnvironmentLight is a light node for PhysicalMaterial and SpecularGlossinessMaterial nodes.

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 future versions of X_ITE. This node only affects the PhysicalMaterial and SpecularGlossinessMaterial nodes.

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 (-∞,∞)

Input/Output field rotation.

SFNode [in, out] diffuseTexture NULL [X3DEnvironmentTextureNode]

Input/Output field diffuseTexture.

MFFloat [in, out] diffuseCoefficients [ ]

Input/Output field diffuseCoefficients.

SFNode [in, out] specularTexture NULL [X3DEnvironmentTextureNode]

Input/Output field specularTexture.

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.