ChangeLightTypePoint

標準ライトのタイプをポイントライトにする

ChangeLightTypePoint Position, Range, Atten0, Atten1, Atten2

VECTOR Position ： ライトの位置
float Range ： ライトの有効距離
float Atten0 ： 距離減衰パラメータ０
float Atten1 ： 距離減衰パラメータ１
float Atten2 ： 距離減衰パラメータ２

(プラグイン / モジュール : DxLibW)

解説

標準ライトのタイプを位置と距離減衰パラメータを持つポイントライトにします。

ディレクショナルライトの次に使用頻度の高い、
指定した位置から全方向に光を放つライトです。

引数の説明をします。

VECTER Position

ポイントライトの位置です。

float Range

ポイントライトの影響最大距離です。

この引数で指定する距離以上の座標にある頂点は、
例え距離減衰計算の結果が０ではなくてもライトの影響は無くなります。

float Atten0

float Atten1

float Atten2

ライトの影響力の距離減衰パラメータです( Atten は Attenuation の略です )。

ディレクショナルライト以外のライトはライトの位置から離れれば離れるほどライトの影響が弱くなるようになっています。

その計算式は以下のようなものです。

d = ライトから頂点への距離
ライトの影響力(％) = 100.0f / ( Atten0 + Atten1 * d + Atten2 * d * d )

つまり、Atten0 はライトと頂点の距離に関係なく減衰する率を指定する引数、
Atten1 はライトの距離に比例して減衰する率、
Atten2 はライトの距離の二乗に比例して減衰する率となります。

率を除算する値ですので、
非常に小さな値でも物凄くライトの影響範囲が狭まります。
なので引数に渡す値はこの式を理解してから決定してください。

尚、引数 Position は float x, y, z の三つのメンバ変数を持っている構造体 VECTOR で、
この３要素を使用して３次元の座標を指定します。

引数が構造体だと事前に引数に渡す構造体を宣言してメンバ変数に値を代入して・・・と準備が面倒ですが、
引数に x, y, z の値を渡すとそれを元にした VECTOR 構造体を戻り値で返してくれる関数 VGet を使用することで簡素に引数を渡すことができます。

戻り値:
  ０：成功

関連項目

情報