instantreality 1.0

Component:
Navigation
Status:
fully implemented
Structure type:
concrete
Standard:
X3D2.0

Billboard

Billboard is a Grouping node that can contain most nodes. Content faces the user, rotating about the specified axis. Set axisOfRotation=0 0 0 to fully face the user's camera. Hint: Put Billboard as close to the geometry as possible, nested inside Transform for local coordinate system. Hint: don't put Viewpoint inside a Billboard. Hint: insert a Shape node before adding geometry or Appearance.

Inheritance

Code

XML encoding
<Billboard enabled='TRUE'
axisOfRotation='0 1 0'
focusOnCamera='TRUE'
alignToScreen='FALSE'
minAngle='0'
maxAngle='-1'
bboxCenter='0 0 0'
bboxSize='-1 -1 -1'
render='TRUE'
showBBox='FALSE'
logFeature=''
 />
Classic encoding
Billboard {
	enabled TRUE
	axisOfRotation 0 1 0
	focusOnCamera TRUE
	alignToScreen FALSE
	minAngle 0
	maxAngle -1
	bboxCenter 0 0 0
	bboxSize -1 -1 -1
	render TRUE
	showBBox FALSE
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
MFNode addChildren MFNode inputOnly The addChildren event appends nodes to the children field of a grouping node. Any nodes passed to the addChildren inputOnly field that are already in the children list of the grouping node are ignored
MFNode children MFNode inputOutput Node field that contains a list of children nodes
MFNode removeChildren MFNode inputOnly The removeChildren event removes nodes from the children fieldof the grouping node . Any nodes in the removeChildren event that are not in the children list of the grouping node are ignored
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
SFBool alignToScreen SFBool inputOutput FALSE This flag is only evaluated if axisOfRotation is the zero vector. If true, the viewVec is also used in the rotation calculation.
SFBool enabled SFBool inputOutput TRUE Enables/disables billboarding for children and all descendants.
SFBool focusOnCamera SFBool inputOutput TRUE This flag is only evaluated if axisOfRotation is the zero vector. If true, a rotation towards the camera is calculated.
SFBool render SFBool inputOutput TRUE Flag to control the visibility of the node or subtree
SFBool showBBox SFBool inputOutput FALSE Show Bounding Box of Subtree.
SFFloat maxAngle SFFloat inputOutput -1 Clamps rotation to maxAngle; only evaluated if minAngle less or equal than maxAngle.
SFFloat minAngle SFFloat inputOutput 0 Clamps rotation to minAngle; only evaluated if minAngle less or equal than maxAngle.
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element
SFVec3f axisOfRotation SFVec3f inputOutput 0 1 0 axisOfRotation direction is relative to local coordinate system. Hint: axis 0 0 0 always faces viewer.
SFVec3f bboxCenter SFVec3f initializeOnly 0 0 0 Bounding box center: position offset from origin of local coordinate system.
SFVec3f bboxSize SFVec3f initializeOnly -1 -1 -1 Bounding box size: automatically calculated, can be specified as an optimization or constraint.