CyclesViewarea
Base for all cycles viewareas.
Inheritance
Code
XML encoding
<CyclesViewarea cyclesEnabled='TRUE' cyclesPaused='FALSE' deviceId='0' ignoreViewModifiers='FALSE' renderWindowTile='FALSE' overrideZNearFar='1e-5 1e5' red='TRUE' green='TRUE' blue='TRUE' alpha='TRUE' leftBuffer='TRUE' rightBuffer='TRUE' 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
CyclesViewarea { cyclesEnabled TRUE cyclesPaused FALSE deviceId 0 ignoreViewModifiers FALSE renderWindowTile FALSE overrideZNearFar 1e-5 1e5 red TRUE green TRUE blue TRUE alpha TRUE leftBuffer TRUE rightBuffer TRUE 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 |
---|---|---|---|---|---|---|
displayFilter | MFNode | inputOutput | DisplayFilter | Holds all optional display filter nodes | ||
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. | ||
targetTextures | MFNode | inputOutput | SingleTexture | The textures to render to. Hint: Use a SolidTexture.First entry is the output buffer (the displayed image), specialized nodes may expose additional buffers. | ||
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 | |||
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 | |||
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 | |||
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 | |||
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 | ||
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 | |||
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. | |||
touchPoints | MFVec4f | outputOnly | Touch points (x, y, id, button state) with button press 0, release 1, move 2. | |||
alpha | SFBool | inputOutput | TRUE | If FALSE, the alpha color component is removed. | ||
blue | SFBool | inputOutput | TRUE | If FALSE, the blue color component is removed. | ||
cyclesEnabled | SFBool | inputOutput | TRUE | Enable rendering with cycles. If false, the default (rasterization) renderer is used. | ||
cyclesPaused | SFBool | inputOutput | FALSE | Pause rendering with cycles. Rendering can be resumed from where it left off by setting this to false again. | ||
enabled | SFBool | inputOutput | TRUE | If FALSE, rendering is disabled | ||
green | SFBool | inputOutput | TRUE | If FALSE, the green color component is removed. | ||
ignoreViewModifiers | SFBool | inputOutput | FALSE | If true, view modifiers are ignored. Currently CyclesViewarea does not support off-center projection, so most of the modifiers won't work correctly. If you experience problems you can at least get the 'default' camera back with this field. This _only_ applies to rendering with Cycles (cyclesEnabled==true), the rasterization bypass is not affected! | ||
leftBuffer | SFBool | inputOutput | TRUE | If TRUE, rendering is done to the view buffer for the left eye | ||
mouseOver | SFBool | inputOnly | FALSE | Emits true, if mouse points to a pointing sensor | ||
red | SFBool | inputOutput | TRUE | If FALSE, the red color component is removed. | ||
renderWindowTile | SFBool | inputOutput | FALSE | If true, this Viewarea is regarded as a tile of the parent window. The camera is interpreted with respect to the whole window, but only the Viewarea is rendered. This enables a basic version of tiled rendering, even though TileViewModifier does not work. If false, the Viewarea is regarded as 'independent'. The camera is interpreted with respect to the Viewarea. This interplays with ignoreViewModifiers. This _only_ applies to rendering with Cycles (cyclesEnabled==true), the rasterization bypass is not affected! | ||
rightBuffer | SFBool | inputOutput | TRUE | If TRUE, rendering is done to the view buffer for the right eye | ||
deviceId | SFInt32 | inputOutput | 0 | Device id to use. 0 is usually the CPU and always present, CUDA and OpenCL devices have higher ids. | ||
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. | ||
keyPress | SFInt32 | inputOutput | 0 | Key press event output | ||
keyRelease | SFInt32 | inputOutput | 0 | Key release event output | ||
mousePress | SFInt32 | inputOutput | 0 | Mouse button press event output | ||
mouseRelease | SFInt32 | inputOutput | 0 | Mouse button release event output | ||
statisticLevel | SFInt32 | inputOutput | 0 | Statistics level | ||
cameraOptions | SFNode | inputOutput | CyclesCameraOptions | A CyclesCameraOptions node that controls the camera associated with this Viewarea. | ||
filmOptions | SFNode | inputOutput | CyclesFilmOptions | A CyclesFilmOptions node that controls the film associated with this Viewarea. | ||
integratorOptions | SFNode | inputOutput | CyclesIntegratorOptions | A CyclesIntegratorOptions node that controls the integrator associated with this Viewarea. | ||
metadata | SFNode | inputOutput | MetadataObject | container for payload metadata inside MetadataSet element | ||
navigator | SFNode | inputOutput | Navigator | Navigator object used for user interaction | ||
sceneOptions | SFNode | inputOutput | CyclesSceneOptions | A CyclesSceneOptions node that controls the scene associated with this Viewarea. | ||
sessionOptions | SFNode | inputOutput | CyclesSessionOptions | A CyclesSessionOptions node that controls the session associated with this Viewarea. | ||
description | SFString | inputOutput | Textual description of this viewarea | |||
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. | ||
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 | |||
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 | ||
mouseMove | SFVec2f | inputOutput | 0 0 | Mouse move event. Gives the position of the mouse in 2D window space | ||
overrideZNearFar | SFVec2f | inputOutput | 1e-5 1e5 | If larger than 0 overrides Viewpoint's zNear/zFar values (if rendering with Cycles). Per default the override is active, because the automatic adaption of zNear/zFar causes problems in Cycles. If all Viewpoints have explicit zNear/zFar values the override can be deactivated by setting (-1,-1). | ||
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 |