DeleteGraph

指定のグラフィックをメモリ上から削除する

DeleteGraph GrHandle

GrHandle : メモリ上から削除したいグラフィックのハンドル

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

解説

指定のグラフィックハンドルに対応する画像データをメモリ上から削除する関数です。

【引数の説明】
・GrHandle: 削除したいグラフィックのハンドルです。LoadGraph, LoadDivGraph, MakeGraph, MakeScreen, DerivationGraph 等で取得したハンドルを指定します。

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

【注意事項】
・削除したグラフィックハンドルを使用して描画関数を呼び出すとエラーになります。
・DerivationGraph で派生元のグラフィックを削除すると、派生先のグラフィックも使用不能になる場合があります。
・不要になったグラフィックはこまめに削除することで、VRAMやメインメモリの消費を抑えられます。
・全グラフィックを一括削除したい場合は InitGraph を使用してください。
・MakeScreen で作成した描画対象用グラフィックも、この関数で削除できます。

【関連関数】
InitGraph（全グラフィック削除）、LoadGraph（画像読み込み）、MakeGraph（空グラフィック作成）、MakeScreen（描画対象グラフィック作成）

戻り値:
  ０：成功

関連項目

情報