glNewList 関数
glNewList 関数と glEndList 関数は、表示リストを作成または置換します。
構文
void WINAPI glNewList(
GLuint list,
GLenum mode
);
パラメーター
-
list
-
表示リスト名。
-
mode
-
コンパイル モード。 次の値を使用できます。
値 説明 - GL_COMPILE
コマンドは単にコンパイルされます。 - GL_COMPILE_AND_EXECUTE
コマンドは、表示リストにコンパイルされると実行されます。
戻り値
この関数は値を返しません。
エラー コード
glGetError 関数では、次のエラー コードを取得できます。
| 名前 | 意味 |
|---|---|
|
list は 0 でした。 |
|
mode が受け入れられた値ではありません。 |
|
この関数は、 glBegin の呼び出しと glEnd の対応する呼び出しの間で呼び出されました。 |
解説
表示リストは、後続の実行のために格納されている OpenGL コマンドのグループです。 表示リストは glNewList を使用して作成されます。 後続のすべてのコマンドは、 glEndList が呼び出されるまで、発行された順序で表示リストに配置されます。
glNewList 関数には、2 つのパラメーターがあります。 最初のパラメーター list は、表示リストの一意の名前になる正の整数です。 glGenList を使用して名前を作成して予約し、glIsList で一意かどうかをテストできます。 2 番目のパラメーター mode は、前の 2 つの値のいずれかを想定できるシンボリック定数です。
特定のコマンドは表示リストにコンパイルされませんが、表示リスト モードに関係なく、すぐに実行されます。 これらのコマンドは、 glColorPointer、 glDeleteLists、 glDisableClientState、 glEdgeFlagPointer、 glEnableClientState、 glFeedbackBuffer、 glFinish、 glFlush、 glGenLists、 glIndexPointer、 glInterleavedArrays、 glIsEnabled、 glIsList、 glNormalPointer、 glPopClientAttrib、 glPixelStore、 glPushClientAttrib、glPushClientAttrib、 glReadPixels、 glRenderMode、 glSelectBuffer、 glTexCoordPointer、 glVertexPointer、およびすべての glGet ルーチン。
同様に、 glTexImage2D と glTexImage1D は直ちに実行され、最初の引数がGL_PROXY_TEXTURE_2DまたはGL_PROXY_TEXTURE_1Dされると、表示リストにコンパイルされません。
glEndList 関数が検出されると、リストを一意の名前リスト (glNewList コマンドで指定) に関連付けることで、表示リスト定義が完了します。 名前リストを含む表示 リスト が既に存在する場合は、 glEndList が呼び出された場合にのみ置き換えられます。
glCallList 関数と glCallLists 関数は、表示リストに入力できます。 glCallList または glCallLists によって実行される表示リストまたはリスト内のコマンドは、リスト作成モードがGL_COMPILE_AND_EXECUTEされている場合でも、作成中の表示リストには含まれません。
次の関数は、 glNewList に関連する情報を取得します。
引数GL_MATRIX_MODEを含む glGet
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|