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

Chapter 18 T glTexImage3DEXT A one-component texture image uses only the red component of the RGBA color extracted from pixels. A two-component image uses the R and A values. A three-component image uses the R, G, and B values. A four-component image uses all of the RGBA components. Notes Texturing has no effect in color index mode. The texture image can be represented by the same data formats and types as the pixels in a glDrawPixels command, except that formats GL_STENCIL_INDEX and GL_DEPTH_COMPONENT cannot be used, and type GL_BITMAP cannot be used. glPixelStore and glPixelTransfer modes affect texture images in exactly the way they affect glDrawPixels. A texture image with zero height, width, or depth indicates the null texture. If the null texture is specified for level-of-detail 0, it is as if texturing were disabled. glTexImage3DEXT is part of the EXT_texture3d extension. Errors • GL_INVALID_ENUM is generated when target is not an accepted value. • GL_INVALID_ENUM is generated when format is not an accepted value. • GL_INVALID_ENUM is generated when type is not an accepted value. • GL_INVALID_VALUE is generated if level is less than zero or greater than log2max, where max is the returned value of GL_MAX_3D_TEXTURE_SIZE_EXT. • GL_INVALID_VALUE is generated if internalformat is not an accepted value. • GL_INVALID_VALUE is generated if width, height, or depth is less than zero or greater than GL_MAX_3D_TEXTURE_SIZE_EXT, when width, height, or depth cannot be represented as 2k + 2 × border for some integer k, • GL_INVALID_VALUE is generated if border is not 0 or 1. • GL_INVALID_OPERATION is generated if glTexImage3DEXT is executed between the execution of glBegin and the corresponding execution of glEnd. • GL_TEXTURE_TOO_LARGE_EXT is generated if the implementation cannot accommodate a texture of the size requested. Associated Gets glGetTexImage glIsEnabled with argument GL_TEXTURE_3D_EXT See Also glDrawPixels, glFog, glPixelStore, glPixelTransfer, glTexEnv, 447