Class Texture3D

java.lang.Object

org.jzy3d.plot3d.primitives.Drawable

org.jzy3d.plot3d.primitives.volume.Texture3D

All Implemented Interfaces:

IMultiColorable, IGLBindedResource, IGLRenderer, ISortableDraw

public class Texture3D
extends Drawable
implements IGLBindedResource, IMultiColorable

Field Summary

Fields

Modifier and Type	Field	Description
protected Buffer	buffer
protected ColormapTexture	colormapTexure
protected boolean	disposed
protected ColorMapper	mapper
protected float	max
protected float	min
protected boolean	mounted
protected GLSLProgram	shaderProgram
protected int[]	shape
protected DrawableVBO	shapeVBO
protected int	texID	The GL texture ID.

Fields inherited from class Drawable

bbox, boundingBoxColor, boundingBoxDisplayed, displayed, hasListeners, legend, legendDisplayed, listeners, spaceTransformer, transform, transformBefore

Constructor Summary

Constructors

Constructor	Description
Texture3D(Buffer buffer, int[] shape, float min, float max, ColorMapper mapper, BoundingBox3d bbox)	Instanciate a drawable volume.
Texture3D(Buffer buffer, int[] shape, ColorMapper mapper, BoundingBox3d bbox)	A convenient constructor that configure the volume value range based on the colormapper settings.

Method Summary

Modifier and Type	Method	Description
void	applyGeometryTransform(Transform transform)
void	bind(IPainter painter)
void	dispose()	Performs all required operation to cleanup the Drawable.
void	draw(IPainter painter)	Call OpenGL2 routines for rendering the object.
ColorMapper	getColorMapper()	Get the colormapper.
boolean	hasMountedOnce()	Return true if mount(...) has been called at least one time
protected static float[]	invertMatrix(float[] m, float[] out)	Invert a column major 4x4 matrix.
void	mount(IPainter painter)	Mount resources to gl context
protected static float[]	multMatrixVec(float[] m, float[] vec, float[] out)	Multiply a column major 4x4 matrix with a 4 component vector.
protected static float[]	normalizeVec3(float[] vec)	Normalize the 3 first components of a vector, or set them to 0 if the vector is null.
void	setColorMapper(ColorMapper mapper)	Set the colormapper that will be used by the Drawable, instead of using precomputed colors.
void	setMax(Number max)
void	setMin(Number min)
void	setTextureData(IPainter painter, Buffer buffer, int[] shape)	Load buffer data into memory
void	unbind(IPainter painter)
void	updateBounds()
protected boolean	validateTexID(IPainter painter, boolean throwException)

Methods inherited from class Drawable

addDrawableListener, asWireframeable, doDrawBoundsIfDisplayed, doTransform, fireDrawableChanged, fireDrawableChanged, getBarycentre, getBoundingBoxColor, getBounds, getDistance, getLegend, getLongestDistance, getShortestDistance, getSpaceTransformer, getTransform, getTransformBefore, hasLegend, isBoundingBoxDisplayed, isDisplayed, isLegendDisplayed, removeDrawableListener, setBoundingBoxColor, setBoundingBoxDisplayed, setDisplayed, setLegend, setLegendDisplayed, setSpaceTransformer, setTransform, setTransformBefore, toString, toString

Methods inherited from class Object

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

Field Details

texID

protected int texID

The GL texture ID.

buffer

protected Buffer buffer

shape

protected int[] shape

mounted

protected boolean mounted

shapeVBO

protected DrawableVBO shapeVBO

shaderProgram

protected GLSLProgram shaderProgram

min

protected float min

max

protected float max

colormapTexure

protected ColormapTexture colormapTexure

disposed

protected boolean disposed

mapper

protected ColorMapper mapper

Constructor Details

Texture3D

public Texture3D(Buffer buffer,
 int[] shape,
 float min,
 float max,
 ColorMapper mapper,
 BoundingBox3d bbox)

Instanciate a drawable volume.

Parameters:

buffer - provides (x,y,z,V) tuples where (x,y,z) are voxel index in the volume and V the value used for coloring voxels

shape - a 3 element array indicating the number of voxels for each dimension

min - the minimum V value provided in the input buffer which must be set consistently with the colormapper

max - the maximum V value provided in the input buffer which must be set consistently with the colormapper

mapper - the colormap handler that will apply a colormap to a value range

bbox - the real world range of each axis, since the input buffer provide tuples with index and not coordinates

Texture3D

public Texture3D(Buffer buffer,
 int[] shape,
 ColorMapper mapper,
 BoundingBox3d bbox)

A convenient constructor that configure the volume value range based on the colormapper settings. Texture3D(Buffer, int[], float, float, ColorMapper, BoundingBox3d)

Method Details

mount

public void mount(IPainter painter)

Description copied from interface: IGLBindedResource

Mount resources to gl context

Specified by:

mount in interface IGLBindedResource

setMin

public void setMin(Number min)

setMax

public void setMax(Number max)

hasMountedOnce

public boolean hasMountedOnce()

Description copied from interface: IGLBindedResource

Return true if mount(...) has been called at least one time

Specified by:

hasMountedOnce in interface IGLBindedResource

bind

public void bind(IPainter painter)

unbind

public void unbind(IPainter painter)

setTextureData

public void setTextureData(IPainter painter,
 Buffer buffer,
 int[] shape)

Load buffer data into memory

Parameters:

painter -

buffer - texture data

shape - the dimensions of 3d texture.

validateTexID

protected boolean validateTexID(IPainter painter,
 boolean throwException)

draw

public void draw(IPainter painter)

Description copied from class: Drawable

Call OpenGL2 routines for rendering the object.

Specified by:

draw in interface IGLRenderer

Specified by:

draw in class Drawable

applyGeometryTransform

public void applyGeometryTransform(Transform transform)

Specified by:

applyGeometryTransform in class Drawable

dispose

public void dispose()

Description copied from class: Drawable

Performs all required operation to cleanup the Drawable.

Overrides:

dispose in class Drawable

updateBounds

public void updateBounds()

Specified by:

updateBounds in class Drawable

getColorMapper

public ColorMapper getColorMapper()

Description copied from interface: IMultiColorable

Get the colormapper.

Specified by:

getColorMapper in interface IMultiColorable

setColorMapper

public void setColorMapper(ColorMapper mapper)

Description copied from interface: IMultiColorable

Set the colormapper that will be used by the Drawable, instead of using precomputed colors.

Specified by:

setColorMapper in interface IMultiColorable

invertMatrix

protected static float[] invertMatrix(float[] m,
 float[] out)

Invert a column major 4x4 matrix.

Returns:

the inverted matrix stored in out, or null if the matrix is not invertible.

multMatrixVec

protected static float[] multMatrixVec(float[] m,
 float[] vec,
 float[] out)

Multiply a column major 4x4 matrix with a 4 component vector. Components of out are written one after the other, hence using the same array for vec and out makes the computation of a component use the components already computed.

normalizeVec3

protected static float[] normalizeVec3(float[] vec)

Normalize the 3 first components of a vector, or set them to 0 if the vector is null.