Coin Logo http://www.sim.no
http://www.coin3d.org

SoCamera.h
1 #ifndef COIN_SOCAMERA_H
2 #define COIN_SOCAMERA_H
3 
4 /**************************************************************************\
5  *
6  * This file is part of the Coin 3D visualization library.
7  * Copyright (C) 1998-2007 by Systems in Motion. All rights reserved.
8  *
9  * This library is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU General Public License
11  * ("GPL") version 2 as published by the Free Software Foundation.
12  * See the file LICENSE.GPL at the root directory of this source
13  * distribution for additional information about the GNU GPL.
14  *
15  * For using Coin with software that can not be combined with the GNU
16  * GPL, and for taking advantage of the additional benefits of our
17  * support services, please contact Systems in Motion about acquiring
18  * a Coin Professional Edition License.
19  *
20  * See http://www.coin3d.org/ for more information.
21  *
22  * Systems in Motion, Postboks 1283, Pirsenteret, 7462 Trondheim, NORWAY.
23  * http://www.sim.no/ sales@sim.no coin-support@coin3d.org
24  *
25 \**************************************************************************/
26 
27 #include <Inventor/nodes/SoSubNode.h>
28 #include <Inventor/SbViewportRegion.h>
29 #include <Inventor/SbViewVolume.h>
30 #include <Inventor/fields/SoSFRotation.h>
31 #include <Inventor/fields/SoSFEnum.h>
32 #include <Inventor/fields/SoSFVec3f.h>
33 #include <Inventor/fields/SoSFFloat.h>
34 
35 #include <Inventor/SbVec3f.h>
36 #include <Inventor/SbBox3f.h>
37 
38 #define SO_ASPECT_SQUARE 1.0f
39 #define SO_ASPECT_VIDEO (4.0f/3.0f)
40 #define SO_ASPECT_35mm_ACADEMY 1.371
41 #define SO_ASPECT_16mm 1.369
42 #define SO_ASPECT_35mm_FULL 1.33333
43 #define SO_ASPECT_70mm 2.287
44 #define SO_ASPECT_CINEMASCOPE 2.35
45 #define SO_ASPECT_HDTV (16.0f/9.0f)
46 #define SO_ASPECT_PANAVISION 2.361
47 #define SO_ASPECT_35mm (3.0f/2.0f)
48 #define SO_ASPECT_VISTAVISION 2.301
49 
50 class SoPath;
51 
52 class SoCameraP;
53 
54 class COIN_DLL_API SoCamera : public SoNode {
55  typedef SoNode inherited;
56 
57  SO_NODE_ABSTRACT_HEADER(SoCamera);
58 
59 public:
60  static void initClass(void);
61 
63  CROP_VIEWPORT_FILL_FRAME,
64  CROP_VIEWPORT_LINE_FRAME,
65  CROP_VIEWPORT_NO_FRAME,
66  ADJUST_CAMERA,
67  LEAVE_ALONE
68  };
69 
77 
78  void pointAt(const SbVec3f & targetpoint);
79  void pointAt(const SbVec3f & targetpoint, const SbVec3f & upvector);
80  virtual void scaleHeight(float scalefactor) = 0;
81  virtual SbViewVolume getViewVolume(float useaspectratio = 0.0f) const = 0;
82  void viewAll(SoNode * const sceneroot, const SbViewportRegion & vpregion,
83  const float slack = 1.0f);
84  void viewAll(SoPath * const path, const SbViewportRegion & vpregion,
85  const float slack = 1.0f);
86  SbViewportRegion getViewportBounds(const SbViewportRegion & region) const;
87 
88  enum StereoMode {
91  RIGHT_VIEW
92  };
93 
94  void setStereoMode(StereoMode mode);
95  StereoMode getStereoMode(void) const;
96 
97  void setStereoAdjustment(float adjustment);
98  float getStereoAdjustment(void) const;
99  void setBalanceAdjustment(float adjustment);
100  float getBalanceAdjustment(void) const;
101 
102  virtual void doAction(SoAction * action);
103  virtual void callback(SoCallbackAction * action);
104  virtual void GLRender(SoGLRenderAction * action);
105  virtual void audioRender(SoAudioRenderAction *action);
106  virtual void getBoundingBox(SoGetBoundingBoxAction * action);
107  virtual void handleEvent(SoHandleEventAction * action);
108  virtual void rayPick(SoRayPickAction * action);
109  virtual void getPrimitiveCount(SoGetPrimitiveCountAction * action);
110 
111 protected:
112  SoCamera(void);
113  virtual ~SoCamera();
114 
115  virtual void viewBoundingBox(const SbBox3f & box, float aspect,
116  float slack) = 0;
117  virtual void jitter(int numpasses, int curpass,
118  const SbViewportRegion & vpreg,
119  SbVec3f & jitteramount) const;
120 
121 private:
122  void getView(SoAction * action, SbViewVolume & resultvv,
123  SbViewportRegion & resultvp,
124  const SbBool considermodelmatrix = TRUE);
125 
126  void drawCroppedFrame(SoGLRenderAction * action,
127  const int viewportmapping,
128  const SbViewportRegion & oldvp,
129  const SbViewportRegion & newvp);
130 
131  void lookAt(const SbVec3f & dir, const SbVec3f & up);
132 
133  StereoMode stereomode;
134  float stereoadjustment;
135  float balanceadjustment;
136 private:
137  SoCameraP *pimpl;
138  friend class SoCameraP;
139 };
140 
141 #endif // !COIN_SOCAMERA_H
SoSFVec3f
The SoSFVec3f class is a container for an SbVec3f vector.
Definition: SoSFVec3f.h:31
SoCamera::~SoCamera
virtual ~SoCamera()
Definition: SoCamera.cpp:354
SbRotation
The SbRotation class represents a rotation in 3D space.
Definition: SbRotation.h:33
SoListenerPositionElement::isSetByListener
static SbBool isSetByListener(SoState *const state)
Definition: SoListenerPositionElement.cpp:124
SoCamera::LEFT_VIEW
@ LEFT_VIEW
Definition: SoCamera.h:90
SoState
The SoState class manages the Coin scenegraph traversal state data.
Definition: SoState.h:35
SoAudioRenderAction
The SoAudioRenderAction class renders the aural parts of the scene graph.
Definition: SoAudioRenderAction.h:30
SbViewportRegion::getViewportSizePixels
const SbVec2s & getViewportSizePixels(void) const
Definition: SbViewportRegion.cpp:425
SoNode::rayPick
virtual void rayPick(SoRayPickAction *action)
Definition: SoNode.cpp:1087
SoAction::apply
virtual void apply(SoNode *root)
Definition: SoAction.cpp:476
SoCamera::nearDistance
SoSFFloat nearDistance
Definition: SoCamera.h:74
SoState::pop
void pop(void)
Definition: SoState.cpp:284
SbMatrix
The SbMatrix class is a 4x4 dimensional representation of a matrix.
Definition: SbMatrix.h:37
SoSFRotation
The SoSFRotation class is a container for an SbRotation.
Definition: SoSFRotation.h:31
SoCamera::focalDistance
SoSFFloat focalDistance
Definition: SoCamera.h:76
SbViewVolume::frustum
void frustum(float left, float right, float bottom, float top, float nearval, float farval)
Definition: SbViewVolume.cpp:468
SbViewVolume::getWidth
float getWidth(void) const
Definition: SbViewVolume.cpp:631
SoCamera::getViewportBounds
SbViewportRegion getViewportBounds(const SbViewportRegion &region) const
Definition: SoCamera.cpp:520
SoCamera::getBoundingBox
virtual void getBoundingBox(SoGetBoundingBoxAction *action)
Definition: SoCamera.cpp:679
SbViewportRegion::getViewportAspectRatio
float getViewportAspectRatio(void) const
Definition: SbViewportRegion.cpp:440
SoCamera::getViewVolume
virtual SbViewVolume getViewVolume(float useaspectratio=0.0f) const =0
SbViewVolume::getMatrices
void getMatrices(SbMatrix &affine, SbMatrix &proj) const
Definition: SbViewVolume.cpp:185
SoNode::audioRender
virtual void audioRender(SoAudioRenderAction *action)
Definition: SoNode.cpp:1255
SoNode::GLRender
virtual void GLRender(SoGLRenderAction *action)
Definition: SoNode.cpp:904
SoField::isIgnored
SbBool isIgnored(void) const
Definition: SoField.cpp:638
SoCamera::MONOSCOPIC
@ MONOSCOPIC
Definition: SoCamera.h:89
SbViewportRegion::getWindowSize
const SbVec2s & getWindowSize(void) const
Definition: SbViewportRegion.cpp:366
SbViewportRegion::getViewportSize
const SbVec2f & getViewportSize(void) const
Definition: SbViewportRegion.cpp:414
SoCamera::rayPick
virtual void rayPick(SoRayPickAction *action)
Definition: SoCamera.cpp:756
SoListenerGainElement
The SoListenerGainElement class stores the SoListener gain during a scene graph traversal.
Definition: SoListenerGainElement.h:29
SoState::push
void push(void)
Definition: SoState.cpp:265
SbBox3f::getMin
const SbVec3f & getMin(void) const
Definition: SbBox3f.cpp:122
SoRayPickAction::computeWorldSpaceRay
void computeWorldSpaceRay(void)
Definition: SoRayPickAction.cpp:464
SoCamera::handleEvent
virtual void handleEvent(SoHandleEventAction *action)
Definition: SoCamera.cpp:692
SbMatrix::inverse
SbMatrix inverse(void) const
Definition: SbMatrix.cpp:418
SoListenerPositionElement::set
static void set(SoState *const state, SoNode *const node, const SbVec3f &position, SbBool setbylistener)
Definition: SoListenerPositionElement.cpp:95
SoGLRenderAction::getCacheContext
uint32_t getCacheContext(void) const
Definition: SoGLRenderAction.cpp:902
SbBox3f
The SbBox3f class is an abstraction for an axis aligned 3 dimensional box.
Definition: SbBox3f.h:37
SoAction
The SoAction class is the base class for all traversal actions.
Definition: SoAction.h:67
SbViewVolume::getProjectionDirection
const SbVec3f & getProjectionDirection(void) const
Definition: SbViewVolume.cpp:609
SoNode::getPrimitiveCount
virtual void getPrimitiveCount(SoGetPrimitiveCountAction *action)
Definition: SoNode.cpp:846
SbMatrix::multRight
SbMatrix & multRight(const SbMatrix &m)
Definition: SbMatrix.cpp:1240
SbViewVolume::getNearDist
float getNearDist(void) const
Definition: SbViewVolume.cpp:620
SoCamera::getPrimitiveCount
virtual void getPrimitiveCount(SoGetPrimitiveCountAction *action)
Definition: SoCamera.cpp:775
SoLineWidthElement::set
static void set(SoState *const state, SoNode *const node, const float lineWidth)
Definition: SoLineWidthElement.cpp:70
SoCamera::audioRender
virtual void audioRender(SoAudioRenderAction *action)
Definition: SoCamera.cpp:624
SoListenerDopplerElement
The SoListenerDopplerElement holds the doppler velocity and factor of the current listener.
Definition: SoListenerDopplerElement.h:30
SoCamera::viewBoundingBox
virtual void viewBoundingBox(const SbBox3f &box, float aspect, float slack)=0
SoCamera::pointAt
void pointAt(const SbVec3f &targetpoint)
Definition: SoCamera.cpp:404
SoListenerOrientationElement
The SoListenerOrientationElement holds the orientation of the current listener.
Definition: SoListenerOrientationElement.h:30
SoNode::callback
virtual void callback(SoCallbackAction *action)
Definition: SoNode.cpp:974
SbVec2s
The SbVec2s class is a 2 dimensional vector with short integer coordinates.
Definition: SbVec2s.h:37
SoCamera::setStereoAdjustment
void setStereoAdjustment(float adjustment)
Definition: SoCamera.cpp:1025
SoPath
The SoPath class is a container class for traversal path descriptions.
Definition: SoPath.h:43
SoCamera::StereoMode
StereoMode
Definition: SoCamera.h:88
SoCamera::doAction
virtual void doAction(SoAction *action)
Definition: SoCamera.cpp:718
SbVec3f::cross
SbVec3f cross(const SbVec3f &v) const
Definition: SbVec3f.cpp:270
SoDebugError::postInfo
static void postInfo(const char *const source, const char *const format,...)
Definition: SoDebugError.cpp:334
SbBox3f::getMax
const SbVec3f & getMax(void) const
Definition: SbBox3f.cpp:134
SoCamera::SoCamera
SoCamera(void)
Definition: SoCamera.cpp:326
SoSFEnum
The SoSFEnum class is a container for an enum value.
Definition: SoSFEnum.h:31
SoListenerPositionElement
The SoListenerPositionElement holds the position of the current listener.
Definition: SoListenerPositionElement.h:30
SoCamera::setStereoMode
void setStereoMode(StereoMode mode)
Definition: SoCamera.cpp:979
SbMatrix::getTransform
void getTransform(SbVec3f &t, SbRotation &r, SbVec3f &s, SbRotation &so) const
Definition: SbMatrix.cpp:997
SbVec3f::setValue
SbVec3f & setValue(const float v[3])
Definition: SbVec3f.cpp:461
SoBase
The SoBase class is the top-level superclass for a number of class-hierarchies.
Definition: SoBase.h:41
SoAction::getState
SoState * getState(void) const
Definition: SoAction.cpp:1028
SoCamera::farDistance
SoSFFloat farDistance
Definition: SoCamera.h:75
SbViewportRegion::scaleHeight
void scaleHeight(float ratio)
Definition: SbViewportRegion.cpp:491
SoCamera
The SoCamera class is the abstract base class for camera definition nodes.
Definition: SoCamera.h:54
SoState::isElementEnabled
SbBool isElementEnabled(const int stackindex) const
Definition: SoState.h:70
SoCamera::getStereoMode
StereoMode getStereoMode(void) const
Definition: SoCamera.cpp:988
SoCamera::callback
virtual void callback(SoCallbackAction *action)
Definition: SoCamera.cpp:749
SbVec3f
The SbVec3f class is a 3 dimensional vector with floating point coordinates.
Definition: SbVec3f.h:37
SoGetBoundingBoxAction
The SoGetBoundingBoxAction class calculates bounding boxes for nodes and subgraphs.
Definition: SoGetBoundingBoxAction.h:34
SbVec3f::dot
float dot(const SbVec3f &v) const
Definition: SbVec3f.cpp:282
SoCallbackAction
The SoCallbackAction class invokes callbacks at specific nodes.
Definition: SoCallbackAction.h:70
SbViewVolume::getDepth
float getDepth(void) const
Definition: SbViewVolume.cpp:654
SbViewportRegion
The SbViewportRegion class is a viewport within a full window.
Definition: SbViewportRegion.h:31
SbViewVolume::transform
void transform(const SbMatrix &matrix)
Definition: SbViewVolume.cpp:708
SoCamera::GLRender
virtual void GLRender(SoGLRenderAction *action)
Definition: SoCamera.cpp:548
SoGLRenderAction::getNumPasses
int getNumPasses(void) const
Definition: SoGLRenderAction.cpp:838
SoCamera::ViewportMapping
ViewportMapping
Definition: SoCamera.h:62
SoCamera::getBalanceAdjustment
float getBalanceAdjustment(void) const
Definition: SoCamera.cpp:1064
SoNode::handleEvent
virtual void handleEvent(SoHandleEventAction *action)
Definition: SoNode.cpp:1031
SbVec3f::normalize
float normalize(void)
Definition: SbVec3f.cpp:436
SbViewVolume
The SbViewVolume class is a viewing volume in 3D space.
Definition: SbViewVolume.h:41
SoGetBoundingBoxAction::getBoundingBox
SbBox3f getBoundingBox(void) const
Definition: SoGetBoundingBoxAction.cpp:307
SoCamera::getStereoAdjustment
float getStereoAdjustment(void) const
Definition: SoCamera.cpp:1036
SbViewportRegion::scaleWidth
void scaleWidth(float ratio)
Definition: SbViewportRegion.cpp:460
SoListenerOrientationElement::set
static void set(SoState *const state, SoNode *const node, const SbRotation &orientation, SbBool setbylistener)
Definition: SoListenerOrientationElement.cpp:96
SoSFFloat
The SoSFFloat class is a container for a floating point value.
Definition: SoSFFloat.h:30
SoCamera::position
SoSFVec3f position
Definition: SoCamera.h:71
SoCamera::viewAll
void viewAll(SoNode *const sceneroot, const SbViewportRegion &vpregion, const float slack=1.0f)
Definition: SoCamera.cpp:465
SbViewVolume::getViewUp
SbVec3f getViewUp(void) const
Definition: SbViewVolume.cpp:723
SoNode
The SoNode class is the base class for nodes used in scene graphs.
Definition: SoNode.h:47
SbVec3f::getValue
const float * getValue(void) const
Definition: SbVec3f.cpp:334
SoCamera::aspectRatio
SoSFFloat aspectRatio
Definition: SoCamera.h:73
SoHandleEventAction
The SoHandleEventAction class distributes user events to the scene.
Definition: SoHandleEventAction.h:36
SoCamera::viewportMapping
SoSFEnum viewportMapping
Definition: SoCamera.h:70
SoListenerOrientationElement::isSetByListener
static SbBool isSetByListener(SoState *const state)
Definition: SoListenerOrientationElement.cpp:126
SoGLRenderAction::handleTransparency
SbBool handleTransparency(SbBool istransparent=0)
Definition: SoGLRenderAction.cpp:1004
SoCamera::setBalanceAdjustment
void setBalanceAdjustment(float adjustment)
Definition: SoCamera.cpp:1053
SoCamera::orientation
SoSFRotation orientation
Definition: SoCamera.h:72
SbMatrix::identity
static SbMatrix identity(void)
Definition: SbMatrix.cpp:748
SoRayPickAction
The SoRayPickAction class does ray intersection with scene graphs.
Definition: SoRayPickAction.h:40
SbViewVolume::getHeight
float getHeight(void) const
Definition: SbViewVolume.cpp:642
SbMatrix::setTranslate
void setTranslate(const SbVec3f &t)
Definition: SbMatrix.cpp:790
SoNode::doAction
virtual void doAction(SoAction *action)
Definition: SoNode.cpp:761
SoNode::getBoundingBox
virtual void getBoundingBox(SoGetBoundingBoxAction *action)
Definition: SoNode.cpp:817
SbBox3f::isEmpty
SbBool isEmpty(void) const
Definition: SbBox3f.cpp:436
SoGLRenderAction
The SoGLRenderAction class renders the scene graph with OpenGL calls.
Definition: SoGLRenderAction.h:39
SoGetPrimitiveCountAction
The SoGetPrimitiveCountAction class counts the primitives in a scene.
Definition: SoGetPrimitiveCountAction.h:32
SbViewportRegion::getViewportOriginPixels
const SbVec2s & getViewportOriginPixels(void) const
Definition: SbViewportRegion.cpp:398
SbViewVolume::scale
void scale(float factor)
Definition: SbViewVolume.cpp:549
SoAction::isOfType
virtual SbBool isOfType(SoType type) const
Definition: SoAction.cpp:462
SoCamera::jitter
virtual void jitter(int numpasses, int curpass, const SbViewportRegion &vpreg, SbVec3f &jitteramount) const
Definition: SoCamera.cpp:706

Copyright © 1998-2007 by Systems in Motion AS. All rights reserved.

Generated on Wed Jul 24 2019 for Coin by Doxygen. 1.8.17