WebGLRenderingContext: Methode texSubImage2D()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methode texSubImage2D() des Interfaces WebGLRenderingContext der WebGL-API legt einen zweidimensionalen rechteckigen Teilbereich eines Texturbildes fest.
Syntax
// WebGL 1:
texSubImage2D(target, level, xoffset, yoffset, width, height, format, type, srcData)
texSubImage2D(target, level, xoffset, yoffset, format, type, source)
// Additionally available in WebGL 2:
texSubImage2D(target, level, xoffset, yoffset, width, height, format, type, srcData, srcOffset)
texSubImage2D(target, level, xoffset, yoffset, width, height, format, type, source)
texSubImage2D(target, level, xoffset, yoffset, width, height, format, type, offset)
Parameter
target-
Ein
GLenum, das den Bindungspunkt (das Ziel) der aktiven Textur angibt. Mögliche Werte:gl.TEXTURE_2D: Eine zweidimensionale Textur.gl.TEXTURE_CUBE_MAP_POSITIVE_X: Die positive X-Seite einer Cube-Map-Textur.gl.TEXTURE_CUBE_MAP_NEGATIVE_X: Die negative X-Seite einer Cube-Map-Textur.gl.TEXTURE_CUBE_MAP_POSITIVE_Y: Die positive Y-Seite einer Cube-Map-Textur.gl.TEXTURE_CUBE_MAP_NEGATIVE_Y: Die negative Y-Seite einer Cube-Map-Textur.gl.TEXTURE_CUBE_MAP_POSITIVE_Z: Die positive Z-Seite einer Cube-Map-Textur.gl.TEXTURE_CUBE_MAP_NEGATIVE_Z: Die negative Z-Seite einer Cube-Map-Textur.
level-
Ein
GLint, das die Detailstufe angibt. Stufe 0 ist die Stufe des Basisbildes, und Stufe n ist die n-te Mipmap-Reduktionsstufe. xoffset-
Ein
GLint, das die x-Koordinate des linken unteren Texels eines rechteckigen Teilbereichs des Texturarrays mit der Breitewidthund der Höheheightangibt. yoffset-
Ein
GLint, das die y-Koordinate des linken unteren Texels eines rechteckigen Teilbereichs des Texturarrays mit der Breitewidthund der Höheheightangibt. width-
Ein
GLsizei, das die Breite der Textur in Texeln angibt. height-
Ein
GLsizei, das die Höhe der Textur in Texeln angibt. format-
Ein
GLenum, das angibt, wie jedes Ganzzahlelement der rohen Texeldaten als Farbkomponente zu interpretieren ist. Mögliche Werte:gl.ALPHA: Verwirft die roten, grünen und blauen Komponenten und liest die Alphakomponente.gl.RGB: Verwirft die Alphakomponenten und liest die roten, grünen und blauen Komponenten.gl.RGBA: Liest die roten, grünen, blauen und Alpha-Komponenten aus dem Farbpuffer.gl.LUMINANCE: Jede Farbkomponente ist eine Luminanzkomponente; Alpha beträgt 1,0.gl.LUMINANCE_ALPHA: Jede Komponente ist eine Luminanz-/Alpha-Komponente.
Bei Verwendung der Erweiterung
EXT_sRGB:ext.SRGB_EXText.SRGB_ALPHA_EXT
Bei Verwendung eines
WebGL2RenderingContextstehen zusätzlich folgende Werte zur Verfügung:gl.REDgl.RED_INTEGERgl.RGgl.RG_INTEGERgl.RGB_INTEGERgl.RGBA_INTEGERgl.DEPTH_COMPONENTgl.DEPTH_STENCIL
type-
Ein
GLenum, das die Größe jedes Ganzzahlelements in den rohen Texeldaten angibt. Informationen zu den verfügbaren Kombinationen vonformatundtypefinden Sie unterWebGLRenderingContext.texImage2D().
Die Texturquelle kann auf drei Arten bereitgestellt werden: aus einem ArrayBuffer (möglicherweise gemeinsam genutzt) mit srcData und srcOffset, aus einer DOM-Pixelquelle mit source oder in WebGL 2 aus gl.PIXEL_UNPACK_BUFFER mit offset.
srcData-
Ein
TypedArrayoderDataView, das die Pixeldaten des Bildes enthält. Sein Typ muss zum Parametertypepassen; sieheWebGLRenderingContext.texImage2D(). srcOffsetOptional-
(Nur WebGL 2) Eine Ganzzahl, die den Index in
srcDataangibt, ab dem gelesen wird. Der Standardwert ist0. source-
Liest Daten aus einer DOM-Pixelquelle. Dies kann einer der folgenden Typen sein:
ImageBitmapImageDataHTMLImageElementHTMLCanvasElementHTMLVideoElementOffscreenCanvasVideoFrame
In WebGL 1 werden
widthundheightimmer aus der Quelle abgeleitet. In WebGL 2 können sie auch ausdrücklich angegeben werden. offset-
(Nur WebGL 2) Ein
GLintptr, das die Startadresse im angl.PIXEL_UNPACK_BUFFERgebundenen Puffer angibt.
Rückgabewert
Keiner (undefined).
Beispiele
gl.texSubImage2D(gl.TEXTURE_2D, 0, 0, 0, gl.RGBA, gl.UNSIGNED_BYTE, image);
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification> # TEXSUBIMAGE2D> |
| WebGL 2.0 Specification> # 4.7.6> |
Browser-Kompatibilität
Siehe auch
WebGLRenderingContext.createTexture()WebGLRenderingContext.bindTexture()WebGLRenderingContext.texImage2D()WebGLRenderingContext.compressedTexImage2D()WebGLRenderingContext.copyTexImage2D()WebGLRenderingContext.getTexParameter()OES_texture_floatOES_texture_half_floatEXT_sRGBEXT_texture_norm16