background_replace()

リソース操作・バックグラウンド

background_replace †

指定のバックグラウンド・リソースを別の画像ファイルに置き換えます

構文 †

background_replace(ind, fname, removeback, smooth);

ind

置き換える先のバックグラウンドのリソース番号

fname

ファイル名

removeback

透過するかどうか

smooth

エッジをスムーズにするかどうか

戻り値 †

N/A

なし

説明 †

この関数は作成済みのバックグラウンドのリソースの画像を上書きします。 これは新規作成ではないため、引数"ind"にはbackground_add()やbackground_create_from_surface()によりあらかじめ作成したものを指定する必要があります。 また、この関数により上書きした場合、元のリソースを復元することはできませんし、このリソースはゲームの最後まで残ることに注意します。

注意点1 †

ターゲット・プラットフォームごとの、ファイルの保存・ロードの詳細についてはファイルの詳細について?を参照して下さい。

注意点2 †

HTML5でこの関数を使用する場合、ブラウザのXSS保護のために、外部のサーバからリソースをロードすると、 ドメイン間でリソースをロードしようとしてブロックすることができますし、返すように表示される場合があることに注意します。

例 †

background_replace(bck_Sky, "Sky_5.png");

上記コードは、バックグラウンド・リソース"bck_Sky"の画像を"Sky_5.png"で上書きします