WebGLRenderingContext: copyTexSubImage2D() 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.copyTexSubImage2D() Methode der WebGL API kopiert Pixel vom aktuellen WebGLFramebuffer in ein bestehendes 2D-Textur-Sub-Image.

Syntax

js
copyTexSubImage2D(target, level, xoffset, yoffset, x, y, width, height)

Parameter

target

Ein GLenum, das den Bindungspunkt (target) 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, der das Detaillevel angibt. Level 0 ist das Basisbild-Level und Level n ist das n-te Mipmap-Reduktionslevel.

xoffset

Ein GLint, der den horizontalen Offset innerhalb des Texturbildes angibt.

yoffset

Ein GLint, der den vertikalen Offset innerhalb des Texturbildes angibt.

x

Ein GLint, der die x-Koordinate der unteren linken Ecke angibt, wo das Kopieren beginnt.

y

Ein GLint, der die y-Koordinate der unteren linken Ecke angibt, wo das Kopieren beginnt.

width

Ein GLsizei, der die Breite der Textur angibt.

height

Ein GLsizei, der die Höhe der Textur angibt.

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.copyTexSubImage2D(gl.TEXTURE_2D, 0, 0, 0, 0, 0, 16, 16);

Spezifikationen

Specification
WebGL Specification
# 5.14.8

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
copyTexSubImage2D

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch