WebGL2RenderingContext: drawElementsInstanced() 方法
注意:此功能在 Web Workers 中可用。
WebGL2RenderingContext.drawElementsInstanced() 方法是 WebGL 2 API 的一部分,它像 gl.drawElements() 方法一樣,使用陣列資料渲染圖元。此外,它還可以執行一組元素的多個例項。
注意:在使用 WebGL 1 時,ANGLE_instanced_arrays 擴充套件也可以提供此方法。
語法
js
drawElementsInstanced(mode, count, type, offset, instanceCount)
引數
模式-
一個
GLenum,指定要渲染的圖元型別。可能的值有:gl.POINTS:繪製一個點。gl.LINE_STRIP:繪製一條連線到下一個頂點的直線。gl.LINE_LOOP:繪製一條連線到下一個頂點的直線,並將最後一個頂點連接回第一個頂點。gl.LINES:在兩個頂點之間繪製一條線。gl.TRIANGLE_STRIPgl.TRIANGLE_FANgl.TRIANGLES:為一組三個頂點繪製一個三角形。
計數-
一個指定要渲染的元素數量的
GLsizei。 type-
一個
GLenum,指定元素陣列緩衝區中值的型別。可能的值為:gl.UNSIGNED_BYTEgl.UNSIGNED_SHORTgl.UNSIGNED_INT當使用OES_element_index_uint擴充套件時。
offset-
一個指定元素陣列緩衝區中偏移量的
GLintptr。必須是給定type大小的有效倍數。 instanceCount-
一個指定要執行的元素集例項數量的
GLsizei。
返回值
無(undefined)。
異常
- 如果
mode不是接受的值之一,則會丟擲gl.INVALID_ENUM錯誤。 - 如果
offset是給定型別大小的有效倍數,則會丟擲gl.INVALID_OPERATION錯誤。 - 如果
count或instanceCount為負數,則會丟擲gl.INVALID_VALUE錯誤。
示例
js
gl.drawElementsInstanced(gl.POINTS, 2, gl.UNSIGNED_SHORT, 0, 4);
規範
| 規範 |
|---|
| WebGL 2.0 規範 # 3.7.9 |
瀏覽器相容性
載入中…