WebGL2RenderingContext: phương thức drawRangeElements()
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.
Note: This feature is available in Web Workers.
Phương thức WebGL2RenderingContext.drawRangeElements() của WebGL API kết xuất các hình nguyên từ dữ liệu mảng trong một dải đã cho.
Cú pháp
drawRangeElements(mode, start, end, count, type, offset)
Tham số
mode-
Một
GLenumchỉ định loại hình nguyên sẽ kết xuất. Các giá trị có thể:gl.POINTS: Vẽ một điểm duy nhất.gl.LINE_STRIP: Vẽ một đường thẳng đến đỉnh tiếp theo.gl.LINE_LOOP: Vẽ một đường thẳng đến đỉnh tiếp theo và kết nối đỉnh cuối cùng trở lại đỉnh đầu tiên.gl.LINES: Vẽ một đường giữa một cặp đỉnh.gl.TRIANGLE_STRIPgl.TRIANGLE_FANgl.TRIANGLES: Vẽ một tam giác cho một nhóm ba đỉnh.
start-
Một
GLuintchỉ định chỉ mục mảng nhỏ nhất chứa trongoffset. end-
Một
GLuintchỉ định chỉ mục mảng lớn nhất chứa trongoffset. count-
Một
GLsizeichỉ định số lượng phần tử sẽ được kết xuất. type-
Một
GLenumchỉ định loại giá trị trong bộ đệm mảng phần tử. Các giá trị có thể:gl.UNSIGNED_BYTEgl.UNSIGNED_SHORTgl.UNSIGNED_INT
offset-
Một
GLintptrchỉ định một offset trong bộ đệm mảng phần tử. Phải là bội số hợp lệ của kích thước củatypeđã cho.
Giá trị trả về
None (undefined).
Ngoại lệ
- Nếu
modekhông phải là một trong các giá trị được chấp nhận, lỗigl.INVALID_ENUMđược ném. - Nếu
offsetkhông phải là bội số hợp lệ của kích thước của type đã cho, lỗigl.INVALID_OPERATIONđược ném. - Nếu
countlà số âm, lỗigl.INVALID_VALUEđược ném.
Ví dụ
gl.drawRangeElements(gl.POINTS, 0, 7, 8, gl.UNSIGNED_BYTE, 0);
Đặc tả kỹ thuật
| Specification |
|---|
| WebGL 2.0 Specification> # 3.7.9> |