glNewList 関数

  • [アーティクル]

glNewList 関数と glEndList 関数は、表示リストを作成または置換します。

構文

void WINAPI glNewList(
   GLuint list,
   GLenum mode
);

パラメーター

list

表示リスト名。

mode

コンパイル モード。 次の値を使用できます。

値 説明
GL_COMPILE
 コマンドは単にコンパイルされます。
GL_COMPILE_AND_EXECUTE
 コマンドは、表示リストにコンパイルされると実行されます。

戻り値

この関数は値を返しません。

エラー コード

glGetError 関数では、次のエラー コードを取得できます。

名前 意味
GL_INVALID_VALUE
 list は 0 でした。
GL_INVALID_ENUM
 mode が受け入れられた値ではありません。
GL_INVALID_OPERATION
 この関数は、 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 [デスクトップ アプリのみ]
ヘッダー
Gl.h
ライブラリ
Opengl32.lib
[DLL]
Opengl32.dll

関連項目

glBegin

glCallList

glCallLists

glDeleteLists

glEnd

glEndList

glGenLists

glIsList