MV1SetAmbColorScale

モデルのアンビエントカラーのスケール値を設定する

MV1SetAmbColorScale MHandle, Scale

int     MHandle : モデルのハンドル
COLOR_F Scale  : カラースケール値( 0.0f ~ 1.0f = 0% ~ 100% )

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

解説

MHandle のモデルハンドルが示すモデルのマテリアルのアンビエントカラー( 環境光色 )のスケール値を設定します。

例えばこの関数の引数で渡す Scale の 赤、緑、青、α成分の内の 緑とα成分を 1.0f、他を 0.0f にして呼ぶと、
モデル描画時にマテリアル中のアンビエントカラーの緑成分とα成分以外が 0.0f として描画されます。

用途はあまり思いつきませんが、環境光の影響を受けたり受けなかったりを変化させることができます。

因みに、モデルのマテリアルに設定されているアンビエントカラー値に対するスケールなので、
設定対象のモデルのマテリアルに元々アンビエントカラー成分が無い場合( アンビエントカラー成分 r, g, b, a が 0.0f の場合 )はスケール値を何にしても見た目の変化はありません。

戻り値:
  0:成功

関連項目

MV1GetAmbColorScaleモデルのアンビエントカラーのスケール値を取得する(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