layer_set_target_room()

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

layer_set_target_room() †

この関数を呼び出すと、それ以降のすべてのレイヤー関数は指定された Room に適用する必要があることがGameMaker Studio 2に通知されます。 このようにして、現在の Room ではない Room のレイヤーとレイヤーコンテンツを手順に従って変更または生成できます。 Room へのレイヤーまたはレイヤー要素の追加が終了したら、関数 layer_reset_target_room() を呼び出して Room のターゲットをリセットします（または、Room の引数に "-1" を指定してこの関数をもう一度呼び出します）。

警告！

別の部屋をターゲットにしている間は、instance_create_layer() または instance_create_depth() を使用してインスタンスを作成できません。またレイヤー関数layer_add_instance() も使用できません

構文 †

layer_set_target_room(room)

room

ルームインデックス

戻り値 †

N/A

なし

例 †

layer_set_target_room(rm_Game);
var l = layer_get_id("SpriteAssets");
repeat(50)
{
  layer_sprite_create(l, random(room_get_width(rm_Game)), random(room_get_height(rm_Game)), spr_Trees);
}
layer_reset_target_room();

上記のコードは、ターゲットルームをルーム "rm_Game" に設定し、そのルームの "SpriteAssets" と呼ばれるレイヤーのレイヤーIDを取得します。 このレイヤーIDは、レイヤーターゲットが現在の部屋にリセットされる前に、50個のランダムなスプライトアセットをレイヤーに追加するために使用されます。