Handles the normal racing camera. More...

#include <camera_normal.hpp>

Inheritance diagram for CameraNormal:

[legend]

Public Member Functions
void	restart ()

bool	isDebug ()

bool	isFPS ()

virtual void	update (float dt) OVERRIDE
	Called once per time frame to move the camera to the right position. More...

void	setAmbientLight (const video::SColor &color)
	Sets the ambient light for this camera.

void	setDistanceToKart (float distance)

float	getDistanceToKart () const

const video::SColor &	getAmbientLight () const
	Returns the current ambient light.

Public Member Functions inherited from Camera
void	setMode (Mode mode)
	Sets the mode of the camera. More...

Mode	getMode ()
	Set the camera to the given mode. More...

Mode	getPreviousMode ()
	Returns the last known mode of the camera.

bool	isSpectatorMode ()
	Returns true if camera is a spectator camera.

void	setNextSpectatorMode ()
	Switch to next spectator mode (a -> soccer -> top view -> a)

void	setKart (AbstractKart *new_kart)
	Changes the owner of this camera to the new kart. More...

virtual void	setInitialTransform ()
	Saves the current kart position as the initial starting position for the camera.

virtual void	activate (bool alsoActivateInIrrlicht=true)
	Sets viewport etc. More...

CameraType	getType ()
	Returns the type of this camera.

void	setFoV ()
	Sets the field of view for the irrlicht camera.

int	getIndex () const
	Returns the camera index (or player kart index, which is the same).

core::matrix4	getPreviousPVMatrix () const
	Returns the project-view matrix of the previous frame.

void	setPreviousPVMatrix (core::matrix4 mat)
	Returns the project-view matrix of the previous frame.

const AbstractKart *	getKart () const
	Returns the kart to which this camera is attached.

AbstractKart *	getKart ()
	Returns the kart to which this camera is attached.

void	setAmbientLight (const video::SColor &color)
	Sets the ambient light for this camera.

const video::SColor &	getAmbientLight () const
	Returns the current ambient light.

const core::recti &	getViewport () const
	Returns the viewport of this camera.

const core::vector2df &	getScaling () const
	Returns the scaling in x/y direction for this camera.

scene::ICameraSceneNode *	getCameraSceneNode ()
	Returns the camera scene node.

Vec3	getXYZ ()
	Returs the absolute position of the camera.

void	setupCamera ()
	Sets up the viewport, aspect ratio, field of view, and scaling for this camera.

Private Member Functions
void	moveCamera (float dt, bool smooth, float cam_angle, float distance)
	Moves the camera smoothly from the current camera position (and target) to the new position and target. More...

void	getCameraSettings (Mode mode, float above_kart, float cam_angle, float side_way, float distance, bool smoothing, float cam_roll_angle)
	Determine the camera settings for the current frame. More...

void	positionCamera (float dt, float above_kart, float cam_angle, float side_way, float distance, float smoothing, float cam_roll_angle)
	Actually sets the camera based on the given parameter. More...

	CameraNormal (Camera::CameraType type, int camera_index, AbstractKart *kart)
	Constructor for the normal camera. More...

Private Attributes
video::SColor	m_ambient_light
	Current ambient light for this camera.

float	m_distance
	Distance between the camera and the kart.

float	m_position_speed
	The speed at which the camera changes position.

float	m_target_speed
	The speed at which the camera target changes position.

float	m_rotation_range
	Factor of the effects of steering in camera aim.

Vec3	m_camera_offset

Mode	m_last_smooth_mode

btVector3	m_kart_position

btQuaternion	m_kart_rotation

Friends
class	Camera

class	CameraDebug

class	CameraEnd

Additional Inherited Members
Public Types inherited from Camera
enum	CameraType { CM_TYPE_NORMAL , CM_TYPE_DEBUG , CM_TYPE_FPS , CM_TYPE_END }
	The different camera types that can be used. More...

enum	Mode { CM_NORMAL , CM_CLOSEUP , CM_REVERSE , CM_LEADER_MODE , CM_SPECTATOR_SOCCER , CM_SPECTATOR_TOP_VIEW , CM_SIMPLE_REPLAY , CM_FALLING }

Static Public Member Functions inherited from Camera
static Camera *	createCamera (AbstractKart *kart, const int index)
	Creates a new camera and adds it to the list of all cameras. More...

static void	resetAllCameras ()

static void	changeCamera (unsigned int camera_index, CameraType type)

static void	setDefaultCameraType (CameraType type)
	Sets the default type for each camera that will be created. More...

static CameraType	getDefaultCameraType ()
	Returns the default type for each camera that will be created. More...

static unsigned int	getNumCameras ()
	Returns the number of cameras used.

static Camera *	getCamera (unsigned int n)
	Returns a camera.

static Camera *	getActiveCamera ()
	Returns the currently active camera.

static void	removeAllCameras ()
	Remove all cameras.

Protected Member Functions inherited from Camera
	Camera (CameraType type, int camera_index, AbstractKart *kart)

virtual	~Camera ()
	Removes the camera scene node from the scene.

virtual void	reset ()
	Reset is called when a new race starts. More...

Static Protected Member Functions inherited from Camera
static Camera *	createCamera (unsigned int index, CameraType type, AbstractKart *kart)
	Creates a camera of the specified type, but does not add it to the list of all cameras. More...

Protected Attributes inherited from Camera
scene::ICameraSceneNode *	m_camera
	The camera scene node.

AbstractKart *	m_kart
	The kart that the camera follows. More...

Detailed Description

Handles the normal racing camera.

Constructor & Destructor Documentation

◆ CameraNormal()

CameraNormal::CameraNormal	(	Camera::CameraType	type,
		int	camera_index,
		AbstractKart *	kart
	)

private

Constructor for the normal camera.

This is the only camera constructor except for the base class that takes a camera type as parameter. This is because debug and end camera use the normal camera as their base class.

Parameters

type	The type of the camera that is created (can be CM_TYPE_END or CM_TYPE_DEBUG).
camera_index	Index of this camera.
Kart	Pointer to the kart for which this camera is used.

Member Function Documentation

◆ getCameraSettings()

void CameraNormal::getCameraSettings	(	Mode	mode,
		float *	above_kart,
		float *	cam_angle,
		float *	sideway,
		float *	distance,
		bool *	smoothing,
		float *	cam_roll_angle
	)

private

Determine the camera settings for the current frame.

Parameters

above_kart	How far above the camera should aim at.
cam_angle	Angle above the kart plane for the camera.
sideway	Sideway movement of the camera.
distance	Distance from kart.
cam_roll_angle	Roll camera for gyroscope steering effect.

◆ moveCamera()

void CameraNormal::moveCamera	(	float	dt,
		bool	smooth,
		float	cam_angle,
		float	distance
	)

private

Moves the camera smoothly from the current camera position (and target) to the new position and target.

Parameters

dt	Delta time,
smooth	Updates the camera if true, only calculate smooth state parameter if false
if	false, the camera instantly moves to the endpoint, or else it smoothly moves

◆ positionCamera()

void CameraNormal::positionCamera	(	float	dt,
		float	above_kart,
		float	cam_angle,
		float	side_way,
		float	distance,
		float	smoothing,
		float	cam_roll_angle
	)

private

Actually sets the camera based on the given parameter.

Parameters

above_kart	How far above the camera should aim at.
cam_angle	Angle above the kart plane for the camera.
sideway	Sideway movement of the camera.
distance	Distance from kart.
cam_roll_angle	Roll camera for gyroscope steering effect.

◆ update()

void CameraNormal::update ( float dt )

virtual

Called once per time frame to move the camera to the right position.

Parameters

dt	Time step.

Reimplemented from Camera.

Reimplemented in CameraEnd, and CameraDebug.

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

graphics/camera/camera_normal.hpp
graphics/camera/camera_normal.cpp

Public Member Functions

Private Member Functions

Private Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CameraNormal()

Member Function Documentation

◆ getCameraSettings()

◆ moveCamera()

◆ positionCamera()

◆ update()