mirror of https://github.com/axmolengine/axmol.git
165 lines
5.0 KiB
C
165 lines
5.0 KiB
C
|
/****************************************************************************
|
||
|
Copyright (c) 2014 Chukong Technologies Inc.
|
||
|
|
||
|
http://www.cocos2d-x.org
|
||
|
|
||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
|
of this software and associated documentation files (the "Software"), to deal
|
||
|
in the Software without restriction, including without limitation the rights
|
||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
|
copies of the Software, and to permit persons to whom the Software is
|
||
|
furnished to do so, subject to the following conditions:
|
||
|
|
||
|
The above copyright notice and this permission notice shall be included in
|
||
|
all copies or substantial portions of the Software.
|
||
|
|
||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||
|
THE SOFTWARE.
|
||
|
****************************************************************************/
|
||
|
#ifndef _CCCAMERA_H__
|
||
|
#define _CCCAMERA_H__
|
||
|
|
||
|
#include "base/CCVector.h"
|
||
|
#include "2d/CCNode.h"
|
||
|
|
||
|
NS_CC_BEGIN
|
||
|
|
||
|
//class Ray;
|
||
|
class Scene;
|
||
|
|
||
|
enum class CameraFlag
|
||
|
{
|
||
|
DEFAULT = 1,
|
||
|
USER1 = 1 << 1,
|
||
|
USER2 = 1 << 2,
|
||
|
USER3 = 1 << 3,
|
||
|
USER4 = 1 << 4,
|
||
|
USER5 = 1 << 5,
|
||
|
USER6 = 1 << 6,
|
||
|
USER7 = 1 << 7,
|
||
|
USER8 = 1 << 8,
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* Defines a camera .
|
||
|
*/
|
||
|
class CC_DLL Camera :public Node
|
||
|
{
|
||
|
public:
|
||
|
/**
|
||
|
* The type of camera.
|
||
|
*/
|
||
|
enum class Type
|
||
|
{
|
||
|
PERSPECTIVE = 1,
|
||
|
ORTHOGRAPHIC = 2
|
||
|
};
|
||
|
public:
|
||
|
/**
|
||
|
* Creates a perspective camera.
|
||
|
*
|
||
|
* @param fieldOfView The field of view for the perspective camera (normally in the range of 40-60 degrees).
|
||
|
* @param aspectRatio The aspect ratio of the camera (normally the width of the viewport divided by the height of the viewport).
|
||
|
* @param nearPlane The near plane distance.
|
||
|
* @param farPlane The far plane distance.
|
||
|
*/
|
||
|
static Camera* createPerspective(float fieldOfView, float aspectRatio, float nearPlane, float farPlane);
|
||
|
/**
|
||
|
* Creates an orthographic camera.
|
||
|
*
|
||
|
* @param zoomX The zoom factor along the X-axis of the orthographic projection (the width of the ortho projection).
|
||
|
* @param zoomY The zoom factor along the Y-axis of the orthographic projection (the height of the ortho projection).
|
||
|
* @param aspectRatio The aspect ratio of the orthographic projection.
|
||
|
* @param nearPlane The near plane distance.
|
||
|
* @param farPlane The far plane distance.
|
||
|
*/
|
||
|
static Camera* createOrthographic(float zoomX, float zoomY, float nearPlane, float farPlane);
|
||
|
|
||
|
/** create default camera, the camera type depends on Director::getProjection */
|
||
|
static Camera* create();
|
||
|
|
||
|
/**
|
||
|
* Gets the type of camera.
|
||
|
*
|
||
|
* @return The camera type.
|
||
|
*/
|
||
|
Camera::Type getType() const { return _type; }
|
||
|
|
||
|
/**get & set Camera flag*/
|
||
|
CameraFlag getCameraFlag() const { return (CameraFlag)_cameraFlag; }
|
||
|
void setCameraFlag(CameraFlag flag) { _cameraFlag = (unsigned short)flag; }
|
||
|
/**
|
||
|
* Sets the position (X, Y, and Z) in its parent's coordinate system
|
||
|
*/
|
||
|
virtual void setPosition3D(const Vec3& position) override;
|
||
|
/**
|
||
|
* Creates a view matrix based on the specified input parameters.
|
||
|
*
|
||
|
* @param eyePosition The eye position.
|
||
|
* @param targetPosition The target's center position.
|
||
|
* @param up The up vector.
|
||
|
* @param dst A matrix to store the result in.
|
||
|
*/
|
||
|
virtual void lookAt(const Vec3& target, const Vec3& up);
|
||
|
|
||
|
/**
|
||
|
* Gets the camera's projection matrix.
|
||
|
*
|
||
|
* @return The camera projection matrix.
|
||
|
*/
|
||
|
const Mat4& getProjectionMatrix() const;
|
||
|
/**
|
||
|
* Gets the camera's view matrix.
|
||
|
*
|
||
|
* @return The camera view matrix.
|
||
|
*/
|
||
|
const Mat4& getViewMatrix();
|
||
|
|
||
|
/**get view projection matrix*/
|
||
|
const Mat4& getViewProjectionMatrix();
|
||
|
|
||
|
/**
|
||
|
* Convert the specified point of viewport from screenspace coordinate into the worldspace coordinate.
|
||
|
*/
|
||
|
void unproject(const Size& viewport, Vec3* src, Vec3* dst);
|
||
|
|
||
|
//override
|
||
|
virtual void onEnter() override;
|
||
|
virtual void onExit() override;
|
||
|
|
||
|
CC_CONSTRUCTOR_ACCESS:
|
||
|
Camera();
|
||
|
~Camera();
|
||
|
|
||
|
void setScene(Scene* scene);
|
||
|
|
||
|
/**set additional matrix for the projection matrix, it multiplys mat to projection matrix when called, used by WP8*/
|
||
|
void setAdditionalProjection(const Mat4& mat);
|
||
|
|
||
|
protected:
|
||
|
|
||
|
Scene* _scene; //Scene camera belongs to
|
||
|
Mat4 _projection;
|
||
|
Mat4 _view;
|
||
|
Mat4 _viewInv;
|
||
|
Mat4 _viewProjection;
|
||
|
Vec3 _up;
|
||
|
Camera::Type _type;
|
||
|
float _fieldOfView;
|
||
|
float _zoom[2];
|
||
|
float _aspectRatio;
|
||
|
float _nearPlane;
|
||
|
float _farPlane;
|
||
|
bool _viewProjectionDirty;
|
||
|
unsigned short _cameraFlag; // camera flag
|
||
|
};
|
||
|
|
||
|
NS_CC_END
|
||
|
|
||
|
#endif// __CCCAMERA_H_
|