Class AbstractCamera

java.lang.Object

gaiasky.scene.camera.AbstractCamera

All Implemented Interfaces:

ICamera

Direct Known Subclasses:

NaturalCamera, RelativisticCamera, SpacecraftCamera

public abstract class AbstractCamera
extends Object
implements ICamera

Common attributes and methods to all cameras.

Field Summary

Fields

Modifier and Type	Field	Description
protected float	angleEdgeRad	Angle from the center to the corner of the screen in scene coordinates, in radians.
protected float	ar	Aspect ratio.
double	CAM_FAR	Camera far value.
double	CAM_NEAR	Camera near value.
com.badlogic.gdx.graphics.PerspectiveCamera	camera	The main camera.
protected com.badlogic.gdx.graphics.PerspectiveCamera[]	cameras	Vector with all perspective cameras.
protected com.badlogic.gdx.graphics.PerspectiveCamera	camLeft	Stereoscopic mode cameras.
protected com.badlogic.gdx.graphics.PerspectiveCamera	camRight	Stereoscopic mode cameras.
protected IFocus	closest	The closest between closestBody and closestStar.
protected FocusView	closestBody	Closest non-star body to the camera.
protected IFocus	closestStar	The closest particle to the camera.
protected FocusView	closestStarView
protected double	distance	Distance of camera to center.
Vector3Q	dPos
float	fovFactor
protected boolean	gamepadInput	The last input event was by a gamepad.
protected static final Logger.Log	logger
protected CameraManager	parent	The parent.
Vector3Q	pos
Vector3Q	posInv
protected com.badlogic.gdx.math.Matrix4	prevCombined
Vector3Q	prevPos
protected Proximity	proximity
Vector3D	shift
Vector3D	tmp

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractCamera(CameraManager parent)

Method Summary

Modifier and Type	Method	Description
void	checkClosestBody(com.badlogic.ashley.core.Entity cb)	Called after updating the body's distance to the cam, it updates the closest body in the camera to figure out the camera near
void	checkClosestBody(IFocus cb)	Called after updating the body's distance to the cam, it updates the closest body in the camera to figure out the camera near
void	checkClosestParticle(IFocus star)	Sets the current closest particle to this camera.
void	copyParamsFrom(AbstractCamera other)
float	getAngleEdge()	Gets the angle of the edge of the screen, diagonally.
float	getAngleEdge(int width, int height, float angle)
com.badlogic.gdx.graphics.PerspectiveCamera	getCameraStereoLeft()
com.badlogic.gdx.graphics.PerspectiveCamera	getCameraStereoRight()
IFocus	getCloseLightSource(int i)	Gets the current i-close light source to this camera
IFocus	getClosest()	Returns the current closest object
IFocus	getClosestBody()
IFocus	getClosestParticle()	Gets the current closest particle to this camera
ICamera	getCurrent()
double	getDistance()	Gets the distance from the camera to the centre of our reference frame (Sun)
Vector3Q	getDPos()
double	getFar()
float	getFovFactor()
Vector3Q	getInversePos()
CameraManager	getManager()
double	getNear()
Vector3Q	getPos()
Vector3Q	getPreviousPos()
com.badlogic.gdx.math.Matrix4	getPreviousProjView()
com.badlogic.gdx.math.Matrix4	getProjView()
IFocus	getSecondClosestBody()
Vector3D	getShift()
double	getSpeedScaling()
double	getSpeedScalingCapped()
Vector3D	getVelocity()
boolean	isRotating()	Check whether the camera is currently rotating around the (possible) focus object.
boolean	isVisible(double viewAngle, Vector3D pos, double distToCamera)
boolean	isVisible(double viewAngle, Vector3Q pos, double distToCamera)
boolean	isVisible(com.badlogic.ashley.core.Entity cb)
void	render(int rw, int rh)
void	setCameraStereoLeft(com.badlogic.gdx.graphics.PerspectiveCamera cam)
void	setCameraStereoRight(com.badlogic.gdx.graphics.PerspectiveCamera cam)
void	setClosest(IFocus focus)	Sets the closest of all
void	setDPos(Vector3D dPos)
void	setDPos(Vector3Q dPos)
protected void	setFrustumPlanes(com.badlogic.gdx.graphics.PerspectiveCamera cam)
void	setGamepadInput(boolean state)	Main input mode is a gamepad.
void	setPointerProjectionOnFocus(com.badlogic.gdx.math.Vector3 point)	Sets the current pointer coordinates, as projected on the current focus object.
void	setPos(Vector3D pos)
void	setPos(Vector3Q pos)
void	setPreviousPos(Vector3D prevpos)
void	setPreviousPos(Vector3Q pos)
void	setPreviousProjView(com.badlogic.gdx.math.Matrix4 mat)
void	setShift(Vector3D shift)
void	swapBuffers()
void	updateAngleEdge(int width, int height)
protected void	updateFovFactor()	Update the FOV factor using the reference FOV.
void	updateFrustumPlanes()

Methods inherited from class Object

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

Methods inherited from interface ICamera

doneLoading, getCamera, getDirection, getDirections, getFocus, getFrontCameras, getMode, getNCameras, getSpeed, getUp, hasFocus, isFocus, resize, setCamera, setDirection, speedScaling, update, updateMode

Modifier and Type	Method	Description
void	doneLoading(com.badlogic.gdx.assets.AssetManager manager)	Loading is finished, gather resources.
com.badlogic.gdx.graphics.PerspectiveCamera	getCamera()	Returns the perspective camera.
Vector3D	getDirection()
Vector3D[]	getDirections()
IFocus	getFocus()	Returns the focus if any.
com.badlogic.gdx.graphics.PerspectiveCamera[]	getFrontCameras()
CameraManager.CameraMode	getMode()
int	getNCameras()
double	getSpeed()	Gets the current velocity of the camera in km/h.
Vector3D	getUp()
boolean	hasFocus()	Checks whether the current camera has a focus set.
boolean	isFocus(com.badlogic.ashley.core.Entity entity)	Checks if the given entity is the current focus.
void	resize(int width, int height)
void	setCamera(com.badlogic.gdx.graphics.PerspectiveCamera perspectiveCamera)	Sets the active camera
void	setDirection(Vector3D dir)
double	speedScaling()
void	update(double dt, ITimeFrameProvider time)	Updates the camera.
void	updateMode(ICamera previousCam, CameraManager.CameraMode previousMode, CameraManager.CameraMode newMode, boolean centerFocus)

Field Details

logger

protected static final Logger.Log logger

CAM_NEAR

public double CAM_NEAR

Camera near value.

CAM_FAR

public double CAM_FAR

Camera far value.

pos

public Vector3Q pos

posInv

public Vector3Q posInv

prevPos

public Vector3Q prevPos

dPos

public Vector3Q dPos

tmp

public Vector3D tmp

shift

public Vector3D shift

camera

public com.badlogic.gdx.graphics.PerspectiveCamera camera

The main camera.

fovFactor

public float fovFactor

angleEdgeRad

protected float angleEdgeRad

Angle from the center to the corner of the screen in scene coordinates, in radians.

ar

protected float ar

Aspect ratio.

distance

protected double distance

Distance of camera to center.

parent

protected CameraManager parent

The parent.

camLeft

protected com.badlogic.gdx.graphics.PerspectiveCamera camLeft

Stereoscopic mode cameras.

camRight

protected com.badlogic.gdx.graphics.PerspectiveCamera camRight

Stereoscopic mode cameras.

cameras

protected com.badlogic.gdx.graphics.PerspectiveCamera[] cameras

Vector with all perspective cameras.

closestBody

protected FocusView closestBody

Closest non-star body to the camera.

closestStar

protected IFocus closestStar

The closest particle to the camera.

closestStarView

protected FocusView closestStarView

proximity

protected Proximity proximity

prevCombined

protected com.badlogic.gdx.math.Matrix4 prevCombined

closest

protected IFocus closest

The closest between closestBody and closestStar.

gamepadInput

protected boolean gamepadInput

The last input event was by a gamepad.

Constructor Details

AbstractCamera

protected AbstractCamera(CameraManager parent)

Method Details

updateAngleEdge

public void updateAngleEdge(int width,
 int height)

Specified by:

updateAngleEdge in interface ICamera

getAngleEdge

public float getAngleEdge(int width,
 int height,
 float angle)

updateFovFactor

protected void updateFovFactor()

Update the FOV factor using the reference FOV.

getFovFactor

public float getFovFactor()

Specified by:

getFovFactor in interface ICamera

getPos

public Vector3Q getPos()

Specified by:

getPos in interface ICamera

setPos

public void setPos(Vector3D pos)

Specified by:

setPos in interface ICamera

setPos

public void setPos(Vector3Q pos)

Specified by:

setPos in interface ICamera

getPreviousPos

public Vector3Q getPreviousPos()

Specified by:

getPreviousPos in interface ICamera

setPreviousPos

public void setPreviousPos(Vector3Q pos)

Specified by:

setPreviousPos in interface ICamera

setPreviousPos

public void setPreviousPos(Vector3D prevpos)

Specified by:

setPreviousPos in interface ICamera

setDPos

public void setDPos(Vector3Q dPos)

Specified by:

setDPos in interface ICamera

setDPos

public void setDPos(Vector3D dPos)

Specified by:

setDPos in interface ICamera

getDPos

public Vector3Q getDPos()

Specified by:

getDPos in interface ICamera

getInversePos

public Vector3Q getInversePos()

Specified by:

getInversePos in interface ICamera

getAngleEdge

public float getAngleEdge()

Description copied from interface: ICamera

Gets the angle of the edge of the screen, diagonally. It assumes the vertical angle is the field of view and corrects the horizontal using the aspect ratio. It depends on the viewport size and the field of view itself.

Specified by:

getAngleEdge in interface ICamera

Returns:

The angle in radians.

getManager

public CameraManager getManager()

Specified by:

getManager in interface ICamera

render

public void render(int rw,
 int rh)

Specified by:

render in interface ICamera

getCurrent

public ICamera getCurrent()

Specified by:

getCurrent in interface ICamera

isVisible

public boolean isVisible(com.badlogic.ashley.core.Entity cb)

Specified by:

isVisible in interface ICamera

isVisible

public boolean isVisible(double viewAngle,
 Vector3D pos,
 double distToCamera)

Specified by:

isVisible in interface ICamera

isVisible

public boolean isVisible(double viewAngle,
 Vector3Q pos,
 double distToCamera)

getDistance

public double getDistance()

Description copied from interface: ICamera

Gets the distance from the camera to the centre of our reference frame (Sun)

Specified by:

getDistance in interface ICamera

Returns:

The distance

copyParamsFrom

public void copyParamsFrom(AbstractCamera other)

getCameraStereoLeft

public com.badlogic.gdx.graphics.PerspectiveCamera getCameraStereoLeft()

Specified by:

getCameraStereoLeft in interface ICamera

setCameraStereoLeft

public void setCameraStereoLeft(com.badlogic.gdx.graphics.PerspectiveCamera cam)

Specified by:

setCameraStereoLeft in interface ICamera

getCameraStereoRight

public com.badlogic.gdx.graphics.PerspectiveCamera getCameraStereoRight()

Specified by:

getCameraStereoRight in interface ICamera

setCameraStereoRight

public void setCameraStereoRight(com.badlogic.gdx.graphics.PerspectiveCamera cam)

Specified by:

setCameraStereoRight in interface ICamera

getShift

public Vector3D getShift()

Specified by:

getShift in interface ICamera

setShift

public void setShift(Vector3D shift)

Specified by:

setShift in interface ICamera

checkClosestBody

public void checkClosestBody(IFocus cb)

Description copied from interface: ICamera

Called after updating the body's distance to the cam, it updates the closest body in the camera to figure out the camera near

Specified by:

checkClosestBody in interface ICamera

Parameters:

cb - The body to check

checkClosestBody

public void checkClosestBody(com.badlogic.ashley.core.Entity cb)

Description copied from interface: ICamera

Called after updating the body's distance to the cam, it updates the closest body in the camera to figure out the camera near

Specified by:

checkClosestBody in interface ICamera

Parameters:

cb - The body to check.

getClosestBody

public IFocus getClosestBody()

Specified by:

getClosestBody in interface ICamera

getSecondClosestBody

public IFocus getSecondClosestBody()

Specified by:

getSecondClosestBody in interface ICamera

getClosestParticle

public IFocus getClosestParticle()

Description copied from interface: ICamera

Gets the current closest particle to this camera

Specified by:

getClosestParticle in interface ICamera

Returns:

The closest particle

getCloseLightSource

public IFocus getCloseLightSource(int i)

Description copied from interface: ICamera

Gets the current i-close light source to this camera

Specified by:

getCloseLightSource in interface ICamera

Returns:

The i close light source (star?)

checkClosestParticle

public void checkClosestParticle(IFocus star)

Description copied from interface: ICamera

Sets the current closest particle to this camera. This will be only set if the given particle is closer than the current.

Specified by:

checkClosestParticle in interface ICamera

Parameters:

star - The candidate particle

swapBuffers

public void swapBuffers()

Specified by:

swapBuffers in interface ICamera

getClosest

public IFocus getClosest()

Description copied from interface: ICamera

Returns the current closest object

Specified by:

getClosest in interface ICamera

setClosest

public void setClosest(IFocus focus)

Description copied from interface: ICamera

Sets the closest of all

Specified by:

setClosest in interface ICamera

Parameters:

focus - The new closest object

getVelocity

public Vector3D getVelocity()

Specified by:

getVelocity in interface ICamera

updateFrustumPlanes

public void updateFrustumPlanes()

Specified by:

updateFrustumPlanes in interface ICamera

setFrustumPlanes

protected void setFrustumPlanes(com.badlogic.gdx.graphics.PerspectiveCamera cam)

getNear

public double getNear()

Specified by:

getNear in interface ICamera

getFar

public double getFar()

Specified by:

getFar in interface ICamera

getProjView

public com.badlogic.gdx.math.Matrix4 getProjView()

Specified by:

getProjView in interface ICamera

getPreviousProjView

public com.badlogic.gdx.math.Matrix4 getPreviousProjView()

Specified by:

getPreviousProjView in interface ICamera

setPreviousProjView

public void setPreviousProjView(com.badlogic.gdx.math.Matrix4 mat)

Specified by:

setPreviousProjView in interface ICamera

setGamepadInput

public void setGamepadInput(boolean state)

Description copied from interface: ICamera

Main input mode is a gamepad.

Specified by:

setGamepadInput in interface ICamera

setPointerProjectionOnFocus

public void setPointerProjectionOnFocus(com.badlogic.gdx.math.Vector3 point)

Description copied from interface: ICamera

Sets the current pointer coordinates, as projected on the current focus object. This only applies when the camera is in focus mode, and the focus is a planet.

Specified by:

setPointerProjectionOnFocus in interface ICamera

Parameters:

point - The Cartesian coordinates of the pointer on the sphere representing the focus object.

getSpeedScaling

public double getSpeedScaling()

Specified by:

getSpeedScaling in interface ICamera

getSpeedScalingCapped

public double getSpeedScalingCapped()

Specified by:

getSpeedScalingCapped in interface ICamera

isRotating

public boolean isRotating()

Description copied from interface: ICamera

Check whether the camera is currently rotating around the (possible) focus object.

Specified by:

isRotating in interface ICamera

Returns:

Whether the camera is rotating.