Post

TextureProjector

Posted Updated
By CREATE3000
3 min read

Overview

TextureProjector is similar to a light that projects a texture into the scene, illuminating geometry that intersects the perspective projection volume.

The TextureProjector node belongs to the TextureProjection component and requires at least level 2, its default container field is children. It is available from X3D version 4.0 or higher.

Hierarchy

1
2
3
4
5

+ X3DNode
  + X3DChildNode
    + X3DLightNode
      + X3DTextureProjectorNode
        + TextureProjector

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

SFString [in, out] description “”

Author-provided prose that describes intended purpose of the url asset.

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).

SFBool [in, out] global TRUE

Global texture projection illuminates all objects within their volume of influence. Scoped texture projection (global false) only illuminates objects within the same transformation hierarchy.

SFBool [in, out] on TRUE

Enables/disables this texture projection 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.

SFVec3f [in, out] location 0 0 0 (-∞,∞)

Position of center of texture projection relative to local coordinate system.

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

Direction for projection.

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

upVector describes the roll of the camera by saying which direction is up for the camera’s orientation.

SFFloat [in, out] fieldOfView π/4 (0,π)

Preferred minimum viewing angle for this projection in radians, providing minimum height or minimum width (whichever is smaller). Small field of view roughly corresponds to a telephoto lens, large field of view roughly corresponds to a wide-angle lens.

Warning

SFFloat [in, out] nearDistance -1 -1 or (0,∞)

Minimum distance necessary for texture display.

SFFloat [in, out] farDistance -1 -1 or (0,∞)

Maximum distance necessary for texture display.

SFFloat [out] aspectRatio

aspectRatio is the ratio of width and height that is projected.

SFNode [in, out] texture NULL [X3DTexture2DNode]

Single contained texture node (ImageTexture, MovieTexture, PixelTexture, MultiTexture) that maps image(s) to surface geometry.

Hints

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.

Hints

Advice

Hint

  • Https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Images/ptmperspective.png

Warning

  • Add textureTransform field?

Example

See Also

TextureProjection

components, TextureProjection
TextureProjection TextureProjector
This post is licensed under CC BY 4.0 by the author.