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