glGetLightfv 関数

glGetLightfv 関数と glGetLightiv 関数は、光源パラメーター値を返します。

構文

void WINAPI glGetLightfv(
   GLenum  light,
   GLenum  pname,
   GLfloat *params
);

パラメーター

light

光源。 使用可能なライトの数は実装によって異なりますが、少なくとも 8 つのライトがサポートされています。 これらは、0 = i< GL_MAX_LIGHTS GL_LIGHT形式のシンボル名によって識別されます。

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_POSITION	params パラメーターは、光源の位置を表す 4 つの整数または浮動小数点値を返します。 要求された整数値は、内部浮動小数点値を最も近い整数値に丸めることで計算されます。 返される値は、目の座標で維持される値です。 これらは、glLight が呼び出された時点でモデルビュー マトリックスが識別されない限り、glLight を使用して指定された値と等しくありません。
GL_SPOT_DIRECTION	params パラメーターは、光源の方向を表す 3 つの整数または浮動小数点値を返します。 要求された整数値は、内部浮動小数点値を最も近い整数値に丸めることで計算されます。 返される値は、目の座標で維持される値です。 これらは、glLight が呼び出された時点でモデルビュー マトリックスが識別されない限り、glLight を使用して指定された値と等しくありません。 スポット方向は照明式で使用される前に正規化されますが、返される値は正規化の前に指定された値の変換されたバージョンです。
GL_SPOT_EXPONENT	params パラメーターは、ライトのスポット指数を表す単一の整数または浮動小数点値を返します。 要求された場合、整数値は、内部浮動小数点表現を最も近い整数に丸めることで計算されます。
GL_SPOT_CUTOFF	params パラメーターは、ライトのスポット カットオフ角度を表す単一の整数または浮動小数点値を返します。 要求された場合、整数値は、内部浮動小数点表現を最も近い整数に丸めることで計算されます。
GL_CONSTANT_ATTENUATION	params パラメーターは、ライトの定数 (距離に関連しない) 減衰を表す単一の整数または浮動小数点値を返します。 要求された場合、整数値は、内部浮動小数点表現を最も近い整数に丸めることで計算されます。
GL_LINEAR_ATTENUATION	params パラメーターは、光の線形減衰を表す単一の整数または浮動小数点値を返します。 要求された場合、整数値は、内部浮動小数点表現を最も近い整数に丸めることで計算されます。
GL_QUADRATIC_ATTENUATION	params パラメーターは、光の 2 次減衰を表す単一の整数または浮動小数点値を返します。 要求された場合、整数値は、内部浮動小数点表現を最も近い整数に丸めることで計算されます。

params

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

戻り値

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

注釈

glGetLight 関数は、光源パラメーターの値または値をパラメーターで返します。 light パラメーターは light という名前を付け、0 = i< GL_MAX_LIGHTSの場合はi GL_LIGHT形式のシンボル名です。ここで、GL_MAX_LIGHTSは 8 以上の実装依存定数です。 pname パラメーターは、10 個の光源パラメーターのうちの 1 つをシンボリック名で指定します。

i = GL_LIGHT0 +i をGL_LIGHTする場合は常 にです。

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

必要条件

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

関連項目

glBegin

glEnd

glLight