WebGLRenderingContext: copyTexImage2D()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die copyTexImage2D()-Methode des WebGLRenderingContext-Interfaces der WebGL API kopiert Pixel aus dem aktuellen WebGLFramebuffer in ein 2D-Texturbild.
Syntax
copyTexImage2D(target, level, internalformat, x, y, width, height, border)
Parameter
target-
Ein
GLenum, der den Bindungspunkt (Ziel) der aktiven Textur angibt. Mögliche Werte:gl.TEXTURE_2D: Eine zweidimensionale Textur.gl.TEXTURE_CUBE_MAP_POSITIVE_X: Positive X-Fläche für eine Würfelkartentextur.gl.TEXTURE_CUBE_MAP_NEGATIVE_X: Negative X-Fläche für eine Würfelkartentextur.gl.TEXTURE_CUBE_MAP_POSITIVE_Y: Positive Y-Fläche für eine Würfelkartentextur.gl.TEXTURE_CUBE_MAP_NEGATIVE_Y: Negative Y-Fläche für eine Würfelkartentextur.gl.TEXTURE_CUBE_MAP_POSITIVE_Z: Positive Z-Fläche für eine Würfelkartentextur.gl.TEXTURE_CUBE_MAP_NEGATIVE_Z: Negative Z-Fläche für eine Würfelkartentextur.
level-
Ein
GLint, der das Detailniveau angibt. Level 0 ist die Basisbildstufe und Level n ist die n-te Mipmap-Reduktionsstufe. internalformat-
Ein
GLenum, der angibt, wie die Textur gespeichert werden soll, nachdem sie geladen wurde. 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: Rote, grüne, blaue und Alphakomponenten werden aus dem Farbbuffer gelesen.gl.LUMINANCE: Jede Farbkomponente ist eine Luminanzkomponente, Alpha ist 1.0.gl.LUMINANCE_ALPHA: Jede Komponente ist eine Luminanz-/Alphakomponente.
x-
Ein
GLint, der die x-Koordinate der linken unteren Ecke angibt, ab der kopiert werden soll. y-
Ein
GLint, der die y-Koordinate der linken unteren Ecke angibt, ab der kopiert werden soll. width-
Ein
GLsizei, der die Breite der Textur in Texeln angibt. height-
Ein
GLsizei, der die Höhe der Textur in Texeln angibt. border-
Ein
GLint, der die Breite des Randes angibt. Muss 0 sein.
Rückgabewert
Keiner (undefined).
Beispiele
gl.copyTexImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 0, 0, 512, 512, 0);
Spezifikationen
| Specification |
|---|
| WebGL Specification # 5.14.8 |
Browser-Kompatibilität
Loading…