D:/SoftwareEntwicklung/C++/HLC/Tools/SoftPixelEngine/repository/sources/SceneGraph/spSceneCamera.hpp

Go to the documentation of this file.

/*
 * Camera scene node header
 * 
 * This file is part of the "SoftPixel Engine" (Copyright (c) 2008 by Lukas Hermanns)
 * See "SoftPixelEngine.hpp" for license information.
 */

#ifndef __SP_SCENE_CAMERA_H__
#define __SP_SCENE_CAMERA_H__


#include "Base/spStandard.hpp"
#include "Base/spDimension.hpp"
#include "Base/spViewFrustum.hpp"
#include "Base/spProjection.hpp"
#include "SceneGraph/spSceneNode.hpp"
#include "SceneGraph/spSceneMesh.hpp"

#include <vector>


namespace sp
{
namespace scene
{


static const f32 DEF_PICKING_LENGTH = -1.0f;

#ifdef SP_COMPILE_WITH_SCENEGRAPH_PORTAL_BASED
class SceneGraphPortalBased;
#endif


class SP_EXPORT Camera : public SceneNode
{
    
    public:
        
        Camera();
        Camera(const dim::rect2di &Viewport, f32 NearPlane, f32 FarPlane, f32 FieldOfView = DEF_PERSPECTIVE_FOV);
        virtual ~Camera();
        
        /* === Functions === */
        
        virtual void updateControl();
        
        virtual void drawMenu();
        
        void setRange(f32 NearRange, f32 FarRange);
        
        void setRangeNear(f32 NearRange);
        void setRangeFar(f32 FarRange);
        
        void setFOV(f32 FieldOfView);
        
        void setZoom(f32 Zoom);
        f32 getZoom() const;
        
        void setOrtho(bool isOrtho);
        
        void setViewport(const dim::rect2di &Viewport);
        
        void setPerspective(const dim::rect2di &Viewport, f32 NearRange, f32 FarRange, f32 FieldOfView = DEF_PERSPECTIVE_FOV);
        void getPerspective(dim::rect2di &Viewport, f32 &NearRange, f32 &FarRange, f32 &FieldOfView);
        
        dim::point2di getProjection(dim::vector3df Position) const;
        
        dim::line3df getPickingLine(const dim::point2di &Position, f32 Length = DEF_PICKING_LENGTH) const;
        
        void lookAt(dim::vector3df Position, bool isGlobal = false);
        
        inline void setupRenderView()
        {
            setupCameraView();
            updateTransformation();
        }
        
        virtual void setupCameraView();
        virtual void updateTransformation();
        
        Camera* copy() const;
        
        const dim::matrix4f& getProjectionMatrix() const;
        
        /* === Inline functions === */
        
        inline void setProjection(const Projection &Proj)
        {
            Projection_ = Proj;
        }
        inline const Projection& getProjection() const
        {
            return Projection_;
        }
        inline Projection& getProjection()
        {
            return Projection_;
        }
        
        inline const ViewFrustum& getViewFrustum() const
        {
            return ViewFrustum_;
        }
        
        inline f32 getRangeNear() const
        {
            return Projection_.getNearPlane();
        }
        inline f32 getRangeFar() const
        {
            return Projection_.getFarPlane();
        }
        
        inline f32 getFOV() const
        {
            return Projection_.getFOV();
        }
        
        inline bool getOrtho() const
        {
            return Projection_.getOrtho();
        }
        
        inline const dim::rect2di& getViewport() const
        {
            return Projection_.getViewport();
        }
        
        inline void setMirrorMatrix(const dim::matrix4f &Matrix)
        {
            MirrorMatrix_ = Matrix;
        }
        inline const dim::matrix4f& getMirrorMatrix() const
        {
            return MirrorMatrix_;
        }
        
        inline void setMirror(bool isMirror)
        {
            isMirror_ = isMirror;
        }
        inline bool getMirror() const
        {
            return isMirror_;
        }
        
    protected:
        
        #ifdef SP_COMPILE_WITH_SCENEGRAPH_PORTAL_BASED
        friend class SceneGraphPortalBased;
        #endif
        
        /* === Members === */
        
        Projection Projection_;
        ViewFrustum ViewFrustum_;
        
        dim::matrix4f MirrorMatrix_;
        bool isMirror_;
        
};


} // /namespace scene

} // /namespace sp


#endif



// ================================================================================