ANGLE_instanced_arrays: drawArraysInstancedANGLE() 方法

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本正常執行。自 2016 年 6 月起,所有瀏覽器均已支援。

ANGLE_instanced_arrays.drawArraysInstancedANGLE() 方法是 WebGL API 的一部分,它像 gl.drawArrays() 方法一樣,從陣列資料渲染圖元。此外,它還可以執行範圍內元素的多個例項。

注意: 使用 WebGL2 時,此方法預設可用作 gl.drawArraysInstanced()

語法

js
drawArraysInstancedANGLE(mode, first, count, primcount)

引數

模式

一個 GLenum,指定要渲染的圖元型別。可能的值有:

  • gl.POINTS:繪製一個點。
  • gl.LINE_STRIP:繪製一條連線到下一個頂點的直線。
  • gl.LINE_LOOP:繪製一條連線到下一個頂點的直線,並將最後一個頂點連接回第一個頂點。
  • gl.LINES:在兩個頂點之間繪製一條線。
  • gl.TRIANGLE_STRIP
  • gl.TRIANGLE_FAN
  • gl.TRIANGLES:為一組三個頂點繪製一個三角形。
first

一個 GLint,指定向量點陣列中的起始索引。

計數

一個 GLsizei,指定要渲染的索引數量。

primcount

一個 GLsizei,指定要執行的元素範圍的例項數量。

返回值

無(undefined)。

異常

  • 如果 mode 不是接受的值之一,則會丟擲 gl.INVALID_ENUM 錯誤。
  • 如果 firstcountprimcount 為負數,則會丟擲 gl.INVALID_VALUE 錯誤。
  • 如果 gl.CURRENT_PROGRAMnull,則會丟擲 gl.INVALID_OPERATION 錯誤。

示例

js
const ext = gl.getExtension("ANGLE_instanced_arrays");
ext.drawArraysInstancedANGLE(gl.POINTS, 0, 8, 4);

規範

規範
WebGL ANGLE_instanced_arrays Khronos 批准的擴充套件規範

瀏覽器相容性

另見