Name
gl.TexSubImage -- specify a one- or two-dimensional texture subimage
Synopsis
gl.TexSubImage(level, format, type, pixels, xoffset[, yoffset])
Function
This function does the same as gl.TexSubImage1D() and gl.TexSubImage2D() except that the pixel data is not passed in a raw memory buffer but as table containing one subtable for each row of pixels. This is of course not as efficient as using raw memory buffers because the table's pixel data has to be copied to a raw memory buffer first.

Width and height of the texture will be automatically determined by the layout of the table in pixels. If there is only one subtable within pixels, gl.TexSubImage() will define a texture of type #GL_TEXTURE_1D. If there are multiple subtables within pixels, #GL_TEXTURE_2D will be used.

Note that only #GL_FLOAT and #GL_UNSIGNED_BYTE are currently supported for type.

See gl.TexSubImage2D for more details on the parameters accepted by this function.

Please consult an OpenGL reference manual for more information.

Inputs
level
specifies the level-of-detail number; level 0 is the base image level; level n is the nth mipmap reduction image
format
specifies the format of the pixel data (see above)
type
specifies the data type of the pixel data (see above)
pixels
specifies a one- or two-dimensional with pixel data
xoffset
specifies a texel offset in the x direction within the texture array
yoffset
optional: specifies a texel offset in the y direction within the texture array (only required for two-dimensional textures)
Show TOC