C
glCopyTexSubImage3DEXT
Chapter 3
85
glCopyTexSubImage3DEXT
glCopyTexSubImage3DEXT: copy pixels into a 3D texture sub image.
C Specification
void glCopyTexSubImage3DEXT(
GLenum target,
GLint level,
GLint xoffset,
GLint yoffset,
GLint zoffset,
GLint x,
GLint y,
GLsizei width,
GLsizei height)
Parameters
target The target texture. Must be GL_TEXTURE_3D_EXT.
level The level-of-detail number. Level 0 is the base image level, and level n
is the nth mipmap reduction image.
xoffset Texel offset in the X direction within the texture array.
yoffset Texel offset in the Y direction within the texture array.
zoffset Texel offset in the Z direction within the texture array.
x The X coordinate of the lower-left corner of the pixel rectangle to be
transferred to the texture array.
y The Y coordinate of the lower-left corner of the pixel rectangle to be
transferred to the texture array.
width The width of the texture sub image.
height The height of the texture sub image.
Description
glCopyTexSubImage3DEXT replaces a rectangular portion of a three-dimensional
texture image with pixels from the current GL_READ_BUFFER (rather than from main
memory, as is the case for glTexSubImage3DEXT).
The screen-aligned pixel rectangle with lower-left corner at (x, y) having width width
and height height replaces the rectangular area of the S-T slice located at zoffset with X
indices xoffset through xoffset + width - 1, inclusive, and Y indices yoffset through yoffset
+ height - 1, inclusive.
The destination rectangle in the texture array may not include any texels outside 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.