Camera (jMonkeyEngine3)

java.lang.Object
- com.jme3.renderer.Camera

All Implemented Interfaces:

Savable, java.lang.Cloneable
```
public class Camera
extends java.lang.Object
implements Savable, java.lang.Cloneable
```
Camera is a standalone, purely mathematical class for doing camera-related computations.
Given input data such as location, orientation (direction, left, up), and viewport settings, it can compute data necessary to render objects with the graphics library. Two matrices are generated, the view matrix transforms objects from world space into eye space, while the projection matrix transforms objects from eye space into clip space.

Another purpose of the camera class is to do frustum culling operations, defined by six planes which define a 3D frustum shape, it is possible to test if an object bounded by a mathematically defined volume is inside the camera frustum, and thus to avoid rendering objects that are outside the frustum

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Camera.FrustumIntersect` The `FrustumIntersect` enum is returned as a result of a culling check operation, see `contains(com.jme3.bounding.BoundingVolume)`

Field Summary

Fields
Modifier and Type	Field and Description
`protected float[]`	`coeffBottom`
`protected float[]`	`coeffLeft`
`protected float[]`	`coeffRight`
`protected float[]`	`coeffTop`
`protected float`	`frustumBottom` Distance from camera to bottom frustum plane.
`protected float`	`frustumFar` Distance from camera to far frustum plane.
`protected float`	`frustumLeft` Distance from camera to left frustum plane.
`protected float`	`frustumNear` Distance from camera to near frustum plane.
`protected float`	`frustumRight` Distance from camera to right frustum plane.
`protected float`	`frustumTop` Distance from camera to top frustum plane.
`protected int`	`height`
`protected Vector3f`	`location` Camera's location
`protected java.lang.String`	`name` The camera's name.
`protected Matrix4f`	`projectionMatrix`
`protected Matrix4f`	`projectionMatrixOverride`
`protected Quaternion`	`rotation` The orientation of the camera.
`protected Matrix4f`	`viewMatrix`
`protected float`	`viewPortBottom` Percent value on display where vertical viewing begins for this camera.
`protected boolean`	`viewportChanged`
`protected float`	`viewPortLeft` Percent value on display where horizontal viewing starts for this camera.
`protected float`	`viewPortRight` Percent value on display where horizontal viewing ends for this camera.
`protected float`	`viewPortTop` Percent value on display where vertical viewing ends for this camera.
`protected Matrix4f`	`viewProjectionMatrix`
`protected int`	`width`
`protected Plane[]`	`worldPlane` Array holding the planes that this camera will check for culling.

Constructor Summary

Constructors
Modifier Constructor and Description

protected Camera()
Serialization only.

Camera(int width, int height)
Constructor instantiates a new Camera object.

Constructors
Modifier	Constructor and Description
`protected`	`Camera()` Serialization only.
	`Camera(int width, int height)` Constructor instantiates a new `Camera` object.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clearViewportChanged()` Clears the viewport changed flag once it has been updated inside the renderer.
`Camera`	`clone()`
`Camera.FrustumIntersect`	`contains(BoundingVolume bound)` `contains` tests a bounding volume against the planes of the camera's frustum.
`boolean`	`containsGui(BoundingVolume bound)` `containsGui` tests a bounding volume against the ortho bounding box of the camera.
`void`	`copyFrom(Camera cam)` This method copies the settings of the given camera.
`float`	`distanceToNearPlane(Vector3f pos)` Returns the pseudo distance from the given position to the near plane of the camera.
`float`	`getAspect()` Obtains the aspect ratio.
`Vector3f`	`getDirection()` `getDirection` retrieves the direction vector the camera is facing.
`Vector3f`	`getDirection(Vector3f store)` `getDirection` retrieves the direction vector the camera is facing.
`float`	`getFov()` Obtains field of view when the camera is in perspective mode.
`float`	`getFrustumBottom()` `getFrustumBottom` returns the value of the bottom frustum plane.
`float`	`getFrustumFar()` `getFrustumFar` gets the value of the far frustum plane.
`float`	`getFrustumLeft()` `getFrustumLeft` gets the value of the left frustum plane.
`float`	`getFrustumNear()` `getFrustumNear` gets the value of the near frustum plane.
`float`	`getFrustumRight()` `getFrustumRight` gets the value of the right frustum plane.
`float`	`getFrustumTop()` `getFrustumTop` gets the value of the top frustum plane.
`int`	`getHeight()`
`Vector3f`	`getLeft()` `getLeft` retrieves the left axis of the camera.
`Vector3f`	`getLeft(Vector3f store)` `getLeft` retrieves the left axis of the camera.
`Vector3f`	`getLocation()` `getLocation` retrieves the location vector of the camera.
`java.lang.String`	`getName()` This method returns the cameras name.
`int`	`getPlaneState()` `getPlaneState` returns the state of the frustum planes.
`Matrix4f`	`getProjectionMatrix()`
`Quaternion`	`getRotation()` `getRotation` retrieves the rotation quaternion of the camera.
`Vector3f`	`getScreenCoordinates(Vector3f worldPos)` Converts the given position from world space to screen space.
`Vector3f`	`getScreenCoordinates(Vector3f worldPosition, Vector3f store)` Converts the given position from world space to screen space.
`Vector3f`	`getUp()` `getUp` retrieves the up axis of the camera.
`Vector3f`	`getUp(Vector3f store)` `getUp` retrieves the up axis of the camera.
`Matrix4f`	`getViewMatrix()`
`float`	`getViewPortBottom()` `getViewPortBottom` gets the bottom boundary of the viewport
`float`	`getViewPortLeft()` `getViewPortLeft` gets the left boundary of the viewport
`float`	`getViewPortRight()` `getViewPortRight` gets the right boundary of the viewport
`float`	`getViewPortTop()` `getViewPortTop` gets the top boundary of the viewport
`Matrix4f`	`getViewProjectionMatrix()`
`float`	`getViewToProjectionZ(float viewZPos)` Computes the z value in projection space from the z value in view space Note that the returned value is going non linearly from 0 to 1.
`int`	`getWidth()`
`Vector3f`	`getWorldCoordinates(Vector2f screenPos, float projectionZPos)` Computes a position in World space given a screen position in screen space (0,0 to width, height) and a z position in projection space ( 0 to 1 non linear).
`Vector3f`	`getWorldCoordinates(Vector2f screenPosition, float projectionZPos, Vector3f store)`
`Plane`	`getWorldPlane(int planeId)`
`boolean`	`isParallelProjection()`
`boolean`	`isViewportChanged()`
`void`	`lookAt(Vector3f pos, Vector3f worldUpVector)` `lookAt` is a convenience method for auto-setting the frame based on a world position the user desires the camera to look at.
`void`	`lookAtDirection(Vector3f direction, Vector3f up)` `lookAtDirection` sets the direction the camera is facing given a direction and an up vector.
`void`	`normalize()` normalize normalizes the camera vectors.
`void`	`onFrameChange()` `onFrameChange` updates the view frame of the camera.
`void`	`onFrustumChange()` `onFrustumChange` updates the frustum to reflect any changes made to the planes.
`void`	`onViewPortChange()` Called when the viewport has been changed.
`void`	`read(JmeImporter e)`
`void`	`resize(int width, int height, boolean fixAspect)` Resize this camera's view for the specified display size.
`void`	`setAxes(Quaternion axes)` `setAxes` uses a rotational matrix to set the axes of the camera.
`void`	`setAxes(Vector3f left, Vector3f up, Vector3f direction)` `setAxes` sets the axes (left, up and direction) for this camera.
`void`	`setClipPlane(Plane clipPlane)` Sets a clipPlane for this camera.
`void`	`setClipPlane(Plane clipPlane, Plane.Side side)` Sets a clipPlane for this camera.
`void`	`setFov(float fovY)` Sets the field of view when the camera is in perspective mode.
`void`	`setFrame(Vector3f location, Quaternion axes)` `setFrame` sets the orientation and location of the camera.
`void`	`setFrame(Vector3f location, Vector3f left, Vector3f up, Vector3f direction)` `setFrame` sets the orientation and location of the camera.
`void`	`setFrustum(float near, float far, float left, float right, float top, float bottom)` `setFrustum` sets the frustum of this camera object.
`void`	`setFrustumBottom(float frustumBottom)` `setFrustumBottom` sets the value of the bottom frustum plane.
`void`	`setFrustumFar(float frustumFar)` `setFrustumFar` sets the value of the far frustum plane.
`void`	`setFrustumLeft(float frustumLeft)` `setFrustumLeft` sets the value of the left frustum plane.
`void`	`setFrustumNear(float frustumNear)` `setFrustumNear` sets the value of the near frustum plane.
`void`	`setFrustumPerspective(float fovY, float aspect, float near, float far)` `setFrustumPerspective` defines the frustum for the camera.
`void`	`setFrustumRight(float frustumRight)` `setFrustumRight` sets the value of the right frustum plane.
`void`	`setFrustumTop(float frustumTop)` `setFrustumTop` sets the value of the top frustum plane.
`void`	`setLocation(Vector3f location)` `setLocation` sets the position of the camera.
`void`	`setName(java.lang.String name)` This method sets the cameras name.
`void`	`setParallelProjection(boolean value)` Enable/disable parallel projection.
`void`	`setPlaneState(int planeState)` `setPlaneState` sets the state to keep track of tested planes for culling.
`void`	`setProjectionMatrix(Matrix4f projMatrix)` Overrides the projection matrix used by the camera.
`void`	`setRotation(Quaternion rotation)` `setRotation` sets the orientation of this camera.
`void`	`setViewPort(float left, float right, float bottom, float top)` `setViewPort` sets the boundaries of the viewport
`void`	`setViewPortBottom(float bottom)` `setViewPortBottom` sets the bottom boundary of the viewport
`void`	`setViewPortLeft(float left)` `setViewPortLeft` sets the left boundary of the viewport
`void`	`setViewPortRight(float right)` `setViewPortRight` sets the right boundary of the viewport
`void`	`setViewPortTop(float top)` `setViewPortTop` sets the top boundary of the viewport
`java.lang.String`	`toString()`
`void`	`update()` `update` updates the camera parameters by calling `onFrustumChange`,`onViewPortChange` and `onFrameChange`.
`void`	`updateViewProjection()` Updates the view projection matrix.
`void`	`write(JmeExporter e)`

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - location
```
protected Vector3f location
```
    Camera's location
  - rotation
```
protected Quaternion rotation
```
    The orientation of the camera.
  - frustumNear
```
protected float frustumNear
```
    Distance from camera to near frustum plane.
  - frustumFar
```
protected float frustumFar
```
    Distance from camera to far frustum plane.
  - frustumLeft
```
protected float frustumLeft
```
    Distance from camera to left frustum plane.
  - frustumRight
```
protected float frustumRight
```
    Distance from camera to right frustum plane.
  - frustumTop
```
protected float frustumTop
```
    Distance from camera to top frustum plane.
  - frustumBottom
```
protected float frustumBottom
```
    Distance from camera to bottom frustum plane.
  - coeffLeft
```
protected float[] coeffLeft
```
  - coeffRight
```
protected float[] coeffRight
```
  - coeffBottom
```
protected float[] coeffBottom
```
  - coeffTop
```
protected float[] coeffTop
```
  - viewPortLeft
```
protected float viewPortLeft
```
    Percent value on display where horizontal viewing starts for this camera. Default is 0.
  - viewPortRight
```
protected float viewPortRight
```
    Percent value on display where horizontal viewing ends for this camera. Default is 1.
  - viewPortTop
```
protected float viewPortTop
```
    Percent value on display where vertical viewing ends for this camera. Default is 1.
  - viewPortBottom
```
protected float viewPortBottom
```
    Percent value on display where vertical viewing begins for this camera. Default is 0.
  - worldPlane
```
protected Plane[] worldPlane
```
    Array holding the planes that this camera will check for culling.
  - width
```
protected int width
```
  - height
```
protected int height
```
  - viewportChanged
```
protected boolean viewportChanged
```
  - projectionMatrixOverride
```
protected Matrix4f projectionMatrixOverride
```
  - viewMatrix
```
protected Matrix4f viewMatrix
```
  - projectionMatrix
```
protected Matrix4f projectionMatrix
```
  - viewProjectionMatrix
```
protected Matrix4f viewProjectionMatrix
```
  - name
```
protected java.lang.String name
```
    The camera's name.
- Constructor Detail
  - Camera
```
protected Camera()
```
    Serialization only. Do not use.
  - Camera
```
public Camera(int width,
              int height)
```
    Constructor instantiates a new Camera object. All values of the camera are set to default.
    
    Parameters:
    
    width - the desired width (in pixels)
    
    height - the desired height (in pixels)
- Method Detail
  - clone
```
public Camera clone()
```
    Overrides:
    
    clone in class java.lang.Object
  - copyFrom
```
public void copyFrom(Camera cam)
```
    This method copies the settings of the given camera.
    
    Parameters:
    
    cam - the camera we copy the settings from
  - setName
```
public void setName(java.lang.String name)
```
    This method sets the cameras name.
    
    Parameters:
    
    name - the cameras name
  - getName
```
public java.lang.String getName()
```
    This method returns the cameras name.
    
    Returns:
    
    the cameras name
  - setClipPlane
```
public void setClipPlane(Plane clipPlane,
                         Plane.Side side)
```
    Sets a clipPlane for this camera. The clipPlane is used to recompute the projectionMatrix using the plane as the near plane This technique is known as the oblique near-plane clipping method introduced by Eric Lengyel more info here
    Note that this will work properly only if it's called on each update, and be aware that it won't work properly with the sky bucket. if you want to handle the sky bucket, look at how it's done in SimpleWaterProcessor.java
    Parameters:
    
    clipPlane - the plane
    
    side - the side the camera stands from the plane
  - setClipPlane
```
public void setClipPlane(Plane clipPlane)
```
    Sets a clipPlane for this camera. The cliPlane is used to recompute the projectionMatrix using the plane as the near plane This technique is known as the oblique near-plane clipping method introduced by Eric Lengyel more info here
    Note that this will work properly only if it's called on each update, and be aware that it won't work properly with the sky bucket. if you want to handle the sky bucket, look at how it's done in SimpleWaterProcessor.java
    Parameters:
    
    clipPlane - the plane
  - resize
```
public void resize(int width,
                   int height,
                   boolean fixAspect)
```
    Resize this camera's view for the specified display size. Invoked by an associated RenderManager to notify the camera of changes to the display dimensions.
    
    Parameters:
    
    width - the new width of the display, in pixels
    
    height - the new height of the display, in pixels
    
    fixAspect - if true, recompute the camera's frustum to preserve its prior aspect ratio
  - getFrustumBottom
```
public float getFrustumBottom()
```
    getFrustumBottom returns the value of the bottom frustum plane.
    
    Returns:
    
    the value of the bottom frustum plane.
  - setFrustumBottom
```
public void setFrustumBottom(float frustumBottom)
```
    setFrustumBottom sets the value of the bottom frustum plane.
    
    Parameters:
    
    frustumBottom - the value of the bottom frustum plane.
  - getFrustumFar
```
public float getFrustumFar()
```
    getFrustumFar gets the value of the far frustum plane.
    
    Returns:
    
    the value of the far frustum plane.
  - setFrustumFar
```
public void setFrustumFar(float frustumFar)
```
    setFrustumFar sets the value of the far frustum plane.
    
    Parameters:
    
    frustumFar - the value of the far frustum plane.
  - getFrustumLeft
```
public float getFrustumLeft()
```
    getFrustumLeft gets the value of the left frustum plane.
    
    Returns:
    
    the value of the left frustum plane.
  - setFrustumLeft
```
public void setFrustumLeft(float frustumLeft)
```
    setFrustumLeft sets the value of the left frustum plane.
    
    Parameters:
    
    frustumLeft - the value of the left frustum plane.
  - getFrustumNear
```
public float getFrustumNear()
```
    getFrustumNear gets the value of the near frustum plane.
    
    Returns:
    
    the value of the near frustum plane.
  - setFrustumNear
```
public void setFrustumNear(float frustumNear)
```
    setFrustumNear sets the value of the near frustum plane.
    
    Parameters:
    
    frustumNear - the value of the near frustum plane.
  - getFrustumRight
```
public float getFrustumRight()
```
    getFrustumRight gets the value of the right frustum plane.
    
    Returns:
    
    frustumRight the value of the right frustum plane.
  - setFrustumRight
```
public void setFrustumRight(float frustumRight)
```
    setFrustumRight sets the value of the right frustum plane.
    
    Parameters:
    
    frustumRight - the value of the right frustum plane.
  - getFrustumTop
```
public float getFrustumTop()
```
    getFrustumTop gets the value of the top frustum plane.
    
    Returns:
    
    the value of the top frustum plane.
  - setFrustumTop
```
public void setFrustumTop(float frustumTop)
```
    setFrustumTop sets the value of the top frustum plane.
    
    Parameters:
    
    frustumTop - the value of the top frustum plane.
  - getFov
```
public float getFov()
```
    Obtains field of view when the camera is in perspective mode.
    
    Returns:
    
    Frame of view angle along the Y in degrees, or 0 if the camera is in orthogonal mode.
  - setFov
```
public void setFov(float fovY)
```
    Sets the field of view when the camera is in perspective mode. Note that this method has no effect when the camera is in orthogonal mode.
    
    Parameters:
    
    fovY - Frame of view angle along the Y in degrees. This must be greater than 0.
  - getAspect
```
public float getAspect()
```
    Obtains the aspect ratio.
    
    Returns:
    
    Width:Height ratio.
  - getLocation
```
public Vector3f getLocation()
```
    getLocation retrieves the location vector of the camera.
    
    Returns:
    
    the position of the camera.
    
    See Also:
    
    getLocation()
  - getRotation
```
public Quaternion getRotation()
```
    getRotation retrieves the rotation quaternion of the camera.
    
    Returns:
    
    the rotation of the camera.
  - getDirection
```
public Vector3f getDirection()
```
    getDirection retrieves the direction vector the camera is facing.
    
    Returns:
    
    the direction the camera is facing.
    
    See Also:
    
    getDirection()
  - getLeft
```
public Vector3f getLeft()
```
    getLeft retrieves the left axis of the camera.
    
    Returns:
    
    the left axis of the camera.
    
    See Also:
    
    getLeft()
  - getUp
```
public Vector3f getUp()
```
    getUp retrieves the up axis of the camera.
    
    Returns:
    
    the up axis of the camera.
    
    See Also:
    
    getUp()
  - getDirection
```
public Vector3f getDirection(Vector3f store)
```
    getDirection retrieves the direction vector the camera is facing.
    
    Parameters:
    
    store - storage for the result (modified if not null)
    
    Returns:
    
    the direction the camera is facing.
    
    See Also:
    
    getDirection()
  - getLeft
```
public Vector3f getLeft(Vector3f store)
```
    getLeft retrieves the left axis of the camera.
    
    Parameters:
    
    store - storage for the result (modified if not null)
    
    Returns:
    
    the left axis of the camera.
    
    See Also:
    
    getLeft()
  - getUp
```
public Vector3f getUp(Vector3f store)
```
    getUp retrieves the up axis of the camera.
    
    Parameters:
    
    store - storage for the result (modified if not null)
    
    Returns:
    
    the up axis of the camera.
    
    See Also:
    
    getUp()
  - setLocation
```
public void setLocation(Vector3f location)
```
    setLocation sets the position of the camera.
    
    Parameters:
    
    location - the position of the camera.
  - setRotation
```
public void setRotation(Quaternion rotation)
```
    setRotation sets the orientation of this camera. This will be equivalent to setting each of the axes: cam.setLeft(rotation.getRotationColumn(0)); cam.setUp(rotation.getRotationColumn(1)); cam.setDirection(rotation.getRotationColumn(2));
    
    Parameters:
    
    rotation - the rotation of this camera
  - lookAtDirection
```
public void lookAtDirection(Vector3f direction,
                            Vector3f up)
```
    lookAtDirection sets the direction the camera is facing given a direction and an up vector.
    
    Parameters:
    
    direction - the direction this camera is facing.
    
    up - the desired "up" direction for the camera (not null, unaffected, typically (0,1,0))
  - setAxes
```
public void setAxes(Vector3f left,
                    Vector3f up,
                    Vector3f direction)
```
    setAxes sets the axes (left, up and direction) for this camera.
    
    Parameters:
    
    left - the left axis of the camera.
    
    up - the up axis of the camera.
    
    direction - the direction the camera is facing.
    
    See Also:
    
    setAxes(com.jme3.math.Quaternion)
  - setAxes
```
public void setAxes(Quaternion axes)
```
    setAxes uses a rotational matrix to set the axes of the camera.
    
    Parameters:
    
    axes - the matrix that defines the orientation of the camera.
  - normalize
```
public void normalize()
```
    normalize normalizes the camera vectors.
  - setFrustum
```
public void setFrustum(float near,
                       float far,
                       float left,
                       float right,
                       float top,
                       float bottom)
```
    setFrustum sets the frustum of this camera object.
    
    Parameters:
    
    near - the near plane.
    
    far - the far plane.
    
    left - the left plane.
    
    right - the right plane.
    
    top - the top plane.
    
    bottom - the bottom plane.
    
    See Also:
    
    setFrustum(float, float, float, float, float, float)
  - setFrustumPerspective
```
public void setFrustumPerspective(float fovY,
                                  float aspect,
                                  float near,
                                  float far)
```
    setFrustumPerspective defines the frustum for the camera. This frustum is defined by a viewing angle, aspect ratio, and near/far planes
    
    Parameters:
    
    fovY - Frame of view angle along the Y in degrees.
    
    aspect - Width:Height ratio
    
    near - Near view plane distance
    
    far - Far view plane distance
  - setFrame
```
public void setFrame(Vector3f location,
                     Vector3f left,
                     Vector3f up,
                     Vector3f direction)
```
    setFrame sets the orientation and location of the camera.
    
    Parameters:
    
    location - the point position of the camera.
    
    left - the left axis of the camera.
    
    up - the up axis of the camera.
    
    direction - the facing of the camera.
    
    See Also:
    
    setFrame(com.jme3.math.Vector3f, com.jme3.math.Vector3f, com.jme3.math.Vector3f, com.jme3.math.Vector3f)
  - lookAt
```
public void lookAt(Vector3f pos,
                   Vector3f worldUpVector)
```
    lookAt is a convenience method for auto-setting the frame based on a world position the user desires the camera to look at. It repoints the camera towards the given position using the difference between the position and the current camera location as a direction vector and the worldUpVector to compute up and left camera vectors.
    
    Parameters:
    
    pos - where to look at in terms of world coordinates
    
    worldUpVector - a normalized vector indicating the up direction of the world. (typically {0, 1, 0} in jME.)
  - setFrame
```
public void setFrame(Vector3f location,
                     Quaternion axes)
```
    setFrame sets the orientation and location of the camera.
    
    Parameters:
    
    location - the point position of the camera.
    
    axes - the orientation of the camera.
  - update
```
public void update()
```
    update updates the camera parameters by calling onFrustumChange,onViewPortChange and onFrameChange.
    
    See Also:
    
    update()
  - getPlaneState
```
public int getPlaneState()
```
    getPlaneState returns the state of the frustum planes. So checks can be made as to which frustum plane has been examined for culling thus far.
    
    Returns:
    
    the current plane state int.
  - setPlaneState
```
public void setPlaneState(int planeState)
```
    setPlaneState sets the state to keep track of tested planes for culling.
    
    Parameters:
    
    planeState - the updated state.
  - getViewPortLeft
```
public float getViewPortLeft()
```
    getViewPortLeft gets the left boundary of the viewport
    
    Returns:
    
    the left boundary of the viewport
  - setViewPortLeft
```
public void setViewPortLeft(float left)
```
    setViewPortLeft sets the left boundary of the viewport
    
    Parameters:
    
    left - the left boundary of the viewport
  - getViewPortRight
```
public float getViewPortRight()
```
    getViewPortRight gets the right boundary of the viewport
    
    Returns:
    
    the right boundary of the viewport
  - setViewPortRight
```
public void setViewPortRight(float right)
```
    setViewPortRight sets the right boundary of the viewport
    
    Parameters:
    
    right - the right boundary of the viewport
  - getViewPortTop
```
public float getViewPortTop()
```
    getViewPortTop gets the top boundary of the viewport
    
    Returns:
    
    the top boundary of the viewport
  - setViewPortTop
```
public void setViewPortTop(float top)
```
    setViewPortTop sets the top boundary of the viewport
    
    Parameters:
    
    top - the top boundary of the viewport
  - getViewPortBottom
```
public float getViewPortBottom()
```
    getViewPortBottom gets the bottom boundary of the viewport
    
    Returns:
    
    the bottom boundary of the viewport
  - setViewPortBottom
```
public void setViewPortBottom(float bottom)
```
    setViewPortBottom sets the bottom boundary of the viewport
    
    Parameters:
    
    bottom - the bottom boundary of the viewport
  - setViewPort
```
public void setViewPort(float left,
                        float right,
                        float bottom,
                        float top)
```
    setViewPort sets the boundaries of the viewport
    
    Parameters:
    
    left - the left boundary of the viewport (default: 0)
    
    right - the right boundary of the viewport (default: 1)
    
    bottom - the bottom boundary of the viewport (default: 0)
    
    top - the top boundary of the viewport (default: 1)
  - distanceToNearPlane
```
public float distanceToNearPlane(Vector3f pos)
```
    Returns the pseudo distance from the given position to the near plane of the camera. This is used for render queue sorting.
    
    Parameters:
    
    pos - The position to compute a distance to.
    
    Returns:
    
    Distance from the near plane to the point.
  - contains
```
public Camera.FrustumIntersect contains(BoundingVolume bound)
```
    contains tests a bounding volume against the planes of the camera's frustum. The frustum's planes are set such that the normals all face in towards the viewable scene. Therefore, if the bounding volume is on the negative side of the plane is can be culled out. NOTE: This method is used internally for culling, for public usage, the plane state of the camera must be saved and restored, e.g: BoundingVolume bv; Camera c; int planeState = c.getPlaneState(); c.setPlaneState(0); c.contains(bv); c.setPlaneState(plateState);
    
    Parameters:
    
    bound - the bound to check for culling
    
    Returns:
    
    See enums in FrustumIntersect
  - getWorldPlane
```
public Plane getWorldPlane(int planeId)
```
  - containsGui
```
public boolean containsGui(BoundingVolume bound)
```
    containsGui tests a bounding volume against the ortho bounding box of the camera. A bounding box spanning from 0, 0 to Width, Height. Constrained by the viewport settings on the camera.
    
    Parameters:
    
    bound - the bound to check for culling
    
    Returns:
    
    True if the camera contains the gui element bounding volume.
  - getViewMatrix
```
public Matrix4f getViewMatrix()
```
    Returns:
    
    the view matrix of the camera. The view matrix transforms world space into eye space. This matrix is usually defined by the position and orientation of the camera.
  - setProjectionMatrix
```
public void setProjectionMatrix(Matrix4f projMatrix)
```
    Overrides the projection matrix used by the camera. Will use the matrix for computing the view projection matrix as well. Use null argument to return to normal functionality.
    
    Parameters:
    
    projMatrix - the desired projection matrix (unaffected) or null to cease the override
  - getProjectionMatrix
```
public Matrix4f getProjectionMatrix()
```
    Returns:
    
    the projection matrix of the camera. The view projection matrix transforms eye space into clip space. This matrix is usually defined by the viewport and perspective settings of the camera.
  - updateViewProjection
```
public void updateViewProjection()
```
    Updates the view projection matrix.
  - getViewProjectionMatrix
```
public Matrix4f getViewProjectionMatrix()
```
    Returns:
    
    The result of multiplying the projection matrix by the view matrix. This matrix is required for rendering an object. It is precomputed so as to not compute it every time an object is rendered.
  - isViewportChanged
```
public boolean isViewportChanged()
```
    Returns:
    
    True if the viewport (width, height, left, right, bottom, up) has been changed. This is needed in the renderer so that the proper viewport can be set-up.
  - clearViewportChanged
```
public void clearViewportChanged()
```
    Clears the viewport changed flag once it has been updated inside the renderer.
  - onViewPortChange
```
public void onViewPortChange()
```
    Called when the viewport has been changed.
  - onFrustumChange
```
public void onFrustumChange()
```
    onFrustumChange updates the frustum to reflect any changes made to the planes. The new frustum values are kept in a temporary location for use when calculating the new frame. The projection matrix is updated to reflect the current values of the frustum.
  - onFrameChange
```
public void onFrameChange()
```
    onFrameChange updates the view frame of the camera.
  - isParallelProjection
```
public boolean isParallelProjection()
```
    Returns:
    
    true if parallel projection is enable, false if in normal perspective mode
    
    See Also:
    
    setParallelProjection(boolean)
  - setParallelProjection
```
public void setParallelProjection(boolean value)
```
    Enable/disable parallel projection.
    
    Parameters:
    
    value - true to set up this camera for parallel projection is enable, false to enter normal perspective mode
  - getViewToProjectionZ
```
public float getViewToProjectionZ(float viewZPos)
```
    Computes the z value in projection space from the z value in view space Note that the returned value is going non linearly from 0 to 1. for more explanations on non linear z buffer see http://www.sjbaker.org/steve/omniv/love_your_z_buffer.html
    
    Parameters:
    
    viewZPos - the z value in view space.
    
    Returns:
    
    the z value in projection space.
  - getWorldCoordinates
```
public Vector3f getWorldCoordinates(Vector2f screenPos,
                                    float projectionZPos)
```
    Computes a position in World space given a screen position in screen space (0,0 to width, height) and a z position in projection space ( 0 to 1 non linear). This former value is also known as the Z buffer value or non linear depth buffer. for more explanations on non linear z buffer see http://www.sjbaker.org/steve/omniv/love_your_z_buffer.html To compute the projection space z from the view space z (distance from cam to object) @see Camera#getViewToProjectionZ
    
    Parameters:
    
    screenPos - 2d coordinate in screen space
    
    projectionZPos - non linear z value in projection space
    
    Returns:
    
    the position in world space.
  - getWorldCoordinates
```
public Vector3f getWorldCoordinates(Vector2f screenPosition,
                                    float projectionZPos,
                                    Vector3f store)
```
    Parameters:
    
    screenPosition - a (2-D) location in screen space (not null)
    
    projectionZPos - a (non-linear) Z value in projection space
    
    store - storage for the result (modified if not null)
    
    Returns:
    
    a location vector (in world coordinates, either store or a new vector)
    
    See Also:
    
    getWorldCoordinates(com.jme3.math.Vector2f, float)
  - getScreenCoordinates
```
public Vector3f getScreenCoordinates(Vector3f worldPos)
```
    Converts the given position from world space to screen space.
    
    Parameters:
    
    worldPos - a location in world coordinates (not null, unaffected)
    
    Returns:
    
    a new (3-D) location vector (in screen coordinates)
    
    See Also:
    
    getScreenCoordinates(com.jme3.math.Vector3f)
  - getScreenCoordinates
```
public Vector3f getScreenCoordinates(Vector3f worldPosition,
                                     Vector3f store)
```
    Converts the given position from world space to screen space.
    
    Parameters:
    
    worldPosition - a location in world coordinates (not null, unaffected)
    
    store - storage for the result (modified if not null)
    
    Returns:
    
    a (3-D) location vector (in screen coordinates, either store or a new vector)
    
    See Also:
    
    getScreenCoordinates(Vector3f, Vector3f)
  - getWidth
```
public int getWidth()
```
    Returns:
    
    the width/resolution of the display.
  - getHeight
```
public int getHeight()
```
    Returns:
    
    the height/resolution of the display.
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - write
```
public void write(JmeExporter e)
           throws java.io.IOException
```
    Specified by:
    
    write in interface Savable
    
    Throws:
    
    java.io.IOException
  - read
```
public void read(JmeImporter e)
          throws java.io.IOException
```
    Specified by:
    
    read in interface Savable
    
    Throws:
    
    java.io.IOException

Class Camera

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

location

rotation

frustumNear

frustumFar

frustumLeft

frustumRight

frustumTop

frustumBottom

coeffLeft

coeffRight

coeffBottom

coeffTop

viewPortLeft

viewPortRight

viewPortTop

viewPortBottom

worldPlane

width

height

viewportChanged

projectionMatrixOverride

viewMatrix

projectionMatrix

viewProjectionMatrix

name

Constructor Detail

Camera

Camera

Method Detail

clone

copyFrom

setName

getName

setClipPlane

setClipPlane

resize

getFrustumBottom

setFrustumBottom

getFrustumFar

setFrustumFar

getFrustumLeft

setFrustumLeft

getFrustumNear

setFrustumNear

getFrustumRight

setFrustumRight

getFrustumTop

setFrustumTop

getFov

setFov

getAspect

getLocation

getRotation

getDirection

getLeft

getUp

getDirection

getLeft

getUp

setLocation

setRotation

lookAtDirection

setAxes

setAxes

normalize

setFrustum

setFrustumPerspective

setFrame

lookAt

setFrame

update

getPlaneState

setPlaneState