instantreality 1.0

Component:
EnvironmentalEffects
Status:
fully implemented
Structure type:
concrete
Standard:
Avalon

PolygonBackground

A Background that renders a single polygon using the specified material.

Inheritance

Code

XML encoding
<PolygonBackground positions='0 0, 1 0, 1 1, 0 1'
texCoords='0 0 0, 1 0 0, 1 1 0, 0 1 0'
normalizedX='TRUE'
normalizedY='TRUE'
fixedImageSize='0,0'
zoomFactor='1.0'
tile='TRUE'
doCleanup='TRUE'
mode='VERTICAL'
clearStencilBitplanes='-1'
isDefault='FALSE'
description=''
triggerName='Synchronize'
logFeature=''
 />
Classic encoding
PolygonBackground {
	positions [0 0, 1 0, 1 1, 0 1]
	texCoords [0 0 0, 1 0 0, 1 1 0, 0 1 0]
	normalizedX TRUE
	normalizedY TRUE
	fixedImageSize 0,0
	zoomFactor 1.0
	tile TRUE
	doCleanup TRUE
	mode "VERTICAL"
	clearStencilBitplanes -1
	isDefault FALSE
	description ""
	triggerName "Synchronize"
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
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
MFVec2f positions MFVec2f inputOutput 0 0, 1 0, 1 1, 0 1 The positions of the polygon to display. Default is a screen-filling quad.
MFVec3f texCoords MFVec3f inputOutput 0 0 0, 1 0 0, 1 1 0, 0 1 0 Texture coordinates for the polygon.
SFBool doCleanup SFBool inputOutput TRUE Clear depth (and stencil) buffer after applying the material.
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))
SFBool normalizedX SFBool inputOutput TRUE Define whether the x coordinates are normalized (0-1) or pixel-based .
SFBool normalizedY SFBool inputOutput TRUE Define whether the y coordinates are normalized (0-1) or pixel-based .
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
SFBool tile SFBool inputOutput TRUE If true the background tiles in multi window settings.
SFFloat zoomFactor SFFloat inputOutput 1.0 Zooming factor for scaling background image.
SFInt32 clearStencilBitplanes SFInt32 inputOutput -1 Usually 0 is used to clear all stencil bitplanes (clear is deactivated if smaller zero).
SFNode appearance SFNode inputOutput Appearance The appearance used to render the polygon.
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element
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)
SFString mode SFString inputOutput VERTICAL [VERTICAL, HORIZONTAL, SMALLER] Defines whether the backgound texture fits vertically, horizontally or in the smaller direction. Only takes effect if fixedImageSize is set.
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 bindTime SFTime outputOnly Event sent when node becomes active/inactive.
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.
SFVec2f fixedImageSize SFVec2f inputOutput 0,0 Useful for keeping aspect ratio when rendering things like images by defining (width, height).
XFAny bind XFAny inputOnly sending any event to this slot will bind/activate the Bindable