Application:getDeviceOrientation: Difference between revisions

From GiderosMobile
No edit summary
No edit summary
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__
'''Available since:''' Gideros 2014.01<br/>
'''Available since:''' Gideros 2014.01<br/>
'''Class:''' [[Application]]<br/>
=== Description ===
=== Description ===
<translate>Get the device orientation (and not what is that in project properties as done with [[Special:MyLanguage/getOrientation|getOrientation]]).Check Accelerometer example project for usage</translate>
Gets the device orientation (and not what is in project properties as done with ''getOrientation''). Please check Gideros Accelerometer sample project for usage.
<source lang="lua">
<syntaxhighlight lang="lua">
(string) = Application:getDeviceOrientation()
(string) = application:getDeviceOrientation()
</source>
</syntaxhighlight>
 
=== Return values ===
=== Return values ===
'''Returns''' (string) <translate>Values "portrait", "portraitUpsideDown", "landscapeLeft", "landscapeRight"</translate><br/>
'''Returns''' (string) values can be: "portrait", "portraitUpsideDown", "landscapeLeft", "landscapeRight"
 
=== Example ===
'''Gideros Accelerometer sample project excerpt'''
<syntaxhighlight lang="lua">
local function compensateAccelerometer(x, y, z)
local orientation = application:getOrientation()
local deviceOrientation = application:getDeviceOrientation()
 
local p1 = orientation == "portrait" or orientation == "portraitUpsideDown"
local p2 = deviceOrientation == "portrait" or deviceOrientation == "portraitUpsideDown"
local rotation = (p1 == p2) and deviceOrientation or orientation
 
if rotation == "portrait" then
return x, y, z
elseif rotation == "landscapeLeft" then
return -y, x, z
elseif rotation == "portraitUpsideDown" then
return -x, -y, z
elseif rotation == "landscapeRight" then
return y, -x, z
end
end
</syntaxhighlight>
 
{{Application}}

Latest revision as of 17:02, 12 January 2025

Available since: Gideros 2014.01
Class: Application

Description

Gets the device orientation (and not what is in project properties as done with getOrientation). Please check Gideros Accelerometer sample project for usage.

(string) = application:getDeviceOrientation()

Return values

Returns (string) values can be: "portrait", "portraitUpsideDown", "landscapeLeft", "landscapeRight"

Example

Gideros Accelerometer sample project excerpt

local function compensateAccelerometer(x, y, z)
	local orientation = application:getOrientation()
	local deviceOrientation = application:getDeviceOrientation()

	local p1 = orientation == "portrait" or orientation == "portraitUpsideDown"
	local p2 = deviceOrientation == "portrait" or deviceOrientation == "portraitUpsideDown"
	
	local rotation = (p1 == p2) and deviceOrientation or orientation

	if rotation == "portrait" then
		return x, y, z
	elseif rotation == "landscapeLeft" then
		return -y, x, z
	elseif rotation == "portraitUpsideDown" then
		return -x, -y, z
	elseif rotation == "landscapeRight" then
		return y, -x, z
	end	
end