WebGL2RenderingContext: bufferSubData() 方法

Baseline 廣泛可用 *

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2021 年 9 月起,所有瀏覽器均已支援此功能。

* 此特性的某些部分可能存在不同級別的支援。

注意:此功能在 Web Workers 中可用。

WebGL2RenderingContext.bufferSubData() 方法是 WebGL API 的一部分,用於更新緩衝區物件資料儲存的子集。

語法

js
bufferSubData(target, dstByteOffset, srcData)
bufferSubData(target, dstByteOffset, srcData, srcOffset)
bufferSubData(target, dstByteOffset, srcData, srcOffset, length)

引數

目標

一個 GLenum,指定繫結點(目標)。可能的值

gl.ARRAY_BUFFER

包含頂點屬性的緩衝區,例如頂點座標、紋理座標資料或頂點顏色資料。

gl.ELEMENT_ARRAY_BUFFER

用於元素索引的緩衝區。

gl.COPY_READ_BUFFER

用於將一個緩衝區物件複製到另一個緩衝區的緩衝區。

gl.COPY_WRITE_BUFFER

用於將一個緩衝區物件複製到另一個緩衝區的緩衝區。

gl.TRANSFORM_FEEDBACK_BUFFER

用於變換反饋操作的緩衝區。

gl.UNIFORM_BUFFER

用於儲存 uniform 塊的緩衝區。

gl.PIXEL_PACK_BUFFER

用於畫素傳輸操作的緩衝區。

gl.PIXEL_UNPACK_BUFFER

用於畫素傳輸操作的緩衝區。

dstByteOffset

一個 GLintptr,指定資料替換開始的位元組偏移量。

srcData 可選

一個 TypedArrayDataView,它檢視化一個 ArrayBufferSharedArrayBuffer,這些資料將被複制到資料儲存中。

srcOffset 可選

一個 GLuint,指定開始讀取緩衝區的元素索引偏移量。

length 可選

一個 GLuint,預設為 0,其中 0 表示 bufferSubData 應自行計算長度。

返回值

無(undefined)。

異常

  • 如果資料寫入超出緩衝區末尾,或者 datanull,則會丟擲 gl.INVALID_VALUE 錯誤。
  • 如果 target 不是允許的列舉值之一,則會丟擲 gl.INVALID_ENUM 錯誤。

規範

規範
WebGL 規範
# 5.14.5

瀏覽器相容性

另見