All Downloads are FREE. Search and download functionalities are using the official Maven repository.
  • Log In
  • Register

    • org.lwjgl.openxr.FBFaceTracking2 Maven / Gradle / Ivy

    Go to download

    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;

import org.lwjgl.*;

import org.lwjgl.system.*;

import static org.lwjgl.system.Checks.*;
import static org.lwjgl.system.JNI.*;
import static org.lwjgl.system.MemoryUtil.*;

/**
 * The XR_FB_face_tracking2 extension.
 * 
 * 
    This extension enables applications to get weights of blend shapes. It also enables applications to render facial expressions in XR experiences.
    
 * 
 * 
    It is recommended to choose this extension over the {@link FBFaceTracking XR_FB_face_tracking} extension, if it is supported by the runtime, because this extension provides the following two additional capabilities to the application:
    
 * 
 * 
      
 * 
    • This extension provides additional seven blend shapes that estimate tongue movement.
      • 
 * 
    • This extension allows an application and the runtime to communicate about the data sources that are used to estimate facial expression in a cooperative manner.
      • 
 * 
    
 * 
 * 
    Face tracking data is sensitive personal information and is closely linked to personal privacy and integrity. Applications storing or transferring face tracking data should always ask the user for active and specific acceptance to do so.
    
 * 
 * 
    If the runtime supports a permission system to control application access to the face tracker, then the runtime must set the {@code isValid} field to {@link XR10#XR_FALSE FALSE} on the supplied {@link XrFaceExpressionWeights2FB} structure until the user allows the application to access the face tracker. When the application access has been allowed, the runtime should set {@code isValid} on the supplied {@link XrFaceExpressionWeights2FB} structure to {@link XR10#XR_TRUE TRUE}.
    
 * 
 * 
    Some permission systems may control access to the eye tracking separately from access to the face tracking, even though the eyes are part of the face. In case the user denied tracking of the eyes, yet, allowed tracking of the face, then the runtime must set the {@code isEyeFollowingBlendshapesValid} field to {@link XR10#XR_FALSE FALSE} on the supplied {@link XrFaceExpressionWeights2FB} for indicating that eye tracking data is not available, but at the same time may set the {@code isValid} field to {@link XR10#XR_TRUE TRUE} on the supplied {@link XrFaceExpressionWeights2FB} for indicating that another part of the face is tracked properly.
    
 */
public class FBFaceTracking2 {

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

    /** The extension name. */
    public static final String XR_FB_FACE_TRACKING2_EXTENSION_NAME = "XR_FB_face_tracking2";

    /** Extends {@code XrObjectType}. */
    public static final int XR_OBJECT_TYPE_FACE_TRACKER2_FB = 1000287012;

    /**
     * Extends {@code XrStructureType}.
     * 
     * 
    Enum values:
    
     * 
     * 
      
     * 
    • {@link #XR_TYPE_SYSTEM_FACE_TRACKING_PROPERTIES2_FB TYPE_SYSTEM_FACE_TRACKING_PROPERTIES2_FB}
      • 
     * 
    • {@link #XR_TYPE_FACE_TRACKER_CREATE_INFO2_FB TYPE_FACE_TRACKER_CREATE_INFO2_FB}
      • 
     * 
    • {@link #XR_TYPE_FACE_EXPRESSION_INFO2_FB TYPE_FACE_EXPRESSION_INFO2_FB}
      • 
     * 
    • {@link #XR_TYPE_FACE_EXPRESSION_WEIGHTS2_FB TYPE_FACE_EXPRESSION_WEIGHTS2_FB}
      • 
     * 
    
     */
    public static final int
        XR_TYPE_SYSTEM_FACE_TRACKING_PROPERTIES2_FB = 1000287013,
        XR_TYPE_FACE_TRACKER_CREATE_INFO2_FB        = 1000287014,
        XR_TYPE_FACE_EXPRESSION_INFO2_FB            = 1000287015,
        XR_TYPE_FACE_EXPRESSION_WEIGHTS2_FB         = 1000287016;

    /**
     * XrFaceExpression2FB - The name of blend shapes that are trackable
     * 
     * 
    Enum values:
    
     * 
     * 
      
     * 
    • {@link #XR_FACE_EXPRESSION2_BROW_LOWERER_L_FB FACE_EXPRESSION2_BROW_LOWERER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_BROW_LOWERER_R_FB FACE_EXPRESSION2_BROW_LOWERER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_CHEEK_PUFF_L_FB FACE_EXPRESSION2_CHEEK_PUFF_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_CHEEK_PUFF_R_FB FACE_EXPRESSION2_CHEEK_PUFF_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_CHEEK_RAISER_L_FB FACE_EXPRESSION2_CHEEK_RAISER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_CHEEK_RAISER_R_FB FACE_EXPRESSION2_CHEEK_RAISER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_CHEEK_SUCK_L_FB FACE_EXPRESSION2_CHEEK_SUCK_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_CHEEK_SUCK_R_FB FACE_EXPRESSION2_CHEEK_SUCK_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_CHIN_RAISER_B_FB FACE_EXPRESSION2_CHIN_RAISER_B_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_CHIN_RAISER_T_FB FACE_EXPRESSION2_CHIN_RAISER_T_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_DIMPLER_L_FB FACE_EXPRESSION2_DIMPLER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_DIMPLER_R_FB FACE_EXPRESSION2_DIMPLER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_CLOSED_L_FB FACE_EXPRESSION2_EYES_CLOSED_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_CLOSED_R_FB FACE_EXPRESSION2_EYES_CLOSED_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_LOOK_DOWN_L_FB FACE_EXPRESSION2_EYES_LOOK_DOWN_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_LOOK_DOWN_R_FB FACE_EXPRESSION2_EYES_LOOK_DOWN_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_LOOK_LEFT_L_FB FACE_EXPRESSION2_EYES_LOOK_LEFT_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_LOOK_LEFT_R_FB FACE_EXPRESSION2_EYES_LOOK_LEFT_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_LOOK_RIGHT_L_FB FACE_EXPRESSION2_EYES_LOOK_RIGHT_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_LOOK_RIGHT_R_FB FACE_EXPRESSION2_EYES_LOOK_RIGHT_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_LOOK_UP_L_FB FACE_EXPRESSION2_EYES_LOOK_UP_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_EYES_LOOK_UP_R_FB FACE_EXPRESSION2_EYES_LOOK_UP_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_INNER_BROW_RAISER_L_FB FACE_EXPRESSION2_INNER_BROW_RAISER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_INNER_BROW_RAISER_R_FB FACE_EXPRESSION2_INNER_BROW_RAISER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_JAW_DROP_FB FACE_EXPRESSION2_JAW_DROP_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_JAW_SIDEWAYS_LEFT_FB FACE_EXPRESSION2_JAW_SIDEWAYS_LEFT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_JAW_SIDEWAYS_RIGHT_FB FACE_EXPRESSION2_JAW_SIDEWAYS_RIGHT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_JAW_THRUST_FB FACE_EXPRESSION2_JAW_THRUST_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LID_TIGHTENER_L_FB FACE_EXPRESSION2_LID_TIGHTENER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LID_TIGHTENER_R_FB FACE_EXPRESSION2_LID_TIGHTENER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_CORNER_DEPRESSOR_L_FB FACE_EXPRESSION2_LIP_CORNER_DEPRESSOR_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_CORNER_DEPRESSOR_R_FB FACE_EXPRESSION2_LIP_CORNER_DEPRESSOR_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_CORNER_PULLER_L_FB FACE_EXPRESSION2_LIP_CORNER_PULLER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_CORNER_PULLER_R_FB FACE_EXPRESSION2_LIP_CORNER_PULLER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_FUNNELER_LB_FB FACE_EXPRESSION2_LIP_FUNNELER_LB_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_FUNNELER_LT_FB FACE_EXPRESSION2_LIP_FUNNELER_LT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_FUNNELER_RB_FB FACE_EXPRESSION2_LIP_FUNNELER_RB_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_FUNNELER_RT_FB FACE_EXPRESSION2_LIP_FUNNELER_RT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_PRESSOR_L_FB FACE_EXPRESSION2_LIP_PRESSOR_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_PRESSOR_R_FB FACE_EXPRESSION2_LIP_PRESSOR_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_PUCKER_L_FB FACE_EXPRESSION2_LIP_PUCKER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_PUCKER_R_FB FACE_EXPRESSION2_LIP_PUCKER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_STRETCHER_L_FB FACE_EXPRESSION2_LIP_STRETCHER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_STRETCHER_R_FB FACE_EXPRESSION2_LIP_STRETCHER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_SUCK_LB_FB FACE_EXPRESSION2_LIP_SUCK_LB_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_SUCK_LT_FB FACE_EXPRESSION2_LIP_SUCK_LT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_SUCK_RB_FB FACE_EXPRESSION2_LIP_SUCK_RB_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_SUCK_RT_FB FACE_EXPRESSION2_LIP_SUCK_RT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_TIGHTENER_L_FB FACE_EXPRESSION2_LIP_TIGHTENER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIP_TIGHTENER_R_FB FACE_EXPRESSION2_LIP_TIGHTENER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LIPS_TOWARD_FB FACE_EXPRESSION2_LIPS_TOWARD_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LOWER_LIP_DEPRESSOR_L_FB FACE_EXPRESSION2_LOWER_LIP_DEPRESSOR_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_LOWER_LIP_DEPRESSOR_R_FB FACE_EXPRESSION2_LOWER_LIP_DEPRESSOR_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_MOUTH_LEFT_FB FACE_EXPRESSION2_MOUTH_LEFT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_MOUTH_RIGHT_FB FACE_EXPRESSION2_MOUTH_RIGHT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_NOSE_WRINKLER_L_FB FACE_EXPRESSION2_NOSE_WRINKLER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_NOSE_WRINKLER_R_FB FACE_EXPRESSION2_NOSE_WRINKLER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_OUTER_BROW_RAISER_L_FB FACE_EXPRESSION2_OUTER_BROW_RAISER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_OUTER_BROW_RAISER_R_FB FACE_EXPRESSION2_OUTER_BROW_RAISER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_UPPER_LID_RAISER_L_FB FACE_EXPRESSION2_UPPER_LID_RAISER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_UPPER_LID_RAISER_R_FB FACE_EXPRESSION2_UPPER_LID_RAISER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_UPPER_LIP_RAISER_L_FB FACE_EXPRESSION2_UPPER_LIP_RAISER_L_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_UPPER_LIP_RAISER_R_FB FACE_EXPRESSION2_UPPER_LIP_RAISER_R_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_TONGUE_TIP_INTERDENTAL_FB FACE_EXPRESSION2_TONGUE_TIP_INTERDENTAL_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_TONGUE_TIP_ALVEOLAR_FB FACE_EXPRESSION2_TONGUE_TIP_ALVEOLAR_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_TONGUE_FRONT_DORSAL_PALATE_FB FACE_EXPRESSION2_TONGUE_FRONT_DORSAL_PALATE_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_TONGUE_MID_DORSAL_PALATE_FB FACE_EXPRESSION2_TONGUE_MID_DORSAL_PALATE_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_TONGUE_BACK_DORSAL_VELAR_FB FACE_EXPRESSION2_TONGUE_BACK_DORSAL_VELAR_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_TONGUE_OUT_FB FACE_EXPRESSION2_TONGUE_OUT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_TONGUE_RETREAT_FB FACE_EXPRESSION2_TONGUE_RETREAT_FB}
      • 
     * 
    • {@link #XR_FACE_EXPRESSION2_COUNT_FB FACE_EXPRESSION2_COUNT_FB}
      • 
     * 
    
     */
    public static final int
        XR_FACE_EXPRESSION2_BROW_LOWERER_L_FB             = 0,
        XR_FACE_EXPRESSION2_BROW_LOWERER_R_FB             = 1,
        XR_FACE_EXPRESSION2_CHEEK_PUFF_L_FB               = 2,
        XR_FACE_EXPRESSION2_CHEEK_PUFF_R_FB               = 3,
        XR_FACE_EXPRESSION2_CHEEK_RAISER_L_FB             = 4,
        XR_FACE_EXPRESSION2_CHEEK_RAISER_R_FB             = 5,
        XR_FACE_EXPRESSION2_CHEEK_SUCK_L_FB               = 6,
        XR_FACE_EXPRESSION2_CHEEK_SUCK_R_FB               = 7,
        XR_FACE_EXPRESSION2_CHIN_RAISER_B_FB              = 8,
        XR_FACE_EXPRESSION2_CHIN_RAISER_T_FB              = 9,
        XR_FACE_EXPRESSION2_DIMPLER_L_FB                  = 10,
        XR_FACE_EXPRESSION2_DIMPLER_R_FB                  = 11,
        XR_FACE_EXPRESSION2_EYES_CLOSED_L_FB              = 12,
        XR_FACE_EXPRESSION2_EYES_CLOSED_R_FB              = 13,
        XR_FACE_EXPRESSION2_EYES_LOOK_DOWN_L_FB           = 14,
        XR_FACE_EXPRESSION2_EYES_LOOK_DOWN_R_FB           = 15,
        XR_FACE_EXPRESSION2_EYES_LOOK_LEFT_L_FB           = 16,
        XR_FACE_EXPRESSION2_EYES_LOOK_LEFT_R_FB           = 17,
        XR_FACE_EXPRESSION2_EYES_LOOK_RIGHT_L_FB          = 18,
        XR_FACE_EXPRESSION2_EYES_LOOK_RIGHT_R_FB          = 19,
        XR_FACE_EXPRESSION2_EYES_LOOK_UP_L_FB             = 20,
        XR_FACE_EXPRESSION2_EYES_LOOK_UP_R_FB             = 21,
        XR_FACE_EXPRESSION2_INNER_BROW_RAISER_L_FB        = 22,
        XR_FACE_EXPRESSION2_INNER_BROW_RAISER_R_FB        = 23,
        XR_FACE_EXPRESSION2_JAW_DROP_FB                   = 24,
        XR_FACE_EXPRESSION2_JAW_SIDEWAYS_LEFT_FB          = 25,
        XR_FACE_EXPRESSION2_JAW_SIDEWAYS_RIGHT_FB         = 26,
        XR_FACE_EXPRESSION2_JAW_THRUST_FB                 = 27,
        XR_FACE_EXPRESSION2_LID_TIGHTENER_L_FB            = 28,
        XR_FACE_EXPRESSION2_LID_TIGHTENER_R_FB            = 29,
        XR_FACE_EXPRESSION2_LIP_CORNER_DEPRESSOR_L_FB     = 30,
        XR_FACE_EXPRESSION2_LIP_CORNER_DEPRESSOR_R_FB     = 31,
        XR_FACE_EXPRESSION2_LIP_CORNER_PULLER_L_FB        = 32,
        XR_FACE_EXPRESSION2_LIP_CORNER_PULLER_R_FB        = 33,
        XR_FACE_EXPRESSION2_LIP_FUNNELER_LB_FB            = 34,
        XR_FACE_EXPRESSION2_LIP_FUNNELER_LT_FB            = 35,
        XR_FACE_EXPRESSION2_LIP_FUNNELER_RB_FB            = 36,
        XR_FACE_EXPRESSION2_LIP_FUNNELER_RT_FB            = 37,
        XR_FACE_EXPRESSION2_LIP_PRESSOR_L_FB              = 38,
        XR_FACE_EXPRESSION2_LIP_PRESSOR_R_FB              = 39,
        XR_FACE_EXPRESSION2_LIP_PUCKER_L_FB               = 40,
        XR_FACE_EXPRESSION2_LIP_PUCKER_R_FB               = 41,
        XR_FACE_EXPRESSION2_LIP_STRETCHER_L_FB            = 42,
        XR_FACE_EXPRESSION2_LIP_STRETCHER_R_FB            = 43,
        XR_FACE_EXPRESSION2_LIP_SUCK_LB_FB                = 44,
        XR_FACE_EXPRESSION2_LIP_SUCK_LT_FB                = 45,
        XR_FACE_EXPRESSION2_LIP_SUCK_RB_FB                = 46,
        XR_FACE_EXPRESSION2_LIP_SUCK_RT_FB                = 47,
        XR_FACE_EXPRESSION2_LIP_TIGHTENER_L_FB            = 48,
        XR_FACE_EXPRESSION2_LIP_TIGHTENER_R_FB            = 49,
        XR_FACE_EXPRESSION2_LIPS_TOWARD_FB                = 50,
        XR_FACE_EXPRESSION2_LOWER_LIP_DEPRESSOR_L_FB      = 51,
        XR_FACE_EXPRESSION2_LOWER_LIP_DEPRESSOR_R_FB      = 52,
        XR_FACE_EXPRESSION2_MOUTH_LEFT_FB                 = 53,
        XR_FACE_EXPRESSION2_MOUTH_RIGHT_FB                = 54,
        XR_FACE_EXPRESSION2_NOSE_WRINKLER_L_FB            = 55,
        XR_FACE_EXPRESSION2_NOSE_WRINKLER_R_FB            = 56,
        XR_FACE_EXPRESSION2_OUTER_BROW_RAISER_L_FB        = 57,
        XR_FACE_EXPRESSION2_OUTER_BROW_RAISER_R_FB        = 58,
        XR_FACE_EXPRESSION2_UPPER_LID_RAISER_L_FB         = 59,
        XR_FACE_EXPRESSION2_UPPER_LID_RAISER_R_FB         = 60,
        XR_FACE_EXPRESSION2_UPPER_LIP_RAISER_L_FB         = 61,
        XR_FACE_EXPRESSION2_UPPER_LIP_RAISER_R_FB         = 62,
        XR_FACE_EXPRESSION2_TONGUE_TIP_INTERDENTAL_FB     = 63,
        XR_FACE_EXPRESSION2_TONGUE_TIP_ALVEOLAR_FB        = 64,
        XR_FACE_EXPRESSION2_TONGUE_FRONT_DORSAL_PALATE_FB = 65,
        XR_FACE_EXPRESSION2_TONGUE_MID_DORSAL_PALATE_FB   = 66,
        XR_FACE_EXPRESSION2_TONGUE_BACK_DORSAL_VELAR_FB   = 67,
        XR_FACE_EXPRESSION2_TONGUE_OUT_FB                 = 68,
        XR_FACE_EXPRESSION2_TONGUE_RETREAT_FB             = 69,
        XR_FACE_EXPRESSION2_COUNT_FB                      = 70;

    /**
     * XrFaceExpressionSet2FB - The set of blend shapes of a facial expression to track.
     * 
     * 
    Enumerant Descriptions
    
     * 
     * 
      
     * 
    • {@link #XR_FACE_EXPRESSION_SET2_DEFAULT_FB FACE_EXPRESSION_SET2_DEFAULT_FB} — indicates that the created {@code XrFaceTracker2FB} tracks the set of blend shapes described by {@code XrFaceExpression2FB} enum, i.e. the {@link #xrGetFaceExpressionWeights2FB GetFaceExpressionWeights2FB} function returns an array of blend shapes with the count of {@link #XR_FACE_EXPRESSION2_COUNT_FB FACE_EXPRESSION2_COUNT_FB} and can be indexed using {@code XrFaceExpression2FB}.
      • 
     * 
    
     * 
     * 
    See Also
    
     * 
     * 
    {@link XrFaceTrackerCreateInfo2FB}
    
     */
    public static final int XR_FACE_EXPRESSION_SET2_DEFAULT_FB = 0;

    /**
     * XrFaceTrackingDataSource2FB - Data source that is used to estimate facial expression.
     * 
     * 
    Enumerant Descriptions
    
     * 
     * 
      
     * 
    • {@link #XR_FACE_TRACKING_DATA_SOURCE2_VISUAL_FB FACE_TRACKING_DATA_SOURCE2_VISUAL_FB} - This value indicates that the face tracking data source supports using visual data to estimate facial expression. The runtime may also use audio to further improve the quality of the tracking.
      • 
     * 
    • {@link #XR_FACE_TRACKING_DATA_SOURCE2_AUDIO_FB FACE_TRACKING_DATA_SOURCE2_AUDIO_FB} - This value indicates that the face tracking data source supports using audio data to estimate facial expression. The runtime must not use visual data for this data source.
      • 
     * 
    
     * 
     * 
    See Also
    
     * 
     * 
    {@link XrFaceExpressionWeights2FB}, {@link XrFaceTrackerCreateInfo2FB}
    
     */
    public static final int
        XR_FACE_TRACKING_DATA_SOURCE2_VISUAL_FB = 0,
        XR_FACE_TRACKING_DATA_SOURCE2_AUDIO_FB  = 1;

    /**
     * XrFaceConfidence2FB - The name of face areas where confidence is known
     * 
     * 
    Description
    
     * 
     * 
    The "upper face" area represents everything above the upper lip, including the eyes and eyebrows. The "lower face" area represents everything under the eyes, including the mouth and chin. Cheek and nose areas contribute to both "upper face" and "lower face" areas.
    
     * 
     * 
    Enum values:
    
     * 
     * 
      
     * 
    • {@link #XR_FACE_CONFIDENCE2_LOWER_FACE_FB FACE_CONFIDENCE2_LOWER_FACE_FB}
      • 
     * 
    • {@link #XR_FACE_CONFIDENCE2_UPPER_FACE_FB FACE_CONFIDENCE2_UPPER_FACE_FB}
      • 
     * 
    • {@link #XR_FACE_CONFIDENCE2_COUNT_FB FACE_CONFIDENCE2_COUNT_FB}
      • 
     * 
    
     */
    public static final int
        XR_FACE_CONFIDENCE2_LOWER_FACE_FB = 0,
        XR_FACE_CONFIDENCE2_UPPER_FACE_FB = 1,
        XR_FACE_CONFIDENCE2_COUNT_FB      = 2;

    protected FBFaceTracking2() {
        throw new UnsupportedOperationException();
    }

    // --- [ xrCreateFaceTracker2FB ] ---

    /** Unsafe version of: {@link #xrCreateFaceTracker2FB CreateFaceTracker2FB} */
    public static int nxrCreateFaceTracker2FB(XrSession session, long createInfo, long faceTracker) {
        long __functionAddress = session.getCapabilities().xrCreateFaceTracker2FB;
        if (CHECKS) {
            check(__functionAddress);
        }
        return callPPPI(session.address(), createInfo, faceTracker, __functionAddress);
    }

    /**
     * Create a face tracking handle.
     * 
     * 
    C Specification
    
     * 
     * 
    The {@link #xrCreateFaceTracker2FB CreateFaceTracker2FB} function is defined as:
    
     * 
     * 
    
     * XrResult xrCreateFaceTracker2FB(
     *     XrSession                                   session,
     *     const XrFaceTrackerCreateInfo2FB*           createInfo,
     *     XrFaceTracker2FB*                           faceTracker);
    
     * 
     * 
    Description
    
     * 
     * 
    An application can create an {@code XrFaceTracker2FB} handle using {@link #xrCreateFaceTracker2FB CreateFaceTracker2FB} function.
    
     * 
     * 
    If the system does not support face tracking, the runtime must return {@link XR10#XR_ERROR_FEATURE_UNSUPPORTED ERROR_FEATURE_UNSUPPORTED} from {@link #xrCreateFaceTracker2FB CreateFaceTracker2FB}. In this case, the runtime must return {@link XR10#XR_FALSE FALSE} for both {@link XrSystemFaceTrackingProperties2FB}{@code ::supportsVisualFaceTracking} and {@link XrSystemFaceTrackingProperties2FB}{@code ::supportsAudioFaceTracking} when the function {@link XR10#xrGetSystemProperties GetSystemProperties} is called, so that the application can avoid creating a face tracker.
    
     * 
     * 
    Valid Usage (Implicit)
    
     * 
     * 
      
     * 
    • The {@link FBFaceTracking2 XR_FB_face_tracking2} extension must be enabled prior to calling {@link #xrCreateFaceTracker2FB CreateFaceTracker2FB}
      • 
     * 
    • {@code session} must be a valid {@code XrSession} handle
      • 
     * 
    • {@code createInfo} must be a pointer to a valid {@link XrFaceTrackerCreateInfo2FB} structure
      • 
     * 
    • {@code faceTracker} must be a pointer to an {@code XrFaceTracker2FB} handle
      • 
     * 
    
     * 
     * 
    Return Codes
    
     * 
     * 
    
     * 
    On success, this command returns
    
     * 
      
     * 
    • {@link XR10#XR_SUCCESS SUCCESS}
      • 
     * 
    • {@link XR10#XR_SESSION_LOSS_PENDING SESSION_LOSS_PENDING}
      • 
     * 
    
     * 
    On failure, this command returns
    
     * 
      
     * 
    • {@link XR10#XR_ERROR_FUNCTION_UNSUPPORTED ERROR_FUNCTION_UNSUPPORTED}
      • 
     * 
    • {@link XR10#XR_ERROR_VALIDATION_FAILURE ERROR_VALIDATION_FAILURE}
      • 
     * 
    • {@link XR10#XR_ERROR_RUNTIME_FAILURE ERROR_RUNTIME_FAILURE}
      • 
     * 
    • {@link XR10#XR_ERROR_HANDLE_INVALID ERROR_HANDLE_INVALID}
      • 
     * 
    • {@link XR10#XR_ERROR_INSTANCE_LOST ERROR_INSTANCE_LOST}
      • 
     * 
    • {@link XR10#XR_ERROR_SESSION_LOST ERROR_SESSION_LOST}
      • 
     * 
    • {@link XR10#XR_ERROR_OUT_OF_MEMORY ERROR_OUT_OF_MEMORY}
      • 
     * 
    • {@link XR10#XR_ERROR_LIMIT_REACHED ERROR_LIMIT_REACHED}
      • 
     * 
    • {@link XR10#XR_ERROR_FEATURE_UNSUPPORTED ERROR_FEATURE_UNSUPPORTED}
      • 
     * 
    
     * 
    
     * 
     * 
    See Also
    
     * 
     * 
    {@link XrFaceTrackerCreateInfo2FB}
    
     *
     * @param session     an {@code XrSession} in which the face tracker will be active.
     * @param createInfo  the {@link XrFaceTrackerCreateInfo2FB} used to specify the face tracker.
     * @param faceTracker the returned {@code XrFaceTracker2FB} handle.
     */
    @NativeType("XrResult")
    public static int xrCreateFaceTracker2FB(XrSession session, @NativeType("XrFaceTrackerCreateInfo2FB const *") XrFaceTrackerCreateInfo2FB createInfo, @NativeType("XrFaceTracker2FB *") PointerBuffer faceTracker) {
        if (CHECKS) {
            check(faceTracker, 1);
        }
        return nxrCreateFaceTracker2FB(session, createInfo.address(), memAddress(faceTracker));
    }

    // --- [ xrDestroyFaceTracker2FB ] ---

    /**
     * Destroy a facial expressions handle.
     * 
     * 
    C Specification
    
     * 
     * 
    The {@link #xrDestroyFaceTracker2FB DestroyFaceTracker2FB} function is defined as:
    
     * 
     * 
    
     * XrResult xrDestroyFaceTracker2FB(
     *     XrFaceTracker2FB                            faceTracker);
    
     * 
     * 
    Description
    
     * 
     * 
    The {@link #xrDestroyFaceTracker2FB DestroyFaceTracker2FB} function releases the {@code faceTracker} and the underlying resources when face tracking experience is over.
    
     * 
     * 
    Valid Usage (Implicit)
    
     * 
     * 
      
     * 
    • The {@link FBFaceTracking2 XR_FB_face_tracking2} extension must be enabled prior to calling {@link #xrDestroyFaceTracker2FB DestroyFaceTracker2FB}
      • 
     * 
    • {@code faceTracker} must be a valid {@code XrFaceTracker2FB} handle
      • 
     * 
    
     * 
     * 
    Thread Safety
    
     * 
     * 
      
     * 
    • Access to {@code faceTracker}, and any child handles, must be externally synchronized
      • 
     * 
    
     * 
     * 
    Return Codes
    
     * 
     * 
    
     * 
    On success, this command returns
    
     * 
      
     * 
    • {@link XR10#XR_SUCCESS SUCCESS}
      • 
     * 
    
     * 
    On failure, this command returns
    
     * 
      
     * 
    • {@link XR10#XR_ERROR_FUNCTION_UNSUPPORTED ERROR_FUNCTION_UNSUPPORTED}
      • 
     * 
    • {@link XR10#XR_ERROR_HANDLE_INVALID ERROR_HANDLE_INVALID}
      • 
     * 
    
     * 
    
     *
     * @param faceTracker an {@code XrFaceTracker2FB} previously created by {@link #xrCreateFaceTracker2FB CreateFaceTracker2FB}.
     */
    @NativeType("XrResult")
    public static int xrDestroyFaceTracker2FB(XrFaceTracker2FB faceTracker) {
        long __functionAddress = faceTracker.getCapabilities().xrDestroyFaceTracker2FB;
        if (CHECKS) {
            check(__functionAddress);
        }
        return callPI(faceTracker.address(), __functionAddress);
    }

    // --- [ xrGetFaceExpressionWeights2FB ] ---

    /** Unsafe version of: {@link #xrGetFaceExpressionWeights2FB GetFaceExpressionWeights2FB} */
    public static int nxrGetFaceExpressionWeights2FB(XrFaceTracker2FB faceTracker, long expressionInfo, long expressionWeights) {
        long __functionAddress = faceTracker.getCapabilities().xrGetFaceExpressionWeights2FB;
        if (CHECKS) {
            check(__functionAddress);
        }
        return callPPPI(faceTracker.address(), expressionInfo, expressionWeights, __functionAddress);
    }

    /**
     * Obtain blend shapes of facial expression.
     * 
     * 
    C Specification
    
     * 
     * 
    The {@link #xrGetFaceExpressionWeights2FB GetFaceExpressionWeights2FB} function is defined as:
    
     * 
     * 
    
     * XrResult xrGetFaceExpressionWeights2FB(
     *     XrFaceTracker2FB                            faceTracker,
     *     const XrFaceExpressionInfo2FB*              expressionInfo,
     *     XrFaceExpressionWeights2FB*                 expressionWeights);
    
     * 
     * 
    Description
    
     * 
     * 
    The {@link #xrGetFaceExpressionWeights2FB GetFaceExpressionWeights2FB} function return blend shapes of facial expression at a given time.
    
     * 
     * 
    Valid Usage (Implicit)
    
     * 
     * 
      
     * 
    • The {@link FBFaceTracking2 XR_FB_face_tracking2} extension must be enabled prior to calling {@link #xrGetFaceExpressionWeights2FB GetFaceExpressionWeights2FB}
      • 
     * 
    • {@code faceTracker} must be a valid {@code XrFaceTracker2FB} handle
      • 
     * 
    • {@code expressionInfo} must be a pointer to a valid {@link XrFaceExpressionInfo2FB} structure
      • 
     * 
    • {@code expressionWeights} must be a pointer to an {@link XrFaceExpressionWeights2FB} structure
      • 
     * 
    
     * 
     * 
    Return Codes
    
     * 
     * 
    
     * 
    On success, this command returns
    
     * 
      
     * 
    • {@link XR10#XR_SUCCESS SUCCESS}
      • 
     * 
    • {@link XR10#XR_SESSION_LOSS_PENDING SESSION_LOSS_PENDING}
      • 
     * 
    
     * 
    On failure, this command returns
    
     * 
      
     * 
    • {@link XR10#XR_ERROR_FUNCTION_UNSUPPORTED ERROR_FUNCTION_UNSUPPORTED}
      • 
     * 
    • {@link XR10#XR_ERROR_VALIDATION_FAILURE ERROR_VALIDATION_FAILURE}
      • 
     * 
    • {@link XR10#XR_ERROR_RUNTIME_FAILURE ERROR_RUNTIME_FAILURE}
      • 
     * 
    • {@link XR10#XR_ERROR_HANDLE_INVALID ERROR_HANDLE_INVALID}
      • 
     * 
    • {@link XR10#XR_ERROR_INSTANCE_LOST ERROR_INSTANCE_LOST}
      • 
     * 
    • {@link XR10#XR_ERROR_SESSION_LOST ERROR_SESSION_LOST}
      • 
     * 
    • {@link XR10#XR_ERROR_TIME_INVALID ERROR_TIME_INVALID}
      • 
     * 
    
     * 
    
     * 
     * 
    See Also
    
     * 
     * 
    {@link XrFaceExpressionInfo2FB}, {@link XrFaceExpressionWeights2FB}
    
     *
     * @param faceTracker       an {@code XrFaceTracker2FB} previously created by {@link #xrCreateFaceTracker2FB CreateFaceTracker2FB}.
     * @param expressionInfo    a pointer to {@link XrFaceExpressionInfo2FB} describing information to obtain face expression.
     * @param expressionWeights a pointer to {@link XrFaceExpressionWeights2FB} receiving the returned facial expression weights.
     */
    @NativeType("XrResult")
    public static int xrGetFaceExpressionWeights2FB(XrFaceTracker2FB faceTracker, @NativeType("XrFaceExpressionInfo2FB const *") XrFaceExpressionInfo2FB expressionInfo, @NativeType("XrFaceExpressionWeights2FB *") XrFaceExpressionWeights2FB expressionWeights) {
        return nxrGetFaceExpressionWeights2FB(faceTracker, expressionInfo.address(), expressionWeights.address());
    }

}




    © 2015 - 2025 Weber Informatics LLC | Privacy Policy