display.screenOriginY

Type Number
Library display.*
Revision Release 2024.3703
Keywords screen, origin, positioning
See also display.screenOriginX
display.safeScreenOriginY
display.getSafeAreaInsets()

Overview

Returns the y distance from the top of the actual screen to the top of the content area, in Corona content units. For example, in "letterbox" or "zoomEven" scaling modes, there may be added area or cropped area on the current device screen. This lets you find out how much visible area has been added or removed on the current device.

Example

config.lua
application =
{
    content =
    {
        width = 320,
        height = 480,
        scale = "letterbox"
    },
}
main.lua
-- Create a grey background
local background = display.newRect( 0, 0, 320, 480 )
background:setFillColor( 0.5 )

-- Create two squares
local rect1 = display.newRect( 0, 0, 50, 50 )
local rect2 = display.newRect( 0, 0, 50, 50 )

-- Place the squares along the top edge ; offset the second square with "display.screenOriginY"
rect1.x = 62
rect2.x = 162
rect1.y = 25
rect2.y = 25 + display.screenOriginY