Main Page | Modules | Namespace List | Class Hierarchy | Class List | Namespace Members | Class Members | Related Pages

Viewpoint Class Reference

Viewpoint provides a handy place to hold camera params. More...

Inheritance diagram for Viewpoint:

TransformNode ChildNode IParent ITransform Node Object List of all members.

Detailed Description

Viewpoint provides a handy place to hold camera params.

It is meant as a way-point, or a 3D bookmark. It is NOT rendered.

Authoring Interface:

        Viewpoint {
            field SFVec3f       position        0 0 10
            field SFRotation    orientation     0 0 1 0
            field SFFloat       fieldOfView     0.785398
            field SFFloat       nearLimit       1.0
            field SFFloat       visibilityLimit 0.0
            field SFString      projectionType  "PERSPECTIVE" // or "ORTHO"
            field SFFloat       aspectRatio     XXX
            field SFString      description     ""
            eventOut SFBoolean  isBound
        }

Parameters:
position specifies the location of the Viewpoint, establishing the camera's eyepoint. Position is relative to the coordinate system's origin (0,0,0) Default value: 0 0 10
orientation specifies the Viewpoint's orientation, establishing the camera's direction of view. orientation specifies a rotation RELATIVE to the default orientation. In the default position and orientation, the viewer is on the Z-axis looking down the -Z-axis toward the origin with +X to the right and +Y straight up. For example: default direction is 0 0 -1 to look to the left ( direction -1 0 0 ), use 0 1 0, Math.PI/2 to look to the right( direction 1 0 0 ), use 0 1 0, -Math.PI/2 to look back ( direction 0 0 1 ), use 0 1 0, Math.PI Default value: 0 0 1 0
fieldOfView If orthographic is FALSE, fieldOfView specifies the Viewpoint's minimum viewing angle in radians. If orthographic is TRUE, fieldOfView specifies the height of the viewing frustum. Default value: 0.785398
nearLimit specifies near distance in front of which geometry will not be rendered. Default value: 1.0
visibilityLimit specifies a far distance beyond which geometry may not be rendered. A value of 0.0 indicates an infinite visibility limit.
XXX this should be moved to a NavigationInfo node Default value: 0.0
projectionType controls which projection is used. Possibilities include "PERSPECTIVE" and "ORTHOGRAPHIC". Default value: "PERSPECTIVE" XXX should be restructured as the following:
orthographic controls whether a perspective or an orthographic projection is used. Default value: false
aspectRatio specifies the proportion of the viewing frustum.
XXX this should be determined by the surface consuming the camera (e.g. window viewport).
description provides a descriptive label for this Viewpoint, which may be used to identify and select this Viewpoint in a navigational user interface.
isBound eventOut that fires when it is bound/unbound to the Camera

Functionality:

XXX To be written


Generated on Sat Apr 1 06:08:08 2006 for Emma Content Development Kit by  doxygen 1.4.3