ReloadGraph

画像ファイルからグラフィックハンドルへ画像データを転送する

val = ReloadGraph(FileName, GrHandle)

FileName : string (wstr)
GrHandle : int (int)

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

解説

既存のグラフィックハンドルに対して、画像ファイルからデータを再読み込み(再転送)する関数です。LoadGraph で最初に読み込んだ画像ファイルを変更した後、ハンドルを作り直さずに画像データだけを更新したい場合に使用します。

【引数の説明】
・FileName: 読み込む画像ファイルのパス(BMP, PNG, JPEG, DDS 等に対応)です。
・GrHandle: 画像データを転送する先のグラフィックハンドルです。LoadGraph 等で事前に作成済みのハンドルを指定します。

【戻り値】
0: 成功、-1: エラー

【注意事項】
・転送先のグラフィックハンドルは事前に作成されている必要があります。
・元の画像サイズと異なるサイズの画像を転送した場合の動作は保証されません。同じサイズの画像を使用してください。
・動的にテクスチャを差し替えたい場合(キャラクターの衣装変更など)に有用です。

【関連関数】
ReloadDivGraph(分割再読み込み)、LoadGraph(画像読み込み・ハンドル作成)、DeleteGraph(グラフィック削除)

戻り値: int

情報

プラグイン / モジュール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