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

js
drawRangeElements(mode, start, end, count, type, offset)

Tham số

mode

Một GLenum chỉ đị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_STRIP
  • gl.TRIANGLE_FAN
  • gl.TRIANGLES: Vẽ một tam giác cho một nhóm ba đỉnh.
start

Một GLuint chỉ định chỉ mục mảng nhỏ nhất chứa trong offset.

end

Một GLuint chỉ định chỉ mục mảng lớn nhất chứa trong offset.

count

Một GLsizei chỉ định số lượng phần tử sẽ được kết xuất.

type

Một GLenum chỉ định loại giá trị trong bộ đệm mảng phần tử. Các giá trị có thể:

  • gl.UNSIGNED_BYTE
  • gl.UNSIGNED_SHORT
  • gl.UNSIGNED_INT
offset

Một GLintptr chỉ đị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ủa type đã cho.

Giá trị trả về

None (undefined).

Ngoại lệ

  • Nếu mode không phải là một trong các giá trị được chấp nhận, lỗi gl.INVALID_ENUM được ném.
  • Nếu offset không phải là bội số hợp lệ của kích thước của type đã cho, lỗi gl.INVALID_OPERATION được ném.
  • Nếu count là số âm, lỗi gl.INVALID_VALUE được ném.

Ví dụ

js
gl.drawRangeElements(gl.POINTS, 0, 7, 8, gl.UNSIGNED_BYTE, 0);

Đặc tả kỹ thuật

Specification
WebGL 2.0 Specification
# 3.7.9

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

Xem thêm