layer_add_instance()

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

layer_add_instance() †

この関数を使用して、特定のインスタンスを現在あるレイヤーから別のレイヤーに移動できます。 レイヤーID（ layer_create() を使用してレイヤーを作成するときに取得する）またはレイヤー名（文字列として。これはパフォーマンスに影響します）およびレイヤー間を移動するインスタンスのインスタンスIDを指定します。 たとえば、プレーヤーが別のレイヤーよりも奥行きの浅いレイヤーにあり、2つのレイヤーの間のレイヤーの後ろに表示したいとします。 この関数を使用して、プレーヤーを前景レイヤーから背景レイヤーに切り替え、描画されている他のレイヤーの後ろに表示させることができます。

注意

この関数を使用して、レイヤーに新しいインスタンスを追加することはできません。 以前にインスタンスを作成し、そのIDを変数に保存しておく必要があります。

注意

この関数は、現在のルームのスコープ内でのみ有効であり、layer_set_target_room() 関数を使用してスコープが変更されている場合は使用できません。

※注意

この関数でインスタンスをレイヤーに登録すると、そのレイヤーにおける depth値は再度設定する必要があります

構文 †

layer_add_instance(layer_id, instance_id)

layer_id

インスタンスを登録するレイヤーID(またはレイヤー名)

instance_id

レイヤーに登録するインスタンスID

戻り値 †

N/A

なし

例 †

var near = instance_nearest(x, y, obj_Tree);
var layer_id = layer_get_id("Instances Front");
layer_add_instance(layer_id, near);

上記コードは生成した ob_Tree を レイヤー "instances Front" に登録しています