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
bufferSubData(target, dstByteOffset, srcData)
bufferSubData(target, dstByteOffset, srcData, srcOffset)
bufferSubData(target, dstByteOffset, srcData, srcOffset, length)
Tham số
target-
Một
GLenumchỉ đị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
GLintptrchỉ định offset tính bằng byte nơi việc thay thế dữ liệu sẽ bắt đầu. srcData-
Một
TypedArrayhoặc mộtDataViewxem mộtArrayBufferhoặcSharedArrayBuffersẽ được sao chép vào kho dữ liệu. srcOffsetOptional-
Một
GLuintchỉ định offset chỉ mục phần tử nơi bắt đầu đọc bộ đệm. lengthOptional-
Một
GLuintmặc định là 0, trong đó 0 có nghĩa làbufferSubDatasẽ 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ếudatalànull. - Lỗi
gl.INVALID_ENUMđược ném nếutargetkhông phải là một trong các enum cho phép.
Đặc tả kỹ thuật
| Specification |
|---|
| WebGL Specification> # 5.14.5> |