// Copyright (C) 2002-2011 Nikolaus Gebhardt // This file is part of the "Irrlicht Engine". // For conditions of distribution and use, see copyright notice in irrlicht.h #ifndef __C_CAMERA_SCENE_NODE_H_INCLUDED__ #define __C_CAMERA_SCENE_NODE_H_INCLUDED__ #include "ICameraSceneNode.h" #include "SViewFrustum.h" namespace irr { namespace scene { class CCameraSceneNode : public ICameraSceneNode { public: //! constructor CCameraSceneNode(ISceneNode* parent, ISceneManager* mgr, s32 id, const core::vector3df& position = core::vector3df(0,0,0), const core::vector3df& lookat = core::vector3df(0,0,100)); //! Sets the projection matrix of the camera. /** The core::matrix4 class has some methods to build a projection matrix. e.g: core::matrix4::buildProjectionMatrixPerspectiveFovLH. Note that the matrix will only stay as set by this method until one of the following Methods are called: setNearValue, setFarValue, setAspectRatio, setFOV. \param projection The new projection matrix of the camera. \param isOrthogonal Set this to true if the matrix is an orthogonal one (e.g. from matrix4::buildProjectionMatrixOrthoLH(). */ virtual void setProjectionMatrix(const core::matrix4& projection, bool isOrthogonal = false); //! Gets the current projection matrix of the camera //! \return Returns the current projection matrix of the camera. virtual const core::matrix4& getProjectionMatrix() const; //! Gets the current view matrix of the camera //! \return Returns the current view matrix of the camera. virtual const core::matrix4& getViewMatrix() const; //! Sets a custom view matrix affector. /** \param affector: The affector matrix. */ virtual void setViewMatrixAffector(const core::matrix4& affector); //! Gets the custom view matrix affector. virtual const core::matrix4& getViewMatrixAffector() const; //! It is possible to send mouse and key events to the camera. Most cameras //! may ignore this input, but camera scene nodes which are created for //! example with scene::ISceneManager::addMayaCameraSceneNode or //! scene::ISceneManager::addMeshViewerCameraSceneNode, may want to get this input //! for changing their position, look at target or whatever. virtual bool OnEvent(const SEvent& event); //! Sets the look at target of the camera /** If the camera's target and rotation are bound ( @see bindTargetAndRotation() ) then calling this will also change the camera's scene node rotation to match the target. \param pos: Look at target of the camera. */ virtual void setTarget(const core::vector3df& pos); //! Sets the rotation of the node. /** This only modifies the relative rotation of the node. If the camera's target and rotation are bound ( @see bindTargetAndRotation() ) then calling this will also change the camera's target to match the rotation. \param rotation New rotation of the node in degrees. */ virtual void setRotation(const core::vector3df& rotation); //! Gets the current look at target of the camera /** \return The current look at target of the camera */ virtual const core::vector3df& getTarget() const; //! Sets the up vector of the camera. //! \param pos: New upvector of the camera. virtual void setUpVector(const core::vector3df& pos); //! Gets the up vector of the camera. //! \return Returns the up vector of the camera. virtual const core::vector3df& getUpVector() const; //! Gets distance from the camera to the near plane. //! \return Value of the near plane of the camera. virtual f32 getNearValue() const; //! Gets the distance from the camera to the far plane. //! \return Value of the far plane of the camera. virtual f32 getFarValue() const; //! Get the aspect ratio of the camera. //! \return The aspect ratio of the camera. virtual f32 getAspectRatio() const; //! Gets the field of view of the camera. //! \return Field of view of the camera virtual f32 getFOV() const; //! Sets the value of the near clipping plane. (default: 1.0f) virtual void setNearValue(f32 zn); //! Sets the value of the far clipping plane (default: 2000.0f) virtual void setFarValue(f32 zf); //! Sets the aspect ratio (default: 4.0f / 3.0f) virtual void setAspectRatio(f32 aspect); //! Sets the field of view (Default: PI / 3.5f) virtual void setFOV(f32 fovy); //! PreRender event virtual void OnRegisterSceneNode(); //! Render virtual void render(); //! Returns the axis aligned bounding box of this node virtual const core::aabbox3d<f32>& getBoundingBox() const; //! Returns the view area. Sometimes needed by bsp or lod render nodes. virtual const SViewFrustum* getViewFrustum() const; //! Disables or enables the camera to get key or mouse inputs. //! If this is set to true, the camera will respond to key inputs //! otherwise not. virtual void setInputReceiverEnabled(bool enabled); //! Returns if the input receiver of the camera is currently enabled. virtual bool isInputReceiverEnabled() const; //! Writes attributes of the scene node. virtual void serializeAttributes(io::IAttributes* out, io::SAttributeReadWriteOptions* options=0) const; //! Reads attributes of the scene node. virtual void deserializeAttributes(io::IAttributes* in, io::SAttributeReadWriteOptions* options=0); //! Returns type of the scene node virtual ESCENE_NODE_TYPE getType() const { return ESNT_CAMERA; } //! Binds the camera scene node's rotation to its target position and vice vera, or unbinds them. virtual void bindTargetAndRotation(bool bound); //! Queries if the camera scene node's rotation and its target position are bound together. virtual bool getTargetAndRotationBinding(void) const; //! Creates a clone of this scene node and its children. virtual ISceneNode* clone(ISceneNode* newParent=0, ISceneManager* newManager=0); protected: void recalculateProjectionMatrix(); void recalculateViewArea(); core::vector3df Target; core::vector3df UpVector; f32 Fovy; // Field of view, in radians. f32 Aspect; // Aspect ratio. f32 ZNear; // value of the near view-plane. f32 ZFar; // Z-value of the far view-plane. SViewFrustum ViewArea; core::matrix4 Affector; bool InputReceiverEnabled; bool TargetAndRotationAreBound; }; } // end namespace } // end namespace #endif
