OpenGL ES-specific swapchain sampler state structure.

Description

When XrSwapchainStateSamplerOpenGLESFB is specified in the call to UpdateSwapchainFB, texture sampler state for all images in the XrSwapchain will be updated for both the application and compositor processes.

For most cases, the sampler state update is only required compositor-side, as that is where the swapchain images are sampled. For completeness, the application-side sampler state is additionally updated to support cases where the application may choose to directly sample the swapchain images.

Applications are expected to handle synchronization of the sampler state update with application-side rendering. Similarly, the compositor will synchronize the sampler state update with rendering of the next compositor frame.

An EGLContext, either the EGLContext bound during XrSwapchain creation or an EGLContext in the same share group, is required to be bound on the application calling thread. Current texture bindings may be altered by the call, including the active texture.

When XrSwapchainStateSamplerOpenGLESFB is specified in the call to GetSwapchainStateFB, the sampler state will be populated with the current swapchain sampler state.

To use XrSwapchainStateSamplerOpenGLESFB, USE_GRAPHICS_API_OPENGL_ES must be defined before including openxr_platform.h.

Valid Usage (Implicit)

• The XR_FB_swapchain_update_state_opengl_es extension must be enabled prior to using XrSwapchainStateSamplerOpenGLESFB
• type must be TYPE_SWAPCHAIN_STATE_SAMPLER_OPENGL_ES_FB
• next must be NULL or a valid pointer to the next structure in a structure chain
• minFilter must be a valid EGLenum value
• magFilter must be a valid EGLenum value
• wrapModeS must be a valid EGLenum value
• wrapModeT must be a valid EGLenum value
• swizzleRed must be a valid EGLenum value
• swizzleGreen must be a valid EGLenum value
• swizzleBlue must be a valid EGLenum value
• swizzleAlpha must be a valid EGLenum value

See Also

XrColor4f, GetSwapchainStateFB, UpdateSwapchainFB

Layout

struct XrSwapchainStateSamplerOpenGLESFB {
    XrStructureType type;
    void * next;
    EGLenum minFilter;
    EGLenum magFilter;
    EGLenum wrapModeS;
    EGLenum wrapModeT;
    EGLenum swizzleRed;
    EGLenum swizzleGreen;
    EGLenum swizzleBlue;
    EGLenum swizzleAlpha;
    float maxAnisotropy;
    XrColor4f borderColor;
}