Top Description Fields Constructors Methods
org.lwjgl.opengl

public Class ARBTextureCompression

extends Object
Class Inheritance
Imports
java.nio.*, org.lwjgl.system.*

Native bindings to the ARB_texture_compression extension.

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:

  1. A framework upon which extensions providing specific compressed image formats can be built.
  2. A set of generic compressed internal formats that allow applications to specify that texture images should be stored in compressed form without needing to code for specific compression formats.

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.

Field Summary

Modifier and TypeField and Description
public static final int
GL_COMPRESSED_ALPHA_ARB

Accepted by the internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.

public static final int
GL_COMPRESSED_INTENSITY_ARB

Accepted by the internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.

public static final int
GL_COMPRESSED_LUMINANCE_ALPHA_ARB

Accepted by the internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.

public static final int
GL_COMPRESSED_LUMINANCE_ARB

Accepted by the internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.

public static final int
GL_COMPRESSED_RGB_ARB

Accepted by the internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.

public static final int
GL_COMPRESSED_RGBA_ARB

Accepted by the internalformat parameter of TexImage1D, TexImage2D, TexImage3D, CopyTexImage1D, and CopyTexImage2D.

public static final int
GL_COMPRESSED_TEXTURE_FORMATS_ARB

Accepted by the value parameter of GetIntegerv, GetBooleanv, GetFloatv, and GetDoublev.

public static final int
GL_NUM_COMPRESSED_TEXTURE_FORMATS_ARB

Accepted by the value parameter of GetIntegerv, GetBooleanv, GetFloatv, and GetDoublev.

public static final int
GL_TEXTURE_COMPRESSED_ARB

Accepted by the value parameter of GetTexLevelParameter.

public static final int
GL_TEXTURE_COMPRESSED_IMAGE_SIZE_ARB

Accepted by the value parameter of GetTexLevelParameter.

public static final int
GL_TEXTURE_COMPRESSION_HINT_ARB

Accepted by the target parameter of Hint and the value parameter of GetIntegerv, GetBooleanv, GetFloatv, and GetDoublev.

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
public static void
glCompressedTexImage1DARB(int
the target texture. One of:
TEXTURE_1DPROXY_TEXTURE_1D
target
,
int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
int internalformat, int
the width of the texture image
width
,
int
must be 0
border
,
int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long
a pointer to the compressed image data
data
)

Specifies a one-dimensional texture image in a compressed format.

public static void
public static void
glCompressedTexImage2DARB(int target, int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
int internalformat, int
the width of the texture image
width
,
int
the height of the texture image
height
,
int
must be 0
border
,
int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long
a pointer to the compressed image data
data
)

Specifies a two-dimensional texture image in a compressed format.

public static void
public static void
glCompressedTexImage3DARB(int target, int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
int internalformat, int
the width of the texture image
width
,
int
the height of the texture image
height
,
int
the depth of the texture image
depth
,
int
must be 0
border
,
int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long
a pointer to the compressed image data
data
)

Specifies a three-dimensional texture image in a compressed format.

public static void
public static void
glCompressedTexSubImage1DARB(int
the target texture. Must be:
TEXTURE_1D
target
,
int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
int
a texel offset in the x direction within the texture array
xoffset
,
int
the width of the texture subimage
width
,
int format, int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long
a pointer to the compressed image data
data
)

Respecifies only a subregion of an existing 1D texel array, with incoming data stored in a specific compressed image format.

public static void
glCompressedTexSubImage1DARB(int
the target texture. Must be:
TEXTURE_1D
target
,
int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
int
a texel offset in the x direction within the texture array
xoffset
,
int
the width of the texture subimage
width
,
int format, ByteBuffer
a pointer to the compressed image data
data
)

Respecifies only a subregion of an existing 1D texel array, with incoming data stored in a specific compressed image format.

public static void
glCompressedTexSubImage2DARB(int target, int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
int
a texel offset in the x direction within the texture array
xoffset
,
int
a texel offset in the y direction within the texture array
yoffset
,
int
the width of the texture subimage
width
,
int
the height of the texture subimage
height
,
int format, int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long
a pointer to the compressed image data
data
)

Respecifies only a rectangular subregion of an existing 2D texel array, with incoming data stored in a specific compressed image format.

public static void
glCompressedTexSubImage2DARB(int target, int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
int
a texel offset in the x direction within the texture array
xoffset
,
int
a texel offset in the y direction within the texture array
yoffset
,
int
the width of the texture subimage
width
,
int
the height of the texture subimage
height
,
int format, ByteBuffer
a pointer to the compressed image data
data
)

Respecifies only a rectangular subregion of an existing 2D texel array, with incoming data stored in a specific compressed image format.

public static void
glCompressedTexSubImage3DARB(int target, int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
int
a texel offset in the x direction within the texture array
xoffset
,
int
a texel offset in the y direction within the texture array
yoffset
,
int
a texel offset in the z direction within the texture array
zoffset
,
int
the width of the texture subimage
width
,
int
the height of the texture subimage
height
,
int
the depth of the texture subimage
depth
,
int format, int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long
a pointer to the compressed image data
data
)

Respecifies only a cubic subregion of an existing 3D texel array, with incoming data stored in a specific compressed image format.

public static void
glCompressedTexSubImage3DARB(int target, int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
int
a texel offset in the x direction within the texture array
xoffset
,
int
a texel offset in the y direction within the texture array
yoffset
,
int
a texel offset in the z direction within the texture array
zoffset
,
int
the width of the texture subimage
width
,
int
the height of the texture subimage
height
,
int
the depth of the texture subimage
depth
,
int format, ByteBuffer
a pointer to the compressed image data
data
)

Respecifies only a cubic subregion of an existing 3D texel array, with incoming data stored in a specific compressed image format.

public static void
glGetCompressedTexImageARB(int target, int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
ByteBuffer
a buffer in which to return the compressed texture image
pixels
)

Returns a compressed texture image.

public static void
glGetCompressedTexImageARB(int target, int
the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
level
,
long
a buffer in which to return the compressed texture image
pixels
)

Returns a compressed texture image.

public static native void
nglCompressedTexImage1DARB(int target, int level, int internalformat, int width, int border, int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long data)

Unsafe version of: CompressedTexImage1DARB

public static native void
nglCompressedTexImage2DARB(int target, int level, int internalformat, int width, int height, int border, int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long data)

Unsafe version of: CompressedTexImage2DARB

public static native void
nglCompressedTexImage3DARB(int target, int level, int internalformat, int width, int height, int depth, int border, int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long data)

Unsafe version of: CompressedTexImage3DARB

public static native void
nglCompressedTexSubImage1DARB(int target, int level, int xoffset, int width, int format, int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long data)

Unsafe version of: CompressedTexSubImage1DARB

public static native void
nglCompressedTexSubImage2DARB(int target, int level, int xoffset, int yoffset, int width, int height, int format, int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long data)

Unsafe version of: CompressedTexSubImage2DARB

public static native void
nglCompressedTexSubImage3DARB(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int
the number of unsigned bytes of image data starting at the address specified by data
imageSize
,
long data)

Unsafe version of: CompressedTexSubImage3DARB

public static native void
nglGetCompressedTexImageARB(int target, int level, long pixels)

Unsafe version of: GetCompressedTexImageARB

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait