NAME

       SDL_SensorType - The different sensors defined by SDL.

HEADER FILE

       Defined in SDL3/SDL_sensor.h

SYNOPSIS

       #include "SDL3/SDL.h"

       typedef enum SDL_SensorType
       {
           SDL_SENSOR_INVALID = -1,    /**< Returned for an invalid sensor */
           SDL_SENSOR_UNKNOWN,         /**< Unknown sensor type */
           SDL_SENSOR_ACCEL,           /**< Accelerometer */
           SDL_SENSOR_GYRO,            /**< Gyroscope */
           SDL_SENSOR_ACCEL_L,         /**< Accelerometer for left Joy-Con controller and Wii nunchuk */
           SDL_SENSOR_GYRO_L,          /**< Gyroscope for left Joy-Con controller */
           SDL_SENSOR_ACCEL_R,         /**< Accelerometer for right Joy-Con controller */
           SDL_SENSOR_GYRO_R           /**< Gyroscope for right Joy-Con controller */
       } SDL_SensorType;

DESCRIPTION

       Additional sensors may be available, using platform dependent semantics.

       Here are the additional Android sensors:

       https://developer.android.com/reference/android/hardware/SensorEvent.html#values

       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.

AVAILABILITY

       This enum is available since SDL 3.2.0.

SEE ALSO

       •(3), SDL_GetCurrentDisplayOrientation(3)

Simple Directmedia Layer                            SDL 3.2.8                              SDL_SensorType(3type)