glDrawArrays 函式

GlDrawArrays 函數會指定多個要轉譯的基本專案。

語法

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

參數

mode

要轉譯的基本類型。 下列常數指定可接受的基本類型: GL _ 點、gl _ 行 _ 帶、gl _ 線 _ 迴圈、gl _ 線、gl _ 三角形區域 _ 、gl _ 三角形 _ 風扇、gl _ 三角形、gl _ 四個區域 _ 、gl _ 四邊形和 gl _ 多邊形。

first

啟用的陣列中的起始索引。

計數

要呈現的索引數目。

傳回值

此函式不會傳回值。

錯誤碼

GlGetError函式可以取出下列錯誤碼。

名稱 意義
GL _ 無效 _ 值
計數 為負數。
GL _ 無效 _ 列舉
模式 不是可接受的值。
GL _ 不正確 _ 操作
呼叫 glBegin 和對應的 glEnd呼叫之間呼叫了函數。

備註

使用 glDrawArrays,您可以指定多個幾何基本型別來呈現。 除了呼叫個別的 OpenGL 函式來傳遞每個個別頂點、一般或色彩之外,您還可以指定不同的頂點、法線和色彩陣列,以定義一系列的基本專案, (所有相同種類) 與 glDrawArrays 的單一呼叫。

當您呼叫 glDrawArrays 時,會使用每個已啟用陣列的連續元素 計數 ,從 第一個 元素開始,用來建立一系列幾何基本專案。 Mode 參數指定要建立的基本類型,以及如何使用陣列元素來建立基本專案。

GlDrawArrays 傳回之後,由 glDrawArrays 修改的頂點屬性值為未定義。 例如,如果 _ _ 已啟用 GL 色彩陣列,則在 glDrawArrays 傳回之後,目前色彩的值會是未定義的。 GlDrawArrays 未修改的屬性仍會定義。 如果 _ _ 未啟用 GL 頂點陣列,則不會產生任何幾何基本專案,但是會修改對應至已啟用陣列的屬性。

您可以在顯示清單中包含 glDrawArrays 。 當您在顯示清單中包含 glDrawArrays 時,會在顯示清單中產生並輸入必要的陣列資料(由陣列指標和啟用所決定)。 陣列指標和啟用的值會在建立顯示清單期間決定。

您可以隨時讀取靜態陣列資料。 如果已修改任何靜態陣列元素,且未再次指定陣列,則任何後續呼叫 glDrawArrays 的結果都是未定義的。

雖然當您在 glBeginglend 配對中多次指定陣列時,不會產生任何錯誤,但結果是未定義的。

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
標頭
Gl
程式庫
Opengl32 .lib
DLL
Opengl32.dll

另請參閱

glArrayElement

glBegin

glColorPointer

glEdgeFlagPointer

glEnd

glGetPointerv

glGetString

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer