C
glCopyTexSubImage3DEXT
Chapter 3
86
The pixels in the rectangle are processed exactly as if glCopyPixels had been called, but
the process stops just before final conversion. At this point all pixel component values
are clamped to the range [0, 1] and then converted to the texture’s internal format for
storage in the texel array.
If any of the pixels within the specified rectangle of the current GL_READ_BUFFER are
outside the read window associated with the current rendering context, then the values
obtained for those pixels are undefined.
Notes
glCopyTexSubImage3DEXT is part of the EXT_copy_texture extension.
Errors
• GL_INVALID_ENUM is generated when target is not one of the allowable values.
• GL_INVALID_VALUE is generated if level is less than zero or greater than log
2
max,
where max is the returned value of GL_MAX_TEXTURE_SIZE.
• GL_INVALID_VALUE is generated if xoffset <- TEXTURE_BORDER, (xoffset +
width) > (TEXTURE_WIDTH - TEXTURE_BORDER), yoffset < -
TEXTURE_BORDER, or if zoffset < - TEXTURE_BORDER, where
TEXTURE_WIDTH, TEXTURE_HEIGHT, and TEXTURE_BORDER are the state
values of the texture image being modified, and interlace is 1 if
GL_INTERLACE_SGIX is disabled, and 2 otherwise. Note that TEXTURE_WIDTH
and TEXTURE_HEIGHT include twice the border width.
• GL_INVALID_VALUE is generated if width or height is negative.
• GL_INVALID_OPERATION is generated when the texture array has not been
defined by a previous glTexImage3D (or equivalent) operation.
• GL_INVALID_OPERATION is generated if glCopyTexSubImage3DEXT is executed
between the execution of glBegin and the corresponding execution of glEnd.
Associated Gets
glGetTexImage
See Also
glTexImage3D,
glTexSubImage3DEXT,
glCopyPixels.
To Next Page
Loading...
Need help?
General