OpenGL API - glDrawArrays

https://www.khronos.org/registry/OpenGL-Refpages/gl4/html/glDrawArrays.xhtml

OpenGL API - 筆記彙總

名稱

glDrawArrays ---- 從緩存數組數據中渲染圖元。

原型

void glDrawArrays(	GLenum mode,
				 	GLint first,
				 	GLsizei count);

參數

mode
指定需要渲染什麼圖元。符號常量 GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_LINE_STRIP_ADJACENCY, GL_LINES_ADJACENCY, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_TRIANGLES, GL_TRIANGLE_STRIP_ADJACENCY, GL_TRIANGLES_ADJACENCY 和 GL_PATCHES 都是可接受的。
first
指定啓用的緩存數組的開始索引。
count
指定渲染用的索引數量。

描述

當調用 glDrawArrays 時，將從使用第 first 個元素開始，count 個啓用的數據的序列元素來構成一個幾何圖元序列。mode指定圖元是什麼類型的，和如何構成圖元的。

注意

GL_LINE_STRIP_ADJACENCY, GL_LINES_ADJACENCY, GL_TRIANGLE_STRIP_ADJACENCY 和 GL_TRIANGLES_ADJACENCY 僅能用於 GL 3.2 或以上的版本。

錯誤

如果 mode 是不可接受的值，將生成 GL_INVALID_ENUM 錯誤。

如果 count 是負數，將生成 GL_INVALID_VALUE 錯誤。

如果綁定了一個非空的，啓用的緩存對象名稱，且緩存對象數據儲存是當前的映射，將生成 GL_INVALID_OPERATION 錯誤。

如果geometry shader 激活了，且 mode 是 geometry shader 中不兼容的圖元類型，將生成 GL_INVALID_OPERATION 錯誤。