Class MSFTCompositionLayerReprojection
- java.lang.Object
-
- org.lwjgl.openxr.MSFTCompositionLayerReprojection
-
public class MSFTCompositionLayerReprojection extends java.lang.ObjectThe MSFT_composition_layer_reprojection extension.
-
-
Field Summary
Fields Modifier and Type Field Description static intXR_ERROR_REPROJECTION_MODE_UNSUPPORTED_MSFTExtendsXrResult.static java.lang.StringXR_MSFT_COMPOSITION_LAYER_REPROJECTION_EXTENSION_NAMEThe extension name.static intXR_MSFT_composition_layer_reprojection_SPEC_VERSIONThe extension specification version.static intXR_REPROJECTION_MODE_DEPTH_MSFT
XR_REPROJECTION_MODE_ORIENTATION_ONLY_MSFT
XR_REPROJECTION_MODE_PLANAR_FROM_DEPTH_MSFT
XR_REPROJECTION_MODE_PLANAR_MANUAL_MSFTXrReprojectionModeMSFT - Describes the reprojection mode of a composition layerstatic intXR_TYPE_COMPOSITION_LAYER_REPROJECTION_INFO_MSFT
XR_TYPE_COMPOSITION_LAYER_REPROJECTION_PLANE_OVERRIDE_MSFTExtendsXrStructureType.
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static intnxrEnumerateReprojectionModesMSFT(org.lwjgl.openxr.XrInstance instance, long systemId, int viewConfigurationType, int modeCapacityInput, long modeCountOutput, long modes)Unsafe version of:EnumerateReprojectionModesMSFTstatic intxrEnumerateReprojectionModesMSFT(org.lwjgl.openxr.XrInstance instance, long systemId, int viewConfigurationType, java.nio.IntBuffer modeCountOutput, java.nio.IntBuffer modes)Queries the supported reprojection modes.
-
-
-
Field Detail
-
XR_MSFT_composition_layer_reprojection_SPEC_VERSION
The extension specification version.
-
XR_MSFT_COMPOSITION_LAYER_REPROJECTION_EXTENSION_NAME
The extension name.
-
XR_TYPE_COMPOSITION_LAYER_REPROJECTION_INFO_MSFT, XR_TYPE_COMPOSITION_LAYER_REPROJECTION_PLANE_OVERRIDE_MSFT
ExtendsXrStructureType.Enum values:
-
XR_ERROR_REPROJECTION_MODE_UNSUPPORTED_MSFT
ExtendsXrResult.
-
XR_REPROJECTION_MODE_DEPTH_MSFT, XR_REPROJECTION_MODE_PLANAR_FROM_DEPTH_MSFT, XR_REPROJECTION_MODE_PLANAR_MANUAL_MSFT, XR_REPROJECTION_MODE_ORIENTATION_ONLY_MSFT
XrReprojectionModeMSFT - Describes the reprojection mode of a composition layerDescription
REPROJECTION_MODE_DEPTH_MSFTindicates the corresponding layer may benefit from per-pixel depth reprojection provided byXrCompositionLayerDepthInfoKHRto the projection layer. This mode is typically used for world-locked content that should remain physically stationary as the user walks around.REPROJECTION_MODE_PLANAR_FROM_DEPTH_MSFTindicates the corresponding layer may benefit from planar reprojection and the plane can be calculated from the corresponding depth information provided byXrCompositionLayerDepthInfoKHRto the projection layer. This mode works better when the application knows the content is mostly placed on a plane.REPROJECTION_MODE_PLANAR_MANUAL_MSFTindicates that the corresponding layer may benefit from planar reprojection. The application can customize the plane by chaining anXrCompositionLayerReprojectionPlaneOverrideMSFTstructure to the same layer. The app can also omit the plane override, indicating the runtime should use the default reprojection plane settings. This mode works better when the application knows the content is mostly placed on a plane, or when it cannot afford to submit depth information.REPROJECTION_MODE_ORIENTATION_ONLY_MSFTindicates the layer should be stabilized only for changes to orientation, ignoring positional changes. This mode works better for body-locked content that should follow the user as they walk around, such as 360-degree video.
When the application passes
REPROJECTION_MODE_DEPTH_MSFTorREPROJECTION_MODE_PLANAR_FROM_DEPTH_MSFTmode, it should also provide the depth buffer for the corresponding layer usingXrCompositionLayerDepthInfoKHRin XR_KHR_composition_layer_depth extension. However, if the application does not submit this depth buffer, the runtime must apply a runtime defined fallback reprojection mode, and must not fail theEndFramefunction because of this missing depth.When the application passes
REPROJECTION_MODE_PLANAR_MANUAL_MSFTorREPROJECTION_MODE_ORIENTATION_ONLY_MSFTmode, it should avoid providing a depth buffer for the corresponding layer usingXrCompositionLayerDepthInfoKHRin XR_KHR_composition_layer_depth extension. However, if the application does submit this depth buffer, the runtime must not fail theEndFramefunction because of this unused depth data.See Also
XrCompositionLayerReprojectionInfoMSFT,EnumerateReprojectionModesMSFT
-
-
Method Detail
-
nxrEnumerateReprojectionModesMSFT
public static int nxrEnumerateReprojectionModesMSFT(org.lwjgl.openxr.XrInstance instance, long systemId, int viewConfigurationType, int modeCapacityInput, long modeCountOutput, long modes)Unsafe version of:EnumerateReprojectionModesMSFT- Parameters:
modeCapacityInput- the capacity of the array, or 0 to indicate a request to retrieve the required capacity.
-
xrEnumerateReprojectionModesMSFT
public static int xrEnumerateReprojectionModesMSFT(org.lwjgl.openxr.XrInstance instance, long systemId, int viewConfigurationType, java.nio.IntBuffer modeCountOutput, @Nullable java.nio.IntBuffer modes)Queries the supported reprojection modes.C Specification
First, the application uses
EnumerateReprojectionModesMSFTto inspect what reprojection mode the view configuration supports.The
EnumerateReprojectionModesMSFTfunction returns the supported reprojection modes of the view configuration.XrResult xrEnumerateReprojectionModesMSFT( XrInstance instance, XrSystemId systemId, XrViewConfigurationType viewConfigurationType, uint32_t modeCapacityInput, uint32_t* modeCountOutput, XrReprojectionModeMSFT* modes);Valid Usage (Implicit)
- The
XR_MSFT_composition_layer_reprojectionextension must be enabled prior to callingEnumerateReprojectionModesMSFT instancemust be a validXrInstancehandleviewConfigurationTypemust be a validXrViewConfigurationTypevaluemodeCountOutputmust be a pointer to auint32_tvalue- If
modeCapacityInputis not 0,modesmust be a pointer to an array ofmodeCapacityInputXrReprojectionModeMSFTvalues
Return Codes
- On success, this command returns
- On failure, this command returns
A system may support different sets of reprojection modes for different view configuration types.
- Parameters:
instance- the instance from whichsystemIdwas retrieved.systemId- theXrSystemIdwhose reprojection modes will be enumerated.viewConfigurationType- theXrViewConfigurationTypeto enumerate.modeCountOutput- a pointer to the count of the array, or a pointer to the required capacity in the case thatmodeCapacityInputis 0.modes- a pointer to an application-allocated array that will be filled with theXrReprojectionModeMSFTvalues that are supported by the runtime. It can beNULLifmodeCapacityInputis 0.
- The
-
-