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 July 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die WebGLRenderingContext.copyTexImage2D() Methode der WebGL-API kopiert Pixel vom aktuellen WebGLFramebuffer in ein 2D-Texturbild.
Syntax
copyTexImage2D(target, level, internalformat, x, y, width, height, border)
Parameter
target-
Ein
GLenum, das 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 cubemap-Textur.gl.TEXTURE_CUBE_MAP_NEGATIVE_X: Negative X-Fläche für eine cubemap-Textur.gl.TEXTURE_CUBE_MAP_POSITIVE_Y: Positive Y-Fläche für eine cubemap-Textur.gl.TEXTURE_CUBE_MAP_NEGATIVE_Y: Negative Y-Fläche für eine cubemap-Textur.gl.TEXTURE_CUBE_MAP_POSITIVE_Z: Positive Z-Fläche für eine cubemap-Textur.gl.TEXTURE_CUBE_MAP_NEGATIVE_Z: Negative Z-Fläche für eine cubemap-Textur.
level-
Ein
GLint, das die Detailebene angibt. Stufe 0 ist die Basisbildstufe und Stufe n ist die n-te Mipmap-Reduktionsstufe. internalformat-
Ein
GLenum, das die Farbkomponenten in der Textur angibt. 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 Farbpuffer gelesen.gl.LUMINANCE: Jede Farbkomponente ist eine Luminanzkomponente, Alpha ist 1.0.gl.LUMINANCE_ALPHA: Jede Komponente ist eine Luminanz/Alpha-Komponente.
x-
Ein
GLint, das die x-Koordinate der unteren linken Ecke angibt, von der aus das Kopieren beginnt. y-
Ein
GLint, das die y-Koordinate der unteren linken Ecke angibt, von der aus das Kopieren beginnt. width-
Ein
GLsizei, das die Breite der Textur angibt. height-
Ein
GLsizei, das die Höhe der Textur angibt. border-
Ein
GLint, das die Breite des Rands 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 |