layer_get_depth

可以使用此函数获取与给定层关联的深度值。提供层 ID(使用layer_create()创建层时获得的 ID)或层名称(作为字符串,这将对性能产生影响),并且该函数将以实数返回层深度。请注意,深度被定义为距离相机"越远"越高,距离相机越近,因此,如果您有三层,深度为100、0、100,则各层将按100、0、- 100的顺序绘制,因此,"顶部"层(即最接近摄像机视图的层,因此在其它所有地方绘制)将是深度为-100的层。

下图显示了深度如何作用于层的示意图:

Layer depth example请注意,如果您提供了一个无效的层ID值,您将得到一个错误。

 

语法:

layer_get_depth(layer_id)

参数类型描述
layer_idString or Layer要获取深度的图层的唯一ID值(或字符串形式的图层名称)

 

返回:

Real

 

例子:

if (layer_get_depth(global.temp_layer) != -100)
{
    layer_destroy(global.temp_layer);
    global.temp_layer = layer_create(-100);
}

上面的代码检查存储在全局变量中的层ID的深度,如果它不是-100,则它销毁该层并在深度-100处重新创建它。