SENSOR_CATEGORY_ORIENTATION
The SENSOR_CATEGORY_ORIENTATION category contains sensors that provide information about physical orientation. Compasses provide navigational orientation, such as those based on Magnetic North. Inclinometers measure slope or elevation. Distance sensors measure the proximity of some object to the sensor.
Platform-defined Sensor Types
This category includes the following platform-defined sensor types.
Sensor type | Meaning |
---|---|
SENSOR_TYPE_COMPASS_1D |
One-axis compasses. |
SENSOR_TYPE_COMPASS_2D |
Two-axis compasses. |
SENSOR_TYPE_COMPASS_3D |
Three-axis compasses. |
SENSOR_TYPE_DISTANCE_1D |
One-axis distance sensors. |
SENSOR_TYPE_DISTANCE_2D |
Two-axis distance sensors. |
SENSOR_TYPE_DISTANCE_3D |
Three-axis distance sensors. |
SENSOR_TYPE_INCLINOMETER_1D |
One-axis inclinometers. |
SENSOR_TYPE_INCLINOMETER_2D |
Two-axis inclinometers. |
SENSOR_TYPE_INCLINOMETER_3D |
Three-axis inclinometers. |
Platform-defined Data Fields
This category includes the following platform-defined data fields.
Data type | Type | Meaning |
---|---|---|
SENSOR_DATA_TYPE_TILT_X_DEGREES(PID = 2) |
VT_R4 |
Inclinometer x-axis angle, in degrees. |
SENSOR_DATA_TYPE_TILT_Y_DEGREES(PID = 3) |
VT_R4 |
Inclinometer y-axis angle, in degrees. |
SENSOR_DATA_TYPE_TILT_Z_DEGREES(PID = 4) |
VT_R4 |
Inclinometer z-axis angle, in degrees. |
SENSOR_DATA_TYPE_DISTANCE_X_METERS(PID = 8) |
VT_R4 |
X-axis distance, in meters. |
SENSOR_DATA_TYPE_DISTANCE_Y_METERS(PID = 9) |
VT_R4 |
Y-axis distance, in meters. |
SENSOR_DATA_TYPE_DISTANCE_Z_METERS(PID = 10) |
VT_R4 |
Z-axis distance, in meters. |
SENSOR_DATA_TYPE_MAGNETIC_HEADING_X_DEGREES(PID = 5) |
VT_R4 |
Compass x-axis heading, in degrees. |
SENSOR_DATA_TYPE_MAGNETIC_HEADING_Y_DEGREES(PID = 6) |
VT_R4 |
Compass y-axis heading, in degrees. |
SENSOR_DATA_TYPE_MAGNETIC_HEADING_Z_DEGREES(PID = 7) |
VT_R4 |
Compass z-axis heading, in degrees. |
SENSOR_DATA_TYPE_MAGNETIC_HEADING_COMPENSATED_MAGNETIC_NORTH_DEGREES (PID = 11) |
VT_R8 |
Compensated compass heading relative to magnetic North in degrees. This compensation causes the measurement of the heading angle to be represented as if a compass device is laying flat on level ground where the PC is located. |
SENSOR_DATA_TYPE_MAGNETIC_HEADING_COMPENSATED_TRUE_NORTH_DEGREES (PID = 12) |
VT_R8 |
Compensated compass heading relative to true North in degrees. This compensation causes the measurement of the heading angle to be represented as if a compass device is laying flat on level ground where the PC is located. |
SENSOR_DATA_TYPE_MAGNETIC_HEADING_MAGNETIC_NORTH_DEGREES (PID = 13) |
VT_R8 |
Uncompensated compass heading relative to magnetic North in degrees. The measurement of the heading angle is represented as measured on the plane that the compass device is installed relative to. |
SENSOR_DATA_TYPE_MAGNETIC_HEADING_TRUE_NORTH_DEGREES (PID = 14) |
VT_R8 |
Uncompensated compass heading relative to true North in degrees. The measurement of the heading angle is represented as measured on the plane that the compass device is installed relative to. |
Important Each platform-defined orientation data type PROPERTYKEY is based on a common GUID that is named SENSOR_DATA_TYPE_ORIENTATION_GUID. As it is a reserved base value, do not use this GUID to define your own property keys.
Requirements
Minimum supported client |
Windows 7 |
Minimum supported server |
None supported |
Version |
Available in Windows 7. |
Header |
Sensors.h |
Send comments about this topic to Microsoft
Build date: 11/29/2012