public interface Texture
Modifier and Type | Method and Description |
---|---|
void |
dispose(javax.media.opengl.GLContext context)
Disposes all Java heap and GPU resources associated with this texture.
|
int |
getDimensionSize(int n)
Given a dimension index (0, 1, or 2) returns the number of data
elements in the texture along that dimension.
|
int[] |
getHandles()
Returns the OpenGL handle to the texture data.
|
int |
getNumDimension()
Returns whether the texture is a 1-dimensional, 2-dimensional,
or 3-dimensional texture.
|
boolean |
isDirty()
Indicates whether
makeDirty() has been called. |
boolean |
isResident(javax.media.opengl.GL2 gl)
OpenGL implementations may swap store a "working set" of textures
in a very fast cache of texture memory.
|
void |
makeDirty()
Most Texture implementations are backed by a buffer on the
heap which acts as a staging area for data changes to the
texture.
|
boolean |
prepare(javax.media.opengl.GL2 gl,
int texUnit)
Allocates space for the texture in GPU texture memory (once, if this is the
first time that
prepare( GL, int) has been called), copies texture
data from the heap into GPU memory (if isDirty() is true). |
int[] getHandles()
void makeDirty()
makeDirty()
indicates that the
contents of this buffer has changed and the new data should
be copied to the GPU.boolean isDirty()
makeDirty()
has been called. Once
makeDirty()
is called, isDirty()
will return
true until prepare( GL, int )
is called and the tecture
data is copied to the GPU.int getNumDimension()
int getDimensionSize(int n)
n
- the texture dimension to queryboolean isResident(javax.media.opengl.GL2 gl)
isResident( GL )
indicates whether this texture is resident in texture memory.gl
- a GL handle for the active GLContextboolean prepare(javax.media.opengl.GL2 gl, int texUnit)
prepare( GL, int)
has been called), copies texture
data from the heap into GPU memory (if isDirty()
is true). This texture
is then made active on the provided texture unit (using glActiveTexture()
)
and bound as the current GL_TEXTURE_1D
, GL_TEXTURE_2D
, or
GL_TEXTURE_3D
as appropriate based on getNumDimension()
. Once this
is complete, the texture is ready to be used by a
GlimpsePainter
.gl
- a GL handle for the active GLContexttexUnit
- the texture unit to bind to this texturevoid dispose(javax.media.opengl.GLContext context)
context
- the active GLContextCopyright © 2016 Metron, Inc.. All rights reserved.