GetLightAmbColorHandle

ライトハンドルのライトのアンビエントカラーを取得する

val = GetLightAmbColorHandle(LHandle)

int LHandle : ライトハンドル

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

解説

ライトハンドルで指定したライトのアンビエントカラー(環境光色)を取得します。

アンビエントカラーは光が直接当たらない部分の基本的な明るさ(間接光)です。
戻り値は COLOR_F 構造体(r, g, b, a)です。

戻り値: アンビエントカラー(COLOR_F)

関連関数: SetLightAmbColorHandle, GetLightDifColorHandle

※ この関数は #cfuncst (COLOR_F) で宣言されています。
戻り値は構造体 COLOR_F (16バイト) です。

代入するだけで自動的に構造体変数が作成されます:
  v = GetLightAmbColorHandle(...)   ; auto dim + copy
代入後はメンバにアクセスできます:
  mes v->r
  mes v->g
  mes v->b
  ...

関連項目

SetLightAmbColorHandleライトハンドルのライトのアンビエントカラーを設定する(DxLibW)

情報

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