HeadOrientation Class

Reference

Definition

Namespace:: Windows.Devices.Sensors

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Represents an object that describes the orientation a user's head is facing relative to the human presence sensor, in terms of roll, pitch, and yaw.

public ref class HeadOrientation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 1245184)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HeadOrientation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 1245184)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HeadOrientation

Public NotInheritable Class HeadOrientation

Inheritance: Object Platform::Object IInspectable HeadOrientation

Attributes: ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family	Windows 11 Insider Preview (introduced in 10.0.26100.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v19.0)

Remarks

The X-axis is in the plane of the device screen. It is positive towards the right-hand side of the screen, from the perspective of a user facing the device. (For devices without a screen, the axes are defined relative to the front panel of the device.)

The Y-axis is in the plane of the screen. It is positive towards the top of the screen.

The Z-axis is perpendicular to the screen. It is positive towards the user facing the device.

The axes are fixed relative to the device and don't change with device rotation.

The following image shows how roll, pitch, and yaw are described by the human presence APIs.

Diagram depicting how roll, pitch, and yaw are described by the human presence APIs.

Properties

PitchInDegrees	Gets the counterclockwise rotation of the user's head around the X'-axis (or lateral axis), in degrees.
RollInDegrees	Gets the counterclockwise rotation of the user's head around the Z'-axis (or longitudinal axis), in degrees.
YawInDegrees	Gets the counterclockwise rotation of the user's head around the Y'-axis (or vertical axis), in degrees.

Applies to