CreateDirLightHandle

ディレクショナルタイプのライトハンドルを作成する

val = CreateDirLightHandle(Direction)

VECTOR Direction ： ライトの方向

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

解説

ディレクショナルタイプのライトハンドルを作成します。
( ディレクショナルライトとは位置を持たず方向だけを設定するライトで、
太陽の光などの光源が遠すぎて何処に居ても同じ方向から照らされるライト効果などに使用します )

この関数は戻り値にライトハンドル( int 型の数値 )を返してきます。

ライトハンドルの設定を変更したり、
不要になったライトハンドルを削除したりする際に必要になりますので戻り値は必ず何かしらの変数に保存しておくようにしてください。

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

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

尚、ライトハンドル系の関数は一つしかない標準ライト以外にライトを使用したい場合に使用します。
( とはいえ同時に有効にできるのは標準ライトを含めて３つまでですが・・・ )

戻り値:
  ０以上：ライトハンドル

情報