T
glTexSubImage2D
Chapter 18
459
yoffset + height - 1, inclusive. This region may not include any texels outside the range of
the texture array as it was originally specified. It is not an error to specify a subtexture
with zero width or height, but such a specification has no effect.
Notes
glTexSubImage2D is available only if the GL version is 1.1 or greater.
Texturing has no effect in color index mode.
The format GL_DEPTH_COMPONENT may only be used if the GL_EXT_shadow
extension is supported.
glPixelStore and glPixelTransfer modes affect texture images in exactly the way they
affect glDrawPixels.
Errors
• GL_INVALID_ENUM is generated if target is not GL_TEXTURE_2D.
• GL_INVALID_OPERATION is generated if the texture array has not been defined
by a previous glTexImage2D operation.
• GL_INVALID_VALUE is generated if level is less than 0.
• GL_INVALID_VALUE may be generated if level is greater than log
2
max, where max
is the returned value of GL_MAX_TEXTURE_SIZE.
• GL_INVALID_VALUE is generated if xoffset <-b,(xoffset + width)>(w-b), yoffset <
- b, or (yoffset + height) > (h - b), where w is the GL_TEXTURE_WIDTH, h is the
GL_TEXTURE_HEIGHT, and b is the border width of the texture image being
modified.
Note that w and h include twice the border width. GL_INVALID_VALUE is
generated if width or height is less than 0.
• GL_INVALID_ENUM is generated if format is not an accepted format constant.
• GL_INVALID_ENUM is generated if type is not a type constant.
• GL_INVALID_ENUM is generated if type is GL_BITMAP and format is not
GL_COLOR_INDEX.
• GL_INVALID_OPERATION is generated if glTexSubImage2D is executed between
the execution of glBegin and the corresponding execution of glEnd.
Associated Gets
glGetTexImage
glIsEnabled with argument GL_TEXTURE_2D
See Also
glCopyTexImage1D,
glCopyTexImage2D,
glCopyTexSubImage1D,
glCopyTexSubImage2D,
glDrawPixels,
To Next Page
Loading...
Need help?
General