public class ARBTextureCompression
extends java.lang.Object
Compressing texture images can reduce texture memory utilization and improve performance when rendering textured primitives. This extension allows OpenGL applications to use compressed texture images by providing:
An application can define compressed texture images by providing a texture image stored in a specific compressed image format. This extension does not define any specific compressed image formats, but it does provide the mechanisms necessary to enable other extensions that do.
An application can also define compressed texture images by providing an uncompressed texture image but specifying a compressed internal format. In this case, the GL will automatically compress the texture image using the appropriate image format. Compressed internal formats can either be specific (as above) or generic. Generic compressed internal formats are not actual image formats, but are instead mapped into one of the specific compressed formats provided by the GL (or to an uncompressed base internal format if no appropriate compressed format is available). Generic compressed internal formats allow applications to use texture compression without needing to code to any particular compression algorithm. Generic compressed formats allow the use of texture compression across a wide range of platforms with differing compression algorithms and also allow future GL implementations to substitute improved compression methods transparently.
Promoted to core in OpenGL 1.3.
| Modifier and Type | Field and Description |
|---|---|
static int |
GL_COMPRESSED_ALPHA_ARB
Accepted by the
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D. |
static int |
GL_COMPRESSED_INTENSITY_ARB
Accepted by the
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D. |
static int |
GL_COMPRESSED_LUMINANCE_ALPHA_ARB
Accepted by the
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D. |
static int |
GL_COMPRESSED_LUMINANCE_ARB
Accepted by the
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D. |
static int |
GL_COMPRESSED_RGB_ARB
Accepted by the
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D. |
static int |
GL_COMPRESSED_RGBA_ARB
Accepted by the
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D. |
static int |
GL_COMPRESSED_TEXTURE_FORMATS_ARB
Accepted by the
value parameter of GetIntegerv, GetBooleanv, GetFloatv, and GetDoublev. |
static int |
GL_NUM_COMPRESSED_TEXTURE_FORMATS_ARB
Accepted by the
value parameter of GetIntegerv, GetBooleanv, GetFloatv, and GetDoublev. |
static int |
GL_TEXTURE_COMPRESSED_ARB
Accepted by the
value parameter of GetTexLevelParameter. |
static int |
GL_TEXTURE_COMPRESSED_IMAGE_SIZE_ARB
Accepted by the
value parameter of GetTexLevelParameter. |
static int |
GL_TEXTURE_COMPRESSION_HINT_ARB
Accepted by the
target parameter of Hint and the value parameter of GetIntegerv, GetBooleanv, GetFloatv, and GetDoublev. |
| Modifier and Type | Method and Description |
|---|---|
static void |
glCompressedTexImage1DARB(int target,
int level,
int internalformat,
int width,
java.nio.ByteBuffer data)
Specifies a one-dimensional texture image in a compressed format.
|
static void |
glCompressedTexImage1DARB(int target,
int level,
int internalformat,
int width,
int border,
int imageSize,
long data)
Specifies a one-dimensional texture image in a compressed format.
|
static void |
glCompressedTexImage2DARB(int target,
int level,
int internalformat,
int width,
int height,
java.nio.ByteBuffer data)
Specifies a two-dimensional texture image in a compressed format.
|
static void |
glCompressedTexImage2DARB(int target,
int level,
int internalformat,
int width,
int height,
int border,
int imageSize,
long data)
Specifies a two-dimensional texture image in a compressed format.
|
static void |
glCompressedTexImage3DARB(int target,
int level,
int internalformat,
int width,
int height,
int depth,
java.nio.ByteBuffer data)
Specifies a three-dimensional texture image in a compressed format.
|
static void |
glCompressedTexImage3DARB(int target,
int level,
int internalformat,
int width,
int height,
int depth,
int border,
int imageSize,
long data)
Specifies a three-dimensional texture image in a compressed format.
|
static void |
glCompressedTexSubImage1DARB(int target,
int level,
int xoffset,
int width,
int format,
java.nio.ByteBuffer data)
Respecifies only a subregion of an existing 1D texel array, with incoming data stored in a specific compressed image format.
|
static void |
glCompressedTexSubImage1DARB(int target,
int level,
int xoffset,
int width,
int format,
int imageSize,
long data)
Respecifies only a subregion of an existing 1D texel array, with incoming data stored in a specific compressed image format.
|
static void |
glCompressedTexSubImage2DARB(int target,
int level,
int xoffset,
int yoffset,
int width,
int height,
int format,
java.nio.ByteBuffer data)
Respecifies only a rectangular subregion of an existing 2D texel array, with incoming data stored in a specific compressed image format.
|
static void |
glCompressedTexSubImage2DARB(int target,
int level,
int xoffset,
int yoffset,
int width,
int height,
int format,
int imageSize,
long data)
Respecifies only a rectangular subregion of an existing 2D texel array, with incoming data stored in a specific compressed image format.
|
static void |
glCompressedTexSubImage3DARB(int target,
int level,
int xoffset,
int yoffset,
int zoffset,
int width,
int height,
int depth,
int format,
java.nio.ByteBuffer data)
Respecifies only a cubic subregion of an existing 3D texel array, with incoming data stored in a specific compressed image format.
|
static void |
glCompressedTexSubImage3DARB(int target,
int level,
int xoffset,
int yoffset,
int zoffset,
int width,
int height,
int depth,
int format,
int imageSize,
long data)
Respecifies only a cubic subregion of an existing 3D texel array, with incoming data stored in a specific compressed image format.
|
static void |
glGetCompressedTexImageARB(int target,
int level,
java.nio.ByteBuffer pixels)
Returns a compressed texture image.
|
static void |
glGetCompressedTexImageARB(int target,
int level,
long pixels)
Returns a compressed texture image.
|
static void |
nglCompressedTexImage1DARB(int target,
int level,
int internalformat,
int width,
int border,
int imageSize,
long data)
Unsafe version of:
CompressedTexImage1DARB |
static void |
nglCompressedTexImage2DARB(int target,
int level,
int internalformat,
int width,
int height,
int border,
int imageSize,
long data)
Unsafe version of:
CompressedTexImage2DARB |
static void |
nglCompressedTexImage3DARB(int target,
int level,
int internalformat,
int width,
int height,
int depth,
int border,
int imageSize,
long data)
Unsafe version of:
CompressedTexImage3DARB |
static void |
nglCompressedTexSubImage1DARB(int target,
int level,
int xoffset,
int width,
int format,
int imageSize,
long data)
Unsafe version of:
CompressedTexSubImage1DARB |
static void |
nglCompressedTexSubImage2DARB(int target,
int level,
int xoffset,
int yoffset,
int width,
int height,
int format,
int imageSize,
long data)
Unsafe version of:
CompressedTexSubImage2DARB |
static void |
nglCompressedTexSubImage3DARB(int target,
int level,
int xoffset,
int yoffset,
int zoffset,
int width,
int height,
int depth,
int format,
int imageSize,
long data)
Unsafe version of:
CompressedTexSubImage3DARB |
static void |
nglGetCompressedTexImageARB(int target,
int level,
long pixels)
Unsafe version of:
GetCompressedTexImageARB |
public static final int GL_COMPRESSED_ALPHA_ARB
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.public static final int GL_COMPRESSED_LUMINANCE_ARB
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.public static final int GL_COMPRESSED_LUMINANCE_ALPHA_ARB
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.public static final int GL_COMPRESSED_INTENSITY_ARB
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.public static final int GL_COMPRESSED_RGB_ARB
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.public static final int GL_COMPRESSED_RGBA_ARB
internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.public static final int GL_TEXTURE_COMPRESSION_HINT_ARB
target parameter of Hint and the value parameter of GetIntegerv, GetBooleanv, GetFloatv, and GetDoublev.public static final int GL_TEXTURE_COMPRESSED_IMAGE_SIZE_ARB
value parameter of GetTexLevelParameter.public static final int GL_TEXTURE_COMPRESSED_ARB
value parameter of GetTexLevelParameter.public static final int GL_NUM_COMPRESSED_TEXTURE_FORMATS_ARB
value parameter of GetIntegerv, GetBooleanv, GetFloatv, and GetDoublev.public static final int GL_COMPRESSED_TEXTURE_FORMATS_ARB
value parameter of GetIntegerv, GetBooleanv, GetFloatv, and GetDoublev.public static void nglCompressedTexImage3DARB(int target,
int level,
int internalformat,
int width,
int height,
int depth,
int border,
int imageSize,
long data)
CompressedTexImage3DARBimageSize - the number of unsigned bytes of image data starting at the address specified by datapublic static void glCompressedTexImage3DARB(int target,
int level,
int internalformat,
int width,
int height,
int depth,
int border,
int imageSize,
long data)
target - the target texture. One of:TEXTURE_3D | TEXTURE_2D_ARRAY | TEXTURE_CUBE_MAP_ARRAY | PROXY_TEXTURE_3D |
PROXY_TEXTURE_2D_ARRAY | PROXY_TEXTURE_CUBE_MAP_ARRAY |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.internalformat - the format of the compressed image data. One of:width - the width of the texture imageheight - the height of the texture imagedepth - the depth of the texture imageborder - must be 0imageSize - the number of unsigned bytes of image data starting at the address specified by datadata - a pointer to the compressed image datapublic static void glCompressedTexImage3DARB(int target,
int level,
int internalformat,
int width,
int height,
int depth,
java.nio.ByteBuffer data)
target - the target texture. One of:TEXTURE_3D | TEXTURE_2D_ARRAY | TEXTURE_CUBE_MAP_ARRAY | PROXY_TEXTURE_3D |
PROXY_TEXTURE_2D_ARRAY | PROXY_TEXTURE_CUBE_MAP_ARRAY |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.internalformat - the format of the compressed image data. One of:width - the width of the texture imageheight - the height of the texture imagedepth - the depth of the texture imagedata - a pointer to the compressed image datapublic static void nglCompressedTexImage2DARB(int target,
int level,
int internalformat,
int width,
int height,
int border,
int imageSize,
long data)
CompressedTexImage2DARBimageSize - the number of unsigned bytes of image data starting at the address specified by datapublic static void glCompressedTexImage2DARB(int target,
int level,
int internalformat,
int width,
int height,
int border,
int imageSize,
long data)
target - the target texture. One of:TEXTURE_2D | TEXTURE_1D_ARRAY | TEXTURE_RECTANGLE | TEXTURE_CUBE_MAP |
PROXY_TEXTURE_2D | PROXY_TEXTURE_1D_ARRAY | PROXY_TEXTURE_RECTANGLE | PROXY_TEXTURE_CUBE_MAP |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.internalformat - the format of the compressed image data. One of:width - the width of the texture imageheight - the height of the texture imageborder - must be 0imageSize - the number of unsigned bytes of image data starting at the address specified by datadata - a pointer to the compressed image datapublic static void glCompressedTexImage2DARB(int target,
int level,
int internalformat,
int width,
int height,
java.nio.ByteBuffer data)
target - the target texture. One of:TEXTURE_2D | TEXTURE_1D_ARRAY | TEXTURE_RECTANGLE | TEXTURE_CUBE_MAP |
PROXY_TEXTURE_2D | PROXY_TEXTURE_1D_ARRAY | PROXY_TEXTURE_RECTANGLE | PROXY_TEXTURE_CUBE_MAP |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.internalformat - the format of the compressed image data. One of:width - the width of the texture imageheight - the height of the texture imagedata - a pointer to the compressed image datapublic static void nglCompressedTexImage1DARB(int target,
int level,
int internalformat,
int width,
int border,
int imageSize,
long data)
CompressedTexImage1DARBimageSize - the number of unsigned bytes of image data starting at the address specified by datapublic static void glCompressedTexImage1DARB(int target,
int level,
int internalformat,
int width,
int border,
int imageSize,
long data)
target - the target texture. One of:TEXTURE_1D | PROXY_TEXTURE_1D |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.internalformat - the format of the compressed image data. One of:width - the width of the texture imageborder - must be 0imageSize - the number of unsigned bytes of image data starting at the address specified by datadata - a pointer to the compressed image datapublic static void glCompressedTexImage1DARB(int target,
int level,
int internalformat,
int width,
java.nio.ByteBuffer data)
target - the target texture. One of:TEXTURE_1D | PROXY_TEXTURE_1D |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.internalformat - the format of the compressed image data. One of:width - the width of the texture imagedata - a pointer to the compressed image datapublic static void nglCompressedTexSubImage3DARB(int target,
int level,
int xoffset,
int yoffset,
int zoffset,
int width,
int height,
int depth,
int format,
int imageSize,
long data)
CompressedTexSubImage3DARBimageSize - the number of unsigned bytes of image data starting at the address specified by datapublic static void glCompressedTexSubImage3DARB(int target,
int level,
int xoffset,
int yoffset,
int zoffset,
int width,
int height,
int depth,
int format,
int imageSize,
long data)
target - the target texture. One of:TEXTURE_3D | TEXTURE_2D_ARRAY | TEXTURE_CUBE_MAP_ARRAY |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.xoffset - a texel offset in the x direction within the texture arrayyoffset - a texel offset in the y direction within the texture arrayzoffset - a texel offset in the z direction within the texture arraywidth - the width of the texture subimageheight - the height of the texture subimagedepth - the depth of the texture subimageformat - the format of the compressed image data stored at address data. One of:imageSize - the number of unsigned bytes of image data starting at the address specified by datadata - a pointer to the compressed image datapublic static void glCompressedTexSubImage3DARB(int target,
int level,
int xoffset,
int yoffset,
int zoffset,
int width,
int height,
int depth,
int format,
java.nio.ByteBuffer data)
target - the target texture. One of:TEXTURE_3D | TEXTURE_2D_ARRAY | TEXTURE_CUBE_MAP_ARRAY |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.xoffset - a texel offset in the x direction within the texture arrayyoffset - a texel offset in the y direction within the texture arrayzoffset - a texel offset in the z direction within the texture arraywidth - the width of the texture subimageheight - the height of the texture subimagedepth - the depth of the texture subimageformat - the format of the compressed image data stored at address data. One of:data - a pointer to the compressed image datapublic static void nglCompressedTexSubImage2DARB(int target,
int level,
int xoffset,
int yoffset,
int width,
int height,
int format,
int imageSize,
long data)
CompressedTexSubImage2DARBimageSize - the number of unsigned bytes of image data starting at the address specified by datapublic static void glCompressedTexSubImage2DARB(int target,
int level,
int xoffset,
int yoffset,
int width,
int height,
int format,
int imageSize,
long data)
target - the target texture. One of:TEXTURE_2D | TEXTURE_1D_ARRAY | TEXTURE_RECTANGLE | TEXTURE_CUBE_MAP |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.xoffset - a texel offset in the x direction within the texture arrayyoffset - a texel offset in the y direction within the texture arraywidth - the width of the texture subimageheight - the height of the texture subimageformat - the format of the compressed image data stored at address data. One of:imageSize - the number of unsigned bytes of image data starting at the address specified by datadata - a pointer to the compressed image datapublic static void glCompressedTexSubImage2DARB(int target,
int level,
int xoffset,
int yoffset,
int width,
int height,
int format,
java.nio.ByteBuffer data)
target - the target texture. One of:TEXTURE_2D | TEXTURE_1D_ARRAY | TEXTURE_RECTANGLE | TEXTURE_CUBE_MAP |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.xoffset - a texel offset in the x direction within the texture arrayyoffset - a texel offset in the y direction within the texture arraywidth - the width of the texture subimageheight - the height of the texture subimageformat - the format of the compressed image data stored at address data. One of:data - a pointer to the compressed image datapublic static void nglCompressedTexSubImage1DARB(int target,
int level,
int xoffset,
int width,
int format,
int imageSize,
long data)
CompressedTexSubImage1DARBimageSize - the number of unsigned bytes of image data starting at the address specified by datapublic static void glCompressedTexSubImage1DARB(int target,
int level,
int xoffset,
int width,
int format,
int imageSize,
long data)
target - the target texture. Must be:TEXTURE_1D |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.xoffset - a texel offset in the x direction within the texture arraywidth - the width of the texture subimageformat - the format of the compressed image data stored at address data. One of:imageSize - the number of unsigned bytes of image data starting at the address specified by datadata - a pointer to the compressed image datapublic static void glCompressedTexSubImage1DARB(int target,
int level,
int xoffset,
int width,
int format,
java.nio.ByteBuffer data)
target - the target texture. Must be:TEXTURE_1D |
level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.xoffset - a texel offset in the x direction within the texture arraywidth - the width of the texture subimageformat - the format of the compressed image data stored at address data. One of:data - a pointer to the compressed image datapublic static void nglGetCompressedTexImageARB(int target,
int level,
long pixels)
GetCompressedTexImageARBpublic static void glGetCompressedTexImageARB(int target,
int level,
java.nio.ByteBuffer pixels)
target - the target texture. One of:level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.pixels - a buffer in which to return the compressed texture imagepublic static void glGetCompressedTexImageARB(int target,
int level,
long pixels)
target - the target texture. One of:level - the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.pixels - a buffer in which to return the compressed texture imageCopyright LWJGL. All Rights Reserved. License terms.