instantreality 1.0

Component:
Engine
Status:
fully implemented
Structure type:
abstract
Standard:
X3D3.2

Viewarea (alias: StandardViewarea)

A Viewarea is a rectangular area in the window

Inheritance

Code

XML encoding
<Viewarea enabled='TRUE'
view=''
background=''
foreground=''
environment=''
user=''
fog=''
lowerLeft='0 0'
upperRight='1 1'
description=''
grabFrames='0'
grabFile='frame%04d.png'
statisticLevel='0'
keyPress='0'
keyRelease='0'
mousePress='0'
mouseRelease='0'
mouseMove='0 0'
logFeature=''
 />
Classic encoding
Viewarea {
	enabled TRUE
	view [""]
	background [""]
	foreground [""]
	environment [""]
	user [""]
	fog [""]
	lowerLeft 0 0
	upperRight 1 1
	description ""
	grabFrames 0
	grabFile "frame%04d.png"
	statisticLevel 0
	keyPress 0
	keyRelease 0
	mousePress 0
	mouseRelease 0
	mouseMove 0 0
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
SFBool enabled SFBool inputOutput TRUE If FALSE, rendering is disabled
MFString view MFString inputOutput Names of viewpoint objects that should be used on this viewarea. If no name is given, the currently bound viewpoint is used. If more than one name is given, the first valid viewpoint is used.
MFString background MFString inputOutput Names of background objects that should be used on this viewarea. If no name is given, the currently bound background is used. If more than one name is given, the first valid backgound is used
MFString foreground MFString inputOutput Names of foreground objects that should be used on this viewarea. If no name is given, the currently bound foreground is used. If more than one name is given, the first valid foreground is used
MFString environment MFString inputOutput Names of environment objects that should be used on this viewarea. If no name is given, the currently bound background is used. If more than one name is given, the first valid environment is used
MFString user MFString inputOutput Names of user bindable objects that should be used on this viewarea. If no name is given, the currently bound user is used. If more than one name is given, the first valid user is used
MFString fog MFString inputOutput Names of fog bindable objects that should be used on this viewarea. If no name is given, the currently bound fog is used. If more than one name is given, the first valid fog is used
SFVec2f lowerLeft SFVec2f inputOutput 0 0 Lower left corner of the viewarea. Values less or equal then 1 are treated as relative values. If values are greater then 1, the values are treated as number of pixels
SFVec2f upperRight SFVec2f inputOutput 1 1 Upper right corner of the viewarea. Values less or equal then 1 are treated as relative values. If values are greater then 1, the values are treated as number of pixels
SFString description SFString inputOutput Textual description of this viewarea
SFInt32 grabFrames SFInt32 inputOutput 0 If value positive, 'value' rendered images are grabed and written into a file given by grabFile, if value=-1, grabbing is always done, if 0, it is disabled.
SFString grabFile SFString inputOutput frame%04d.png Filename that should be used to save grabed images. A sequence number can be used with the sprintf %d operator.
SFInt32 statisticLevel SFInt32 inputOutput 0 Statistics level
MFNode modifier MFNode initializeOnly ViewModifier Modifiers are used to add additional features to the viewing matrix. This is used for tiled displays or other complex projections.
SFNode navigator SFNode inputOutput Navigator Navigator object used for user interaction
SFInt32 keyPress SFInt32 inputOutput 0 Key press event output
SFInt32 keyRelease SFInt32 inputOutput 0 Key release event output
SFInt32 mousePress SFInt32 inputOutput 0 Mouse button press event output
SFInt32 mouseRelease SFInt32 inputOutput 0 Mouse button release event output
SFVec2f mouseMove SFVec2f inputOutput 0 0 Mouse move event. Gives the position of the mouse in 2D window space
SFBool mouseOver SFBool inputOnly FALSE Emits true, if mouse points to a pointing sensor
MFVec4f touchPoints MFVec4f outputOnly Touch points (x, y, id, button state) with button press 0, release 1, move 2.
SFString message SFString outputOnly Message to be processed. Valid messages are: toggleFullScreen toggleHeadlight toggleGlobalShadow nextShadowMode toggleLazyInteractionEvalution toggleDrawVolume toggleCullFrustum toggleCullOcclusion nextDrawMode pointDrawMode lineDrawMode fillDrawMode nextInfoScreen firstView lastView nextView prevView resetViewPosition showAll walkNav flyNav freeFlyNav examineNav lookatNav noneNav forward backward left right exportBackendASC exportBackendBIN exit
MFNode displayFilter MFNode inputOutput DisplayFilter Holds all optional display filter nodes
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