org.lwjgl.openxr.EXTHandJointsMotionRange Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of lwjgl-openxr Show documentation

A royalty-free, open standard that provides high-performance access to Augmented Reality (AR) and Virtual Reality (VR)—collectively known as XR—platforms and devices.

There is a newer version: 3.3.6

Show newest version

/*
 * Copyright LWJGL. All rights reserved.
 * License terms: https://www.lwjgl.org/license
 * MACHINE GENERATED FILE, DO NOT EDIT
 */
package org.lwjgl.openxr;

/**
 * The XR_EXT_hand_joints_motion_range extension.
 * 
 * This extension augments the {@link EXTHandTracking XR_EXT_hand_tracking} extension to enable applications to request that the {@link XrHandJointLocationsEXT} returned by {@link EXTHandTracking#xrLocateHandJointsEXT LocateHandJointsEXT} should return hand joint locations conforming to a range of motion specified by the application.
 * 
 * The application must enable the {@link EXTHandTracking XR_EXT_hand_tracking} extension in order to use this extension.
 */
public final class EXTHandJointsMotionRange {

    /** The extension specification version. */
    public static final int XR_EXT_hand_joints_motion_range_SPEC_VERSION = 1;

    /** The extension name. */
    public static final String XR_EXT_HAND_JOINTS_MOTION_RANGE_EXTENSION_NAME = "XR_EXT_hand_joints_motion_range";

    /** Extends {@code XrStructureType}. */
    public static final int XR_TYPE_HAND_JOINTS_MOTION_RANGE_INFO_EXT = 1000080000;

    /**
     * XrHandJointsMotionRangeEXT - Describes the hand animation range of motion.
     * 
     * Enumerant Descriptions
     * 
     * 
     * {@link #XR_HAND_JOINTS_MOTION_RANGE_UNOBSTRUCTED_EXT HAND_JOINTS_MOTION_RANGE_UNOBSTRUCTED_EXT} This option refers to the range of motion of a human hand, without any obstructions. Input systems that obstruct the movement of the user’s hand (e.g.: a held controller preventing the user from making a fist) or have only limited ability to track finger positions must use the information available to them to emulate an unobstructed range of motion.
     * {@link #XR_HAND_JOINTS_MOTION_RANGE_CONFORMING_TO_CONTROLLER_EXT HAND_JOINTS_MOTION_RANGE_CONFORMING_TO_CONTROLLER_EXT} This option refers to the range of motion of the hand joints taking into account any physical limits imposed by the controller itself. This will tend to be the most accurate pose compared to the user’s actual hand pose, but might not allow a closed fist for example.
     * 
     * 
     * If the current interaction profile represents a controller, or other device that obstructs the hand, the implementation must return joint locations conforming to the shape of that device. If the current interaction profile is being emulated by a different physical controller, the implementation may return joint locations conforming to the shape of either the current interaction profile or the actual physical controller.
     * If the current interaction profile does not represent a controller, the implementation must return joint locations based on the unobstructed joint locations.
     * 
     * 
     * 
     * 
     * See Also
     * 
     * {@link XrHandJointsMotionRangeInfoEXT}, {@link EXTHandTracking#xrLocateHandJointsEXT LocateHandJointsEXT}
     */
    public static final int
        XR_HAND_JOINTS_MOTION_RANGE_UNOBSTRUCTED_EXT             = 1,
        XR_HAND_JOINTS_MOTION_RANGE_CONFORMING_TO_CONTROLLER_EXT = 2;

    private EXTHandJointsMotionRange() {}

}