renderstack::camera Class Reference

holds necessary information to produce projection matrix

#include <camera.hpp>

Inherits renderstack::frame.

Public Member Functions
	camera ()
void	update (viewport const &viewport)
void	update_frame (frame const &frame)
bool	connect (uniform_bindings &bindings, enum logical_uniform uniform, int slot)
void	set_near_clip (float v)
void	set_far_clip (float v)
void	set_projection_type (enum camera_projection v)
void	set_fov (float angle_radians)
void	set_ortho_width (float v)
void	set_ortho_height (float v)
float	near_clip () const
float	far_clip () const
enum camera_projection	projection_type () const
float	fov () const
float	ortho_width () const
float	ortho_height () const
matrix const &	frame_to_clip () const
matrix const &	frame_to_camera () const
matrix const &	world_to_clip () const
matrix const &	clip_to_world () const
matrix const &	clip_to_local () const
matrix const &	local_to_clip () const
matrix &	frame_to_clip ()
matrix &	frame_to_camera ()
matrix &	world_to_clip ()
matrix &	clip_to_world ()
matrix &	clip_to_local ()
matrix &	local_to_clip ()

---

Detailed Description

Definition at line 53 of file camera.hpp.

---

Constructor & Destructor Documentation

renderstack::camera::camera

(

)

Definition at line 33 of file camera.cpp.

{
    m_near_clip       = 0.1f;
    m_far_clip        = 100.0f;
    m_projection_type = camera_projection_perspective_vertical;
    m_fov             = 90.0f * RS_PI / 180.0f;
}

---

Member Function Documentation

void renderstack::camera::update

(

viewport const &

viewport

)

Definition at line 55 of file camera.cpp.

{
    switch(m_projection_type)
    {
        case camera_projection_perspective_horizontal:
        {
            m_local_to_clip = make_matrix_perspective_horizontal(
                m_fov,
                viewport.aspect_ratio(),
                m_near_clip,
                m_far_clip
            );
            break;
        }
        case camera_projection_perspective_vertical:
        {
            m_local_to_clip = make_matrix_perspective_vertical(
                m_fov,
                viewport.aspect_ratio(),
                m_near_clip,
                m_far_clip
            );
            break;
        }
        case camera_projection_orthogonal_horizontal:
        {
            m_local_to_clip = make_matrix_orthogonal_centered(
                m_ortho_width,
                m_ortho_width / viewport.aspect_ratio(),
                m_near_clip,
                m_far_clip
            );
            break;
        }
        case camera_projection_orthogonal_vertical:
        {
            m_local_to_clip = make_matrix_orthogonal_centered(
                m_ortho_height * viewport.aspect_ratio(),
                m_ortho_height,
                m_near_clip,
                m_far_clip
            );
            break;
        }
        case camera_projection_orthogonal:
        {
            m_local_to_clip = make_matrix_orthogonal(
                0,
                m_ortho_width,
                0,
                m_ortho_height,
                m_near_clip, 
                m_far_clip
            );
            break;
        }
        default:
        {
            throw invalid_camera_projection_exception();
        }
    }

    {
        m_clip_to_local = inverse(m_local_to_clip);
    }

    m_world_to_clip = local_to_clip() * world_to_local();
    m_clip_to_world = local_to_world() * clip_to_local();
}

void renderstack::camera::update_frame

(

frame const &

frame

)

Definition at line 125 of file camera.cpp.

{
    m_frame_to_clip   = this->world_to_clip() * frame.local_to_world();
    m_frame_to_camera = this->world_to_local() * frame.local_to_world();
}

bool renderstack::camera::connect	(	uniform_bindings &	bindings,
		enum logical_uniform	uniform,
		int	slot
	)			[virtual]

Reimplemented from renderstack::frame.

Definition at line 41 of file camera.cpp.

{
    switch(uniform)
    {
        case logical_uniform_local_to_clip         : return bindings.add(uniform_type_matrix_4, slot, 1, &frame_to_clip().m[0][0]);
        case logical_uniform_clip_to_local         : return bindings.add(uniform_type_matrix_4, slot, 1, &clip_to_local().m[0][0]);
        case logical_uniform_world_to_clip         : return bindings.add(uniform_type_matrix_4, slot, 1, &world_to_clip().m[0][0]);
        case logical_uniform_clip_to_world         : return bindings.add(uniform_type_matrix_4, slot, 1, &clip_to_world().m[0][0]);
        case logical_uniform_view_position_in_world: return bindings.add(uniform_type_vec3,     slot, 1, &local_to_world().m[3][0]);
        default: 
            return false;
    }
}

void renderstack::camera::set_near_clip

(

float

v

)

[inline]

Definition at line 65 of file camera.hpp.

{ m_near_clip = v; }

void renderstack::camera::set_far_clip

(

float

v

)

[inline]

Definition at line 66 of file camera.hpp.

{ m_far_clip = v; }

void renderstack::camera::set_projection_type

(

enum camera_projection

v

)

[inline]

Definition at line 67 of file camera.hpp.

{ m_projection_type = v; }

void renderstack::camera::set_fov

(

float

angle_radians

)

[inline]

Definition at line 68 of file camera.hpp.

{ m_fov = angle_radians; }

void renderstack::camera::set_ortho_width

(

float

v

)

[inline]

Definition at line 69 of file camera.hpp.

{ m_ortho_width = v; }

void renderstack::camera::set_ortho_height

(

float

v

)

[inline]

Definition at line 70 of file camera.hpp.

{ m_ortho_height = v; }

float renderstack::camera::near_clip

(

)

const [inline]

Definition at line 72 of file camera.hpp.

{ return m_near_clip; }

float renderstack::camera::far_clip

(

)

const [inline]

Definition at line 73 of file camera.hpp.

{ return m_far_clip; }

enum camera_projection renderstack::camera::projection_type

(

)

const [inline]

Definition at line 74 of file camera.hpp.

{ return m_projection_type; }

float renderstack::camera::fov

(

)

const [inline]

Definition at line 75 of file camera.hpp.

{ return m_fov; }

float renderstack::camera::ortho_width

(

)

const [inline]

Definition at line 76 of file camera.hpp.

{ return m_ortho_width; }

float renderstack::camera::ortho_height

(

)

const [inline]

Definition at line 77 of file camera.hpp.

{ return m_ortho_height; }

matrix const& renderstack::camera::frame_to_clip

(

)

const [inline]

Definition at line 79 of file camera.hpp.

{ return m_frame_to_clip; }

matrix const& renderstack::camera::frame_to_camera

(

)

const [inline]

Definition at line 80 of file camera.hpp.

{ return m_frame_to_camera; }

matrix const& renderstack::camera::world_to_clip

(

)

const [inline]

Definition at line 81 of file camera.hpp.

{ return m_world_to_clip; }

matrix const& renderstack::camera::clip_to_world

(

)

const [inline]

Definition at line 82 of file camera.hpp.

{ return m_clip_to_world; }

matrix const& renderstack::camera::clip_to_local

(

)

const [inline]

Definition at line 83 of file camera.hpp.

{ return m_clip_to_local; }

matrix const& renderstack::camera::local_to_clip

(

)

const [inline]

Definition at line 84 of file camera.hpp.

{ return m_local_to_clip; }

matrix& renderstack::camera::frame_to_clip

(

)

[inline]

Definition at line 86 of file camera.hpp.

{ return m_frame_to_clip; }

matrix& renderstack::camera::frame_to_camera

(

)

[inline]

Definition at line 87 of file camera.hpp.

{ return m_frame_to_camera; }

matrix& renderstack::camera::world_to_clip

(

)

[inline]

Definition at line 88 of file camera.hpp.

{ return m_world_to_clip; }

matrix& renderstack::camera::clip_to_world

(

)

[inline]

Definition at line 89 of file camera.hpp.

{ return m_clip_to_world; }

matrix& renderstack::camera::clip_to_local

(

)

[inline]

Definition at line 90 of file camera.hpp.

{ return m_clip_to_local; }

matrix& renderstack::camera::local_to_clip

(

)

[inline]

Definition at line 91 of file camera.hpp.

{ return m_local_to_clip; }

---

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

• camera.hpp
• camera.cpp