glDrawArrays 函式

glDrawArrays函式會指定要轉譯的多個基本類型。

語法

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

參數

mode

要呈現的基本類型。 下列常數會指定可接受的基本類型：GL_POINTS、GL_LINE_STRIP、GL_LINE_LOOP、GL_LINES、GL_TRIANGLE_STRIP、GL_TRIANGLE_FAN、GL_TRIANGLES、GL_QUAD_STRIP、GL_QUADS和GL_POLYGON。

first

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

計數

要轉譯的索引數目。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_VALUE	count 為負數。
GL_INVALID_ENUM	mode 不是接受的值。
GL_INVALID_OPERATION	在 對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。

備註

使用 glDrawArrays，您可以指定要呈現的多個幾何基本類型。 除了呼叫個別的 OpenGL 函式來傳遞每個個別頂點、一般或色彩，您也可以指定個別的頂點、常態和色彩陣列，以定義一連串的基本類型， (所有相同類型的基本類型，) 與 glDrawArrays的單一呼叫。

當您呼叫 glDrawArrays時，會使用每個已啟用陣列的循序 元素來 建構幾何基本類型的序列，從 第一 個專案開始。 mode參數會指定要建構的基本類型，以及如何使用陣列元素來建構基本類型。

glDrawArrays傳回之後，未定義 glDrawArrays所修改的頂點屬性值。 例如，如果啟用GL_COLOR_ARRAY， 則 glDrawArrays 傳回之後，目前色彩的值就會未定義。 glDrawArrays未修改的屬性會維持定義。 未啟用GL_VERTEX_ARRAY時，不會產生幾何基本類型，但會修改對應至已啟用陣列的屬性。

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

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

雖然當您在 glBegin 和 篩選 配對內指定陣列一次以上時，不會產生任何錯誤，但結果未定義。

規格需求

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

另請參閱

glArrayElement

glBegin

glColorPointer

glEdgeFlagPointer

glEnd

glGetPointerv

glGetString

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer