int TiltGetz();

Returns the tilt value for the z axis of the device.  Imagine a line running perpendicular through the center of your device's screen.

Return Value

Returns a value representing the tilt of the device.

Remarks

TiltGetz() reveals whether the face of the device is pointed toward the sky (positive) or the ground (negative).  The range of values is typically between -1000 and 1000.  A value of zero is returned if the device is flat on this axis.  Values greater than +/- 1000 indicate that the device is being shaken.

Availability

Available in DragonFireSDK 1.0 and later.

Example

The example below will query the current location of a text object and increment it's X and Y coordinates in the OnTimer() event.

#include "DragonFireSDK.h"

int BallImage;

int BallView;

void AppMain()

{

  // Set up an image of a ball to move around the screen:

  BallImage = ImageAdd("Images/Ball.png");

  BallView = ViewAdd(BallImage, 0, 0);

}

void AppExit()

{

}

void OnTimer()

{

  int BallX, BallY;

  int tx, ty, tz;

  // Get tilt (accelerometer) data for each axis.

  tx = TiltGetx();

  ty = TiltGety();

  tz = TiltGetz();  

  // Update the ball's next X and Y values based on G-Force and the strength of gravity:

  BallX = ViewGetx(BallView) + (tx / 100);  

  BallY = ViewGety(BallView) + (ty / 100);

  // Don't let the ball go off the screen:

  if (BallX >= 283)

     BallX = 283;

  if (BallX <= 0)

     BallX = 0;

  if (BallY >= 443)

     BallY = 443;

  if (BallY <= 0)

     BallY = 0;

  // Update the ball's position:

  ViewSetxy(BallView, BallX, BallY);

}