rendering_engine::Camera Class Reference

Represents a 3D perspective camera with world transform and projection settings. More...

#include <camera.hpp>

Public Member Functions
	Camera (IApplication &app)
	Constructs a camera for the given application context.
virtual	~Camera ()=default
	Virtual destructor.
virtual void	Initialize ()
	Initializes camera parameters and matrices.
virtual void	Update (float deltaTime)
	Updates camera logic, recalculates view/projection matrices as needed.
void	SetPosition (const glm::vec3 &position)
	Sets the camera position in world space.
void	SetRotation (const glm::quat &rotation)
	Sets the camera rotation via quaternion.
void	SetRotation (const glm::vec3 &rotation)
	Sets the camera rotation via Euler angles (degrees).
glm::vec3	GetPosition () const
	Gets the camera position.
glm::quat	GetRotationQuat () const
	Gets the camera rotation as a quaternion.
glm::vec3	GetRotation () const
	Gets the camera rotation as Euler angles (degrees).
glm::vec3	GetForward () const
	Gets the camera's forward direction vector.
glm::vec3	GetUp () const
	Gets the camera's up direction vector.
glm::vec3	GetRight () const
	Gets the camera's right direction vector.
const glm::mat4 &	ViewMatrix () const
	Gets the camera view matrix.
const glm::mat4 &	ProjectionMatrix () const
	Gets the camera projection matrix.
glm::mat4	ViewProjectionMatrix () const
	Gets the combined view-projection matrix.
void	Reset ()
	Resets the camera to the default position and rotation.
void	UpdateProjectionMatrix ()
	Updates the camera's projection matrix (based on FOV, aspect, near/far).
void	UpdateViewMatrix ()
	Updates the camera's view matrix (based on position/orientation).
	Camera (const Camera &rhs)=delete
Camera &	operator= (const Camera &rhs)=delete

Protected Attributes
IApplication &	mApp
std::unique_ptr< SceneComponent >	mSceneComponent
glm::mat4	mViewMatrix
glm::mat4	mProjectionMatrix
float	mFieldOfView
float	mAspectRatio
float	mNearPlaneDistance
float	mFarPlaneDistance

Static Protected Attributes
static const float	sDefaultFieldOfView = 45.0f
static const float	sDefaultAspectRatio
static const float	sDefaultNearPlaneDistance = 0.01f
static const float	sDefaultFarPlaneDistance = 1000.0f

Detailed Description

Represents a 3D perspective camera with world transform and projection settings.

The Camera defines the viewpoint in the 3D scene, including position and orientation (via a SceneComponent) and projection parameters (field of view, aspect ratio, near/far planes). The camera supports standard view matrix construction using GLM and can be subclassed for additional camera types (third-person, orbit, etc).

Coordinate System

The rendering engine uses a left-handed coordinate system:

• X+ : Forward (world forward direction)
• Y+ : Right
• Z+ : Up See rendering_engine::axes for axis definitions.

By default, the camera looks along the world Y+ direction after Reset().

Note

• Angles (Euler) are in degrees, matching typical editor/engine conventions.
• The camera transform is provided by a SceneComponent.
• The camera generates a perspective projection matrix using a vertical field of view.

See also

rendering_engine::SceneComponent

rendering_engine::axes

Definition at line 47 of file camera.hpp.

Constructor & Destructor Documentation

Camera() [1/2]

rendering_engine::Camera::Camera

(

IApplication &

app

)

Constructs a camera for the given application context.

Parameters

app	Reference to the IApplication (for screen settings, etc.).

Definition at line 12 of file camera.cpp.

    :
    mApp(app),
    mSceneComponent(std::make_unique<SceneComponent>()),
    mFieldOfView(sDefaultFieldOfView),
    mNearPlaneDistance(sDefaultNearPlaneDistance),
    mFarPlaneDistance(sDefaultFarPlaneDistance)
{
    mAspectRatio = static_cast<float>(mApp.GetScreenSettings().width) /
        static_cast<float>(mApp.GetScreenSettings().height);
}

~Camera()

virtual rendering_engine::Camera::~Camera ( )

virtualdefault

Virtual destructor.

Camera() [2/2]

rendering_engine::Camera::Camera ( const Camera & rhs )

delete

Member Function Documentation

GetForward()

glm::vec3 rendering_engine::Camera::GetForward

(

)

const

Gets the camera's forward direction vector.

Definition at line 59 of file camera.cpp.

{
    return mSceneComponent->GetForward();
}

GetPosition()

glm::vec3 rendering_engine::Camera::GetPosition

(

)

const

Gets the camera position.

Definition at line 47 of file camera.cpp.

{
    return mSceneComponent->GetPosition();
}

GetRight()

glm::vec3 rendering_engine::Camera::GetRight

(

)

const

Gets the camera's right direction vector.

Definition at line 67 of file camera.cpp.

{
    return mSceneComponent->GetRight();
}

GetRotation()

glm::vec3 rendering_engine::Camera::GetRotation

(

)

const

Gets the camera rotation as Euler angles (degrees).

Definition at line 55 of file camera.cpp.

{
    return mSceneComponent->GetRotation();
}

GetRotationQuat()

glm::quat rendering_engine::Camera::GetRotationQuat

(

)

const

Gets the camera rotation as a quaternion.

Definition at line 51 of file camera.cpp.

{
    return mSceneComponent->GetRotationQuat();
}

GetUp()

glm::vec3 rendering_engine::Camera::GetUp

(

)

const

Gets the camera's up direction vector.

Definition at line 63 of file camera.cpp.

{
    return mSceneComponent->GetUp();
}

Initialize()

void rendering_engine::Camera::Initialize ( )

virtual

Initializes camera parameters and matrices.

Definition at line 24 of file camera.cpp.

{
    UpdateProjectionMatrix();
    Reset();
    UpdateViewMatrix();
}

operator=()

Camera & rendering_engine::Camera::operator= ( const Camera & rhs )

delete

ProjectionMatrix()

const glm::mat4 & rendering_engine::Camera::ProjectionMatrix

(

)

const

Gets the camera projection matrix.

Definition at line 75 of file camera.cpp.

{
    return mProjectionMatrix;
}

Reset()

void rendering_engine::Camera::Reset

(

)

Resets the camera to the default position and rotation.

Definition at line 83 of file camera.cpp.

{
    // Turn leff, as by default it will look to the right
    SetPosition(glm::vec3(-10.0f, 0.0f, 0.0f));
    SetRotation(glm::vec3(0.0f, 0.0f, 0.0f)); 
}

SetPosition()

void rendering_engine::Camera::SetPosition

(

const glm::vec3 &

position

)

Sets the camera position in world space.

Parameters

position

New position (glm::vec3).

Definition at line 35 of file camera.cpp.

{
    mSceneComponent->SetPosition(position);
}

SetRotation() [1/2]

void rendering_engine::Camera::SetRotation

(

const glm::quat &

rotation

)

Sets the camera rotation via quaternion.

Parameters

rotation

New rotation (glm::quat).

Definition at line 39 of file camera.cpp.

{
    mSceneComponent->SetRotation(rotation);
}

SetRotation() [2/2]

void rendering_engine::Camera::SetRotation

(

const glm::vec3 &

rotation

)

Sets the camera rotation via Euler angles (degrees).

Parameters

rotation

Euler angles (pitch, yaw, roll), in degrees.

Definition at line 43 of file camera.cpp.

{
    mSceneComponent->SetRotation(rotation);
}

Update()

void rendering_engine::Camera::Update ( float deltaTime )

virtual

Updates camera logic, recalculates view/projection matrices as needed.

Parameters

deltaTime

Elapsed time since last update (seconds).

Definition at line 30 of file camera.cpp.

{
    UpdateViewMatrix();
    UpdateProjectionMatrix();
}

UpdateProjectionMatrix()

void rendering_engine::Camera::UpdateProjectionMatrix

(

)

Updates the camera's projection matrix (based on FOV, aspect, near/far).

Definition at line 89 of file camera.cpp.

{
    mAspectRatio = static_cast<float>(mApp.GetScreenSettings().width) /
        static_cast<float>(mApp.GetScreenSettings().height);
    mProjectionMatrix = glm::perspective(glm::radians(mFieldOfView), mAspectRatio, mNearPlaneDistance, mFarPlaneDistance);
}

UpdateViewMatrix()

void rendering_engine::Camera::UpdateViewMatrix

(

)

Updates the camera's view matrix (based on position/orientation).

Definition at line 95 of file camera.cpp.

{
    const glm::vec3 target = mSceneComponent->GetPosition() + mSceneComponent->GetForward();
    mViewMatrix = glm::lookAt(mSceneComponent->GetPosition(), target, mSceneComponent->GetUp());
}

ViewMatrix()

const glm::mat4 & rendering_engine::Camera::ViewMatrix

(

)

const

Gets the camera view matrix.

Definition at line 71 of file camera.cpp.

{
    return mViewMatrix;
}

ViewProjectionMatrix()

glm::mat4 rendering_engine::Camera::ViewProjectionMatrix

(

)

const

Gets the combined view-projection matrix.

Definition at line 79 of file camera.cpp.

{
    return mProjectionMatrix * mViewMatrix;
}

Member Data Documentation

mApp

IApplication& rendering_engine::Camera::mApp

protected

Definition at line 154 of file camera.hpp.

mAspectRatio

float rendering_engine::Camera::mAspectRatio

protected

Definition at line 167 of file camera.hpp.

mFarPlaneDistance

float rendering_engine::Camera::mFarPlaneDistance

protected

Definition at line 169 of file camera.hpp.

mFieldOfView

float rendering_engine::Camera::mFieldOfView

protected

Definition at line 166 of file camera.hpp.

mNearPlaneDistance

float rendering_engine::Camera::mNearPlaneDistance

protected

Definition at line 168 of file camera.hpp.

mProjectionMatrix

glm::mat4 rendering_engine::Camera::mProjectionMatrix

protected

Definition at line 159 of file camera.hpp.

mSceneComponent

std::unique_ptr<SceneComponent> rendering_engine::Camera::mSceneComponent

protected

Definition at line 156 of file camera.hpp.

mViewMatrix

glm::mat4 rendering_engine::Camera::mViewMatrix

protected

Definition at line 158 of file camera.hpp.

sDefaultAspectRatio

const float rendering_engine::Camera::sDefaultAspectRatio

staticprotected

Definition at line 162 of file camera.hpp.

sDefaultFarPlaneDistance

const float rendering_engine::Camera::sDefaultFarPlaneDistance = 1000.0f

staticprotected

Definition at line 164 of file camera.hpp.

sDefaultFieldOfView

const float rendering_engine::Camera::sDefaultFieldOfView = 45.0f

staticprotected

Definition at line 161 of file camera.hpp.

sDefaultNearPlaneDistance

const float rendering_engine::Camera::sDefaultNearPlaneDistance = 0.01f

staticprotected

Definition at line 163 of file camera.hpp.

---

The documentation for this class was generated from the following files:

• camera.hpp
• camera.cpp