SoCamera

#define SO_ASPECT_SQUARE 1.00

#define SO_ASPECT_VIDEO 1.333333333

#define SO_ASPECT_35mm_ACADEMY 1.371

#define SO_ASPECT_16mm 1.369

#define SO_ASPECT_35mm_FULL 1.33333

#define SO_ASPECT_70mm 2.287

#define SO_ASPECT_CINEMASCOPE 2.35

#define SO_ASPECT_HDTV 1.777777777

#define SO_ASPECT_PANAVISION 2.361

#define SO_ASPECT_35mm 1.5

#define SO_ASPECT_VISTAVISION 2.301

enum ViewportMapping {

SoCamera::CROP_VIEWPORT_FILL_FRAME Crops the viewport within the current window, so that the aspect ratio matches that of the camera. As the window size changes, the aspect ratio remains unchanged. The cropped region is drawn as a filled gray area.

SoCamera::CROP_VIEWPORT_LINE_FRAME Crops the viewport, but draws a thin frame around the viewport

SoCamera::CROP_VIEWPORT_NO_FRAME Crops the viewport, but gives no visual feedback as to the viewport dimensions within the window

SoCamera::ADJUST_CAMERA Adjusts the camera aspect ratio and height to make it fit within the given window. (The camera's fields are not affected, just the values sent to the graphics library.)

SoCamera::LEAVE_ALONE Do nothing. Camera image may become stretched out of proportion

}

Fields from class SoCamera:

SoSFEnum viewportMapping

SoSFVec3f position

SoSFRotation orientation

SoSFFloat aspectRatio

SoSFFloat nearDistance

SoSFFloat farDistance

SoSFFloat focalDistance

Methods from class SoCamera:

void pointAt(const SbVec3f &targetPoint)

virtual void scaleHeight(float scaleFactor)

virtual SbViewVolume getViewVolume(float useAspectRatio = 0.0) const

void viewAll(SoNode *sceneRoot, const SbViewportRegion &vpRegion, float slack = 1.0)

void viewAll(SoPath *path, const SbViewportRegion &vpRegion, float slack = 1.0)

SbViewportRegion getViewportBounds(const SbViewportRegion ®ion) const

static SoType getClassTypeId()

Methods from class SoNode:

void setOverride(SbBool state)

SbBool isOverride() const

SoNode * copy(SbBool copyConnections = FALSE) const

virtual SbBool affectsState() const

static SoNode * getByName(const SbName &name)

static int getByName(const SbName &name, SoNodeList &list)

Methods from class SoFieldContainer:

void setToDefaults()

SbBool hasDefaultValues() const

SbBool fieldsAreEqual(const SoFieldContainer *fc) const

void copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)

SbBool set(const char *fieldDataString)

void get(SbString &fieldDataString)

virtual int getFields(SoFieldList &resultList) const

virtual SoField * getField(const SbName &fieldName) const

SbBool getFieldName(const SoField *field, SbName &fieldName) const

SbBool isNotifyEnabled() const

SbBool enableNotify(SbBool flag)

Methods from class SoBase:

void ref()

void unref() const

void unrefNoDelete() const

void touch()

virtual SoType getTypeId() const

SbBool isOfType(SoType type) const

virtual void setName(const SbName &name)

virtual SbName getName() const

This is the abstract base class for all camera nodes. It defines the common methods and fields that all cameras have. Cameras are used to view a scene. When a camera is encountered during rendering, it sets the projection and viewing matrices and viewport appropriately; it does not draw geometry. Cameras should be placed before any shape nodes or light nodes in a scene graph; otherwise, those shapes or lights cannot be rendered properly. Cameras are affected by the current transformation, so you can position a camera by placing a transformation node before it in the scene graph . The default position and orientation of a camera is at (0,0,1) looking along the negative z-axis.

You can also use a node kit to create a camera; see the reference page for SoCameraKit.