T
glTexImage3DEXT
Chapter 18
447
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 log
2
max,
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 2
k
+ 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,
To Next Page
Loading...
Need help?
General