Package org.lwjgl.opengl

Class GL12

java.lang.Object

org.lwjgl.opengl.GL12

public class GL12
extends java.lang.Object

The core OpenGL 1.2 functionality.

Extensions promoted to core in this release:

• EXT_texture3D
• EXT_bgra
• EXT_packed_pixels
• EXT_rescale_normal
• EXT_separate_specular_color
• SGIS_texture_edge_clamp
• SGIS_texture_lod
• EXT_draw_range_elements

Extensions part of the imaging subset:

• EXT_color_table and EXT_color_subtable
• EXT_convolution and HP_convolution_border_modes
• SGI_color_matrix
• EXT_histogram
• EXT_blend_color
• EXT_blend_minmax and EXT_EXT_blend_subtract

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_ALIASED_LINE_WIDTH_RANGE GL_ALIASED_POINT_SIZE_RANGE Aliases for smooth points and lines.
static int	GL_BGR GL_BGRA Accepted by the format parameter of DrawPixels, GetTexImage, ReadPixels, TexImage1D, and TexImage2D.
static int	GL_CLAMP_TO_EDGE Accepted by the param parameter of TexParameteri and TexParameterf, and by the params parameter of TexParameteriv and TexParameterfv, when their pname parameter is TEXTURE_WRAP_S, TEXTURE_WRAP_T, or TEXTURE_WRAP_R.
static int	GL_LIGHT_MODEL_COLOR_CONTROL Accepted by the pname parameter of LightModel*, and also by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
static int	GL_MAX_3D_TEXTURE_SIZE Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
static int	GL_MAX_ELEMENTS_INDICES GL_MAX_ELEMENTS_VERTICES Recommended maximum amounts of vertex and index data.
static int	GL_PACK_IMAGE_HEIGHT GL_PACK_SKIP_IMAGES Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev, and by the pname parameter of PixelStore.
static int	GL_PROXY_TEXTURE_3D Accepted by the target parameter of TexImage3D, GetTexLevelParameteriv, and GetTexLevelParameterfv.
static int	GL_RESCALE_NORMAL Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
static int	GL_SEPARATE_SPECULAR_COLOR GL_SINGLE_COLOR Accepted by the param parameter of LightModel* when pname is LIGHT_MODEL_COLOR_CONTROL.
static int	GL_SMOOTH_LINE_WIDTH_GRANULARITY GL_SMOOTH_LINE_WIDTH_RANGE GL_SMOOTH_POINT_SIZE_GRANULARITY GL_SMOOTH_POINT_SIZE_RANGE Aliases for smooth points and lines.
static int	GL_TEXTURE_3D Accepted by the cap parameter of Enable, Disable, and IsEnabled, by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev, and by the target parameter of TexImage3D, GetTexImage, GetTexLevelParameteriv, GetTexLevelParameterfv, GetTexParameteriv, and GetTexParameterfv.
static int	GL_TEXTURE_BASE_LEVEL Accepted by the pname parameter of TexParameteri, TexParameterf, TexParameteriv, TexParameterfv, GetTexParameteriv, and GetTexParameterfv.
static int	GL_TEXTURE_BINDING_3D Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
static int	GL_TEXTURE_DEPTH Accepted by the pname parameter of GetTexLevelParameteriv and GetTexLevelParameterfv.
static int	GL_TEXTURE_MAX_LEVEL GL_TEXTURE_MAX_LOD GL_TEXTURE_MIN_LOD Accepted by the pname parameter of TexParameteri, TexParameterf, TexParameteriv, TexParameterfv, GetTexParameteriv, and GetTexParameterfv.
static int	GL_TEXTURE_WRAP_R Accepted by the pname parameter of TexParameteriv, TexParameterfv, GetTexParameteriv, and GetTexParameterfv.
static int	GL_UNPACK_IMAGE_HEIGHT GL_UNPACK_SKIP_IMAGES Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev, and by the pname parameter of PixelStore.
static int	GL_UNSIGNED_BYTE_2_3_3_REV GL_UNSIGNED_BYTE_3_3_2 GL_UNSIGNED_INT_10_10_10_2 GL_UNSIGNED_INT_2_10_10_10_REV GL_UNSIGNED_INT_8_8_8_8 GL_UNSIGNED_INT_8_8_8_8_REV GL_UNSIGNED_SHORT_1_5_5_5_REV GL_UNSIGNED_SHORT_4_4_4_4 GL_UNSIGNED_SHORT_4_4_4_4_REV GL_UNSIGNED_SHORT_5_5_5_1 GL_UNSIGNED_SHORT_5_6_5 GL_UNSIGNED_SHORT_5_6_5_REV Accepted by the type parameter of DrawPixels, ReadPixels, TexImage1D, TexImage2D, GetTexImage, TexImage3D, TexSubImage1D, TexSubImage2D, TexSubImage3D, GetHistogram, GetMinmax, ConvolutionFilter1D, ConvolutionFilter2D, ConvolutionFilter3D, GetConvolutionFilter, SeparableFilter2D, SeparableFilter3D, GetSeparableFilter, ColorTable, GetColorTable, TexImage4D, and TexSubImage4D.

Method Summary

Modifier and Type	Method and Description
static void	glCopyTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int x, int y, int width, int height) OpenGL SDK Reference
static void	glDrawRangeElements(int mode, int start, int end, java.nio.ByteBuffer indices) OpenGL SDK Reference
static void	glDrawRangeElements(int mode, int start, int end, java.nio.IntBuffer indices) OpenGL SDK Reference
static void	glDrawRangeElements(int mode, int start, int end, int type, java.nio.ByteBuffer indices) OpenGL SDK Reference
static void	glDrawRangeElements(int mode, int start, int end, int count, int type, long indices) OpenGL SDK Reference
static void	glDrawRangeElements(int mode, int start, int end, java.nio.ShortBuffer indices) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, java.nio.ByteBuffer pixels) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, double[] pixels) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, java.nio.DoubleBuffer pixels) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, float[] pixels) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, java.nio.FloatBuffer pixels) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, int[] pixels) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, java.nio.IntBuffer pixels) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, long pixels) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, short[] pixels) OpenGL SDK Reference
static void	glTexImage3D(int target, int level, int internalformat, int width, int height, int depth, int border, int format, int type, java.nio.ShortBuffer pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, java.nio.ByteBuffer pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, double[] pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, java.nio.DoubleBuffer pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, float[] pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, java.nio.FloatBuffer pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, int[] pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, java.nio.IntBuffer pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, long pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, short[] pixels) OpenGL SDK Reference
static void	glTexSubImage3D(int target, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, java.nio.ShortBuffer pixels) OpenGL SDK Reference

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

GL_ALIASED_POINT_SIZE_RANGE, GL_ALIASED_LINE_WIDTH_RANGE, GL_SMOOTH_POINT_SIZE_RANGE, GL_SMOOTH_POINT_SIZE_GRANULARITY, GL_SMOOTH_LINE_WIDTH_RANGE, GL_SMOOTH_LINE_WIDTH_GRANULARITY

Aliases for smooth points and lines.

GL_TEXTURE_BINDING_3D

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

GL_PACK_SKIP_IMAGES, GL_PACK_IMAGE_HEIGHT, GL_UNPACK_SKIP_IMAGES, GL_UNPACK_IMAGE_HEIGHT

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

GL_TEXTURE_3D

Accepted by the cap parameter of Enable, Disable, and IsEnabled, by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev, and by the target parameter of TexImage3D, GetTexImage, GetTexLevelParameteriv, GetTexLevelParameterfv, GetTexParameteriv, and GetTexParameterfv.

GL_PROXY_TEXTURE_3D

Accepted by the target parameter of TexImage3D, GetTexLevelParameteriv, and GetTexLevelParameterfv.

GL_TEXTURE_DEPTH

Accepted by the pname parameter of GetTexLevelParameteriv and GetTexLevelParameterfv.

GL_TEXTURE_WRAP_R

Accepted by the pname parameter of TexParameteriv, TexParameterfv, GetTexParameteriv, and GetTexParameterfv.

GL_MAX_3D_TEXTURE_SIZE

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

GL_BGR, GL_BGRA

Accepted by the format parameter of DrawPixels, GetTexImage, ReadPixels, TexImage1D, and TexImage2D.

GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2, GL_UNSIGNED_INT_2_10_10_10_REV

Accepted by the type parameter of DrawPixels, ReadPixels, TexImage1D, TexImage2D, GetTexImage, TexImage3D, TexSubImage1D, TexSubImage2D, TexSubImage3D, GetHistogram, GetMinmax, ConvolutionFilter1D, ConvolutionFilter2D, ConvolutionFilter3D, GetConvolutionFilter, SeparableFilter2D, SeparableFilter3D, GetSeparableFilter, ColorTable, GetColorTable, TexImage4D, and TexSubImage4D.

GL_RESCALE_NORMAL

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

GL_LIGHT_MODEL_COLOR_CONTROL

Accepted by the pname parameter of LightModel*, and also by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

GL_SINGLE_COLOR, GL_SEPARATE_SPECULAR_COLOR

Accepted by the param parameter of LightModel* when pname is LIGHT_MODEL_COLOR_CONTROL.

GL_CLAMP_TO_EDGE

Accepted by the param parameter of TexParameteri and TexParameterf, and by the params parameter of TexParameteriv and TexParameterfv, when their pname parameter is TEXTURE_WRAP_S, TEXTURE_WRAP_T, or TEXTURE_WRAP_R.

GL_TEXTURE_MIN_LOD, GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_MAX_LEVEL

Accepted by the pname parameter of TexParameteri, TexParameterf, TexParameteriv, TexParameterfv, GetTexParameteriv, and GetTexParameterfv.

GL_MAX_ELEMENTS_VERTICES, GL_MAX_ELEMENTS_INDICES

Recommended maximum amounts of vertex and index data.

Method Detail

glTexImage3D

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                java.nio.ByteBuffer pixels)

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                long pixels)

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                java.nio.ShortBuffer pixels)

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                java.nio.IntBuffer pixels)

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                java.nio.FloatBuffer pixels)

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                java.nio.DoubleBuffer pixels)

OpenGL SDK Reference

Specifies a three-dimensional texture image.

Parameters:

target - the texture target. 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

internalformat - the texture internal format. One of:

RED	RG	RGB	RGBA	DEPTH_COMPONENT	DEPTH_STENCIL
R8	R8_SNORM	R16	R16_SNORM	RG8	RG8_SNORM
RG16	RG16_SNORM	R3_G3_B2	RGB4	RGB5	RGB565
RGB8	RGB8_SNORM	RGB10	RGB12	RGB16	RGB16_SNORM
RGBA2	RGBA4	RGB5_A1	RGBA8	RGBA8_SNORM	RGB10_A2
RGB10_A2UI	RGBA12	RGBA16	RGBA16_SNORM	SRGB8	SRGB8_ALPHA8
R16F	RG16F	RGB16F	RGBA16F	R32F	RG32F
RGB32F	RGBA32F	R11F_G11F_B10F	RGB9_E5	R8I	R8UI
R16I	R16UI	R32I	R32UI	RG8I	RG8UI
RG16I	RG16UI	RG32I	RG32UI	RGB8I	RGB8UI
RGB16I	RGB16UI	RGB32I	RGB32UI	RGBA8I	RGBA8UI
RGBA16I	RGBA16UI	RGBA32I	RGBA32UI	DEPTH_COMPONENT16	DEPTH_COMPONENT24
DEPTH_COMPONENT32	DEPTH24_STENCIL8	DEPTH_COMPONENT32F	DEPTH32F_STENCIL8	COMPRESSED_RED	COMPRESSED_RG
COMPRESSED_RGB	COMPRESSED_RGBA	COMPRESSED_SRGB	COMPRESSED_SRGB_ALPHA	COMPRESSED_RED_RGTC1	COMPRESSED_SIGNED_RED_RGTC1
COMPRESSED_RG_RGTC2	COMPRESSED_SIGNED_RG_RGTC2	COMPRESSED_RGBA_BPTC_UNORM	COMPRESSED_SRGB_ALPHA_BPTC_UNORM	COMPRESSED_RGB_BPTC_SIGNED_FLOAT	COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT
COMPRESSED_RGB8_ETC2	COMPRESSED_SRGB8_ETC2	COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2	COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2	COMPRESSED_RGBA8_ETC2_EAC	COMPRESSED_SRGB8_ALPHA8_ETC2_EAC
COMPRESSED_R11_EAC	COMPRESSED_SIGNED_R11_EAC	COMPRESSED_RG11_EAC	COMPRESSED_SIGNED_RG11_EAC	see EXTTextureCompressionS3TC	see EXTTextureCompressionLATC
see ATITextureCompression3DC

width - the texture width

height - the texture height

depth - the texture depth

border - the texture border width

format - the texel data format. One of:

STENCIL_INDEX	DEPTH_COMPONENT	DEPTH_STENCIL	RED	GREEN	BLUE	ALPHA	RG
RGB	RGBA	BGR	BGRA	LUMINANCE	LUMINANCE_ALPHA	RED_INTEGER	GREEN_INTEGER
BLUE_INTEGER	ALPHA_INTEGER	RG_INTEGER	RGB_INTEGER	RGBA_INTEGER	BGR_INTEGER	BGRA_INTEGER

type - the texel data type. One of:

UNSIGNED_BYTE	BYTE	UNSIGNED_SHORT	SHORT
UNSIGNED_INT	INT	HALF_FLOAT	FLOAT
UNSIGNED_BYTE_3_3_2	UNSIGNED_BYTE_2_3_3_REV	UNSIGNED_SHORT_5_6_5	UNSIGNED_SHORT_5_6_5_REV
UNSIGNED_SHORT_4_4_4_4	UNSIGNED_SHORT_4_4_4_4_REV	UNSIGNED_SHORT_5_5_5_1	UNSIGNED_SHORT_1_5_5_5_REV
UNSIGNED_INT_8_8_8_8	UNSIGNED_INT_8_8_8_8_REV	UNSIGNED_INT_10_10_10_2	UNSIGNED_INT_2_10_10_10_REV
UNSIGNED_INT_24_8	UNSIGNED_INT_10F_11F_11F_REV	UNSIGNED_INT_5_9_9_9_REV	FLOAT_32_UNSIGNED_INT_24_8_REV
BITMAP

pixels - the texel data

glTexSubImage3D

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   java.nio.ByteBuffer pixels)

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   long pixels)

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   java.nio.ShortBuffer pixels)

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   java.nio.IntBuffer pixels)

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   java.nio.FloatBuffer pixels)

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   java.nio.DoubleBuffer pixels)

OpenGL SDK Reference

Respecifies a cubic subregion of an existing 3D texel array. No change is made to the internalformat, width, height, depth, or border parameters of the specified texel array, nor is any change made to texel values outside the specified subregion.

Parameters:

target - the texture target. One of:

TEXTURE_3D

TEXTURE_2D_ARRAY

TEXTURE_CUBE_MAP_ARRAY

level - the level-of-detail-number

xoffset - the x coordinate of the texel subregion

yoffset - the y coordinate of the texel subregion

zoffset - the z coordinate of the texel subregion

width - the subregion width

height - the subregion height

depth - the subregion depth

format - the pixel data format. One of:

STENCIL_INDEX	DEPTH_COMPONENT	DEPTH_STENCIL	RED	GREEN	BLUE	ALPHA	RG
RGB	RGBA	BGR	BGRA	LUMINANCE	LUMINANCE_ALPHA	RED_INTEGER	GREEN_INTEGER
BLUE_INTEGER	ALPHA_INTEGER	RG_INTEGER	RGB_INTEGER	RGBA_INTEGER	BGR_INTEGER	BGRA_INTEGER

type - the pixel data type. One of:

UNSIGNED_BYTE	BYTE	UNSIGNED_SHORT	SHORT
UNSIGNED_INT	INT	HALF_FLOAT	FLOAT
UNSIGNED_BYTE_3_3_2	UNSIGNED_BYTE_2_3_3_REV	UNSIGNED_SHORT_5_6_5	UNSIGNED_SHORT_5_6_5_REV
UNSIGNED_SHORT_4_4_4_4	UNSIGNED_SHORT_4_4_4_4_REV	UNSIGNED_SHORT_5_5_5_1	UNSIGNED_SHORT_1_5_5_5_REV
UNSIGNED_INT_8_8_8_8	UNSIGNED_INT_8_8_8_8_REV	UNSIGNED_INT_10_10_10_2	UNSIGNED_INT_2_10_10_10_REV
UNSIGNED_INT_24_8	UNSIGNED_INT_10F_11F_11F_REV	UNSIGNED_INT_5_9_9_9_REV	FLOAT_32_UNSIGNED_INT_24_8_REV
BITMAP

pixels - the pixel data

glCopyTexSubImage3D

public static void glCopyTexSubImage3D(int target,
                                       int level,
                                       int xoffset,
                                       int yoffset,
                                       int zoffset,
                                       int x,
                                       int y,
                                       int width,
                                       int height)

OpenGL SDK Reference

Respecifies a rectangular subregion of a slice of an existing 3D texel array. No change is made to the internalformat, width, height, or border parameters of the specified texel array, nor is any change made to texel values outside the specified subregion. See CopyTexImage2D for more details.

Parameters:

target - the texture target. One of:

TEXTURE_3D

TEXTURE_2D_ARRAY

TEXTURE_CUBE_MAP_ARRAY

level - the level-of-detail number

xoffset - the x coordinate of the texture subregion to update

yoffset - the y coordinate of the texture subregion to update

zoffset - the z coordinate of the texture subregion to update

x - the left framebuffer pixel coordinate

y - the lower framebuffer pixel coordinate

width - the texture subregion width

height - the texture subregion height

glDrawRangeElements

public static void glDrawRangeElements(int mode,
                                       int start,
                                       int end,
                                       int count,
                                       int type,
                                       long indices)

OpenGL SDK Reference

A restricted form of DrawElements. mode, start, end, and count match the corresponding arguments to glDrawElements, with the additional constraint that all values in the arrays count must lie between start and end, inclusive.

Implementations denote recommended maximum amounts of vertex and index data, which may be queried by calling glGet with argument MAX_ELEMENTS_VERTICES and MAX_ELEMENTS_INDICES. If end - start + 1 is greater than the value of GL_MAX_ELEMENTS_VERTICES, or if count is greater than the value of GL_MAX_ELEMENTS_INDICES, then the call may operate at reduced performance. There is no requirement that all vertices in the range start end be referenced. However, the implementation may partially process unused vertices, reducing performance from what could be achieved with an optimal index set.

When glDrawRangeElements is called, it uses count sequential elements from an enabled array, starting at start to construct a sequence of geometric primitives. mode specifies what kind of primitives are constructed, and how the array elements construct these primitives. If more than one array is enabled, each is used.

Vertex attributes that are modified by glDrawRangeElements have an unspecified value after glDrawRangeElements returns. Attributes that aren't modified maintain their previous values.

Errors

It is an error for indices to lie outside the range start end, but implementations may not check for this situation. Such indices cause implementation-dependent behavior.

• GL_INVALID_ENUM is generated if mode is not an accepted value.
• GL_INVALID_VALUE is generated if count is negative.
• GL_INVALID_VALUE is generated if end < start.
• GL_INVALID_OPERATION is generated if a geometry shader is active and mode is incompatible with the input primitive type of the geometry shader in the currently installed program object.
• GL_INVALID_OPERATION is generated if a non-zero buffer object name is bound to an enabled array or the element array and the buffer object's data store is currently mapped.

Parameters:

mode - the kind of primitives to render. One of:

POINTS	LINE_STRIP	LINE_LOOP	LINES	POLYGON	TRIANGLE_STRIP	TRIANGLE_FAN
TRIANGLES	QUAD_STRIP	QUADS	LINES_ADJACENCY	LINE_STRIP_ADJACENCY	TRIANGLES_ADJACENCY	TRIANGLE_STRIP_ADJACENCY
PATCHES

start - the minimum array index contained in indices

end - the maximum array index contained in indices

count - the number of elements to be rendered

type - the type of the values in indices. One of:

UNSIGNED_BYTE

UNSIGNED_SHORT

UNSIGNED_INT

indices - a pointer to the location where the indices are stored

glDrawRangeElements

public static void glDrawRangeElements(int mode,
                                       int start,
                                       int end,
                                       int type,
                                       java.nio.ByteBuffer indices)

OpenGL SDK Reference

A restricted form of DrawElements. mode, start, end, and count match the corresponding arguments to glDrawElements, with the additional constraint that all values in the arrays count must lie between start and end, inclusive.

Implementations denote recommended maximum amounts of vertex and index data, which may be queried by calling glGet with argument MAX_ELEMENTS_VERTICES and MAX_ELEMENTS_INDICES. If end - start + 1 is greater than the value of GL_MAX_ELEMENTS_VERTICES, or if count is greater than the value of GL_MAX_ELEMENTS_INDICES, then the call may operate at reduced performance. There is no requirement that all vertices in the range start end be referenced. However, the implementation may partially process unused vertices, reducing performance from what could be achieved with an optimal index set.

When glDrawRangeElements is called, it uses count sequential elements from an enabled array, starting at start to construct a sequence of geometric primitives. mode specifies what kind of primitives are constructed, and how the array elements construct these primitives. If more than one array is enabled, each is used.

Vertex attributes that are modified by glDrawRangeElements have an unspecified value after glDrawRangeElements returns. Attributes that aren't modified maintain their previous values.

Errors

It is an error for indices to lie outside the range start end, but implementations may not check for this situation. Such indices cause implementation-dependent behavior.

• GL_INVALID_ENUM is generated if mode is not an accepted value.
• GL_INVALID_VALUE is generated if count is negative.
• GL_INVALID_VALUE is generated if end < start.
• GL_INVALID_OPERATION is generated if a geometry shader is active and mode is incompatible with the input primitive type of the geometry shader in the currently installed program object.
• GL_INVALID_OPERATION is generated if a non-zero buffer object name is bound to an enabled array or the element array and the buffer object's data store is currently mapped.

Parameters:

mode - the kind of primitives to render. One of:

POINTS	LINE_STRIP	LINE_LOOP	LINES	POLYGON	TRIANGLE_STRIP	TRIANGLE_FAN
TRIANGLES	QUAD_STRIP	QUADS	LINES_ADJACENCY	LINE_STRIP_ADJACENCY	TRIANGLES_ADJACENCY	TRIANGLE_STRIP_ADJACENCY
PATCHES

start - the minimum array index contained in indices

end - the maximum array index contained in indices

type - the type of the values in indices. One of:

UNSIGNED_BYTE

UNSIGNED_SHORT

UNSIGNED_INT

indices - a pointer to the location where the indices are stored

glDrawRangeElements

public static void glDrawRangeElements(int mode,
                                       int start,
                                       int end,
                                       java.nio.ByteBuffer indices)

public static void glDrawRangeElements(int mode,
                                       int start,
                                       int end,
                                       java.nio.ShortBuffer indices)

public static void glDrawRangeElements(int mode,
                                       int start,
                                       int end,
                                       java.nio.IntBuffer indices)

OpenGL SDK Reference

A restricted form of DrawElements. mode, start, end, and count match the corresponding arguments to glDrawElements, with the additional constraint that all values in the arrays count must lie between start and end, inclusive.

Implementations denote recommended maximum amounts of vertex and index data, which may be queried by calling glGet with argument MAX_ELEMENTS_VERTICES and MAX_ELEMENTS_INDICES. If end - start + 1 is greater than the value of GL_MAX_ELEMENTS_VERTICES, or if count is greater than the value of GL_MAX_ELEMENTS_INDICES, then the call may operate at reduced performance. There is no requirement that all vertices in the range start end be referenced. However, the implementation may partially process unused vertices, reducing performance from what could be achieved with an optimal index set.

When glDrawRangeElements is called, it uses count sequential elements from an enabled array, starting at start to construct a sequence of geometric primitives. mode specifies what kind of primitives are constructed, and how the array elements construct these primitives. If more than one array is enabled, each is used.

Vertex attributes that are modified by glDrawRangeElements have an unspecified value after glDrawRangeElements returns. Attributes that aren't modified maintain their previous values.

Errors

It is an error for indices to lie outside the range start end, but implementations may not check for this situation. Such indices cause implementation-dependent behavior.

• GL_INVALID_ENUM is generated if mode is not an accepted value.
• GL_INVALID_VALUE is generated if count is negative.
• GL_INVALID_VALUE is generated if end < start.
• GL_INVALID_OPERATION is generated if a geometry shader is active and mode is incompatible with the input primitive type of the geometry shader in the currently installed program object.
• GL_INVALID_OPERATION is generated if a non-zero buffer object name is bound to an enabled array or the element array and the buffer object's data store is currently mapped.

Parameters:

mode - the kind of primitives to render. One of:

POINTS	LINE_STRIP	LINE_LOOP	LINES	POLYGON	TRIANGLE_STRIP	TRIANGLE_FAN
TRIANGLES	QUAD_STRIP	QUADS	LINES_ADJACENCY	LINE_STRIP_ADJACENCY	TRIANGLES_ADJACENCY	TRIANGLE_STRIP_ADJACENCY
PATCHES

start - the minimum array index contained in indices

end - the maximum array index contained in indices

indices - a pointer to the location where the indices are stored

glTexImage3D

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                short[] pixels)

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                int[] pixels)

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                float[] pixels)

public static void glTexImage3D(int target,
                                int level,
                                int internalformat,
                                int width,
                                int height,
                                int depth,
                                int border,
                                int format,
                                int type,
                                double[] pixels)

OpenGL SDK Reference

Array version of: TexImage3D

glTexSubImage3D

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   short[] pixels)

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   int[] pixels)

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   float[] pixels)

public static void glTexSubImage3D(int target,
                                   int level,
                                   int xoffset,
                                   int yoffset,
                                   int zoffset,
                                   int width,
                                   int height,
                                   int depth,
                                   int format,
                                   int type,
                                   double[] pixels)

OpenGL SDK Reference

Array version of: TexSubImage3D