← 返回首页
WebGLRenderingContext: Methode bufferSubData() - Web-APIs | MDN

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

WebGLRenderingContext: Methode bufferSubData()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGLRenderingContext.bufferSubData()-Methode der WebGL API aktualisiert einen Teil der Datenablage eines Pufferobjekts.

In diesem Artikel

Syntax

js
bufferSubData(target, offset) bufferSubData(target, offset, srcData)

Parameter

target

Ein GLenum, der den Bindungspunkt (Ziel) angibt. Mögliche Werte:

gl.ARRAY_BUFFER

Puffer, der Vertex-Attribute enthält, wie z.B. Vertex-Koordinaten, Texturkoordinatendaten oder Vertex-Farbwerte.

gl.ELEMENT_ARRAY_BUFFER

Puffer, der für Elementindizes verwendet wird.

offset

Ein GLintptr, der einen Offset in Bytes angibt, ab dem der Datenaustausch beginnt.

srcData Optional

Ein TypedArray oder ein DataView, der/die einen ArrayBuffer oder SharedArrayBuffer ansieht, der in die Datenablage kopiert wird.

Rückgabewert

Keiner (undefined).

Ausnahmen

  • Ein gl.INVALID_VALUE-Fehler wird ausgelöst, wenn die Daten über das Ende des Puffers hinaus geschrieben würden oder wenn data null ist.
  • Ein gl.INVALID_ENUM-Fehler wird ausgelöst, wenn target nicht einer der erlaubten Enums ist.

Beispiele

Verwendung von bufferSubData

js
const canvas = document.getElementById("canvas"); const gl = canvas.getContext("webgl"); const buffer = gl.createBuffer(); const data = new Float32Array([1, 2, 3, 4]); gl.bindBuffer(gl.ARRAY_BUFFER, buffer); gl.bufferData(gl.ARRAY_BUFFER, 1024, gl.STATIC_DRAW); gl.bufferSubData(gl.ARRAY_BUFFER, 512, data);

Spezifikationen

Spezifikation
WebGL Specification
# 5.14.5

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch