xrGetFaceExpressionWeightsFB(3)

C Specification

The xrGetFaceExpressionWeightsFB function return blend shapes of facial expression at a given time.

// Provided by XR_FB_face_tracking
XrResult xrGetFaceExpressionWeightsFB(
    XrFaceTrackerFB                             faceTracker,
    const XrFaceExpressionInfoFB*               expressionInfo,
    XrFaceExpressionWeightsFB*                  expressionWeights);

Parameters

Parameter Descriptions

faceTracker is an XrFaceTrackerFB previously created by xrCreateFaceTrackerFB.
expressionInfo is a pointer to XrFaceExpressionInfoFB describing information to obtain face expression.
expressionWeights is a pointer to XrFaceExpressionWeightsFB receiving the returned facial expression weights.

Description

Valid Usage (Implicit)

The XR_FB_face_tracking extension must be enabled prior to calling xrGetFaceExpressionWeightsFB
faceTracker must be a valid XrFaceTrackerFB handle
expressionInfo must be a pointer to a valid XrFaceExpressionInfoFB structure
expressionWeights must be a pointer to an XrFaceExpressionWeightsFB structure

Return Codes

On success, this command returns

XR_SUCCESS
XR_SESSION_LOSS_PENDING

On failure, this command returns

XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_VALIDATION_FAILURE
XR_ERROR_RUNTIME_FAILURE
XR_ERROR_HANDLE_INVALID
XR_ERROR_INSTANCE_LOST
XR_ERROR_SESSION_LOST
XR_ERROR_TIME_INVALID

See Also

XR_FB_face_tracking, XrFaceExpressionInfoFB, XrFaceExpressionWeightsFB, XrFaceTrackerFB

Document Notes

For more information, see the OpenXR Specification

This page is extracted from the OpenXR Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2024, The Khronos Group Inc.

This work is licensed under a Creative Commons Attribution 4.0 International License.