FMX.Gyroscope Sample

This sample demonstrates how to use the Gyroscope in order to rotate a 3D cube when your device is tilted.

Location

You can find the Gyroscope sample project at:

• Start | Programs | Embarcadero RAD Studio Athens | Samples and then navigate to:
  • Object Pascal\Mobile Snippets\Gyroscope
  • CPP\Mobile Snippets\Gyroscope
• Subversion Repository:
  • You can find Delphi and C++ code samples in GitHub Repositories. Search by name into the samples repositories according to your RAD Studio version.

Description

The Gyroscope sample demonstrates how to use the Gyroscope in order to rotate a 3D cube when your device is tilted. This sample suports both iOS or Android devices. The sample uses the TOrientationSensor component and the TCustomOrientationSensor class to act like a gyroscope that rotates a 3D cube while you tilt your device.

Note: The TCustomOrientationSensor class supports Android, iOS and Windows platforms. However, each platform provides different orientation sensors and each type of sensor supports a different set of properties (see platform support for a completed list of platform, sensors and suported properties).

How to Use the Sample

1. Navigate to one of the locations given above and open:
   • Delphi: Gyroscope.dproj.
   • C++: Gyroscope.cbproj.
2. Select the target platform, iOS and Android supported.
3. Press F9 or choose Run > Run.
4. Interact with the sample:
   • There is a 3D cube displayed in the screen.
   • Tilt your device and see how the 3D cube rotates.

Files

File in Delphi	File in C++	Contains
Gyroscope.dproj	Gyroscope.cbproj	The project itself.
uMain.fmx	uMain.fmx	The main form where the components are located.
uMain.pas	GyroscopePCH.h, Gyroscope.cpp	Used to define and implement the sample.
Information.txt	Information.txt	Further information about the sample.

Classes

TGyroscopeForm is the main form that represents the main window of the sample. It contains the following components:

• A TLight object.
• A TLightMaterialSource object.
• A TRectangle3D object.
• A TTimer object.
• A TLayer3D object with a TLabel object.
• A TOrientationSensor object.

Implementation

• The sample uses TRectangle3D to implement a 3D shape under the form of a 3D rectangle that can be placed on a 3D FireMonkey form.
• The sample uses TSensorManager to identify the sensor of your device.
• The sample uses TOrientationSensor to obtain information about the device inclination (tilt).
• The sample uses TTimer to repeat specific actions after a given time interval. TTimer specifies the time interval in wich TOrientationSensor offers the tilt information used to rotate the TRectangle3D.
• The sample uses TLight to imitate the rays of light and their propagation on the 3D object.
• The sample uses TLightMaterialSource to link a TLightMaterial to 3D objects. The link is made through MaterialSource property of the 3D object.

When you run the application, you see a 3D cube on the screen. If you tilt your device, the sample uses the TiltX, TiltY and TiltZ properties of TCustomOrientationSensor to obtain the angle that has to be used to rotate the 3D cube using the RotationAngle.X, RotationAngle.Y and RotationAngle.Z properties of TRectangle3D.

Uses

• TOrientationSensor
• TCustomOrientationSensor
• TiltX
• TiltY
• TiltZ
• TTimer
• TRectangle3D
• RotationAngle
• TLightMaterialSource
• TLight
• TLayer3D

See Also

• FireMonkey 3D
• Tutorial: Creating a FireMonkey 3D Application
  • Creating the User Interface (FireMonkey 3D Tutorial)
  • Creating a 2D Interface in a 3D Application (FireMonkey 3D Tutorial)
  • Creating a FireMonkey 3D Application with Animation Effects

Samples

• FireMonkey Orientation Sensor sample
• FireMonkey Low Level 3D sample
• FireMonkey Model Viewer sample
• FireMonkey 3D Arrows sample
• FireMonkey First App3D sample