WebGL2RenderingContext: phương thức bufferSubData()

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

* Some parts of this feature may have varying levels of support.

Note: This feature is available in Web Workers.

Phương thức WebGL2RenderingContext.bufferSubData() của WebGL API cập nhật một tập hợp con của kho dữ liệu đối tượng bộ đệm.

Cú pháp

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

Tham số

target

Một GLenum chỉ định điểm liên kết (target). Các giá trị có thể:

gl.ARRAY_BUFFER

Bộ đệm chứa các thuộc tính đỉnh, chẳng hạn như tọa độ đỉnh, dữ liệu tọa độ texture hoặc dữ liệu màu đỉnh.

gl.ELEMENT_ARRAY_BUFFER

Bộ đệm dùng cho chỉ mục phần tử.

gl.COPY_READ_BUFFER

Bộ đệm để sao chép từ một đối tượng bộ đệm sang bộ đệm khác.

gl.COPY_WRITE_BUFFER

Bộ đệm để sao chép từ một đối tượng bộ đệm sang bộ đệm khác.

gl.TRANSFORM_FEEDBACK_BUFFER

Bộ đệm cho các hoạt động transform feedback.

gl.UNIFORM_BUFFER

Bộ đệm dùng để lưu trữ các khối uniform.

gl.PIXEL_PACK_BUFFER

Bộ đệm dùng cho các hoạt động chuyển pixel.

gl.PIXEL_UNPACK_BUFFER

Bộ đệm dùng cho các hoạt động chuyển pixel.

dstByteOffset

Một GLintptr chỉ định offset tính bằng byte nơi việc thay thế dữ liệu sẽ bắt đầu.

srcData

Một TypedArray hoặc một DataView xem một ArrayBuffer hoặc SharedArrayBuffer sẽ được sao chép vào kho dữ liệu.

srcOffset Optional

Một GLuint chỉ định offset chỉ mục phần tử nơi bắt đầu đọc bộ đệm.

length Optional

Một GLuint mặc định là 0, trong đó 0 có nghĩa là bufferSubData sẽ tính toán độ dài.

Giá trị trả về

None (undefined).

Ngoại lệ

  • Lỗi gl.INVALID_VALUE được ném nếu dữ liệu sẽ được ghi vượt quá cuối bộ đệm hoặc nếu datanull.
  • Lỗi gl.INVALID_ENUM được ném nếu target không phải là một trong các enum cho phép.

Đặc tả kỹ thuật

Specification
WebGL Specification
# 5.14.5

Tương thích trình duyệt

Xem thêm