SetGlobalAmbientLight

グローバルアンビエントライトカラーを設定する

SetGlobalAmbientLight Color

COLOR_F Color : グローバルアンビエントライトカラー( 各色 0.0f ~ 1.0f )

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

解説

すべてのモデルに適用されるアンビエントカラー( 環境光色 )を設定します。

各ライトの設定にもアンビエントカラーはありますが、
この値はその値に加算されます。( 初期値は真っ黒( Color のメンバ変数 r g b がすべて 0.0f )です )

引数の COLOR_F は float r, g, b, a を持つ構造体です。

これの実体を定義してメンバ変数に値を代入して引数に渡す、と言うことをすると非常に面倒なので、
引数に r, g, b, a の値を渡すと COLOR_F 構造体を戻り値として返す関数 GetColorF を使用すると便利です。
( 因みにライト関係の関数では a の値は使われません )

値を大きくすればするほど、マテリアルに設定されたアンビエントカラーの影響が大きくなります。

逆に、この値を何にしてもマテリアルのアンビエントカラーが真っ黒だとなにも見た目は変わりません。

戻り値:
  0:成功

関連項目

SetLightDirection標準ライトの方向を設定する(DxLibW)
SetLightDifColor標準ライトのディフューズカラーを設定する(DxLibW)
SetLightSpcColor標準ライトのスペキュラカラーを設定する(DxLibW)
SetLightAmbColor標準ライトのアンビエントカラーを設定する(DxLibW)
SetLightEnable標準ライトの有効、無効をセットする(DxLibW)

情報

プラグイン / モジュールDxLibW
バージョン3.24f
作成日2026/04/12
著作者DxLib: Takumi Yamada / HSP binding: IronHSP Project
URLhttps://dxlib.xsrv.jp/
備考hspdxlib.as をインクルードして使用
タイプDxLib ゲームライブラリ
グループDxLib その他
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\hspdxlib.hs