Application:getDeviceOrientation: Difference between revisions

From GiderosMobile
No edit summary
No edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''Available since:''' Gideros 2014.01<br/>
'''Available since:''' Gideros 2014.01<br/>
'''Class:''' [[Application|Application]]<br/>
'''Class:''' [[Application]]<br/>


=== Description ===
=== Description ===
Get the device orientation (and not what is that in project properties as done with ''getOrientation'').Check Accelerometer example project for usage.
Gets the device orientation (and not what is in project properties as done with ''getOrientation''). Please check Gideros Accelerometer sample project for usage.
 
<syntaxhighlight lang="lua">
<source lang="lua">
(string) = application:getDeviceOrientation()
(string) = application:getDeviceOrientation()
</source>
</syntaxhighlight>


=== Return values ===
=== Return values ===
'''Returns''' (string) Values "portrait", "portraitUpsideDown", "landscapeLeft", "landscapeRight"
'''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}}
{{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