|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.sun.opengl.util.texture.TextureData
Represents the data for an OpenGL texture. This is separated from the notion of a Texture to support things like streaming in of textures in a background thread without requiring an OpenGL context to be current on that thread.
Nested Class Summary | |
static interface |
TextureData.Flusher
Defines a callback mechanism to allow the user to explicitly deallocate native resources (memory-mapped files, etc.) associated with a particular TextureData. |
Constructor Summary | |
TextureData(int internalFormat,
int pixelFormat,
boolean mipmap,
BufferedImage image)
Constructs a new TextureData object with the specified parameters and data contained in the given BufferedImage. |
|
TextureData(int internalFormat,
int width,
int height,
int border,
int pixelFormat,
int pixelType,
boolean mipmap,
boolean dataIsCompressed,
boolean mustFlipVertically,
Buffer buffer,
TextureData.Flusher flusher)
Constructs a new TextureData object with the specified parameters and data contained in the given Buffer. |
|
TextureData(int internalFormat,
int width,
int height,
int border,
int pixelFormat,
int pixelType,
boolean dataIsCompressed,
boolean mustFlipVertically,
Buffer[] mipmapData,
TextureData.Flusher flusher)
Constructs a new TextureData object with the specified parameters and data for multiple mipmap levels contained in the given array of Buffers. |
Method Summary | |
void |
flush()
Flushes resources associated with this TextureData by calling Flusher.flush(). |
int |
getAlignment()
Returns the required byte alignment for the texture data. |
int |
getBorder()
Returns the border in pixels of the texture data. |
Buffer |
getBuffer()
Returns the texture data, or null if it is specified as a set of mipmaps. |
int |
getEstimatedMemorySize()
Returns an estimate of the amount of memory in bytes this TextureData will consume once uploaded to the graphics card. |
int |
getHeight()
Returns the height in pixels of the texture data. |
int |
getInternalFormat()
Returns the intended OpenGL internal format of the texture data. |
boolean |
getMipmap()
Returns whether mipmaps should be generated for the texture data. |
Buffer[] |
getMipmapData()
Returns all mipmap levels for the texture data, or null if it is specified as a single image. |
boolean |
getMustFlipVertically()
Indicates whether the texture coordinates must be flipped vertically for proper display. |
int |
getPixelFormat()
Returns the intended OpenGL pixel format of the texture data. |
int |
getPixelType()
Returns the intended OpenGL pixel type of the texture data. |
int |
getWidth()
Returns the width in pixels of the texture data. |
boolean |
isDataCompressed()
Indicates whether the texture data is in compressed form. |
void |
setAlignment(int alignment)
Sets the required byte alignment for the texture data. |
void |
setBorder(int border)
Sets the border in pixels of the texture data. |
void |
setBuffer(Buffer buffer)
Sets the texture data. |
void |
setHeight(int height)
Sets the height in pixels of the texture data. |
void |
setInternalFormat(int internalFormat)
Sets the intended OpenGL internal format of the texture data. |
void |
setIsDataCompressed(boolean compressed)
Sets whether the texture data is in compressed form. |
void |
setMipmap(boolean mipmap)
Sets whether mipmaps should be generated for the texture data. |
void |
setMustFlipVertically(boolean mustFlipVertically)
Sets whether the texture coordinates must be flipped vertically for proper display. |
void |
setPixelFormat(int pixelFormat)
Sets the intended OpenGL pixel format of the texture data. |
void |
setPixelType(int pixelType)
Sets the intended OpenGL pixel type of the texture data. |
void |
setWidth(int width)
Sets the width in pixels of the texture data. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public TextureData(int internalFormat, int width, int height, int border, int pixelFormat, int pixelType, boolean mipmap, boolean dataIsCompressed, boolean mustFlipVertically, Buffer buffer, TextureData.Flusher flusher) throws IllegalArgumentException
internalFormat
- the OpenGL internal format for the
resulting texture; must be specified, may
not be 0width
- the width in pixels of the textureheight
- the height in pixels of the textureborder
- the number of pixels of border this texture
data has (0 or 1)pixelFormat
- the OpenGL pixel format for the
resulting texture; must be specified, may
not be 0pixelType
- the OpenGL type of the pixels of the texturemipmap
- indicates whether mipmaps should be
autogenerated (using GLU) for the resulting
texture. Currently if mipmap is true then
dataIsCompressed may not be true.dataIsCompressed
- indicates whether the texture data is in
compressed form
(e.g. GL_COMPRESSED_RGB_S3TC_DXT1_EXT)mustFlipVertically
- indicates whether the texture
coordinates must be flipped vertically
in order to properly display the
texturebuffer
- the buffer containing the texture dataflusher
- optional flusher to perform cleanup tasks
upon call to flush()
IllegalArgumentException
- if any parameters of the texture
data were invalid, such as requesting mipmap generation for a
compressed texturepublic TextureData(int internalFormat, int width, int height, int border, int pixelFormat, int pixelType, boolean dataIsCompressed, boolean mustFlipVertically, Buffer[] mipmapData, TextureData.Flusher flusher) throws IllegalArgumentException
internalFormat
- the OpenGL internal format for the
resulting texture; must be specified, may
not be 0width
- the width in pixels of the topmost mipmap
level of the textureheight
- the height in pixels of the topmost mipmap
level of the textureborder
- the number of pixels of border this texture
data has (0 or 1)pixelFormat
- the OpenGL pixel format for the
resulting texture; must be specified, may
not be 0pixelType
- the OpenGL type of the pixels of the texturedataIsCompressed
- indicates whether the texture data is in
compressed form
(e.g. GL_COMPRESSED_RGB_S3TC_DXT1_EXT)mustFlipVertically
- indicates whether the texture
coordinates must be flipped vertically
in order to properly display the
texturemipmapData
- the buffers containing all mipmap levels
of the texture's dataflusher
- optional flusher to perform cleanup tasks
upon call to flush()
IllegalArgumentException
- if any parameters of the texture
data were invalid, such as requesting mipmap generation for a
compressed texturepublic TextureData(int internalFormat, int pixelFormat, boolean mipmap, BufferedImage image)
internalFormat
- the OpenGL internal format for the
resulting texture; may be 0, in which case
it is inferred from the image's typepixelFormat
- the OpenGL internal format for the
resulting texture; may be 0, in which case
it is inferred from the image's type (note:
this argument is currently always ignored)mipmap
- indicates whether mipmaps should be
autogenerated (using GLU) for the resulting
textureimage
- the image containing the texture dataMethod Detail |
public int getWidth()
public int getHeight()
public int getBorder()
public int getPixelFormat()
public int getPixelType()
public int getInternalFormat()
public boolean getMipmap()
public boolean isDataCompressed()
public boolean getMustFlipVertically()
public Buffer getBuffer()
public Buffer[] getMipmapData()
public int getAlignment()
public void setWidth(int width)
public void setHeight(int height)
public void setBorder(int border)
public void setPixelFormat(int pixelFormat)
public void setPixelType(int pixelType)
public void setInternalFormat(int internalFormat)
public void setMipmap(boolean mipmap)
public void setIsDataCompressed(boolean compressed)
public void setMustFlipVertically(boolean mustFlipVertically)
public void setBuffer(Buffer buffer)
public void setAlignment(int alignment)
public int getEstimatedMemorySize()
public void flush()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |