Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
// 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 Breite width und der Höhe height angibt.

yoffset

Ein GLint, das die y-Koordinate des linken unteren Texels eines rechteckigen Teilbereichs des Texturarrays mit der Breite width und der Höhe height angibt.

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_EXT
  • ext.SRGB_ALPHA_EXT

Bei Verwendung eines WebGL2RenderingContext stehen zusätzlich folgende Werte zur Verfügung:

  • gl.RED
  • gl.RED_INTEGER
  • gl.RG
  • gl.RG_INTEGER
  • gl.RGB_INTEGER
  • gl.RGBA_INTEGER
  • gl.DEPTH_COMPONENT
  • gl.DEPTH_STENCIL
type

Ein GLenum, das die Größe jedes Ganzzahlelements in den rohen Texeldaten angibt. Informationen zu den verfügbaren Kombinationen von format und type finden Sie unter WebGLRenderingContext.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 TypedArray oder DataView, das die Pixeldaten des Bildes enthält. Sein Typ muss zum Parameter type passen; siehe WebGLRenderingContext.texImage2D().

srcOffset Optional

(Nur WebGL 2) Eine Ganzzahl, die den Index in srcData angibt, ab dem gelesen wird. Der Standardwert ist 0.

source

Liest Daten aus einer DOM-Pixelquelle. Dies kann einer der folgenden Typen sein:

In WebGL 1 werden width und height immer 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 an gl.PIXEL_UNPACK_BUFFER gebundenen Puffer angibt.

Rückgabewert

Keiner (undefined).

Beispiele

js
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