英語で読む

次の方法で共有


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 つの値のいずれかを想定できるシンボリック定数です。

特定のコマンドは表示リストにコンパイルされませんが、表示リスト モードに関係なく、すぐに実行されます。 これらのコマンドは、 glColorPointerglDeleteListsglDisableClientStateglEdgeFlagPointerglEnableClientStateglFeedbackBufferglFinishglFlushglGenListsglIndexPointerglInterleavedArraysglIsEnabledglIsListglNormalPointerglPopClientAttribglPixelStoreglPushClientAttrib、glPushClientAttribglReadPixelsglRenderModeglSelectBufferglTexCoordPointerglVertexPointer、およびすべての glGet ルーチン。

同様に、 glTexImage2DglTexImage1D は直ちに実行され、最初の引数が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