love.window.getSafeArea (日本語)

LÖVE 11.3 から使用可能
この関数は以前のバージョンでは非対応です。

システムタイトルバー、 iPhone X のノッチなどで隠されないウィンドウ領域範囲を取得します。ユーザインタフェースの構成要素においてユーザーが視認できる領域を確認するために有用です。

関数

概要

x, y, w, h = love.window.getSafeArea( )

引数

なし。

返値

number x
セーフエリアの始点 (x-軸)。
number y
セーフエリアの始点 (y-軸)。
number w
セーフエリアの幅。
number h
セーフエリアの高さ。

注釈

値は ピクセル単位ではなく、 DPI 縮尺係数による単位 (DPI-scaled units) で返されます (この関数以外に利用できるウィンドウ関連 API のほとんどと同じ座標系)。

用例

セーフエリアの表示
function love.draw()
	local safeX, safeY, safeW, safeH = love.window.getSafeArea()

	love.graphics.translate(safeX, safeY)
	love.graphics.rectangle("line", 0, 0, safeW, safeH)
	love.graphics.line(0, 0, safeW, safeH)
	love.graphics.line(0, safeH, safeW, 0)
	love.graphics.circle('line', safeW/2, safeH/2, safeW/2)
	love.graphics.circle('line', safeW/2, safeH/2, safeH/2)
end

関連



そのほかの言語