com.sun.opengl.util.texture
Class TextureData

java.lang.Object
  extended by com.sun.opengl.util.texture.TextureData
Direct Known Subclasses:
AWTTextureData

public class TextureData
extends Object

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.

Author:
Chris Campbell, Kenneth Russell

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.
 
Field Summary
protected  int alignment
           
protected  Buffer buffer
           
protected  int estimatedMemorySize
           
protected  boolean haveEXTABGR
           
protected  boolean haveGL12
           
protected  int height
           
protected  int internalFormat
           
protected  boolean mipmap
           
protected  boolean mustFlipVertically
           
protected  int pixelFormat
           
protected  int pixelType
           
protected  int rowLength
           
protected  int width
           
 
Constructor Summary
protected TextureData()
          Used only by subclasses
  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 destroy()
          Calls flush()
protected static int estimatedMemorySize(Buffer buffer)
           
 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 getRowLength()
          Returns the row length needed for correct GL_UNPACK_ROW_LENGTH specification.
 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 setHaveEXTABGR(boolean haveEXTABGR)
          Indicates to this TextureData whether the GL_EXT_abgr extension is available.
 void setHaveGL12(boolean haveGL12)
          Indicates to this TextureData whether OpenGL version 1.2 is available.
 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 setRowLength(int rowLength)
          Sets the row length needed for correct GL_UNPACK_ROW_LENGTH specification.
 void setWidth(int width)
          Sets the width in pixels of the texture data.
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

width

protected int width

height

protected int height

pixelFormat

protected int pixelFormat

pixelType

protected int pixelType

internalFormat

protected int internalFormat

mipmap

protected boolean mipmap

mustFlipVertically

protected boolean mustFlipVertically

buffer

protected Buffer buffer

rowLength

protected int rowLength

alignment

protected int alignment

estimatedMemorySize

protected int estimatedMemorySize

haveEXTABGR

protected boolean haveEXTABGR

haveGL12

protected boolean haveGL12
Constructor Detail

TextureData

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
Constructs a new TextureData object with the specified parameters and data contained in the given Buffer. The optional Flusher can be used to clean up native resources associated with this TextureData when processing is complete; for example, closing of memory-mapped files that might otherwise require a garbage collection to reclaim and close.

Parameters:
internalFormat - the OpenGL internal format for the resulting texture; must be specified, may not be 0
width - the width in pixels of the texture
height - the height in pixels of the texture
border - 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 0
pixelType - the OpenGL type of the pixels of the texture
mipmap - 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 texture
buffer - the buffer containing the texture data
flusher - optional flusher to perform cleanup tasks upon call to flush()
Throws:
IllegalArgumentException - if any parameters of the texture data were invalid, such as requesting mipmap generation for a compressed texture

TextureData

public TextureData(int internalFormat,
                   int width,
                   int height,
                   int border,
                   int pixelFormat,
                   int pixelType,
                   boolean dataIsCompressed,
                   boolean mustFlipVertically,
                   Buffer[] mipmapData,
                   TextureData.Flusher flusher)
            throws IllegalArgumentException
Constructs a new TextureData object with the specified parameters and data for multiple mipmap levels contained in the given array of Buffers. The optional Flusher can be used to clean up native resources associated with this TextureData when processing is complete; for example, closing of memory-mapped files that might otherwise require a garbage collection to reclaim and close.

Parameters:
internalFormat - the OpenGL internal format for the resulting texture; must be specified, may not be 0
width - the width in pixels of the topmost mipmap level of the texture
height - the height in pixels of the topmost mipmap level of the texture
border - 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 0
pixelType - the OpenGL type of the pixels of the texture
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 texture
mipmapData - the buffers containing all mipmap levels of the texture's data
flusher - optional flusher to perform cleanup tasks upon call to flush()
Throws:
IllegalArgumentException - if any parameters of the texture data were invalid, such as requesting mipmap generation for a compressed texture

TextureData

protected TextureData()
Used only by subclasses

Method Detail

getWidth

public int getWidth()
Returns the width in pixels of the texture data.


getHeight

public int getHeight()
Returns the height in pixels of the texture data.


getBorder

public int getBorder()
Returns the border in pixels of the texture data.


getPixelFormat

public int getPixelFormat()
Returns the intended OpenGL pixel format of the texture data.


getPixelType

public int getPixelType()
Returns the intended OpenGL pixel type of the texture data.


getInternalFormat

public int getInternalFormat()
Returns the intended OpenGL internal format of the texture data.


getMipmap

public boolean getMipmap()
Returns whether mipmaps should be generated for the texture data.


isDataCompressed

public boolean isDataCompressed()
Indicates whether the texture data is in compressed form.


getMustFlipVertically

public boolean getMustFlipVertically()
Indicates whether the texture coordinates must be flipped vertically for proper display.


getBuffer

public Buffer getBuffer()
Returns the texture data, or null if it is specified as a set of mipmaps.


getMipmapData

public Buffer[] getMipmapData()
Returns all mipmap levels for the texture data, or null if it is specified as a single image.


getAlignment

public int getAlignment()
Returns the required byte alignment for the texture data.


getRowLength

public int getRowLength()
Returns the row length needed for correct GL_UNPACK_ROW_LENGTH specification. This is currently only supported for non-mipmapped, non-compressed textures.


setWidth

public void setWidth(int width)
Sets the width in pixels of the texture data.


setHeight

public void setHeight(int height)
Sets the height in pixels of the texture data.


setBorder

public void setBorder(int border)
Sets the border in pixels of the texture data.


setPixelFormat

public void setPixelFormat(int pixelFormat)
Sets the intended OpenGL pixel format of the texture data.


setPixelType

public void setPixelType(int pixelType)
Sets the intended OpenGL pixel type of the texture data.


setInternalFormat

public void setInternalFormat(int internalFormat)
Sets the intended OpenGL internal format of the texture data.


setMipmap

public void setMipmap(boolean mipmap)
Sets whether mipmaps should be generated for the texture data.


setIsDataCompressed

public void setIsDataCompressed(boolean compressed)
Sets whether the texture data is in compressed form.


setMustFlipVertically

public void setMustFlipVertically(boolean mustFlipVertically)
Sets whether the texture coordinates must be flipped vertically for proper display.


setBuffer

public void setBuffer(Buffer buffer)
Sets the texture data.


setAlignment

public void setAlignment(int alignment)
Sets the required byte alignment for the texture data.


setRowLength

public void setRowLength(int rowLength)
Sets the row length needed for correct GL_UNPACK_ROW_LENGTH specification. This is currently only supported for non-mipmapped, non-compressed textures.


setHaveEXTABGR

public void setHaveEXTABGR(boolean haveEXTABGR)
Indicates to this TextureData whether the GL_EXT_abgr extension is available. Used for optimization along some code paths to avoid data copies.


setHaveGL12

public void setHaveGL12(boolean haveGL12)
Indicates to this TextureData whether OpenGL version 1.2 is available. If not, falls back to relatively inefficient code paths for several input data types (several kinds of packed pixel formats, in particular).


getEstimatedMemorySize

public int getEstimatedMemorySize()
Returns an estimate of the amount of memory in bytes this TextureData will consume once uploaded to the graphics card. It should only be treated as an estimate; most applications should not need to query this but instead let the OpenGL implementation page textures in and out as necessary.


flush

public void flush()
Flushes resources associated with this TextureData by calling Flusher.flush().


destroy

public void destroy()
Calls flush()

See Also:
flush()

toString

public String toString()
Overrides:
toString in class Object

estimatedMemorySize

protected static int estimatedMemorySize(Buffer buffer)


Copyright 2005 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.