C Specification

The XrFacialExpressionClientCreateInfoML structure is defined as follows:

// Provided by XR_ML_facial_expression
typedef struct XrFacialExpressionClientCreateInfoML {
    XrStructureType                type;
    const void*                    next;
    uint32_t                       requestedCount;
    const XrFacialBlendShapeML*    requestedFacialBlendShapes;
} XrFacialExpressionClientCreateInfoML;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

  • next is NULL or a pointer to the next structure in a structure chain. No such structures are defined in core OpenXR or this extension.

  • requestedCount is the size of the requestedFacialBlendShapes array

  • requestedFacialBlendShapes is a pointer to an application defined array containing the blend shapes for the runtime to target.

Description

Note that although the naming convention for requestedCount does not align with requestedFacialBlendShapes, they are coupled together.

The XrFacialExpressionClientCreateInfoML structure describes the information to create an XrFacialExpressionClientML handle.

An application specifies the blend shapes they want to query by creating an array of type XrFacialBlendShapeML and passing it to requestedFacialBlendShapes along with the corresponding requestedCount.

The application can also pass in NULL into requestedFacialBlendShapes to capture the entirety of XrFacialBlendShapeML. However, for performance reasons, it may be better to be explicit about what blend shapes to query for performance reasons since some blend shapes may be queried by the runtime at a greater frequency than other blend shapes.

Valid Usage (Implicit)

See Also

XR_ML_facial_expression, XrFacialBlendShapeML, XrStructureType, xrCreateFacialExpressionClientML, xrDestroyFacialExpressionClientML

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-2025 The Khronos Group Inc.

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