glBegin

glBegin と glEnd 関数はプリミティブまたは同種プリミティブ群の頂点を区切る。

glBegin mode

mode : [int] glBegin と後続の glEnd の間で指定された頂点から生成されるプリミティブ。受け付けるシンボル定数と意味は次のとおり。GL_POINTS: 各頂点を単一点として扱う。頂点 n が点 n を定義し、N 個の点が描画される。GL_LINES: 各頂点ペアを独立した線分として扱う。頂点 2n-1, 2n が線 n を定義し、N/2 本描画される。GL_LINE_STRIP: 最初の頂点から最後へ接続された線分群を描画する。頂点 n, n+1 が線 n を定義し、N-1 本描画される。GL_LINE_LOOP: 最初の頂点から最後へ、さらに最初に戻る接続線分群。最終線は頂点 N と 1 で定義され、N 本描画される。GL_TRIANGLES: 頂点を 3 個ずつ独立した三角形として扱う。頂点 3n-2, 3n-1, 3n が三角形 n を定義し、N/3 個描画される。GL_TRIANGLE_STRIP: 接続された三角形群。最初の 2 頂点以降、1 頂点ごとに三角形を 1 個定義する。奇数 n では頂点 n, n+1, n+2、偶数 n では n+1, n, n+2 で三角形 n を定義し、N-2 個描画される。GL_TRIANGLE_FAN: 接続された三角形群。頂点 1, n+1, n+2 で三角形 n を定義し、N-2 個描画される。GL_QUADS: 頂点を 4 個ずつ独立した四角形として扱う。頂点 4n-3, 4n-2, 4n-1, 4n で四角形 n を定義し、N/4 個描画される。GL_QUAD_STRIP: 接続された四角形群。最初のペア以降、1 頂点ペアごとに 1 個の四角形を定義する。頂点 2n-1, 2n, 2n+2, 2n+1 で四角形 n を定義し、N/2-1 個描画される。頂点の使用順が独立データの場合と異なる点に注意。GL_POLYGON: 単一の凸ポリゴンを描画する。頂点 1 から N がポリゴンを定義する。

(プラグイン / モジュール : opengl32.dll)

解説

glBegin と glEnd 関数はプリミティブまたは同種プリミティブ群の頂点を区切る。

[戻り値]
この関数は値を返さない。

[備考]
glBegin と glEnd はプリミティブまたは同種プリミティブ群を定義する頂点を区切る。glBegin は mode 引数を 1
つ受け取り、10 種類のプリミティブのいずれを構成するかを指定する。glBegin と glEnd の間で利用可能な関数は
glVertex、glColor、glIndex、glNormal、glTexCoord、glEvalCoord、glEvalPoint、glMaterial、glEdgeFlag
の各ファミリに限られる。これら以外を含む表示リストを glCallList / glCallLists で実行することも可能。それ以外の
OpenGL 関数を呼び出すとエラーフラグがセットされ呼び出しは無視される。mode の値に関わらず glBegin / glEnd
間の頂点数に上限はない。不完全に指定された線・三角形・四角形・ポリゴンは描画されない。プリミティブごとの最小頂点数: 点 1、線
2、三角形 3、四角形 4、ポリゴン 3。特定倍数が必要なモード: GL_LINES (2)、GL_TRIANGLES
(3)、GL_QUADS (4)、GL_QUAD_STRIP (2)。

情報