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

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.drawArraysInstancedANGLE() 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.drawArrays(). Ngoài ra, nó có thể thực thi nhiều thể hiện của dải 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.drawArraysInstanced().

Cú pháp

js
drawArraysInstancedANGLE(mode, first, count, 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.
first

Một GLint chỉ định chỉ mục bắt đầu trong mảng các điểm véc-tơ.

count

Một GLsizei chỉ định số chỉ mục sẽ được kết xuất.

primcount

Một GLsizei chỉ định số thể hiện của dải 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 first, count hoặc primcount là số âm, lỗi gl.INVALID_VALUE sẽ được ném ra.
  • nếu gl.CURRENT_PROGRAMnull, lỗi gl.INVALID_OPERATION sẽ được ném ra.

Ví dụ

js
const ext = gl.getExtension("ANGLE_instanced_arrays");
ext.drawArraysInstancedANGLE(gl.POINTS, 0, 8, 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