glCallLists 関数

  • [アーティクル]

glCallLists 関数は、表示リストのリストを実行します。

構文

void WINAPI glCallLists(
         GLsizei n,
         GLenum  type,
   const GLvoid  *lists
);

パラメーター

n

実行する表示リストの数。

type

リスト内の値の型。 次のシンボリック定数を使用できます。

値 説明
GL_BYTE
 lists パラメーターは、それぞれ -128 ~ 127 の範囲の符号付きバイトの配列として扱われます。
GL_UNSIGNED_BYTE
 lists パラメーターは、それぞれ 0 ~ 255 の範囲の符号なしバイトの配列として扱われます。
GL_SHORT
 lists パラメーターは、符号付き 2 バイト整数の配列として扱われ、それぞれ -32768 から 32767 の範囲になります。
GL_UNSIGNED_SHORT
 lists パラメーターは、0 ~ 65535 の範囲の符号なし 2 バイト整数の配列として扱われます。
GL_INT
 lists パラメーターは、符号付き 4 バイト整数の配列として扱われます。
GL_UNSIGNED_INT
 lists パラメーターは、符号なし 4 バイト整数の配列として扱われます。
GL_FLOAT
 lists パラメーターは、4 バイトの浮動小数点値の配列として扱われます。
GL_2_BYTES
 lists パラメーターは、符号なしバイトの配列として扱われます。 バイトの各ペアは、1 つの表示リスト名を指定します。 ペアの値は、最初のバイトの符号なし値と 2 番目のバイトの符号なし値の 256 倍として計算されます。
GL_3_BYTES
 lists パラメーターは、符号なしバイトの配列として扱われます。 バイトの各トリプレットは、1 つの表示リスト名を指定します。 トリプレットの値は、最初のバイトの符号なし値の 65536 倍、2 番目のバイトの符号なし値と 3 番目のバイトの符号なし値の 256 倍として計算されます。
GL_4_BYTES
 lists パラメーターは、符号なしバイトの配列として扱われます。 各 4 倍のバイトは、1 つの表示リスト名を指定します。 4 つ目の値は、最初のバイトの符号なし値16777216倍、2 番目のバイトの符号なし値の 65536 倍、3 番目のバイトの符号なし値の 256 倍、および 4 番目のバイトの符号なし値として計算されます。

リスト

表示リスト内の名前オフセットの配列のアドレス。 ポインター型は void です。オフセットは、 型の値に応じてバイト、ショーツ、ints、または float にできます。

戻り値

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

注釈

glCallLists 関数を使用すると、リストとして渡された名前のリスト内の各表示リストが実行されます。 その結果、各表示リストに保存された関数は、表示リストを使用せずに呼び出された場合と同様に、順番に実行されます。 定義されていない表示リストの名前は無視されます。

glCallLists 関数は、表示リストを実行するための効率的な手段を提供します。 n パラメーターは、glCallLists が実行するさまざまな名前形式 (型パラメーターで指定) を持つリストの数を指定します。

表示リスト名のリストは null で終わるものではありません。 代わりに、 n はリストから取得する名前の数を指定 します。

glListBase 関数を使用すると、追加レベルの間接参照を使用できるようになります。 glListBase 関数は、その表示リストが実行される前にリストで指定された各表示リスト名に追加される符号なしオフセットを指定します。

glCallLists 関数は、表示リスト内に表示できます。 表示リストが相互に呼び出され、無限再帰が発生する可能性を回避するために、表示リストの実行中に、表示リストの入れ子レベルに制限が設定されます。 この制限は少なくとも 64 である必要があり、実装によって異なります。

OpenGL 状態は、 glCallLists の呼び出し全体で保存および復元されません。 したがって、表示リストの実行中に OpenGL 状態に加えられた変更は、実行が完了した後も残ります。 glCallLists 呼び出し全体で OpenGL 状態を保持するには、glPushAttrib、glPopAttrib、glPushMatrix、glPopMatrix を使用します。

表示リストにこの間隔で許可されている関数のみが含まれている限り、 glBegin の呼び出しと glEnd の対応する呼び出しの間で表示リストを実行できます。

次の関数は 、glCallLists 関数に関連する情報を取得します。

glGet と引数 GL_LIST_BASE

glGet と引数 GL_MAX_LIST_NESTING

glIsList

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Gl.h
ライブラリ
Opengl32.lib
[DLL]
Opengl32.dll

関連項目

glBegin

glCallList

glDeleteLists

glEnd

glGenLists

glGet

glIsList

glListBase

glNewList

glPopAttrib

glPopMatrix

glPushAttrib

glPushMatrix