VRS - The Virtual Rendering System

version 3.3

camera.h

Go to the documentation of this file.

 /**********************************************************************
 VRS - The Virtual Rendering System
 Copyright (C) 2001 Computer Graphics Systems Group at the 
 Hasso-Plattner-Institute, Potsdam, Germany.
 This library is free software; you can redistribute it and/or 
 modify it under the terms of the GNU Lesser General Public 
 License as published by the Free Software Foundation; either 
 version 2.1 of the License, or (at your option) any later version.
 This library is distributed in the hope that it will be useful, but 
 WITHOUT ANY WARRANTY; without even the implied warranty of 
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
 See the GNU Lesser General Public License for more details.
 You should have received a copy of the GNU Lesser+ General Public
 License along with this library; if not, write to the FreeSoftware 
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA, 02111-1307, USA.
 **********************************************************************/
// $Id: camera.h 6654 2009-01-30 09:57:05Z Rico_Richter $
// $Date: 2009-01-30 10:57:05 +0100 (Fri, 30 Jan 2009) $
// $Revision: 6654 $
// $State$
// $Author: Rico_Richter $
//
// $Log$
// Revision 1.30  2005/10/21 08:52:23  baumann
// missing include added
//
// Revision 1.29  2005/01/03 01:43:07  klimetschek
// - modified win32 project layout, splitted vrs.vcproj into vrs_container, vrs_core, vrs_sg, vrs_image, vrs_opengl and vrs_io
// - removed vrs.vcproj
// minor things:
// - added all glutexamples to vrs4glut.sln
// - fixed some problems in glutexamples
// - removed all project references from all VS projects (using solution wide project dependencies instead)
//
// Revision 1.28  2004/12/17 09:46:40  baumann
// added arguments z1 and z2 to newPixelCoordsCamera()
//
// Revision 1.27  2004/12/17 08:06:56  baumann
// return type for newPixelCoordsCamera() changed from Camera* to SO<Camera>
//
// Revision 1.26  2004/11/05 13:58:09  basch
// Class comment changed (Doxygen style)
//
// Revision 1.25  2004/09/18 13:07:13  baumann
// added method newNormalizedDeviceCoordsCamera(const Bounds& bbox)
//
// Revision 1.24  2004/03/22 11:19:38  grabs
// newNormalizedDeviceCoordsCamera() got some parameters for even more convenience
//
// Revision 1.23  2004/03/12 16:28:38  baumann
// macros VRS_NAMESPACE_BEGIN/_END expanded and removed
//
// Revision 1.22  2004/01/19 11:43:56  baumann
// serialization mechanism improved
//
// Revision 1.21  2004/01/19 07:28:03  baumann
// serialization mechanism improved
//
// Revision 1.20  2003/11/29 11:29:23  kirsch
// - added support for local poly attributes
// - removed PolyAttribute::switchDefault() and Attribute::rememberTransform()
// - renamed Engine::SwType: On/Off/All to Engine::SwitchType: ON/OFF/ALL
// - changed class hierarchy of TechniqueProcessor and Technique
// - GLCanvas::prepareRedisplay() / finishRedisplay() now push / pop standard attributes
//
// Revision 1.19  2003/11/07 14:19:23  kirsch
// removed leading underscore from include guards
//
// Revision 1.18  2003/07/09 13:32:11  kirsch
// moved functionality of ImmediateCamera, CanvasTransform and PixelCoordinateHandler to Camera
// removed CanvasTransform and PixelCoordinateHandler
// deprecated ImmediateCamera, ResizeHandler and SceneView
// see ChangeLog for more details
//
// Revision 1.17  2002/10/29 10:32:51  baumann
// macros VRS_CLASSNAME_* and VRS_IMPL_TYPEINFO_* removed
//
// Revision 1.16  2002/06/24 14:03:38  baumann
// changed List<T> to Array<T>
//
// Revision 1.15  2002/04/27 08:19:31  kirsch
// made getTransform const
//
// Revision 1.14  2002/03/04 11:08:34  kersting
// directory structure changes
//
// Revision 1.13  2002/03/03 21:44:24  kosta
// VRS_TYPEINFO-macro rewritten
//
// Revision 1.12  2002/02/19 10:34:07  kosta
// undone all changes since 2002-02-15
//
// Revision 1.9  2002/02/13 16:54:50  kirsch
// changed: Camera contains ResizeHandler
//
// Revision 1.8  2002/02/05 07:48:24  kosta
// new persistency macros:
//     VRS_SERIALIZABLE(CLASS_NAME);
//     VRS_SERIALIZABLE_ABSTRACT_CLASS(CLASS_NAME);
//     VRS_SERIALIZABLE_NO_SO_CLASS(CLASS_NAME)
//
// Revision 1.7  2002/02/04 13:07:19  kosta
// VRS_SERIALIZABLE macros completely rewritten
//
// Revision 1.6  2002/01/15 16:25:53  kosta
// macros rewritten for a better namespace support
//
// Revision 1.5  2001/11/13 16:36:30  kirsch
// changed line feed to unix style (removed control-M)
//
// Revision 1.4  2001/09/05 10:56:11  kirsch
// Documentation updates
//
// Revision 1.3  2001/07/30 11:17:25  kirsch
// ResizeHandler and PaneManipulator can now use Camera
//
// Revision 1.2  2001/07/26 15:23:47  kirsch
// added camera-attribute
//
// Revision 1.1.2.1  2001/06/26 20:24:38  kirsch
// Added camera-attribute, painter and technique
//

#ifndef VRS_CAMERA_H
#define VRS_CAMERA_H

#include <vrs/bounds.h>
#include <vrs/monoattribute.h>
#include <vrs/transform.h>
#include <vrs/viewinfo.h>

namespace VRS {

template<typename T> class Array;
template<typename T> class Iterator;

class VRS_CORE_API Camera : public MonoAttribute {

public:

    enum Scope { SCENE, LOCAL };
    VRS_SERIALIZABLE_CLASS_ENUM(Scope);

    enum SizePolicy { NO_POLICY, SAME_SIZE, FIT_INSIDE, FIT_OUTSIDE };
    VRS_SERIALIZABLE_CLASS_ENUM(SizePolicy);
    Camera(Transform* projection = 0, Transform* orientation = 0, 
           Scope = Camera::SCENE, SizePolicy = Camera::FIT_INSIDE);
    Camera(Vector from, Vector to, double angle, double nearPlane=0, double farPlane=0, 
           Scope = Camera::SCENE, SizePolicy = Camera::FIT_INSIDE);
    static SO<Camera> newNormalizedDeviceCoordsCamera(
        double x1 = -1.0, double x2 =   1.0,
        double y1 = -1.0, double y2 =   1.0,
        double z1 = -1.0, double z2 = 100.0
    );
    static SO<Camera> newNormalizedDeviceCoordsCamera(
        const Bounds& bbox
    );

    static SO<Camera> newPixelCoordsCamera(
        double z1 = -1.0, double z2 = 100.0
    );

    void setOrientation(Transform* tf);
    Transform* getOrientation() const;
    
    void setProjection(Transform* tf);
    Transform* getProjection() const;

    void setScope(Scope);
    Scope getScope() const;

    void setSizePolicy(SizePolicy);
    SizePolicy getSizePolicy() const;

    void setPixelCoordsTransform(bool);
    bool getPixelCoordsTransform() const;

    void pushTransform(Transform* tf);
    Iterator<SO<Transform> >* getTransform() const;
    void popTransform();

    virtual SO<ViewInfoFactory> newViewInfoFactory() const;

    VRS_TYPEINFO(Camera, MonoAttribute);
    VRS_SERIALIZABLE(Camera);

private:
    SO<Transform> projection_;
    SO<Transform> orientation_;
    Camera::Scope scope_;
    Camera::SizePolicy policy_;
    bool pixelCoordsTransform_;
    SO<Array<SO<Transform> > > transform_;

    bool init_;
};

class Engine;

class VRS_CORE_API CameraViewInfo :
    public ModelviewProjectionViewInfo
{
public:
    VRS_TYPEINFO(CameraViewInfo, ModelviewProjectionViewInfo);

    CameraViewInfo(
        SO<const Camera> camera,
        SO<const Engine> engine,
        unsigned int viewportSizeX,
        unsigned int viewportSizeY
    );

    virtual CullingPos culling(const Vector& point, double radius) const;
    virtual CullingPos culling(const Vector& point) const;
    virtual CullingPos culling(const Bounds& bbox) const;

protected:
    template<class T>
    CullingPos cullPlanes(const T& obj) const;

private:
    SO<const Camera> m_camera;
    WO<const Engine> m_engine;
        bool m_testCullingPlanes;
};

inline Transform* Camera::getOrientation() const        { return orientation_; }
inline Transform* Camera::getProjection() const         { return projection_; }
inline Camera::Scope Camera::getScope() const           { return scope_; }
inline Camera::SizePolicy Camera::getSizePolicy() const { return policy_; }
inline bool Camera::getPixelCoordsTransform() const     { return pixelCoordsTransform_; }

} // namespace VRS

#endif // VRS_CAMERA_H

---

Generated on Fri May 18 06:00:13 2012 by Doxygen 1.5.6

© 2001-2010 Hasso-Plattner-Institut | Impressum | Contact