sprite_duplicate()

リソース操作・スプライト

sprite_duplicate †

指定のスプライトを複製します

構文 †

sprite_duplicate(index);

index

複製するスプライトのインデックス番号

戻り値 †

Real

複製したスプライトのインデックス番号。失敗したら「-1」

説明 †

この関数は指定のスプライトを複製し、そのインデックス番号を返します。 もし複製に失敗した場合は「-1」を返します。 この関数は変更前のスプライト情報を複製します。 そのため、変更後の情報、例えば境界ボックスやアルファ値の変更などの情報を引き継ぎたい場合は、それぞれを個別にコピーする必要があります

注意点 †

この関数で動的にロードし不要なスプライトを削除しないと、メモリリークとなり、ゲームのパフォーマンス低下、 ひいてはゲームをクラッシュさせる危険性があります。 そのため、不要なスプライトはsprite_delete()で削除する必要があります。

例 †

new_spr = sprite_duplicate(sprite_index)

上記コードは、現在のインスタンスのスプライトを複製し、変数"new_spr"に新しいスプライトのインデックス番号を格納します。