WebGLRenderingContext: drawArrays() method

Baseline Widely available

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

Note: This feature is available in Web Workers.

Phương thức WebGLRenderingContext.drawArrays() của WebGL API hiển thị các giá trị gốc từ dữ liệu mảng.

Cú pháp

js
drawArrays(mode, first, count)

Thông số

mode

Một GLenum chỉ định kiểu nguyên thủy cần hiển thị. Giá trị có thể là:

  • gl.POINTS: Vẽ một dấu 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 cùng trở lại đỉnh đầu tiên.
  • gl.LINES: Vẽ một đường thẳ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.

[!GHI CHÚ] Nếu modePOINTS, gl_PointSize có thể cần được thiết lập để drawArrays hiển thị, vì giá trị của nó không xác định nếu không được ghi rõ ràng. Chỉ một số GPU đặt mặc định là 1.0.

first

A GLint chỉ định chỉ số bắt đầu trong mảng các điểm vectơ.

count

Một GLsizei chỉ định số lượng chỉ mục được hiển thị.

Giá trị trả về

Không có (undefined).

Ngoại lệ

  • Nếu mode không phải là một trong những giá trị được chấp nhận, thì Lỗi gl.INVALID_ENUM được đưa ra.
  • Nếu first hoặc count âm, a Lỗi gl.INVALID_VALUE được đưa ra.
  • nếu gl.CURRENT_PROGRAMnull, a Lỗi gl.INVALID_OPERATION được đưa ra.

Ví dụ

js
gl.drawArrays(gl.POINTS, 0, 8);

Thông số kỹ thuật

Specification
WebGL Specification
# 5.14.11

Khả năng tương thích của trình duyệt

Xem thêm