Component: Orientation ( Data)

Author	MatrixTSL
Version	1.0
Category	Data

Orientation component

Component that provides orientation data for the mobile device using its internal magnetometer

Version information

Library Version, Component Version, Date, Author, Info
1, 1.0, 24-04-26, ST, Created

Detailed description

Many mobile devices contain an internal accelerometer and magnetometer which together can report the orientation of the device.

This component allows access to this orientation data (if it is available on the device), returning with 3 angles showing the rotation of the device in the 3 axes (x, y and z).

Examples

Graphing the device orientation

This example shows the orientation of the device in the 3 axes on a chart.

DeviceOrientation.fcweb

The web app created by this example can be viewed here: DeviceOrientation Example

Using the Orientation component with a callback

The is a similar example to above, but this one uses a callback function to retrieve the orientation of the device whenever there is new data available.

DeviceOrientationWithCallback.fcweb

The web app created by this example can be viewed here: DeviceOrientationWithCallback Example

Macro reference

GetAlpha

	GetAlpha
Returns rotation around the z-axis, i.e. twisted anticlockwise around the centre of the screen (in degrees between 0 and 360)
- FLOAT	Return

GetBeta

	GetBeta
Returns rotation around the x-axis, i.e. tilted forwards/backwards (in degrees between -180 and 180)
- FLOAT	Return

GetGamma

	GetGamma
Returns rotation around the y-axis, i.e. tilted left/right (in degrees between -90 and 90)
- FLOAT	Return

Initialise

	Initialise
Begins monitoring of the device's orientation information. Returns true if the device can provide orientation information.
- BOOL	Return

IsAbsolute

	IsAbsolute
Returns true if the device is providing absolute orientation information. Absolute data will be in reference to the Earth's coordinate frame.
- BOOL	Return

Property reference

	Properties
	Use Callback
Set true to use a callback that retrieves regular updates of the device orientation

Component Source Code

Please click here to download the component source project: FC_Comp_Source_WEBEXP_Orientation.fcsx

Please click here to view the component source code (Beta): FC_Comp_Source_WEBEXP_Orientation.fcsx