WEBGL_multi_draw: multiDrawElementsInstancedWEBGL() 方法

語法

multiDrawElementsInstancedWEBGL(mode,
    countsList, countsOffset,
    type,
    firstsList, firstsOffset,
    instanceCountsList, instanceCountsOffset,
    drawCount)

引數

模式

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

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

countsList

一個 Int32Array 或 Array（包含 GLint 型別的值），指定要渲染的索引數量列表。

countsOffset

一個 GLUint，定義了 countsList 陣列的起始位置。

type

一個 GLenum，指定元素陣列緩衝區中值的型別。可能的值有：

• gl.UNSIGNED_BYTE
• gl.UNSIGNED_SHORT
• 使用 OES_element_index_uint 擴充套件時
  • gl.UNSIGNED_INT

offsetsList

一個 Int32Array 或 Array（包含 GLsizei 型別的值），指定向量點陣列的起始索引列表。

offsetsOffset

一個 GLuint，定義了 offsetsList 陣列的起始位置。

instanceCountsList

一個 Int32Array 或 Array（包含 GLsizei 型別的值），指定要執行的元素範圍的例項數量列表。

instanceCountsOffset

一個 GLuint，定義了 instanceCountsList 陣列的起始位置。

drawCount

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

返回值

無。

異常

• 如果 mode 不是接受的值之一，則會丟擲 gl.INVALID_ENUM 錯誤。
• 如果 drawCount 或 countsList、offsetsList、instanceCountsList 中的條目為負數，則會丟擲 gl.INVALID_VALUE 錯誤。

示例

const counts = new Int32Array(/* … */);
const offsets = new Int32Array(/* … */);
const instanceCounts = new Int32Array(/* … */);
ext.multiDrawElementsInstancedWEBGL(
  gl.TRIANGLES,
  counts,
  0,
  gl.UNSIGNED_SHORT,
  offsets,
  0,
  instanceCounts,
  0,
  counts.length,
);

規範

瀏覽器相容性

另見

• WebGLRenderingContext.drawElements()
• WebGL2RenderingContext.drawElementsInstanced()