|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Texture
Wrapper interface for an OpenGL texture. Provides methods for getting its size, marking it as modified, binding it to a texture unit, and disposing of it properly.
Method Summary | |
---|---|
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 |
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.GL 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.GL 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). |
Method Detail |
---|
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 query
boolean isResident(javax.media.opengl.GL gl)
isResident( GL )
indicates whether this texture is resident in texture memory.
gl
- a GL handle for the active GLContext
boolean prepare(javax.media.opengl.GL 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 texture
void dispose(javax.media.opengl.GLContext context)
context
- the active GLContext
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |