Type Number
Event accelerometer
Revision Current Public Release (2018.3326)
Keywords accelerometer, xGravity


Provides the acceleration due to gravity relative to the x-axis of the device's screen in portrait orientation.

This value is "smoothed" based on the previous accelerometer readings in order to reduce a jittering effect when used to manipulate graphics on screen.


This value is always relative to the device in portrait orientation, regardless of the current orientation of your application. So, if your application is running in landscape mode, you'll need to compensate by 90 degrees.


local function onAccelerate( event )
    print( event.name, event.xGravity, event.yGravity, event.zGravity )
Runtime:addEventListener( "accelerometer", onAccelerate )