次の方法で共有

glGetMaterialiv 関数

  • [アーティクル]

glGetMaterialfv 関数と glGetMaterialiv 関数は、マテリアル パラメーターを返します。

構文

void WINAPI glGetMaterialiv(
   GLenum face,
   GLenum pname,
   GLint  *params
);

パラメーター

顔

クエリを実行する 2 つの資料のうちどれを指定します。 GL_FRONTまたはGL_BACKは、それぞれ前面と背面の材料を表します。

pname

返すマテリアル パラメーター。 次の値を使用できます。

値 説明
GL_AMBIENT
 params パラメーターは、マテリアルのアンビエント反射率を表す 4 つの整数または浮動小数点値を返します。 整数値は、要求されると、内部浮動小数点表現から線形にマップされます。これにより、1.0 は最も正の表現可能な整数値にマップされ、-1.0 は最も負の表現可能な整数値にマップされます。 内部値が [-1,1] の範囲外の場合、対応する整数値は未定義です。
GL_DIFFUSE
 params パラメーターは、マテリアルの拡散反射率を表す 4 つの整数または浮動小数点値を返します。 整数値は、要求されると、内部浮動小数点表現から線形にマップされます。これにより、1.0 は最も正の表現可能な整数値にマップされ、-1.0 は最も負の表現可能な整数値にマップされます。 内部値が [-1,1] の範囲外の場合、対応する整数値は未定義です。
GL_SPECULAR
 params パラメーターは、マテリアルの反射反射率を表す 4 つの整数または浮動小数点値を返します。 整数値は、要求されると、内部浮動小数点表現から線形にマップされます。これにより、1.0 は最も正の表現可能な整数値にマップされ、-1.0 は最も負の表現可能な整数値にマップされます。 内部値が [-1,1] の範囲外の場合、対応する整数値は未定義です。
GL_EMISSION
 params パラメーターは、マテリアルの放射光強度を表す 4 つの整数または浮動小数点値を返します。 整数値は、要求されると、内部浮動小数点表現から線形にマップされます。これにより、1.0 は最も正の表現可能な整数値にマップされ、-1.0 は最も負の表現可能な整数値にマップされます。 内部値が [-1,1] の範囲外の場合、対応する整数値は未定義です。
GL_SHININESS
 params パラメーターは、マテリアルの反射指数を表す 1 つの整数または浮動小数点値を返します。 整数値は、要求されると、内部浮動小数点値を最も近い整数値に丸めることで計算されます。
GL_COLOR_INDEXES
 params パラメーターは、マテリアルのアンビエント インデックス、拡散インデックス、および反射インデックスを表す 3 つの整数または浮動小数点値を返します。 これらのインデックスは、カラー インデックス照明にのみ使用します。 (その他のパラメーターはすべて、RGBA 照明にのみ使用されます)。整数値は、要求されると、内部浮動小数点値を最も近い整数値に丸めることで計算されます。

params

要求されたデータを返します。

戻り値

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

エラー コード

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

Name 意味
GL_INVALID_ENUM
 ターゲット または クエリ が受け入れ可能な値ではなかった。
GL_INVALID_OPERATION
 glBegin の呼び出しと glEnd の対応する呼び出しの間に関数が呼び出されました。

注釈

glGetMaterial 関数は、材料面のパラメーター pname の値をパラメーターで返します。

エラーが生成された場合、 パラメーターの内容は変更されません。

要件

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

こちらもご覧ください

glBegin

glEnd

glMaterial