Udostępnij za pośrednictwem

SpatialPointerInteractionSourcePose Class

  • Reference

Definition

Namespace:
Windows.UI.Input.Spatial
Edit

Represents a motion controller's pointer pose in relation to its surroundings.

public ref class SpatialPointerInteractionSourcePose sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialPointerInteractionSourcePose final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialPointerInteractionSourcePose
Public NotInheritable Class SpatialPointerInteractionSourcePose
Inheritance
Object Platform::Object IInspectable SpatialPointerInteractionSourcePose
Attributes
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows requirements

Device family
Windows 10 Creators Update (introduced in 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v4.0)

Remarks

Windows Mixed Reality supports motion controllers in a variety of form factors, with each controller's design differing in its relationship between the user's hand position and the natural "forward" direction that apps should use for pointing when rendering the controller.

To better represent these controllers, there are two kinds of poses you can investigate for each interaction source.

The grip pose represents the location of either the palm of a hand detected by a HoloLens, or the palm holding a motion controller. On immersive headsets, this pose is best used to render the user's hand or an object held in the user's hand, such as a sword or gun. The grip pose is represented by the position, orientation and velocity properties directly within this type.

The pointer pose represents the tip of a motion controller pointing forward. This pose is best used to raycast when pointing at UI when you are rendering the controller model itself. The pointer pose can be accessed through the SourcePointerPose property.

Version history

Windows version SDK version Value added
1709 16299 Orientation
1709 16299 PositionAccuracy

Properties

ForwardDirection

Gets the forward direction of the motion controller's pointer pose in the specified coordinate system, as a unit vector.
Orientation

Gets the orientation of the motion controller's pointer pose in the specified coordinate system.
Position

Gets the position of the motion controller's pointer pose in the specified coordinate system.
PositionAccuracy

Gets the accuracy of an interaction source's positional tracking.
UpDirection

Gets the up direction that orients the motion controller's pointer pose in the specified coordinate system, as a unit vector.

Applies to

See also