thothbot.parallax.core.shared.cameras

Class PerspectiveCamera

java.lang.Object

thothbot.parallax.core.shared.core.Object3D

thothbot.parallax.core.shared.cameras.Camera

thothbot.parallax.core.shared.cameras.PerspectiveCamera

All Implemented Interfaces:

com.google.gwt.event.shared.EventHandler, HasEventBus, ViewportResizeHandler, HasNearFar

public class PerspectiveCamera
extends Camera
implements HasNearFar

Camera with perspective projection.

 
 PerspectiveCamera camera = new PerspectiveCamera( 45, width / height, 1, 1000 );
 
 

Author:

thothbot

Nested Class Summary

Nested classes/interfaces inherited from class thothbot.parallax.core.shared.core.Object3D

Object3D.ObjectHandler, Object3D.Traverse

Field Summary

Fields

Modifier and Type	Field and Description
double	zoom

Fields inherited from class thothbot.parallax.core.shared.core.Object3D

__webglActive, __webglInit, _modelViewMatrix, _normalMatrix, DefaultUp

Fields inherited from interface thothbot.parallax.core.client.events.HasEventBus

EVENT_BUS

Constructor Summary

Constructors

Constructor and Description
PerspectiveCamera() Perspective Camera default constructor.
PerspectiveCamera(double fieldOfView, double aspectRatio, double near, double far) Perspective Camera constructor

Method Summary

Modifier and Type	Method and Description
PerspectiveCamera	clone() Creates a new clone of this object and all descendants.
double	getAspect() Gets Camera frustum aspect ratio.
double	getFar() Gets Camera frustum far plane.
double	getFov() Gets Camera frustum vertical field of view.
int	getFullHeight()
int	getFullWidth()
int	getHeight()
double	getNear() Gets Camera frustum near plane.
int	getWidth()
double	getX()
double	getY()
void	onResize(ViewportResizeEvent event)
void	setAspect(double aspect) Sets Camera frustum aspect ratio.
void	setFar(double far) Sets Camera frustum far plane.
void	setFov(double fov) Sets Camera frustum vertical field of view.
void	setFullHeight(int fullHeight)
void	setFullWidth(int fullWidth)
void	setHeight(int height)
void	setLens(int focalLength)
void	setLens(int focalLength, int frameHeight) Uses Focal Length (in mm) to estimate and set FOV 35mm (fullframe) camera is used if frame size is not specified.
void	setNear(double near) Sets Camera frustum near plane.
void	setViewOffset(int fullWidth, int fullHeight, double x, double y, int width, int height) Sets an offset in a larger frustum.
void	setWidth(int width)
void	setX(double x)
void	setY(double y)
void	updateProjectionMatrix() Updates the camera projection matrix.

Methods inherited from class thothbot.parallax.core.shared.cameras.Camera

addViewportResizeHandler, clone, getMatrixWorldInverse, getProjectionMatrix, getWorldDirection, getWorldDirection, lookAt, setMatrixWorldInverse, setProjectionMatrix

Methods inherited from class thothbot.parallax.core.shared.core.Object3D

add, add, applyMatrix, clone, clone, getChildren, getChildrenByClass, getId, getMatrix, getMatrixWorld, getName, getObjectById, getObjectByName, getParent, getPosition, getQuaternion, getRenderDepth, getRotation, getScale, getUp, getWorldPosition, getWorldPosition, getWorldQuaternion, getWorldQuaternion, getWorldRotation, getWorldRotation, getWorldScale, getWorldScale, isCastShadow, isFrustumCulled, isMatrixAutoUpdate, isMatrixWorldNeedsUpdate, isReceiveShadow, isRotationAutoUpdate, isVisible, localToWorld, remove, remove, rotateOnAxis, rotateX, rotateY, rotateZ, setCastShadow, setChildren, setFrustumCulled, setHandler, setMatrix, setMatrixAutoUpdate, setMatrixWorld, setMatrixWorldNeedsUpdate, setName, setParent, setPosition, setQuaternion, setReceiveShadow, setRenderDepth, setRotation, setRotationAutoUpdate, setRotationFromAxisAngle, setRotationFromEuler, setRotationFromMatrix, setRotationFromQuaternion, setScale, setUp, setVisible, toString, translateOnAxis, translateX, translateY, translateZ, traverse, traverseVisible, updateMatrix, updateMatrixWorld, worldToLocal

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

zoom

public double zoom

Constructor Detail

PerspectiveCamera

public PerspectiveCamera()

Perspective Camera default constructor. It uses the following defaults:

• fieldOfView - 50
• aspectRatio - 1
• near - 0.1
• far - 2000

PerspectiveCamera

public PerspectiveCamera(double fieldOfView,
                         double aspectRatio,
                         double near,
                         double far)

Perspective Camera constructor

Parameters:

fieldOfView - Camera frustum vertical field of view.

aspectRatio - Camera frustum aspect ratio.

near - Camera frustum near plane.

far - Camera frustum far plane.

Method Detail

onResize

public void onResize(ViewportResizeEvent event)

Specified by:

onResize in interface ViewportResizeHandler

Overrides:

onResize in class Camera

getFov

public double getFov()

Gets Camera frustum vertical field of view.

setFov

public void setFov(double fov)

Sets Camera frustum vertical field of view.

getAspect

public double getAspect()

Gets Camera frustum aspect ratio.

setAspect

public void setAspect(double aspect)

Sets Camera frustum aspect ratio.

getNear

public double getNear()

Gets Camera frustum near plane.

Specified by:

getNear in interface HasNearFar

setNear

public void setNear(double near)

Sets Camera frustum near plane.

Specified by:

setNear in interface HasNearFar

getFar

public double getFar()

Gets Camera frustum far plane.

Specified by:

getFar in interface HasNearFar

setFar

public void setFar(double far)

Sets Camera frustum far plane.

Specified by:

setFar in interface HasNearFar

getFullWidth

public int getFullWidth()

setFullWidth

public void setFullWidth(int fullWidth)

getFullHeight

public int getFullHeight()

setFullHeight

public void setFullHeight(int fullHeight)

getX

public double getX()

setX

public void setX(double x)

getY

public double getY()

setY

public void setY(double y)

getWidth

public int getWidth()

setWidth

public void setWidth(int width)

getHeight

public int getHeight()

setHeight

public void setHeight(int height)

setLens

public void setLens(int focalLength)

Parameters:

focalLength - the focal length

See Also:

setLens(int, int)

setLens

public void setLens(int focalLength,
                    int frameHeight)

Uses Focal Length (in mm) to estimate and set FOV 35mm (fullframe) camera is used if frame size is not specified.
Formula based on bobatkins.com

Parameters:

focalLength - the focal length

frameHeight - the frame size

setViewOffset

public void setViewOffset(int fullWidth,
                          int fullHeight,
                          double x,
                          double y,
                          int width,
                          int height)

Sets an offset in a larger frustum. This is useful for multi-window or multi-monitor/multi-machine setups.

For example, if you have 3x2 monitors and each monitor is 1920x1080 and the monitors are in grid like this

   +---+---+---+
   | A | B | C |
   +---+---+---+
   | D | E | F |
   +---+---+---+

then for each monitor you would call it like this

   double w = 1920;
   double h = 1080;
   double fullWidth = w * 3;
   double fullHeight = h * 2;

   --A--
   camera.setOffset( fullWidth, fullHeight, w * 0, h * 0, w, h );
   --B--
   camera.setOffset( fullWidth, fullHeight, w * 1, h * 0, w, h );
   --C--
   camera.setOffset( fullWidth, fullHeight, w * 2, h * 0, w, h );
   --D--
   camera.setOffset( fullWidth, fullHeight, w * 0, h * 1, w, h );
   --E--
   camera.setOffset( fullWidth, fullHeight, w * 1, h * 1, w, h );
   --F--
   camera.setOffset( fullWidth, fullHeight, w * 2, h * 1, w, h );

Note there is no reason monitors have to be the same size or in a grid.

Parameters:

fullWidth - the full width of multiview setup

fullHeight - the full height of multiview setup

x - the horizontal offset of subcamera

y - the vertical offset of subcamera

width - the width of subcamera

height - the height of subcamera

updateProjectionMatrix

public void updateProjectionMatrix()

Updates the camera projection matrix.

Must be called after change of parameters.

clone

public PerspectiveCamera clone()

Description copied from class: Object3D

Creates a new clone of this object and all descendants.

Overrides:

clone in class Camera