C Specification

The XrFoveationApplyInfoHTC structure is defined as:

// Provided by XR_HTC_foveation
typedef struct XrFoveationApplyInfoHTC {
    XrStructureType         type;
    const void*             next;
    XrFoveationModeHTC      mode;
    uint32_t                subImageCount;
    XrSwapchainSubImage*    subImages;
} XrFoveationApplyInfoHTC;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

  • next is NULL or a pointer to the next structure in a structure chain.

  • mode is an XrFoveationModeHTC enum describing the foveation mode.

  • subImageCount is the count of subImages in the subImages array. This must be equal to the number of view poses returned by xrLocateViews.

  • subImages is an array of XrSwapchainSubImage to apply foveated rendering.

Description

The application should set the following configurations in XrFoveationApplyInfoHTC:

  • The foveation mode to be applied.

  • The specified XrSwapchainSubImage to the corresponding view.

The XrSwapchain::faceCount of the swapchain in XrSwapchainSubImage must be 1 since this extension does not support cubemaps.

If mode is XR_FOVEATION_MODE_DYNAMIC_HTC, the next chain for this structure must include XrFoveationDynamicModeInfoHTC structure.

If mode is XR_FOVEATION_MODE_CUSTOM_HTC, the next chain for this structure must include XrFoveationCustomModeInfoHTC structure.

The order of subImages must be the same order as in XrCompositionLayerProjectionView when submitted in xrEndFrame.

Valid Usage (Implicit)

See Also

XR_HTC_foveation, XrFoveationModeHTC, XrStructureType, XrSwapchainSubImage, xrApplyFoveationHTC

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.