instantreality 1.0

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

Switch

Switch is a Grouping node that only renders one (or zero) child at a time. Switch can contain most nodes. (Contained nodes are now called 'children' rather than 'choice', for consistent naming among all GroupingNodeType nodes.) All child choices continue to receive and send events regardless of whichChoice is active. Hint: insert a Shape node before adding geometry or Appearance. Hint: authors can temporarily hide test geometry under an unselected child of a Switch. This is a good alternative to 'commenting out' nodes.

Inheritance

Code

XML encoding
<Switch whichChoice='-1'
cycle='TRUE'
bboxCenter='0 0 0'
bboxSize='-1 -1 -1'
render='TRUE'
showBBox='FALSE'
logFeature=''
 />
Classic encoding
Switch {
	whichChoice -1
	cycle TRUE
	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
SFInt32 whichChoice SFInt32 inputOutput -1 Index of active child choice, counting from 0. Warning: default whichChoice= -1 means no selection (and no rendering), whichChoice=0 means initial child.
MFNode children MFNode inputOutput Node field that contains a list of children nodes
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 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
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.
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element