layer_destroy()

Game Maker Language リファレンス > 組み込み関数 用途別 > リソース操作・ルーム > 一般的なレイヤー関数 > layer_destroy()

layer_destroy() †

この関数は、指定されたレイヤーを破棄します。 レイヤーID（ layer_create() を使用してレイヤーを作成するときに取得する）またはレイヤー名（文字列として。これはパフォーマンスに影響します）を指定すると、現在のルームからレイヤーが削除されます。 レイヤーがルームエディターでデザインされたものである場合、次にルームを離れてから戻るときに、レイヤーは元のコンテンツで再作成されますが、ルームが永続的である場合、レイヤーは削除されません 部屋の持続性は再びオフになります。 この方法でレイヤーを破棄すると、そのコンテンツもすべて削除されるため、背景やタイルマップなどの参照IDは無効になり、レイヤーに割り当てられたインスタンスは破棄されます（破棄を実行します） 同時に発生するイベント（存在する場合）、およびクリーンアップイベント）。

構文 †

layer_destroy(layer_id)

layer_id

破棄するレイヤーID (またはリソース名)

戻り値 †

N/A

なし

例 †

if !instance_exists(obj_Bullet_Parent)
{ 
  layer_destroy(global.Bullet_Layer); 
}

上記コードは、"obj_Bullet_Parent" が存在する場合、レイヤー "Bullet_Layer" を削除します