glBegin 函式

GlBeginglend函式會分隔基本或類似基本類型群組的頂點。

語法

void WINAPI glBegin(
   GLenum mode
);

參數

mode

將從 glBegin 和後續 glend之間顯示的頂點建立的基本或基本。 以下是接受的符號常數及其意義:

意義
GL _ 點
將每個頂點視為單一點。 頂點 n 定義點 n。 會繪製 N 個點。
GL _ 行
將每一對頂點視為獨立的線段。 頂點 2n-12n 定義第 n 行。 會繪製 N/2 行。
GL _ 行 _ 帶
從第一個頂點到最後一個頂點,繪製一組連接的線段。 頂點 nn + 1 定義行 n。 會繪製 n-1 行。
GL _ 線路 _ 迴圈
繪製從第一個頂點到最後一個頂點的已連接線段群組,然後回到第一個頂點。 頂點 nn + 1 定義行 n。 但是,最後一行是由頂點 N1 所定義。 會繪製 N 行。
GL _ 三角形
將每個三個頂點視為獨立的三角形。 頂點 3n-23n-13n 定義三角形 n。 會繪製 N/3 個三角形。
GL _ 三角形 _ 條紋
繪製一組已連接的三角形。 針對前兩個頂點之後所呈現的每個頂點,各定義一個三角形。 若是奇數 n、頂點 nn + 1n + 2 ,請定義三角形 n。 針對偶數 頂點 n + 1nn + 2 定義三角形 n。 會繪製 N-2 個三角形。
GL _ 三角形 _ 風扇
繪製一組已連接的三角形。 針對前兩個頂點之後所呈現的每個頂點,各定義一個三角形。 頂點 1n + 1n + 2 定義三角形 n。 會繪製 N-2 個三角形。
GL _ 四邊形
將四個頂點的每個群組視為獨立四邊形。 頂點 4n-34n-24n-14n 定義四邊形 n。 會繪製 N/4 quadrilaterals。
GL _ 四 _ 條
繪製連接的 quadrilaterals 群組。 針對第一組之後所顯示的每一對頂點,定義一個四邊形。 頂點 2n-12n2n + 22n + 1 定義四邊形 n。 會繪製 N/2-1 個 quadrilaterals。 請注意,用來從資料四邊形中建立頂點的順序,與獨立資料所使用的順序不同。
GL _ 多邊形
繪製單一的凸邊。 頂點 1N 定義了這個多邊形。

傳回值

此函式不會傳回值。

錯誤碼

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

Name 意義
GL _ 無效 _ 列舉
模式 已設定為不接受的值。
GL _ 不正確 _ 操作
GlVertexglColorglIndexglNormalglTexCoordglEvalCoordglEvalPointglMaterialglEdgeFlagglCallListglCallLists以外的函式會在 glBegin 與對應的 glend之間呼叫。 函數 glend 是在呼叫對應的 glBegin 之前呼叫,或在 glBegin / glend 序列內呼叫 glBegin。

備註

GlBeginglend函式會分隔定義基本或類似基本類型群組的頂點。 GlBegin 函式會接受單一引數,以指定頂點所組成的10個基本類型。 從1開始,將 n 做為整數計數,而 n 則是指定的頂點總數,如下所示:

  • 您只能在 glBeginGlend之間使用 OpenGL 函數的子集。 您可以使用的函數如下:

    glVertex

    glColor

    glIndex

    glNormal

    glTexCoord

    glEvalCoord

    glEvalPoint

    glMaterial

    glEdgeFlag

    您也可以使用 glCallListglCallLists 來執行只包含上述函式的顯示清單。 如果在 glBeginglend之間呼叫任何其他 OpenGL 函數,則會設定錯誤旗標,並忽略函式。

  • 無論在 glBegin 中為 模式 選擇的值為何,您可以在 glBeginglend之間定義的頂點數目沒有任何限制。 未完整指定的線條、三角形、quadrilaterals 和多邊形都不會繪製。 當提供的頂點太少以指定單一基本或指定了不正確的頂點倍數時,不完整的規格結果。 忽略不完整的基本類型;繪製完整的基本專案。

  • 每個基本類型頂點的最小規格為:

    頂點的最小數目 基本類型
    1
    2 line
    3 三角形
    4 四邊形
    3 多邊形
  • 需要特定多個頂點的模式為 GL _ 行 (2) 、gl _ 三角形 (3) 、gl _ 四邊形 (4) 和 GL 四 _ _ 個 () 。

規格需求

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

另請參閱

glCallList

glCallLists

glColor

glEdgeFlag

glEnd

glEvalCoord

glEvalPoint

glIndex

glMaterial

glNormal

glTexCoord

glVertex