instantreality 1.0

Component:
EnvironmentalEffects
Status:
fully implemented
Structure type:
concrete
Standard:
X3D3.0

TextureBackground

TextureBackground simulates ground and sky, using vertical arrays of wraparound color values, TextureBackground can also provide backdrop texture images on all six sides. Field names of child texture nodes are in alphabetic order: backTexture, bottomTexture, frontTexture, leftTexture, rightTexture, topTexture. Background, Fog, NavigationInfo, TextureBackground and Viewpoint are bindable nodes.

Inheritance

Code

XML encoding
<TextureBackground groundAngle=''
groundColor=''
skyAngle=''
skyColor='0 0 0'
groundTransparency=''
skyTransparency=''
transparency='0'
panoramaAtFront='TRUE'
clearStencilBitplanes='-1'
isDefault='FALSE'
description=''
triggerName='Synchronize'
logFeature=''
 />
Classic encoding
TextureBackground {
	groundAngle []
	groundColor []
	skyAngle []
	skyColor [0 0 0]
	groundTransparency []
	skyTransparency []
	transparency 0
	panoramaAtFront TRUE
	clearStencilBitplanes -1
	isDefault FALSE
	description ""
	triggerName "Synchronize"
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
SFNode backTexture SFNode inputOutput SingleTexture texture for the backside of the SkyBox
XFAny bind XFAny inputOnly sending any event to this slot will bind/activate the Bindable
SFTime bindTime SFTime outputOnly Event sent when node becomes active/inactive.
SFNode bottomTexture SFNode inputOutput SingleTexture texture for the bottom of the SkyBox
SFInt32 clearStencilBitplanes SFInt32 inputOutput -1 Usually 0 is used to clear all stencil bitplanes (clear is deactivated if smaller zero).
SFString description SFString initializeOnly Text description or navigation hint to be displayed for this Bindable. Hint: make descriptions clear and readable. Warning: without description, Bindable (e.g. Viewpoint objs) can not be activated/deactivated with keyboard or gui messages (e.g. switched with PgUp bzw PgDn)
SFNode frontTexture SFNode inputOutput SingleTexture texture for the frontside of the SkyBox
MFFloat groundAngle MFFloat inputOutput [0, pi/2] The angle values increase from 0.0 nadir (straight down) to /2=1.5708 (horizon). Warning: you must have one more groundColor value than groundAngle values. Warning: colors at groundAngle=0 are ignored. Interchange profile hint: this field may be ignored.
MFColor groundColor MFColor inputOutput 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). Warning: you must have one more groundColor value than groundAngle values. Interchange profile hint: this field may be ignored.
MFFloat groundTransparency MFFloat inputOutput [0, 1] transparency values corresponding to the groundColors
SFBool isBound SFBool outputOnly FALSE Event true sent when node becomes active, event false sent when unbound by another node.
SFBool isDefault SFBool initializeOnly FALSE indicates if the object is the default bindable or not (generated if the scene did not contain any Bindable of a missing Type (e.g. Viewpoint))
SFNode leftTexture SFNode inputOutput SingleTexture texture for the left side of the SkyBox
MFString logFeature MFString inputOutput state, child, parent, route, eventIn, eventOut controls the logging of changes, state: log state changes (e.g. live), child: log child add/remove, parent: log parent add/remove, route: log route add/remove; eventIn: log receiving of events, eventOut: log sending of events: guiView, runtime system should create node-view, guiEdit: runtime system should create node-editeverything: log everything
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element
SFBool panoramaAtFront SFBool inputOutput TRUE future-option...sets the boxInside field of the underlying OpenSG-SkyBackground...which is never used anywhere!?
SFNode rightTexture SFNode inputOutput SingleTexture texture for the right side of the SkyBox
SFBool set_bind SFBool inputOnly Sending event set_bind=true makes this node active. Sending event set_bind=false makes this node inactive. Thus setting set_bind to true/false will pop/push (enable/disable) this Bindable
MFFloat skyAngle MFFloat inputOutput [0, pi] The angle values increase from 0.0 zenith (straight up) to /2=1.57 (horizon) to =3.14159 (nadir). Warning: you must have one more skyColor value than skyAngle values. Warning: colors at skyAngle=0 are ignored. Interchange profile hint: this field may be ignored.
MFColor skyColor MFColor inputOutput 0 0 0 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). Warning: you must have one more skyColor value than skyAngle values. Interchange profile hint: only one color might be rendered, others can be ignored.
MFFloat skyTransparency MFFloat inputOutput [0, 1] transparency values corresponding to the skyColors
SFNode topTexture SFNode inputOutput SingleTexture texture for the top of the SkyBox
SFFloat transparency SFFloat inputOutput 0 [0, 1] transparency applied to sky and ground spheres.
SFString triggerName SFString initializeOnly Synchronize name of the dynamic context-slot which is used by the run-time environment (e.g. Jobs) to trigger the node. Life-Nodes will automatically connect the context-eventOutut to the triggerSlot-eventInput Slot.
SFTime triggerSlot SFTime inputOnly slot which is used internally to connect a dynamic context-slot which name is set by the triggerName value. Its used automatically to install run-time environment trigger.