layer_get_depth()

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

layer_get_depth() †

この関数を使用して、特定のレイヤーに関連付けられたdepth値を取得できます。 レイヤーID（layer_create() を使用してレイヤーを作成するときに取得する）またはレイヤー名（文字列として-これはパフォーマンスに影響します）を指定すると、関数はそのレイヤーのdepthを実数として返します。 depthはカメラから「遠い」ほど高く、カメラに「近い」ほど低く定義されているため、depthが-100、0、100の3つのレイヤーがある場合、レイヤーは100の順序で描画されます。 0、-100。「トップ」レイヤー（つまり、カメラビューに最も近く、他のすべての上に描画される）は、depthが-100のレイヤーになります。

次の画像は、レイヤーでdepthがどのように機能するかを示しています。

注意

無効なレイヤーID値を指定すると、エラーが発生します

構文 †

layer_get_depth(layer_id)

layer_id

レイヤーID(またはレイヤー名)

戻り値 †

Real

depth値

例 †

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

上記のコードは、グローバル変数に格納されているレイヤーIDの depth をチェックし、-100でない場合はレイヤーを破棄し、-100の depth でレイヤーを再作成します。