C Specification

The XrEventDataBoundaryVisibilityChangedMETA structure is defined as:

// Provided by XR_META_boundary_visibility
typedef struct XrEventDataBoundaryVisibilityChangedMETA {
    XrStructureType             type;
    const void*                 next;
    XrBoundaryVisibilityMETA    boundaryVisibility;
} XrEventDataBoundaryVisibilityChangedMETA;

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.

  • boundaryVisibility is an XrBoundaryVisibilityMETA value to represent the boundary visibility changed in the runtime.

Description

The XrEventDataBoundaryVisibilityChangedMETA structure represents an event indicating that the boundary visibility has changed in the runtime. This event may be a result of the xrRequestBoundaryVisibilityMETA function called from this application or some other application. This event may also be a result of runtime-specific conditions that changed the boundary visibility. An example of the runtime-specific conditions may be the application fully obscuring the real world environment, in which case the runtime may change the boundary visibility to XR_BOUNDARY_VISIBILITY_NOT_SUPPRESSED_META.

The runtime must queue this event upon a successful call to the xrBeginSession function, regardless of the value of boundaryVisibility, so that the application is in sync on the value of the boundary visibility when a session begins running.

The runtime must return a valid XrSession handle for a running session.

After the application calls xrEndSession, a running session is ended and the runtime must not enqueue this event anymore. Therefore, the application will no longer observe any changes of the boundaryVisibility until another running session.

Valid Usage (Implicit)

See Also

XR_META_boundary_visibility, XrBoundaryVisibilityMETA, XrStructureType, xrRequestBoundaryVisibilityMETA

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

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