ANGLE_instanced_arrays: phương thức drawElementsInstancedANGLE()

Baseline Widely available

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

Phương thức ANGLE_instanced_arrays.drawElementsInstancedANGLE() của WebGL API kết xuất các nguyên thủy từ dữ liệu mảng giống như phương thức gl.drawElements(). Ngoài ra, nó có thể thực thi nhiều thể hiện của một tập phần tử.

Note: Khi dùng WebGL2, phương thức này mặc định có sẵn dưới dạng gl.drawElementsInstanced().

Cú pháp

js
drawElementsInstancedANGLE(mode, count, type, offset, primcount)

Tham số

mode

Một GLenum chỉ định kiểu nguyên thủy cần kết xuất. Các giá trị có thể là:

  • gl.POINTS: Vẽ một chấm đơn.
  • gl.LINE_STRIP: Vẽ một đường thẳng tới đỉnh tiếp theo.
  • gl.LINE_LOOP: Vẽ một đường thẳng tới đỉnh tiếp theo, và nối đỉnh cuối trở lại đỉnh đầu.
  • 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.
count

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

type

Một GLenum chỉ định kiểu của các giá trị trong bộ đệm mảng phần tử. Các giá trị có thể là:

  • gl.UNSIGNED_BYTE
  • gl.UNSIGNED_SHORT
  • gl.UNSIGNED_INT khi dùng tiện ích mở rộng OES_element_index_uint.
offset

Một GLintptr chỉ định độ lệch trong bộ đệm mảng phần tử. Phải là một bội số hợp lệ của kích thước kiểu đã cho.

primcount

Một GLsizei chỉ định số thể hiện của tập phần tử cần thực thi.

Giá trị trả về

Không có (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 sẽ được ném ra.
  • Nếu offset không phải là bội số hợp lệ của kích thước kiểu đã cho, lỗi gl.INVALID_OPERATION sẽ được ném ra.
  • Nếu count hoặc primcount là số âm, lỗi gl.INVALID_VALUE sẽ được ném ra.

Ví dụ

js
const ext = gl.getExtension("ANGLE_instanced_arrays");
ext.drawElementsInstancedANGLE(gl.POINTS, 2, gl.UNSIGNED_SHORT, 0, 4);

Thông số kỹ thuật

Thông số kỹ thuật
WebGL ANGLE_instanced_arrays Khronos Ratified Extension Specification

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

Xem thêm