Titania X3D Editor

Bring Colours to Your Life.

Titania v4.0.1

Bring Colours to Your Life.

X3D Reference

TextureBackground

TextureBackground

TextureBackground simulates ground and sky, using vertical arrays of wraparound color values, TextureBackground can also provide backdrop texture images on all six sides.

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

Hierarchy

Fields

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] set_bind

Input event set_bind=true makes this node active, input event set_bind=false makes this node inactive. Thus setting set_bind true/false will pop/push (enable/disable) this node.

MFFloat [in, out] skyAngle [ ] [0,π]

The angle array values increase from 0.0 zenith (straight up) to π/2=1.570796 (horizon) to π=3.14159 (nadir).

Warnings

You must have one more skyColor value than skyAngle values. Colors at skyAngle=0 are ignored. Interchange profile hint: this field may be ignored, applying the default value regardless.

MFColor [in, out] skyColor 0 0 0 [0,1]

Color of the sky at various angles on the sky sphere. First value is color of sky at 0.0 radians representing the zenith (straight up).

Hint

Setting the same color at two consecutive angles produces a solid color band.

Warning

You must have one more skyColor value than skyAngle values. Interchange profile hint: only one color might be rendered, others can be ignored.

See Also

X3D Scene Authoring Hints, Color

MFFloat [in, out] groundAngle [ ] [0,π/2]

The angle array values increase from 0.0 nadir (straight down) to π/2=1.570796 (horizon).

Warnings

You must have one more groundColor value than groundAngle values. Colors at groundAngle=0 are ignored. Interchange profile hint: this field may be ignored, applying the default value regardless.

MFColor [in, out] groundColor [ ] [0,1]

Color of the ground at the various angles on the ground partial sphere. First value is color of ground at 0.0 radians representing the nadir (straight down).

Hint

Setting the same color at two consecutive angles produces a solid color band.

Warning

You must have one more groundColor value than groundAngle values. Interchange profile hint: this field may be ignored, applying the default value regardless.

See Also

X3D Scene Authoring Hints, Color

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

Transparency applied to texture images, enabling an X3D scene to overlay an HTML page or desktop.

SFBool [out] isBound

Event true sent when node becomes active, event false sent when unbound by another node.

SFTime [out] bindTime

Event sent when node becomes active/inactive.

SFNode [in, out] frontTexture NULL [X3DTexture2DNode,MultiTexture]

Input/Output field frontTexture.

SFNode [in, out] backTexture NULL [X3DTexture2DNode,MultiTexture]

Input/Output field backTexture.

SFNode [in, out] leftTexture NULL [X3DTexture2DNode,MultiTexture]

Input/Output field leftTexture.

SFNode [in, out] rightTexture NULL [X3DTexture2DNode,MultiTexture]

Input/Output field rightTexture.

SFNode [in, out] topTexture NULL [X3DTexture2DNode,MultiTexture]

Input/Output field topTexture.

SFNode [in, out] bottomTexture NULL [X3DTexture2DNode,MultiTexture]

Input/Output field bottomTexture.

Description

Hints

  • NavigationInfo, Background, TextureBackground, Fog, OrthoViewpoint and Viewpoint are bindable nodes, meaning that no more than one of each node type can be active at a given time.
  • Authors can have LoadSensor nodes receive notification when background texture node(s) are loaded.

Warnings

  • Results are undefined if a bindable node (Viewpoint, OrthoViewpoint, NavigationInfo, Fog, Background, TextureBackground) is a contained child of LOD or Switch.
  • Child ImageTexture nodes must have unique containerField values for backTexture, bottomTexture, frontTexture, leftTexture, rightTexture, or topTexture.

Browser Compatibility

Titania X_ITE
yes yes

External Links