Skip to content

TSdlSensorKind

The different sensors defined by SDL.

Additional sensors may be available, using platform dependent semantics.

Here are the additional Android sensors.

Accelerometer sensor notes:

The accelerometer returns the current acceleration in SI meters per second squared. This measurement includes the force of gravity, so a device at rest will have an value of SDL_STANDARD_GRAVITY away from the center of the earth, which is a positive Y value.

  • Values[0]: Acceleration on the x axis
  • Values[1]: Acceleration on the y axis
  • Values[2]: Acceleration on the z axis

For phones and tablets held in natural orientation and game controllers held in front of you, the axes are defined as follows:

  • -X ... +X : left ... right
  • -Y ... +Y : bottom ... top
  • -Z ... +Z : farther ... closer

The accelerometer axis data is not changed when the device is rotated.

Gyroscope sensor notes:

The gyroscope returns the current rate of rotation in radians per second. The rotation is positive in the counter-clockwise direction. That is, an observer looking from a positive location on one of the axes would see positive rotation on that axis when it appeared to be rotating counter-clockwise.

  • Values[0]: Angular speed around the x axis (pitch)
  • Values[1]: Angular speed around the y axis (yaw)
  • Values[2]: Angular speed around the z axis (roll)

For phones and tablets held in natural orientation and game controllers held in front of you, the axes are defined as follows:

  • -X ... +X : left ... right
  • -Y ... +Y : bottom ... top
  • -Z ... +Z : farther ... closer

The gyroscope axis data is not changed when the device is rotated.

Definition

Unit: Neslib.Sdl3.Input

type TSdlSensorKind = (Invalid, Unknown, Accel, Gyro, AccelLeft, GyroLeft, AccelRight, GyroRight)

See Also

Enumeration Values

Invalid = SDL_SENSOR_INVALID

Returned for an invalid sensor

Unknown = SDL_SENSOR_UNKNOWN

Unknown sensor type

Accel = SDL_SENSOR_ACCEL

Accelerometer

Gyro = SDL_SENSOR_GYRO

Gyroscope

AccelLeft = SDL_SENSOR_ACCEL_L

Accelerometer for left Joy-Con controller and Wii nunchuk

GyroLeft = SDL_SENSOR_GYRO_L

Gyroscope for left Joy-Con controller

AccelRight = SDL_SENSOR_ACCEL_R

Accelerometer for right Joy-Con controller

GyroRight = SDL_SENSOR_GYRO_R

Gyroscope for right Joy-Con controller