glTexSubImage2D

specify a two-dimensional texture subimage

Signature

glTexSubImage2D( GLenum ( target ) , GLint ( level ) , GLint ( xoffset ) , GLint ( yoffset ) , GLsizei ( width ) , GLsizei ( height ) , GLenum ( format ) , GLenum ( type ) , const GLvoid * ( data ) )-> void
glTexSubImage2D( target , level , xoffset , yoffset , width , height , format , type , pixels )
glTexSubImage2Df( target , level , xoffset , yoffset , format , pixels )
glTexSubImage2Di( target , level , xoffset , yoffset , format , pixels )
glTexSubImage2Ds( target , level , xoffset , yoffset , format , pixels )
glTexSubImage2Dui( target , level , xoffset , yoffset , format , pixels )
glTexSubImage2Dus( target , level , xoffset , yoffset , format , pixels )

Parameters

VariablesDescription
target
Specifies the target texture. Must be GL_TEXTURE_2D , GL_TEXTURE_CUBE_MAP_POSITIVE_X , GL_TEXTURE_CUBE_MAP_NEGATIVE_X , GL_TEXTURE_CUBE_MAP_POSITIVE_Y , GL_TEXTURE_CUBE_MAP_NEGATIVE_Y , GL_TEXTURE_CUBE_MAP_POSITIVE_Z , GL_TEXTURE_CUBE_MAP_NEGATIVE_Z , or GL_TEXTURE_1D_ARRAY .
level
Specifies the level-of-detail number. Level 0 is the base image level. Level n is the n th mipmap reduction image.
xoffset
Specifies a texel offset in the x direction within the texture array.
yoffset
Specifies a texel offset in the y direction within the texture array.
width
Specifies the width of the texture subimage.
height
Specifies the height of the texture subimage.
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_DEPTH_COMPONENT , and GL_STENCIL_INDEX .
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.

glTexSubImage2D
OpenGLContext OpenGLContext/texture.py Lines: 109
OpenGL-Demo PyOpenGL-Demo/NeHe/lesson42.py Lines: 262
{LGPL} VisionEgg VisionEgg/Textures.py Lines: 994
{LGPL} PyMT pymt/texture.py Lines: 18, 324
Visvis core/baseTexture.py Lines: 402
Visvis text/text_base.py Lines: 97