ca.blarg.gdx.graphics

Class EulerPerspectiveCamera

java.lang.Object

com.badlogic.gdx.graphics.Camera

ca.blarg.gdx.graphics.EulerPerspectiveCamera

public class EulerPerspectiveCamera
extends com.badlogic.gdx.graphics.Camera

Simple 3D perspective camera class using euler angles to control orientation. Yaw (Y-axis) and pitch (X-axis) are the only angles used. Roll is not used. Yaw controls left/right directions. Pitch controls vertical directions. This class was mainly created because I find it far easier/intuitive to control a camera via euler angles and haven't really ever had a problem with any gimbal lock situations. This type of camera may not be best for all kinds of situations though (e.g. where some heavy-duty / crazy rotations are taking place). For most kinds of first person / "up-right" type of cameras this is probably quite suitable. Changes to Camera.direction are ignored completely. However, this field will be updated appropriately whenever the other rotation-related properties are recalculated (e.g. forward and rotation). Camera methods which modify Camera.direction will all throw UnsupportedOperationException. Camera direction is solely controlled by the yaw and pitch attributes added by this class. Modification of position and orientation should all be performed via the provided methods: turn, pitch, move, etc. These methods handle updating the internal Quaternion rotations and forward/target vectors. Modifying Camera.position directly may result in odd behaviour. As per usual with Camera classes in libgdx, make sure to call update() after you've manipulated any attributes of the camera (position, orientation, viewport size, etc).

Field Summary

Fields

Modifier and Type	Field and Description
float	fieldOfView

Fields inherited from class com.badlogic.gdx.graphics.Camera

combined, direction, far, frustum, invProjectionView, near, position, projection, up, view, viewportHeight, viewportWidth

Constructor Summary

Constructors

Constructor and Description
EulerPerspectiveCamera(float fieldOfView, float viewportWidth, float viewportHeight)

Method Summary

Modifier and Type	Method and Description
com.badlogic.gdx.math.Vector3	getForward()
float	getPitch()
com.badlogic.gdx.math.Quaternion	getRotation()
float	getYaw()
void	lookAt(float x, float y, float z)
void	lookAt(com.badlogic.gdx.math.Vector3 target)
void	move(com.badlogic.gdx.math.Vector3 offset)
void	moveTo(float x, float y, float z)
void	moveTo(com.badlogic.gdx.math.Vector3 position)
void	normalizeUp()
void	orient(float yawDegrees, float pitchDegrees)
void	orientTo(float yawDegrees, float pitchDegrees)
void	pitch(float degrees)
void	pitchTo(float degrees)
void	rotate(float angle, float axisX, float axisY, float axisZ)
void	rotate(com.badlogic.gdx.math.Matrix4 transform)
void	rotate(com.badlogic.gdx.math.Quaternion quat)
void	rotate(com.badlogic.gdx.math.Vector3 axis, float angle)
void	rotateAround(com.badlogic.gdx.math.Vector3 point, com.badlogic.gdx.math.Vector3 axis, float angle)
void	transform(com.badlogic.gdx.math.Matrix4 transform)
void	translate(float x, float y, float z)
void	translate(com.badlogic.gdx.math.Vector3 vec)
void	turn(float degrees)
void	turnTo(float degrees)
void	update()
void	update(boolean updateFrustum)

Methods inherited from class com.badlogic.gdx.graphics.Camera

getPickRay, getPickRay, project, project, unproject, unproject

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

fieldOfView

public float fieldOfView

Constructor Detail

EulerPerspectiveCamera

public EulerPerspectiveCamera(float fieldOfView,
                              float viewportWidth,
                              float viewportHeight)

Method Detail

getYaw

public float getYaw()

getPitch

public float getPitch()

getForward

public com.badlogic.gdx.math.Vector3 getForward()

getRotation

public com.badlogic.gdx.math.Quaternion getRotation()

turn

public void turn(float degrees)

turnTo

public void turnTo(float degrees)

pitch

public void pitch(float degrees)

pitchTo

public void pitchTo(float degrees)

orient

public void orient(float yawDegrees,
                   float pitchDegrees)

orientTo

public void orientTo(float yawDegrees,
                     float pitchDegrees)

move

public void move(com.badlogic.gdx.math.Vector3 offset)

moveTo

public void moveTo(com.badlogic.gdx.math.Vector3 position)

moveTo

public void moveTo(float x,
                   float y,
                   float z)

update

public void update()

Specified by:

update in class com.badlogic.gdx.graphics.Camera

update

public void update(boolean updateFrustum)

Specified by:

update in class com.badlogic.gdx.graphics.Camera

translate

public void translate(com.badlogic.gdx.math.Vector3 vec)

Overrides:

translate in class com.badlogic.gdx.graphics.Camera

translate

public void translate(float x,
                      float y,
                      float z)

Overrides:

translate in class com.badlogic.gdx.graphics.Camera

transform

public void transform(com.badlogic.gdx.math.Matrix4 transform)

Overrides:

transform in class com.badlogic.gdx.graphics.Camera

rotateAround

public void rotateAround(com.badlogic.gdx.math.Vector3 point,
                         com.badlogic.gdx.math.Vector3 axis,
                         float angle)

Overrides:

rotateAround in class com.badlogic.gdx.graphics.Camera

rotate

public void rotate(com.badlogic.gdx.math.Quaternion quat)

Overrides:

rotate in class com.badlogic.gdx.graphics.Camera

rotate

public void rotate(com.badlogic.gdx.math.Matrix4 transform)

Overrides:

rotate in class com.badlogic.gdx.graphics.Camera

rotate

public void rotate(com.badlogic.gdx.math.Vector3 axis,
                   float angle)

Overrides:

rotate in class com.badlogic.gdx.graphics.Camera

rotate

public void rotate(float angle,
                   float axisX,
                   float axisY,
                   float axisZ)

Overrides:

rotate in class com.badlogic.gdx.graphics.Camera

normalizeUp

public void normalizeUp()

Overrides:

normalizeUp in class com.badlogic.gdx.graphics.Camera

lookAt

public void lookAt(com.badlogic.gdx.math.Vector3 target)

Overrides:

lookAt in class com.badlogic.gdx.graphics.Camera

lookAt

public void lookAt(float x,
                   float y,
                   float z)

Overrides:

lookAt in class com.badlogic.gdx.graphics.Camera