org.jzy3d.plot3d.rendering.view

Class Camera

java.lang.Object

org.jzy3d.plot3d.rendering.view.AbstractViewportManager

org.jzy3d.plot3d.rendering.view.Camera

public class Camera
extends AbstractViewportManager

A Camera allow to define on the view and target points in a cartesian coordinate system. The Camera provides the following services:

• allows setting perspective/orthogonal rendering mode through CameraMode.
• selects the appropriate clipping planes according to a given target box.
• ensure the modelview matrix is always available for GL2 calls related to anything else than projection.
• methods to convert screen coordinates into 3d coordinates and vice-versa

Author:

Martin Pernollet

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_CAMERA_DISTANCE_MODE Defines if camera distance is real, or only squared (squared distance avoid computing Math.sqrt() and is thus faster).
static Coord3d	DEFAULT_VIEW The polar default view point, i.e.
protected Coord3d	eye
protected float	far
protected float	near
protected float	radius
protected Coord3d	target
protected Coord3d	up
protected boolean	useSquaredDistance

Fields inherited from class org.jzy3d.plot3d.rendering.view.AbstractViewportManager

lastViewPort, mode, ratioHeight, ratioWidth, screenBottom, screenGridDisplayed, screenHeight, screenLeft, screenSquaredDim, screenWidth, screenXOffset, screenYOffset

Constructor Summary

Constructors

Constructor and Description
Camera(Coord3d target) Set up a Camera looking at target, with a viewpoint standing at target+(0,0,100).

Method Summary

Modifier and Type	Method and Description
protected double	computeFieldOfView(double size, double distance) Compute the field of View, in order to occupy the entire screen in PERSPECTIVE mode.
void	doShoot(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, CameraMode projection)
protected void	failedProjection(String message)
double	getDistance(AbstractDrawable drawable) Return the distance between the camera eye and the given drawable's barycenter.
double	getDistance(AbstractDrawable drawable, Coord3d viewScale) Apply scaling before computing distance between the camera eye and the given drawable's barycenter.
double	getDistance(Coord3d coord) Return the distance between the camera eye and the given coordinate.
double	getDistance(Coord3d coord, Coord3d viewScale) Apply scaling before computing distance between the camera eye and the given coordinate.
Coord3d	getEye() Returns the eye's position.
float	getFar() Return the position of the "far" clipping plane
protected double[]	getModelViewAsDouble(com.jogamp.opengl.GL gl)
protected float[]	getModelViewAsFloat(com.jogamp.opengl.GL gl)
float	getNear() Return the position of the "near" clipping plane
protected double[]	getProjectionAsDouble(com.jogamp.opengl.GL gl)
protected float[]	getProjectionAsFloat(com.jogamp.opengl.GL gl)
float	getRenderingSphereRadius() Return the radius of the sphere that will be contained into the rendered view.
Coord3d	getTarget() Returns the target's position that was set at the last call to lookAt().
Coord3d	getUp() Returns the top of the camera.
protected int[]	getViewPortAsInt(com.jogamp.opengl.GL gl)
boolean	isTiltUp() Returns true if the camera is 'looking up', in other word if the eye's Z value is inferior to the target's Z value.
boolean	isUseSquaredDistance()
ArrayList<ArrayList<Coord3d>>	modelToScreen(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, ArrayList<ArrayList<Coord3d>> polygons)
Coord3d	modelToScreen(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Coord3d point) Transform a 3d point coordinate into its screen position.
Coord3d[]	modelToScreen(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Coord3d[] points)
Coord3d[][]	modelToScreen(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Coord3d[][] points)
Grid	modelToScreen(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Grid grid)
List<Coord3d>	modelToScreen(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, List<Coord3d> points)
PolygonArray	modelToScreen(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, PolygonArray polygon)
PolygonArray[][]	modelToScreen(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, PolygonArray[][] polygons)
Coord3d	screenToModel(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Coord3d screen) Transform a 2d screen coordinate into a 3d coordinate.
void	setEye(Coord3d eye) Set the eye's position.
void	setRenderingDepth(float near, float far) Manually set the rendering depth (near and far clipping planes).
void	setRenderingSphereRadius(float radius) Set the radius of the sphere that will be contained into the rendered view.
void	setTarget(Coord3d target) Set the target point of the camera.
void	setUp(Coord3d up) Set the top of the camera.
void	setUseSquaredDistance(boolean useSquaredDistance) Defines what getDistance(...) will return, either: Squared distance (faster to compute since no Math.sqrt(...) at the end) Real distance Default value is set to true, meaning it use the faster squared distance.
void	shoot(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, CameraMode projection) Sets the projection and the mapping of the 3d model to 2d screen.
void	shoot(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, CameraMode projection, boolean doPushMatrixBeforeShooting)
void	show(com.jogamp.opengl.GL gl, Transform transform, Coord3d scaling)
boolean	side(Coord3d point) Return true if the given point is on the left of the vector eye->target.
String	toString() Print out in console information concerning the camera.
protected String	toString(Coord3d eye, Coord3d target, Coord3d up)

Methods inherited from class org.jzy3d.plot3d.rendering.view.AbstractViewportManager

applyViewport, getLastViewPort, getMode, getRectangle, renderSubScreenGrid, setScreenGridDisplayed, setViewPort, setViewPort, setViewPort, setViewportMode

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_VIEW

public static final Coord3d DEFAULT_VIEW

The polar default view point, i.e. Coord3d(Math.PI/3,Math.PI/5,500).

DEFAULT_CAMERA_DISTANCE_MODE

public static final boolean DEFAULT_CAMERA_DISTANCE_MODE

Defines if camera distance is real, or only squared (squared distance avoid computing Math.sqrt() and is thus faster). Second mode requires value true

See Also:

Constant Field Values

eye

protected Coord3d eye

target

protected Coord3d target

up

protected Coord3d up

radius

protected float radius

near

protected float near

far

protected float far

useSquaredDistance

protected boolean useSquaredDistance

Constructor Detail

Camera

public Camera(Coord3d target)

Set up a Camera looking at target, with a viewpoint standing at target+(0,0,100). The top of the camera is set up toward the positive Z direction.

Method Detail

setEye

public void setEye(Coord3d eye)

Set the eye's position.

getEye

public Coord3d getEye()

Returns the eye's position.

setTarget

public void setTarget(Coord3d target)

Set the target point of the camera.

getTarget

public Coord3d getTarget()

Returns the target's position that was set at the last call to lookAt().

setUp

public void setUp(Coord3d up)

Set the top of the camera.

getUp

public Coord3d getUp()

Returns the top of the camera.

isTiltUp

public boolean isTiltUp()

Returns true if the camera is 'looking up', in other word if the eye's Z value is inferior to the target's Z value.

setRenderingSphereRadius

public void setRenderingSphereRadius(float radius)

Set the radius of the sphere that will be contained into the rendered view. As a side effect, the "far" clipping plane is modified according to the eye-target distance, and the position of the "near" clipping plane.

getRenderingSphereRadius

public float getRenderingSphereRadius()

Return the radius of the sphere that will be contained into the rendered view.

setRenderingDepth

public void setRenderingDepth(float near,
                              float far)

Manually set the rendering depth (near and far clipping planes). Note that Camera.setRenderingSphereRadius modified the "far" clipping plane.

getNear

public float getNear()

Return the position of the "near" clipping plane

getFar

public float getFar()

Return the position of the "far" clipping plane

side

public boolean side(Coord3d point)

Return true if the given point is on the left of the vector eye->target.

screenToModel

public Coord3d screenToModel(com.jogamp.opengl.GL gl,
                             com.jogamp.opengl.glu.GLU glu,
                             Coord3d screen)

Transform a 2d screen coordinate into a 3d coordinate. The z component of the screen coordinate indicates a depth value between the near and far clipping plane of the Camera.

Throws:

a - RuntimeException if an error occured while trying to retrieve model coordinates

modelToScreen

public Coord3d modelToScreen(com.jogamp.opengl.GL gl,
                             com.jogamp.opengl.glu.GLU glu,
                             Coord3d point)

Transform a 3d point coordinate into its screen position.

Throws:

a - RuntimeException if an error occured while trying to retrieve model coordinates

modelToScreen

public Coord3d[] modelToScreen(com.jogamp.opengl.GL gl,
                               com.jogamp.opengl.glu.GLU glu,
                               Coord3d[] points)

modelToScreen

public Coord3d[][] modelToScreen(com.jogamp.opengl.GL gl,
                                 com.jogamp.opengl.glu.GLU glu,
                                 Coord3d[][] points)

modelToScreen

public List<Coord3d> modelToScreen(com.jogamp.opengl.GL gl,
                                   com.jogamp.opengl.glu.GLU glu,
                                   List<Coord3d> points)

modelToScreen

public ArrayList<ArrayList<Coord3d>> modelToScreen(com.jogamp.opengl.GL gl,
                                                   com.jogamp.opengl.glu.GLU glu,
                                                   ArrayList<ArrayList<Coord3d>> polygons)

modelToScreen

public PolygonArray modelToScreen(com.jogamp.opengl.GL gl,
                                  com.jogamp.opengl.glu.GLU glu,
                                  PolygonArray polygon)

modelToScreen

public Grid modelToScreen(com.jogamp.opengl.GL gl,
                          com.jogamp.opengl.glu.GLU glu,
                          Grid grid)

modelToScreen

public PolygonArray[][] modelToScreen(com.jogamp.opengl.GL gl,
                                      com.jogamp.opengl.glu.GLU glu,
                                      PolygonArray[][] polygons)

failedProjection

protected void failedProjection(String message)

getViewPortAsInt

protected int[] getViewPortAsInt(com.jogamp.opengl.GL gl)

getProjectionAsDouble

protected double[] getProjectionAsDouble(com.jogamp.opengl.GL gl)

getProjectionAsFloat

protected float[] getProjectionAsFloat(com.jogamp.opengl.GL gl)

getModelViewAsDouble

protected double[] getModelViewAsDouble(com.jogamp.opengl.GL gl)

getModelViewAsFloat

protected float[] getModelViewAsFloat(com.jogamp.opengl.GL gl)

show

public void show(com.jogamp.opengl.GL gl,
                 Transform transform,
                 Coord3d scaling)

shoot

public void shoot(com.jogamp.opengl.GL gl,
                  com.jogamp.opengl.glu.GLU glu,
                  CameraMode projection)

Sets the projection and the mapping of the 3d model to 2d screen. The projection must be either Camera.PERSPECTIVE or Camera.ORTHOGONAL.
shoot() finally calls the GL function glLookAt, according to the stored eye, target, up and scale values.
Note that the Camera set by itselft the MatrixMode to model view at the end of a shoot().

Parameters:

gl - GL2 context.

glu - GLU context.

projection - the projection mode.

Throws:

a - Runtime Exception if the projection mode is neither Camera.PERSPECTIVE nor Camera.ORTHOGONAL.

shoot

public void shoot(com.jogamp.opengl.GL gl,
                  com.jogamp.opengl.glu.GLU glu,
                  CameraMode projection,
                  boolean doPushMatrixBeforeShooting)

doShoot

public void doShoot(com.jogamp.opengl.GL gl,
                    com.jogamp.opengl.glu.GLU glu,
                    CameraMode projection)

computeFieldOfView

protected double computeFieldOfView(double size,
                                    double distance)

Compute the field of View, in order to occupy the entire screen in PERSPECTIVE mode.

getDistance

public double getDistance(AbstractDrawable drawable)

Return the distance between the camera eye and the given drawable's barycenter.

getDistance

public double getDistance(AbstractDrawable drawable,
                          Coord3d viewScale)

Apply scaling before computing distance between the camera eye and the given drawable's barycenter.

getDistance

public double getDistance(Coord3d coord)

Return the distance between the camera eye and the given coordinate.

getDistance

public double getDistance(Coord3d coord,
                          Coord3d viewScale)

Apply scaling before computing distance between the camera eye and the given coordinate.

isUseSquaredDistance

public boolean isUseSquaredDistance()

setUseSquaredDistance

public void setUseSquaredDistance(boolean useSquaredDistance)

Defines what getDistance(...) will return, either:

• Squared distance (faster to compute since no Math.sqrt(...) at the end)
• Real distance

Default value is set to true, meaning it use the faster squared distance.

toString

public String toString()

Print out in console information concerning the camera.

Overrides:

toString in class Object

toString

protected String toString(Coord3d eye,
                          Coord3d target,
                          Coord3d up)