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: Dieses Feature ist verfügbar in Web Workers.

Die WebGLRenderingContext.copyTexImage2D()-Methode der WebGL API kopiert Pixel vom aktuellen WebGLFramebuffer in ein 2D-Texturbild.

Syntax

js
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-Seite für eine Cube-Map-Textur.
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_X: Negative X-Seite für eine Cube-Map-Textur.
  • gl.TEXTURE_CUBE_MAP_POSITIVE_Y: Positive Y-Seite für eine Cube-Map-Textur.
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_Y: Negative Y-Seite für eine Cube-Map-Textur.
  • gl.TEXTURE_CUBE_MAP_POSITIVE_Z: Positive Z-Seite für eine Cube-Map-Textur.
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_Z: Negative Z-Seite für eine Cube-Map-Textur.
level

Ein GLint, das den Detaillierungsgrad angibt. Level 0 ist das Basisbild-Level und Level n ist das n-te Mipmap-Reduktionslevel.

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 Alphakomponente und liest die roten, grünen und blauen Komponenten.
  • gl.RGBA: Rote, grüne, blaue und Alpha-Komponenten werden aus dem Farb-Puffer 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 das Kopieren beginnt.

y

Ein GLint, das die y-Koordinate der unteren linken Ecke angibt, von der 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 Randes angibt. Muss 0 sein.

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.copyTexImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 0, 0, 512, 512, 0);

Spezifikationen

Specification
WebGL Specification
# 5.14.8

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch