org.jzy3d.plot3d.primitives.axes

Class AxeBox

java.lang.Object

org.jzy3d.plot3d.primitives.axes.AxeBox

All Implemented Interfaces:

IAxe

Direct Known Subclasses:

AxeBox2d, AxeBoxWithTxtRenderer, ContourAxeBox, FeedbackBufferAxeBox

public class AxeBox
extends Object
implements IAxe

The AxeBox displays a box with front face invisible and ticks labels.

Author:

Martin Pernollet

Field Summary

Fields

Modifier and Type	Field and Description
protected List<AxeAnnotation>	annotations
static int	AXE_X
static int	AXE_Y
static int	AXE_Z
protected int[][]	axeXquads
protected float[][]	axeXx
protected float[][]	axeXy
protected float[][]	axeXz
protected int[][]	axeYquads
protected float[][]	axeYx
protected float[][]	axeYy
protected float[][]	axeYz
protected int[][]	axeZquads
protected float[][]	axeZx
protected float[][]	axeZy
protected float[][]	axeZz
protected BoundingBox3d	boxBounds
protected Coord3d	center
protected IAxeLayout	layout
protected float[]	normx
protected float[]	normy
protected float[]	normz
protected static int	PRECISION
protected boolean[]	quadIsHidden
protected float[][]	quadx
protected float[][]	quady
protected float[][]	quadz
protected Coord3d	scale
protected SpaceTransformer	spaceTransformer
protected ITextRenderer	txt
protected View	view
protected BoundingBox3d	wholeBounds
protected float	xrange
protected float	yrange
protected float	zrange

Constructor Summary

Constructors

Constructor and Description
AxeBox(BoundingBox3d bbox)
AxeBox(BoundingBox3d bbox, IAxeLayout layout)

Method Summary

Modifier and Type	Method and Description
void	addAnnotation(AxeAnnotation annotation)
void	cullingDisable(com.jogamp.opengl.GL gl)
void	cullingEnable(com.jogamp.opengl.GL gl)
void	dispose()
void	doTransform(com.jogamp.opengl.GL gl) reset to identity and apply scaling
void	draw(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Camera camera) Draws the AxeBox.
void	drawAxisLabel(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Camera cam, int direction, Color color, BoundingBox3d ticksTxtBounds, double xlab, double ylab, double zlab, String axeLabel)
void	drawAxisTickNumericLabel(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, int direction, Camera cam, Color color, Halign hAlign, Valign vAlign, BoundingBox3d ticksTxtBounds, String tickLabel, Coord3d tickPosition)
void	drawAxisTicks(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Camera cam, int direction, Color color, Halign hal, Valign val, float tickLength, BoundingBox3d ticksTxtBounds, double xpos, double ypos, double zpos, float xdir, float ydir, float zdir, double[] ticks) Draw an array of ticks on the given axis indicated by direction field.
protected void	drawCube(com.jogamp.opengl.GL gl, int mode) Make all GL2 calls allowing to build a cube with 6 separate quads.
void	drawFace(com.jogamp.opengl.GL gl)
void	drawGrid(com.jogamp.opengl.GL gl)
protected void	drawGridOnQuad(com.jogamp.opengl.GL gl, int quad) Draw a grid on the desired quad.
void	drawTickLine(com.jogamp.opengl.GL gl, Color color, double xpos, double ypos, double zpos, double xlab, double ylab, double zlab)
protected BoundingBox3d	drawTicks(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Camera cam, int axis, int direction, Color color)
protected BoundingBox3d	drawTicks(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Camera cam, int axis, int direction, Color color, Halign hal, Valign val) Draws axis labels, tick lines and tick label
void	drawTicksAndLabels(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Camera camera)
void	drawTicksAndLabelsX(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Camera camera)
void	drawTicksAndLabelsY(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Camera camera)
void	drawTicksAndLabelsZ(com.jogamp.opengl.GL gl, com.jogamp.opengl.glu.GLU glu, Camera camera)
protected int	findClosestXaxe(Camera cam) Selects the closest displayable X axe from camera
protected int	findClosestYaxe(Camera cam) Selects the closest displayable Y axe from camera
protected int	findClosestZaxe(Camera cam) Selects the closest displayable Z axe from camera
List<AxeAnnotation>	getAnnotations()
protected double[]	getAxisTicks(int direction)
BoundingBox3d	getBoxBounds()
Coord3d	getCenter()
boolean[]	getHiddenQuads(Coord3d scaledEye, Coord3d center)
protected boolean[]	getHiddenQuads(com.jogamp.opengl.GL gl, Camera cam) Computes the visibility of each cube face.
IAxeLayout	getLayout()
Coord3d	getScale()
SpaceTransformer	getSpaceTransformer()
ITextRenderer	getTextRenderer()
View	getView()
BoundingBox3d	getWholeBounds() Return the boundingBox of this axis, including the volume occupied by the texts.
protected void	init()
protected boolean	isX(int direction)
protected boolean	isXDisplayed(int direction)
protected boolean	isY(int direction)
protected boolean	isYDisplayed(int direction)
protected boolean	isZ(int direction)
protected boolean	isZDisplayed(int direction)
Halign	layoutHorizontal(int direction, Camera cam, Halign hal, Coord3d tickPosition)
Valign	layoutVertical(int direction, Valign val, float zdir)
protected int	min(double[] values) Return the index of the minimum value contained in the input array of doubles.
void	setAnnotations(List<AxeAnnotation> annotations)
void	setAxe(BoundingBox3d bbox)
protected void	setAxeBox(float xmin, float xmax, float ymin, float ymax, float zmin, float zmax) Set the parameters and data of the AxeBox.
void	setScale(Coord3d scale) Set the scaling factor that are applyed on this object before GL2 commands.
void	setSpaceTransformer(SpaceTransformer spaceTransformer)
void	setTextRenderer(ITextRenderer renderer)
void	setView(View view) When setting a current view, the AxeBox can know the view is on mode CameraMode.TOP, and optimize some axis placement.
protected void	updateHiddenQuads(com.jogamp.opengl.GL gl, Camera camera)
protected void	vertexGL2(com.jogamp.opengl.GL gl, Coord3d c) A helper to call glVerted3f on the input coordinate.
protected void	vertexGL2(com.jogamp.opengl.GL gl, float x, float y, float z)
protected void	vertexGLES2(Coord3d c) A helper to call glVerted3f on the input coordinate.
protected void	vertexGLES2(float x, float y, float z)

Methods inherited from class java.lang.Object

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

Field Detail

PRECISION

protected static final int PRECISION

See Also:

Constant Field Values

view

protected View view

txt

protected ITextRenderer txt

layout

protected IAxeLayout layout

boxBounds

protected BoundingBox3d boxBounds

wholeBounds

protected BoundingBox3d wholeBounds

center

protected Coord3d center

scale

protected Coord3d scale

xrange

protected float xrange

yrange

protected float yrange

zrange

protected float zrange

quadx

protected float[][] quadx

quady

protected float[][] quady

quadz

protected float[][] quadz

normx

protected float[] normx

normy

protected float[] normy

normz

protected float[] normz

axeXx

protected float[][] axeXx

axeXy

protected float[][] axeXy

axeXz

protected float[][] axeXz

axeYx

protected float[][] axeYx

axeYy

protected float[][] axeYy

axeYz

protected float[][] axeYz

axeZx

protected float[][] axeZx

axeZy

protected float[][] axeZy

axeZz

protected float[][] axeZz

axeXquads

protected int[][] axeXquads

axeYquads

protected int[][] axeYquads

axeZquads

protected int[][] axeZquads

quadIsHidden

protected boolean[] quadIsHidden

AXE_X

public static final int AXE_X

See Also:

Constant Field Values

AXE_Y

public static final int AXE_Y

See Also:

Constant Field Values

AXE_Z

public static final int AXE_Z

See Also:

Constant Field Values

annotations

protected List<AxeAnnotation> annotations

spaceTransformer

protected SpaceTransformer spaceTransformer

Constructor Detail

AxeBox

public AxeBox(BoundingBox3d bbox)

AxeBox

public AxeBox(BoundingBox3d bbox,
              IAxeLayout layout)

Method Detail

getAnnotations

public List<AxeAnnotation> getAnnotations()

Specified by:

getAnnotations in interface IAxe

setAnnotations

public void setAnnotations(List<AxeAnnotation> annotations)

Specified by:

setAnnotations in interface IAxe

addAnnotation

public void addAnnotation(AxeAnnotation annotation)

draw

public void draw(com.jogamp.opengl.GL gl,
                 com.jogamp.opengl.glu.GLU glu,
                 Camera camera)

Draws the AxeBox. The camera is used to determine which axis is closest to the ur point ov view, in order to decide for an axis on which to diplay the tick values.

Specified by:

draw in interface IAxe

doTransform

public void doTransform(com.jogamp.opengl.GL gl)

reset to identity and apply scaling

cullingDisable

public void cullingDisable(com.jogamp.opengl.GL gl)

cullingEnable

public void cullingEnable(com.jogamp.opengl.GL gl)

drawFace

public void drawFace(com.jogamp.opengl.GL gl)

drawGrid

public void drawGrid(com.jogamp.opengl.GL gl)

drawTicksAndLabels

public void drawTicksAndLabels(com.jogamp.opengl.GL gl,
                               com.jogamp.opengl.glu.GLU glu,
                               Camera camera)

drawTicksAndLabelsX

public void drawTicksAndLabelsX(com.jogamp.opengl.GL gl,
                                com.jogamp.opengl.glu.GLU glu,
                                Camera camera)

drawTicksAndLabelsY

public void drawTicksAndLabelsY(com.jogamp.opengl.GL gl,
                                com.jogamp.opengl.glu.GLU glu,
                                Camera camera)

drawTicksAndLabelsZ

public void drawTicksAndLabelsZ(com.jogamp.opengl.GL gl,
                                com.jogamp.opengl.glu.GLU glu,
                                Camera camera)

drawCube

protected void drawCube(com.jogamp.opengl.GL gl,
                        int mode)

Make all GL2 calls allowing to build a cube with 6 separate quads. Each quad is indexed from 0.0f to 5.0f using glPassThrough, and may be traced in feedback mode when mode=GL2.GL_FEEDBACK

drawGridOnQuad

protected void drawGridOnQuad(com.jogamp.opengl.GL gl,
                              int quad)

Draw a grid on the desired quad.

drawTicks

protected BoundingBox3d drawTicks(com.jogamp.opengl.GL gl,
                                  com.jogamp.opengl.glu.GLU glu,
                                  Camera cam,
                                  int axis,
                                  int direction,
                                  Color color)

drawTicks

protected BoundingBox3d drawTicks(com.jogamp.opengl.GL gl,
                                  com.jogamp.opengl.glu.GLU glu,
                                  Camera cam,
                                  int axis,
                                  int direction,
                                  Color color,
                                  Halign hal,
                                  Valign val)

Draws axis labels, tick lines and tick label

drawAxisLabel

public void drawAxisLabel(com.jogamp.opengl.GL gl,
                          com.jogamp.opengl.glu.GLU glu,
                          Camera cam,
                          int direction,
                          Color color,
                          BoundingBox3d ticksTxtBounds,
                          double xlab,
                          double ylab,
                          double zlab,
                          String axeLabel)

isZDisplayed

protected boolean isZDisplayed(int direction)

isYDisplayed

protected boolean isYDisplayed(int direction)

isXDisplayed

protected boolean isXDisplayed(int direction)

isZ

protected boolean isZ(int direction)

isY

protected boolean isY(int direction)

isX

protected boolean isX(int direction)

getAxisTicks

protected double[] getAxisTicks(int direction)

drawAxisTicks

public void drawAxisTicks(com.jogamp.opengl.GL gl,
                          com.jogamp.opengl.glu.GLU glu,
                          Camera cam,
                          int direction,
                          Color color,
                          Halign hal,
                          Valign val,
                          float tickLength,
                          BoundingBox3d ticksTxtBounds,
                          double xpos,
                          double ypos,
                          double zpos,
                          float xdir,
                          float ydir,
                          float zdir,
                          double[] ticks)

Draw an array of ticks on the given axis indicated by direction field.

drawAxisTickNumericLabel

public void drawAxisTickNumericLabel(com.jogamp.opengl.GL gl,
                                     com.jogamp.opengl.glu.GLU glu,
                                     int direction,
                                     Camera cam,
                                     Color color,
                                     Halign hAlign,
                                     Valign vAlign,
                                     BoundingBox3d ticksTxtBounds,
                                     String tickLabel,
                                     Coord3d tickPosition)

layoutVertical

public Valign layoutVertical(int direction,
                             Valign val,
                             float zdir)

layoutHorizontal

public Halign layoutHorizontal(int direction,
                               Camera cam,
                               Halign hal,
                               Coord3d tickPosition)

drawTickLine

public void drawTickLine(com.jogamp.opengl.GL gl,
                         Color color,
                         double xpos,
                         double ypos,
                         double zpos,
                         double xlab,
                         double ylab,
                         double zlab)

vertexGL2

protected void vertexGL2(com.jogamp.opengl.GL gl,
                         Coord3d c)

A helper to call glVerted3f on the input coordinate. For GL2 profile only. If logTransform is non null, then each dimension transform is processed before calling glVertex3d.

vertexGL2

protected void vertexGL2(com.jogamp.opengl.GL gl,
                         float x,
                         float y,
                         float z)

vertexGLES2

protected void vertexGLES2(Coord3d c)

A helper to call glVerted3f on the input coordinate. For GLES2 profile only. If logTransform is non null, then each dimension transform is processed before calling glVertex3d.

vertexGLES2

protected void vertexGLES2(float x,
                           float y,
                           float z)

findClosestXaxe

protected int findClosestXaxe(Camera cam)

Selects the closest displayable X axe from camera

findClosestYaxe

protected int findClosestYaxe(Camera cam)

Selects the closest displayable Y axe from camera

findClosestZaxe

protected int findClosestZaxe(Camera cam)

Selects the closest displayable Z axe from camera

min

protected int min(double[] values)

Return the index of the minimum value contained in the input array of doubles. If no value is smaller than Double.MAX_VALUE, the returned index is -1.

updateHiddenQuads

protected void updateHiddenQuads(com.jogamp.opengl.GL gl,
                                 Camera camera)

getHiddenQuads

protected boolean[] getHiddenQuads(com.jogamp.opengl.GL gl,
                                   Camera cam)

Computes the visibility of each cube face.

getHiddenQuads

public boolean[] getHiddenQuads(Coord3d scaledEye,
                                Coord3d center)

setAxeBox

protected void setAxeBox(float xmin,
                         float xmax,
                         float ymin,
                         float ymax,
                         float zmin,
                         float zmax)

Set the parameters and data of the AxeBox.

init

protected void init()

dispose

public void dispose()

Specified by:

dispose in interface IAxe

getTextRenderer

public ITextRenderer getTextRenderer()

setTextRenderer

public void setTextRenderer(ITextRenderer renderer)

getView

public View getView()

getBoxBounds

public BoundingBox3d getBoxBounds()

Specified by:

getBoxBounds in interface IAxe

getLayout

public IAxeLayout getLayout()

Specified by:

getLayout in interface IAxe

getSpaceTransformer

public SpaceTransformer getSpaceTransformer()

Specified by:

getSpaceTransformer in interface IAxe

setSpaceTransformer

public void setSpaceTransformer(SpaceTransformer spaceTransformer)

Specified by:

setSpaceTransformer in interface IAxe

setView

public void setView(View view)

When setting a current view, the AxeBox can know the view is on mode CameraMode.TOP, and optimize some axis placement.

setAxe

public void setAxe(BoundingBox3d bbox)

Specified by:

setAxe in interface IAxe

getWholeBounds

public BoundingBox3d getWholeBounds()

Return the boundingBox of this axis, including the volume occupied by the texts. This requires calling draw() before, which computes actual ticks position in 3d, and updates the bounds.

Specified by:

getWholeBounds in interface IAxe

getCenter

public Coord3d getCenter()

Specified by:

getCenter in interface IAxe

setScale

public void setScale(Coord3d scale)

Set the scaling factor that are applyed on this object before GL2 commands.

Specified by:

setScale in interface IAxe

getScale

public Coord3d getScale()

Specified by:

getScale in interface IAxe