ROOT logo
ROOT » GRAF3D » GL » TGLOrthoCamera

class TGLOrthoCamera: public TGLCamera


TGLOrthoCamera

Orthographic projection camera. Currently limited to three types
defined at construction time - kXOY, kXOZ, kZOY - where this refers
to the viewport plane axis - e.g. kXOY has X axis horizontal, Y
vertical - i.e. looking down Z axis with Y vertical.

The plane types restriction could easily be removed to supported
arbitary ortho projections along any axis/orientation with free
rotations about them.


Function Members (Methods)

public:
TGLOrthoCamera(TGLOrthoCamera::EType type, const TGLVector3& hAxis, const TGLVector3& vAxis)
virtual~TGLOrthoCamera()
Bool_tTGLCamera::AdjustAndClampVal(Double_t& val, Double_t min, Double_t max, Int_t screenShift, Int_t screenShiftRange, Bool_t mod1, Bool_t mod2) const
Double_tTGLCamera::AdjustDelta(Double_t screenShift, Double_t deltaFactor, Bool_t mod1, Bool_t mod2) const
virtual voidApply(const TGLBoundingBox& sceneBox, const TGLRect* pickRect = 0) const
static TClass*Class()
virtual voidConfigure(Double_t zoom, Double_t dolly, Double_t* center, Double_t hRotate, Double_t vRotate)
virtual Bool_tDolly(Int_t delta, Bool_t mod1, Bool_t mod2)
voidTGLCamera::DrawDebugAids() const
TGLVector3TGLCamera::EyeDirection() const
TGLVertex3TGLCamera::EyePoint() const
TGLVertex3TGLCamera::FrustumCenter() const
EOverlapTGLCamera::FrustumOverlap(const TGLBoundingBox& box) const
const TGLPlane&TGLCamera::FrustumPlane(TGLCamera::EFrustumPlane plane) const
const TGLMatrix&TGLCamera::GetCamBase() const
const TGLMatrix&TGLCamera::GetCamTrans() const
Double_t*TGLCamera::GetCenterVec()
Bool_tGetDollyToZoom() const
Bool_tGetEnableRotate() const
Bool_tTGLCamera::GetExternalCenter()
Double_tTGLCamera::GetFarClip() const
Double_t*TGLCamera::GetFixDefCenterVec()
Double_tTGLCamera::GetNearClip() const
Double_tTGLCamera::GetTheta() const
Float_tTGLCamera::GetVAxisMinAngle()
Double_tGetZoomMax() const
Double_tGetZoomMin() const
voidTGLCamera::IncTimeStamp()
virtual TClass*IsA() const
Bool_tTGLCamera::IsCacheDirty() const
virtual Bool_tIsOrthographic() const
virtual Bool_tTGLCamera::IsPerspective() const
Bool_tTGLCamera::OfInterest(const TGLBoundingBox& box, Bool_t ignoreSize) const
TGLMatrix&TGLCamera::RefCamBase()
TGLMatrix&TGLCamera::RefCamTrans()
TGLMatrix&TGLCamera::RefLastNoPickProjM() const
const TGLMatrix&TGLCamera::RefModelViewMatrix() const
TGLRect&TGLCamera::RefViewport()
const TGLRect&TGLCamera::RefViewport() const
virtual voidReset()
voidTGLCamera::ResetInterest()
virtual Bool_tRotate(Int_t xDelta, Int_t yDelta, Bool_t mod1, Bool_t mod2)
virtual Bool_tTGLCamera::RotateRad(Double_t hRotate, Double_t vRotate)
voidTGLCamera::SetCenterVec(Double_t x, Double_t y, Double_t z)
voidTGLCamera::SetCenterVecWarp(Double_t x, Double_t y, Double_t z)
voidSetDollyToZoom(Bool_t x)
voidSetEnableRotate(Bool_t x)
voidTGLCamera::SetExternalCenter(Bool_t x)
voidTGLCamera::SetFixDefCenter(Bool_t x)
voidTGLCamera::SetFixDefCenterVec(Double_t x, Double_t y, Double_t z)
virtual voidSetup(const TGLBoundingBox& box, Bool_t reset = kTRUE)
voidTGLCamera::SetVAxisMinAngle(Float_t x)
voidTGLCamera::SetViewport(const TGLRect& viewport)
voidSetZoomMax(Double_t z)
voidSetZoomMin(Double_t z)
voidSetZoomMinMax(Double_t min, Double_t max)
virtual voidShowMembers(TMemberInspector& insp)
virtual voidStreamer(TBuffer& b)
voidStreamerNVirtual(TBuffer& b)
UInt_tTGLCamera::TimeStamp() const
virtual Bool_tTruck(Int_t xDelta, Int_t yDelta, Bool_t mod1, Bool_t mod2)
Bool_tTGLCamera::UpdateInterest(Bool_t force)
TGLVector3TGLCamera::ViewportDeltaToWorld(const TGLVertex3& worldRef, Double_t viewportXDelta, Double_t viewportYDelta, TGLMatrix* modviewMat = 0) const
EOverlapTGLCamera::ViewportOverlap(const TGLBoundingBox& box) const
pair<Bool_t,TGLVertex3>TGLCamera::ViewportPlaneIntersection(const TPoint& viewport, const TGLPlane& worldPlane) const
pair<Bool_t,TGLVertex3>TGLCamera::ViewportPlaneIntersection(Double_t viewportX, Double_t viewportY, const TGLPlane& worldPlane) const
TGLRectTGLCamera::ViewportRect(const TGLBoundingBox& box, TGLBoundingBox::EFace face) const
TGLRectTGLCamera::ViewportRect(const TGLBoundingBox& box, const TGLBoundingBox::EFace* face = 0) const
TGLLine3TGLCamera::ViewportToWorld(const TPoint& viewport) const
TGLVertex3TGLCamera::ViewportToWorld(const TGLVertex3& viewportVertex, TGLMatrix* modviewMat = 0) const
TGLLine3TGLCamera::ViewportToWorld(Double_t viewportX, Double_t viewportY) const
voidTGLCamera::WindowToViewport(TPoint& point) const
voidTGLCamera::WindowToViewport(TGLRect& rect) const
voidTGLCamera::WindowToViewport(TGLVertex3& vertex) const
voidTGLCamera::WindowToViewport(Int_t&, Int_t& y) const
TGLVector3TGLCamera::WorldDeltaToViewport(const TGLVertex3& worldRef, const TGLVector3& worldDelta) const
TGLVertex3TGLCamera::WorldToViewport(const TGLVertex3& worldVertex, TGLMatrix* modviewMat = 0) const
virtual Bool_tZoom(Int_t delta, Bool_t mod1, Bool_t mod2)
protected:
voidTGLCamera::UpdateCache() const

Data Members

public:
enum EType { kZOY
kXOZ
kXOY
kZnOY
kXnOZ
kXnOY
};
enum TGLCamera::EFrustumPlane { kNear
kLeft
kRight
kTop
kBottom
kFar
kPlanesPerFrustum
};
protected:
Bool_tTGLCamera::fCacheDirty! cached items dirty?
TGLMatrixTGLCamera::fCamBase! tranformation to center and rotation from up to x vector
TGLMatrixTGLCamera::fCamTrans! transformation relative to fCamTrans
TGLVector3*TGLCamera::fCenter! current camera center
TGLMatrixTGLCamera::fClipM! object space clip matrix (cached)
TGLVector3TGLCamera::fDefCenter! deafult camera center
Double_tTGLCamera::fDollyDefault! default distnce from viewing centre
Double_tTGLCamera::fDollyDistance! unit distance for camera movement in fwd/bck direction
TGLVector3TGLCamera::fExtCenter! external camera center
Bool_tTGLCamera::fExternalCenter! use external center insead of scene center
TGLVector3TGLCamera::fFDCenter! fixed deafult camera center
Double_tTGLCamera::fFarClip! last applied far-clip
Bool_tTGLCamera::fFixDefCenter! use fixed default center
TGLPlaneTGLCamera::fFrustumPlanes[6]! frustum planes (cached)
TGLBoundingBoxTGLCamera::fInterestBox! the interest box - created in UpdateInterest()
Double_tTGLCamera::fLargestSeen! largest box diagonal seen in OfInterest() - used when
TGLMatrixTGLCamera::fLastNoPickProjM! no-pick projection matrix (cached)
TGLMatrixTGLCamera::fModVM! modelView matrix (cached)
Double_tTGLCamera::fNearClip! last applied near-clip
TGLMatrixTGLCamera::fProjM! projection matrix (cached)
UInt_tTGLCamera::fTimeStamp! timestamp
Float_tTGLCamera::fVAxisMinAngle! minimal allowed angle between up and fCamTrans Z vector
TGLRectTGLCamera::fViewport! viewport (GL coords - origin bottom left)
static UInt_tTGLCamera::fgDollyDeltaSens
private:
Double_tfDefXSize
Double_tfDefYSize! x, y size of scene from camera view
Bool_tfDollyToZoom! zoom when dolly is requested
Bool_tfEnableRotate! enable rotation
TGLOrthoCamera::ETypefType! camera type
TGLBoundingBoxfVolume! scene volume
Double_tfZoom! current zoom
Double_tfZoomDefault! default zoom factor
Double_tfZoomMax! maximum zoom factor
Double_tfZoomMin! minimum zoom factor
static UInt_tfgZoomDeltaSens

Class Charts

Inheritance Inherited Members Includes Libraries
Class Charts

Function documentation

TGLOrthoCamera(TGLOrthoCamera::EType type, const TGLVector3& hAxis, const TGLVector3& vAxis)
 Construct orthographic camera.
~TGLOrthoCamera()
 Destroy orthographic camera.
void Setup(const TGLBoundingBox& box, Bool_t reset = kTRUE)
 Setup camera limits suitible to view the world volume defined by 'box'
 and call Reset() to initialise camera.
void Reset()
 Reset the camera to defaults - trucking, zooming to reframe the world volume
 established in Setup(). Note: limits defined in Setup() are not adjusted.
Bool_t Dolly(Int_t delta, Bool_t mod1, Bool_t mod2)
 Dolly the camera.
 By default the dolly is reinterpreted to zoom, but it can be
 changed by modifying the fDollyToZoom data-member.
Bool_t Zoom(Int_t delta, Bool_t mod1, Bool_t mod2)
 Zoom the camera - 'adjust lens focal length, retaining camera position'.
 Arguments are:

 'delta' - mouse viewport delta (pixels) - +ive zoom in, -ive zoom out
 'mod1' / 'mod2' - sensitivity modifiers - see TGLCamera::AdjustAndClampVal()

 For an orthographic camera dollying and zooming are identical and both equate
 logically to a rescaling of the viewport limits - without center shift.
 There is no perspective foreshortening or lens 'focal length'.

 Returns kTRUE is redraw required (camera change), kFALSE otherwise.
void SetZoomMin(Double_t z)
 Set minimum zoom factor. If current zoom is less than z it is
 set to z.
void SetZoomMax(Double_t z)
 Set maximum zoom factor. If current zoom is greater than z it
 is set to z.
Bool_t Truck(Int_t xDelta, Int_t yDelta, Bool_t mod1, Bool_t mod2)
 Truck the camera - 'move camera parallel to film plane'.
 Returns kTRUE is redraw required (camera change), kFALSE otherwise.
Bool_t Rotate(Int_t xDelta, Int_t yDelta, Bool_t mod1, Bool_t mod2)
 Rotate the camera - 'swivel round the view volume center'.
 Returns kTRUE is redraw required (camera change), kFALSE otherwise.
void Apply(const TGLBoundingBox& sceneBox, const TGLRect* pickRect = 0) const
 Apply the camera to the current GL context, setting the viewport, projection
 and modelview matricies. After this verticies etc can be directly entered
 in the world frame. This also updates the cached frustum values, enabling
 all the projection, overlap tests etc defined in TGLCamera to be used.

 Arguments are:
 'box' - view volume box - ignored for ortho camera. Assumed to be same
 as one passed to Setup().
 'pickRect' - optional picking rect. If non-null, restrict drawing to this
 viewport rect.
void Configure(Double_t zoom, Double_t dolly, Double_t* center, Double_t hRotate, Double_t vRotate)
 Configure the camera state.
   zoom    - set directly (default = 0.78);
   dolly   - additional move along the camera forward direction;
   center  - new camera center (can be 0 for no change);
   hRotate - additional "up/down" rotation in radians;
   vRotate - additional "left/right" rotation in radians.
Bool_t IsOrthographic() const
{ return kTRUE; }
void SetEnableRotate(Bool_t x)
{ fEnableRotate = x; }
Bool_t GetEnableRotate() const
{ return fEnableRotate; }
Double_t GetZoomMin() const
{ return fZoomMin; }
Double_t GetZoomMax() const
{ return fZoomMax; }
void SetZoomMinMax(Double_t min, Double_t max)
{ SetZoomMin(min); SetZoomMax(max); }
void SetDollyToZoom(Bool_t x)
{ fDollyToZoom = x; }
Bool_t GetDollyToZoom() const
{ return fDollyToZoom; }