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: Dieses Feature ist verfügbar in Web Workers.
Die WebGLRenderingContext.copyTexSubImage2D()
Methode der
WebGL API kopiert Pixel vom aktuellen
WebGLFramebuffer
in ein bestehendes 2D-Textur-Sub-Image.
Syntax
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
gl.copyTexSubImage2D(gl.TEXTURE_2D, 0, 0, 0, 0, 0, 16, 16);
Spezifikationen
Specification |
---|
WebGL Specification # 5.14.8 |
Browser-Kompatibilität
BCD tables only load in the browser