HP Workstation zx2000 OpenGL 1.1 Reference for HP-UX 11.x - Page 86

C glCopyTexSubImage3DEXT 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 log2max, where max is the returned value of GL_MAX_TEXTURE_SIZE. • GL_INVALID_VALUE is generated if xoffset (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. 86 Chapter 3