Difference between revisions of "love.window.getSafeArea (日本語)"
(Created page with "{{newin (日本語)|11.3|113|type=関数}} システムタイトルバー、 iPhone X のノッチなどで隠されないウィンドウ領域範囲を...") |
m (→注釈) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 12: | Line 12: | ||
{{param|number|x|セーフエリアの始点 (x-軸)。}} | {{param|number|x|セーフエリアの始点 (x-軸)。}} | ||
{{param|number|y|セーフエリアの始点 (y-軸)。}} | {{param|number|y|セーフエリアの始点 (y-軸)。}} | ||
| − | {{param|number|w| | + | {{param|number|w|セーフエリアの幅。}} |
| − | {{param|number|h| | + | {{param|number|h|セーフエリアの高さ。}} |
== 注釈 == | == 注釈 == | ||
| − | + | 値ピクセル単位ではなく、 DPI 縮尺係数による単位 (DPI-scaled units) で値を返します (この関数以外に利用できるウィンドウ関連 API とほぼ同じ座標系)。 | |
| + | |||
| + | === 用例 === | ||
| + | [[File:safe-area-07.png|150px|thumb|right|セーフエリアの表示]] | ||
| + | <source lang="lua"> | ||
| + | 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 | ||
| + | </source> | ||
== 関連 == | == 関連 == | ||
| − | * [[parent::love.window]] | + | * [[parent::love.window (日本語)]] |
| + | * [[love.graphics.translate (日本語)]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
{{#set:Description=ノッチなどで隠されないウィンドウ領域範囲を取得します。}} | {{#set:Description=ノッチなどで隠されないウィンドウ領域範囲を取得します。}} | ||
Latest revision as of 06:17, 17 June 2023
| LÖVE 11.3 から使用可能 |
| この関数は以前のバージョンでは非対応です。 |
システムタイトルバー、 iPhone X のノッチなどで隠されないウィンドウ領域範囲を取得します。ユーザインタフェースの構成要素においてユーザーが視認できる領域を確認するために有用です。
関数
概要
x, y, w, h = love.window.getSafeArea( )
引数
なし。
返値
注釈
値ピクセル単位ではなく、 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
関連
