glTexImage3D

specify a three-dimensional texture image

Signature

glTexImage3D( GLenum ( target ) , GLint ( level ) , GLint ( internalFormat ) , GLsizei ( width ) , GLsizei ( height ) , GLsizei ( depth ) , GLint ( border ) , GLenum ( format ) , GLenum ( type ) , const GLvoid * ( data ) )-> void
glTexImage3D( target , level , internalformat , width , height , depth , border , format , type , pixels )
glTexImage3Df( target , level , internalformat , border , format , pixels )
glTexImage3Di( target , level , internalformat , border , format , pixels )
glTexImage3Ds( target , level , internalformat , border , format , pixels )
glTexImage3Dui( target , level , internalformat , border , format , pixels )
glTexImage3Dus( target , level , internalformat , border , format , pixels )

Parameters

VariablesDescription
target
Specifies the target texture. Must be one of GL_TEXTURE_3D , GL_PROXY_TEXTURE_3D , GL_TEXTURE_2D_ARRAY or GL_PROXY_TEXTURE_2D_ARRAY .
level
Specifies the level-of-detail number. Level 0 is the base image level. Level n is the n th mipmap reduction image.
internalFormat
Specifies the number of color components in the texture. Must be one of base internal formats given in Table 1, one of the sized internal formats given in Table 2, or one of the compressed internal formats given in Table 3, below.
width
Specifies the width of the texture image. All implementations support 3D texture images that are at least 16 texels wide.
height
Specifies the height of the texture image. All implementations support 3D texture images that are at least 256 texels high.
depth
Specifies the depth of the texture image, or the number of layers in a texture array. All implementations support 3D texture images that are at least 256 texels deep, and texture arrays that are at least 256 layers deep.
border
This value must be 0.
format
Specifies the format of the pixel data. The following symbolic values are accepted: GL_RED , GL_RG , GL_RGB , GL_BGR , GL_RGBA , GL_BGRA , GL_RED_INTEGER , GL_RG_INTEGER , GL_RGB_INTEGER , GL_BGR_INTEGER , GL_RGBA_INTEGER , GL_BGRA_INTEGER , GL_STENCIL_INDEX , GL_DEPTH_COMPONENT , GL_DEPTH_STENCIL .
type
Specifies the data type of the pixel data. The following symbolic values are accepted: GL_UNSIGNED_BYTE , GL_BYTE , GL_UNSIGNED_SHORT , GL_SHORT , GL_UNSIGNED_INT , GL_INT , GL_FLOAT , GL_UNSIGNED_BYTE_3_3_2 , GL_UNSIGNED_BYTE_2_3_3_REV , GL_UNSIGNED_SHORT_5_6_5 , GL_UNSIGNED_SHORT_5_6_5_REV , GL_UNSIGNED_SHORT_4_4_4_4 , GL_UNSIGNED_SHORT_4_4_4_4_REV , GL_UNSIGNED_SHORT_5_5_5_1 , GL_UNSIGNED_SHORT_1_5_5_5_REV , GL_UNSIGNED_INT_8_8_8_8 , GL_UNSIGNED_INT_8_8_8_8_REV , GL_UNSIGNED_INT_10_10_10_2 , and GL_UNSIGNED_INT_2_10_10_10_REV .
data
Specifies a pointer to the image data in memory.

Sample Code References

The following code samples have been found which appear to reference the functions described here. Take care that the code may be old, broken or not even use PyOpenGL.

glTexImage3D
Visvis core/baseTexture.py Lines: 424, 449
{GPL3} OpenGL-Programmable 01-direct.py Lines: 46
{GPL3} OpenGL-Programmable 06-perpixel.py Lines: 123
{GPL3} OpenGL-Programmable 09-gles2.py Lines: 160
{GPL3} OpenGL-Programmable 03-array.py Lines: 46
{GPL3} OpenGL-Programmable 10-gl3.2core.py Lines: 168
{GPL3} OpenGL-Programmable 08-pbo.py Lines: 142
{GPL3} OpenGL-Programmable 02-displaylist.py Lines: 46
{GPL3} OpenGL-Programmable 05-shader.py Lines: 115
{GPL3} OpenGL-Programmable 07-attrib.py Lines: 132
{GPL3} OpenGL-Programmable 04-vbo.py Lines: 47

MathML Rendering

Powered by MathJax