layer_add_instance

此函数可用于将给定实例从当前所在的层移动到另一层。

您提供图层 ID(在使用 layer_create 创建图层时获得) 或图层名称 (作为字符串 - 这会对性能产生影响) 以及要移动的实例的实例 ID 各层之间。例如，假设您的播放器位于比另一层深度更低的层上，并且您希望它出现在两层之间的层后面。您可以使用此功能将播放器从前景层切换到背景层，并使其出现在正在绘制的其他层后面。

注意 此函数不能用于向层添加新实例。您 必须 之前已创建实例并将其引用存储在变量中。

注意 该函数仅在当前房间范围内有效，当使用函数 layer_set_target_room 更改范围时无法使用。

语法:

layer_add_instance(layer_id, instance_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);

上面的代码将首先获取与给定x/y位置最近的实例的索引，并将其存储在局部变量中。然后，它获取名为"Instances Front"的层的唯一实例层ID，并将找到的实例移动到该层上。