GLint leve )
PARAMETERS
target Specifies the target texture. Must be GL_TEXTURE_3D.
leve Specifies the level-of-detail number. Level 0 is the base image
level. Level n is the nth mipmap reduction image.
_param3 Specifies a texel offset in the x direction within the texture
array.
_param4 Specifies a texel offset in the y direction within the texture
array.
_param5 Specifies a texel offset in the z direction within the texture
array.
_param6 Specifies the width of the texture subimage.
_param7 Specifies the height of the texture subimage.
_param8 Specifies the depth of the texture subimage.
_param9 Specifies the format of the pixel data. The following symbolic
values are accepted: GL_COLOR_INDEX, GL_RED, GL_GREEN, GL_BLUE,
GL_ALPHA, GL_RGB, GL_BGR, GL_RGBA, GL_BGRA, GL_LUMINANCE, and
GL_LUMINANCE_ALPHA.
_param10
Specifies the data type of the pixel data. The following sym‐
bolic values are accepted: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP,
GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT,
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, and GL_UNSIGNED_INT_2_10_10_10_REV.
_param11
Specifies a pointer to the image data in memory.
DESCRIPTION
Texturing maps a portion of a specified texture image onto each graphi‐
cal primitive for which texturing is enabled. To enable and disable
three-dimensional texturing, call glEnable and glDisable with argument
GL_TEXTURE_3D.
glTexSubImage3D redefines a contiguous subregion of an existing three-
dimensional texture image. The texels referenced by _param11 replace
the portion of the existing texture array with x indices _param3 and
_eqnparam3+_eqnparam6−1, inclusive, y indices _param4 and _eqn‐
Formats GL_BGR, and GL_BGRA and types 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, and
GL_UNSIGNED_INT_2_10_10_10_REV are available only if the GL version is
1.2 or greater.
When the GL_ARB_multitexture extension is supported, glTexSubImage3D
specifies a three-dimensional sub texture for the current texture unit,
specified with glActiveTextureARB.
When the GL_ARB_imaging extension is supported, the RGBA components
specified in _param11 may be processed by the imaging pipeline. See
glTexImage3D for specific details.
ERRORS
GL_INVALID_ENUM is generated if target is not GL_TEXTURE_3D.
GL_INVALID_OPERATION is generated if the texture array has not been de‐
fined by a previous glTexImage3D operation.
GL_INVALID_VALUE is generated if leve is less than 0.
GL_INVALID_VALUE may be generated if leve is greater than log2max, where
max is the returned value of GL_MAX_TEXTURE_SIZE.
GL_INVALID_VALUE is generated if _eqnparam3<−b, (_eqnparam3+_eqn‐
param6)>(w−b), _eqnparam4<−b, or (_eqnparam4+_eqnparam7)>(h−b), or _eqn‐
param5<−b, or (_eqnparam5+_eqnparam8)>(d−b), where w is the
GL_TEXTURE_WIDTH, h is the GL_TEXTURE_HEIGHT, d is the GL_TEXTURE_DEPTH
and b is the border width of the texture image being modified. Note
that w, h, and d include twice the border width.
GL_INVALID_VALUE is generated if _param6, _param7, or _param8 is less
than 0.
GL_INVALID_ENUM is generated if _param9 is not an accepted format con‐
stant.
GL_INVALID_ENUM is generated if _param10 is not a type constant.
GL_INVALID_ENUM is generated if _param10 is GL_BITMAP and _param9 is not
GL_COLOR_INDEX.
GL_INVALID_OPERATION is generated if glTexSubImage3D is executed between
the execution of glBegin and the corresponding execution of glEnd.
GL_INVALID_OPERATION is generated if _param10 is one of
GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV,
GL_UNSIGNED_SHORT_5_6_5, or GL_UNSIGNED_SHORT_5_6_5_REV and _param9 is
glActiveTextureARB, glCopyTexImage1D, glCopyTexImage2D,
glCopyTexSubImage1D, glCopyTexSubImage2D, glCopyTexSubImage3D,
glDrawPixels, glPixelStore, glPixelTransfer, glTexEnv, glTexGen,
glTexImage1D, glTexImage2D, glTexImage3D, glTexSubImage1D,
glTexSubImage2D, glTexParameter
GLTEXSUBIMAGE3D(3G)
Man(1) output converted with
man2html