instantreality 1.0

Component:
Navigation
Status:
partly implemented
Structure type:
concrete
Standard:
Avalon

CinematographicViewpoint

The CinematographicViewpoint is a specialized Camera for handling cinematographic requests like the notion of line of action or rule of thirds.

Inheritance

Code

XML encoding
<CinematographicViewpoint facingDir='0 0 1'
minScreenPos=''
maxScreenPos=''
shotSize='auto'
shotAngle='0'
shotPitch='0'
shotRoll='0'
follow='none'
fieldOfView='0.785398'
fovMode='SMALLER'
aspect='1.0'
centerOfRotation='0 0 0'
orientation='0 0 1 0'
position='0 0 10'
upVector='0 1 0'
zNear='-1'
zFar='-1'
jump='TRUE'
retainUserOffsets='FALSE'
isDefault='FALSE'
description=''
triggerName='Synchronize'
logFeature=''
 />
Classic encoding
CinematographicViewpoint {
	facingDir 0 0 1
	minScreenPos []
	maxScreenPos []
	shotSize "auto"
	shotAngle 0
	shotPitch 0
	shotRoll 0
	follow "none"
	fieldOfView 0.785398
	fovMode "SMALLER"
	aspect 1.0
	centerOfRotation 0 0 0
	orientation 0 0 1 0
	position 0 0 10
	upVector 0 1 0
	zNear -1
	zFar -1
	jump TRUE
	retainUserOffsets FALSE
	isDefault FALSE
	description ""
	triggerName "Synchronize"
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
MFNode objectsFull MFNode inputOutput For full view on actors. Also used for calculating the Line of Action.
MFNode objectsCloseUp MFNode inputOutput For close up view on actors.
SFVec3f facingDir SFVec3f inputOutput 0 0 1 Usually the local facing direction of an object is along z-axis, but modelling tools may have exported differently.
MFVec2f minScreenPos MFVec2f inputOutput Minimum bbox position of actor in normalized screen coords.
MFVec2f maxScreenPos MFVec2f inputOutput Maximum bbox position of actor in normalized screen coords.
SFString shotSize SFString inputOutput auto [auto, extremeLong, long, full, mediumFull, medium, mediumClose, close, wideCloseup, closeup, mediumCloseup, extremeCloseup] Shot sizes to be used (alternatively to screenPos for first actor).
SFFloat shotAngle SFFloat inputOutput 0 Angle offset from the line of action.
SFFloat shotPitch SFFloat inputOutput 0 Angle offset to horizontal plane.
SFFloat shotRoll SFFloat inputOutput 0 Roll is not commonly used for cameras...
SFString follow SFString inputOutput none [none, onlyPos, onlyOrient, all] If not 'none', the camera tries to continously follow the actors (pose can be restricted to position or orientation).
SFString fovMode SFString initializeOnly SMALLER [VERTICAL, HORIZONTAL, SMALLER] Defines whether the field of view is measured vertically, horizontally or in the smaller direction.
SFFloat aspect SFFloat inputOutput 1.0 The aspect ratio (i.e. width / height) of a pixel.
SFVec3f upVector SFVec3f inputOutput 0 1 0 The up vector in world space (usually the y axis).
MFNode navigator MFNode inputOutput Navigator3D holds the 3d navigator which will be called for bound nodes
SFFloat zNear SFFloat inputOutput -1 z-near position; used for clipping
SFFloat zFar SFFloat inputOutput -1 z-far position; used for clipping
SFMatrix4f transformation_request SFMatrix4f outputOnly sends a new request to evaluate a local transformation. Its mainly used together with a NavigationEvaluator node to verify the transformation given by the navigator
SFMatrix4f transformation_result SFMatrix4f inputOnly this slot is used to transform the view to the given local transformation. It is mainly used to return the camera transformation after processed by a NavigationEvaluator
MFNode effects MFNode inputOutput VisualEffects Specifies the desired global effects like depth of field and motion blur for the post-processing step that are specific to a certain camera or lens type.
SFNode splitGroup SFNode inputOutput SplitGroup holds SplitGroup node for this bindable
MFNode children MFNode inputOutput the children fields allow to place object relative to the current camera transformation.
XFAny bind XFAny inputOnly sending any event to this slot will bind/activate the Bindable
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))
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 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.
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