Share via

glGetColorTableParameterivEXT 関数

  • [アーティクル]

glGetColorTableParameterfvEXT 関数と glGetColorTableParameterivEXT 関数は、カラー テーブルからパレット パラメーターを取得します。

構文

void WINAPI glGetColorTableParameterivEXT(
   GLenum target,
   GLenum pname,
   GLint  *params
);

パラメーター

target

パラメーター データが必要なパレットのターゲット テクスチャ。 TEXTURE_1D、TEXTURE_2D、PROXY_TEXTURE_1D、またはPROXY_TEXTURE_2Dである必要があります。

pname

パラメーターが指すパレット パラメーター データの種類のシンボリック定数。

受け入れられるシンボリック定数とその意味を次に示します。

値 説明
GL_COLOR_TABLE_FORMAT_EXT
 glColorTableEXT の最新の呼び出しまたは既定値で指定された内部形式を返します。
GL_COLOR_TABLE_WIDTH_EXT
 現在のパレットの幅を返します。
GL_COLOR_TABLE_RED_SIZE_EXT
 パレット データの赤いコンポーネントを格納するために内部的に使用される実際のサイズを返します。
GL_COLOR_TABLE_GREEN_SIZE_EXT
 パレット データの緑のコンポーネントを格納するために内部的に使用される実際のサイズを返します。
GL_COLOR_TABLE_BLUE_SIZE_EXT
 パレット データの青いコンポーネントを格納するために内部的に使用される実際のサイズを返します。
GL_COLOR_TABLE_ALPHA_SIZE_EXT
 パレット データのアルファ コンポーネントを格納するために内部的に使用される実際のサイズを返します。

params

pname パラメーターで指定されたカラー テーブル パラメーター データをポイントします。

戻り値

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

注釈

glGetColorTableParameterivEXT 関数と glGetColorTableParameterfvEXT 関数を使用して、対象のテクスチャ パレット用に glColorTableEXT で設定されたカラー テーブルから特定のパラメーター データを取得します。 また、これらの関数を使用して、 glGetColorTableEXT が返すカラー テーブル エントリの数を決定することもできます。

ターゲット パラメーターがGL_PROXY_TEXTURE_1DまたはGL_PROXY_TEXTURE_2Dであり、実装で書式または幅に指定された値がサポートされていない場合、glColorTableEXT は要求されたカラー テーブルの作成に失敗する可能性があります。 この場合、カラー テーブルは空であり、取得されるすべてのパラメーターは 0 になります。 OpenGL で特定のカラー テーブルの形式とサイズがサポートされているかどうかを確認するには、プロキシ ターゲットで glColorTableEXT を呼び出し、 glGetColorTableParameterivEXT または glGetColorTableParameterfvEXT を呼び出して、width パラメーターが glColorTableEXT によって設定されたと一致するかどうかを判断します。 取得した幅が 0 の場合、 glColorTable によるカラー テーブルの要求は失敗しました。 取得した幅が 0 でない場合は、実際のターゲットで glColorTable を呼び出し、TEXTURE_1DまたはTEXTURE_2Dしてカラー テーブルを設定できます。

glGetColorTableParameterivEXT 関数と glGetColorTableParameterfvEXT 関数は、標準の OpenGL ライブラリの一部ではありませんが、GL_EXT_paletted_texture拡張機能の一部である拡張関数です。 OpenGL の実装で glGetColorTableParameterivEXT と glGetColorTableParameterfvEXT がサポートされているかどうかをチェックするには、glGetString(GL_EXTENSIONS)を呼び出します。 GL_EXT_paletted_textureを返す場合は、 glGetColorTableParameterivEXT と glGetColorTableParameterfvEXT がサポートされます。 拡張関数の関数アドレスを取得するには、 wglGetProcAddress を呼び出します。

必要条件

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

関連項目

glColorSubTableEXT

glColorTableEXT

glGetColorTableEXT

glGetColorTableParameterfvEXT

wglGetProcAddress