WebGLRenderingContext: drawArrays() 方法

語法

drawArrays(mode, first, count)

引數

模式

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

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

注意： 如果 mode 是 POINTS，可能需要設定 gl_PointSize 才能使 drawArrays 進行渲染，因為如果未顯式寫入，其值是未知的。只有部分 GPU 會將其預設值設定為 1.0。

first

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

計數

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

返回值

無（undefined）。

異常

• 如果 mode 不是接受的值之一，則會丟擲 gl.INVALID_ENUM 錯誤。
• 如果 first 或 count 為負數，則會丟擲 gl.INVALID_VALUE 錯誤。
• 如果 gl.CURRENT_PROGRAM 為 null，則會丟擲 gl.INVALID_OPERATION 錯誤。

示例

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

規範

瀏覽器相容性

另見

• WebGLRenderingContext.drawElements()
• ext.drawArraysInstancedANGLE()
• ext.drawElementsInstancedANGLE()
• ext.vertexAttribDivisorANGLE()
• WebGL2RenderingContext.drawArraysInstanced()
• WebGL2RenderingContext.drawElementsInstanced()
• WebGL2RenderingContext.vertexAttribDivisor()
• WEBGL_multi_draw.multiDrawArraysWEBGL()