layer_depth()

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

layer_depth() †

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

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

注意

layer_get_depth() を使用すると、いつでもレイヤーのdepthを確認できます。 また、レイヤーの最小depthと最大depthは-16000〜16000であり、これらのdepthの外側はレンダリングされません。 その範囲外のdepthが必要な場合は、layer_force_draw_depth() 関数を使用する必要があります。

構文 †

layer_depth(layer_id, depth)

layer_id

レイヤーID、またはレイヤー名 :depth:depth値

戻り値 †

N/A

なし

例 †

if layer_get_depth(layer) != -100
{
  layer_depth(layer, -100);
}

上記のコードは、コードを実行しているインスタンスが存在するレイヤーの depth を取得し、それが-100でない場合、depth は-100に設定されます。