<doc>
	<legacy_id></legacy_id>
	<name>mobileDeviceOrientation</name>
	<type>function</type>

	<syntax>
		<example>mobileDeviceOrientation()</example>
	</syntax>

	<synonyms>
		<synonym>iphoneDeviceOrientation</synonym>
	</synonyms>

	<summary>Returns the current device orientation.</summary>

	<examples>
<example>put mobileDeviceOrientation() into theOrientation</example>
	</examples>

	<history>
		<introduced version="4.5.2">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="4.6.1">4.6.1</changed>
	</history>

	<objects>
	</objects>

	<platforms>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<function tag="mobileOrientation">mobileOrientation Function</function>
		<function tag="mobileAllowedOrientations">mobileAllowedOrientations Function</function>
		<command tag="mobileSetAllowedOrientations">mobileSetAllowedOrientations Command</command>
		<command tag="mobileLockOrientation">mobileLockOrientation Command</command>
		<command tag="mobileUnlockOrientation">mobileUnlockOrientation Command</command>
		<message tag="orientationChanged">orientationChanged Message</message>
	</references>

	<description>
	<overview>Use the <b>mobileDeviceOrientation</b> function to find the current device orientation.</overview>

		<parameters>
		</parameters>

	<value>The <b>mobileDeviceOrientation</b> function returns one of:<p>&#9;* <i>unknown</i> - the orientation could not be determined</p><p>&#9;* <i>portrait</i> - the device is being held upward with the home button at the bottom</p><p>&#9;* <i>portrait upside down</i> - the device is being held upward with the home button at the top</p><p>&#9;* <i>landscape left</i> - the device is being held upward with the home button on the left</p><p>&#9;* <i>landscape right</i> - the device is being held upward with the home button on the right</p><p>&#9;* <i>face up </i>- the device is lying flat with the screen upward</p><p>&#9;* <i>face down</i> - the device is lying flat with the screen downward</p></value>
	<comments>The <b>mobileDeviceOrientation</b> function returns the current orientation of the device.<p></p><p></p><note>Due to the limitation of the Android operating system, <i>landscape left</i> and <i>portrait upside-down</i> are only supported on Android 2.3 and later.</note></comments>
	</description>
</doc>