LWJGL 3.3.3 · org.lwjgl.openxr.ALMALENCEDigitalLensControl

The XR_ALMALENCE_digital_lens_control extension.

Digital Lens for VR (DLVR) is a computational lens aberration correction technology enabling high resolution, visual clarity and fidelity in VR head mounted displays. The Digital Lens allows to overcome two fundamental factors limiting VR picture quality, size constraints and presence of a moving optical element — the eye pupil.

Features:

Complete removal of lateral chromatic aberrations, across the entire FoV, at all gaze directions.
Correction of longitudinal chromatic aberrations, lens blur and higher order aberrations.
Increase of visible resolution.
Enhancement of edge contrast (otherwise degraded due to lens smear).
Enables high quality at wide FoV.

For OpenXR runtimes DLVR is implemented as implicit API Layer distributed by Almalence Inc. as installable package. DLVR utilize eye tracking data (eye pupil coordinates and gaze direction) to produce corrections of render frames. As long as current core OpenXR API doesn’t expose an eye tracking data, DLVR API Layer relies on 3rd-party eye tracking runtimes.

List of supported eye tracking devices:

Tobii_VR4_CARBON_P1 (HP Reverb G2 Omnicept Edition)
Tobii_VR4_U2_P2 (HTC Vive Pro Eye)

This extension enables the handling of the Digital Lens for VR API Layer by calling SetDigitalLensControlALMALENCE.

Field Summary

Modifier and Type	Field and Description
public static final String	XR_ALMALENCE_DIGITAL_LENS_CONTROL_EXTENSION_NAME The extension name.
public static final int	XR_ALMALENCE_digital_lens_control_SPEC_VERSION The extension specification version.
public static final int	XR_DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE XrDigitalLensControlFlagBitsALMALENCE - XrDigitalLensControlFlagBitsALMALENCE Flag Descriptions `DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE` — disables Digital Lens processing of render textures
public static final int	XR_TYPE_DIGITAL_LENS_CONTROL_ALMALENCE Extends `XrStructureType`.

Access	Constructor and Description
protected	ALMALENCEDigitalLensControl()

Method Summary

Modifier and Type	Method and Description
public static int	nxrSetDigitalLensControlALMALENCE(XrSession session, long digitalLensControl) Unsafe version of: `SetDigitalLensControlALMALENCE`
public static int	xrSetDigitalLensControlALMALENCE(XrSession a handle to a running `XrSession`. session, XrDigitalLensControlALMALENCE the `XrDigitalLensControlALMALENCE` that contains desired characteristics for the Digital Lens digitalLensControl) Sets DLVR status.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

XR_ALMALENCE_DIGITAL_LENS_CONTROL_EXTENSION_NAME	back to summary
public static final String XR_ALMALENCE_DIGITAL_LENS_CONTROL_EXTENSION_NAME The extension name.

XR_ALMALENCE_digital_lens_control_SPEC_VERSION	back to summary
public static final int XR_ALMALENCE_digital_lens_control_SPEC_VERSION The extension specification version.

XR_DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE back to summary

XR_DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE	back to summary
public static final int XR_DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE XrDigitalLensControlFlagBitsALMALENCE - XrDigitalLensControlFlagBitsALMALENCE Flag Descriptions `DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE` — disables Digital Lens processing of render textures

public static final int XR_DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE

XrDigitalLensControlFlagBitsALMALENCE - XrDigitalLensControlFlagBitsALMALENCE

Flag Descriptions

DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE — disables Digital Lens processing of render textures

XR_TYPE_DIGITAL_LENS_CONTROL_ALMALENCE	back to summary
public static final int XR_TYPE_DIGITAL_LENS_CONTROL_ALMALENCE Extends `XrStructureType`.

Constructor Detail

ALMALENCEDigitalLensControl	back to summary
protected ALMALENCEDigitalLensControl()

Method Detail

nxrSetDigitalLensControlALMALENCE	back to summary
public static int nxrSetDigitalLensControlALMALENCE(XrSession session, long digitalLensControl) Unsafe version of: `SetDigitalLensControlALMALENCE`

xrSetDigitalLensControlALMALENCE back to summary

xrSetDigitalLensControlALMALENCE	back to summary
public static int xrSetDigitalLensControlALMALENCE(XrSession session, XrDigitalLensControlALMALENCE digitalLensControl) Sets DLVR status. C Specification The `SetDigitalLensControlALMALENCE` function is defined as: `XrResult xrSetDigitalLensControlALMALENCE( XrSession session, const XrDigitalLensControlALMALENCE* digitalLensControl);` Description `SetDigitalLensControlALMALENCE` handles state of Digital Lens API Layer Valid Usage (Implicit) The `XR_ALMALENCE_digital_lens_control` extension must be enabled prior to calling `SetDigitalLensControlALMALENCE` `session` must be a valid `XrSession` handle `digitalLensControl` must be a pointer to a valid `XrDigitalLensControlALMALENCE` structure Return Codes On success, this command returns `SUCCESS` `SESSION_LOSS_PENDING` On failure, this command returns `ERROR_FUNCTION_UNSUPPORTED` `ERROR_HANDLE_INVALID` `ERROR_INSTANCE_LOST` `ERROR_SESSION_LOST` See Also `XrDigitalLensControlALMALENCE` Parameters session:XrSession a handle to a running `XrSession`. digitalLensControl:XrDigitalLensControlALMALENCE the `XrDigitalLensControlALMALENCE` that contains desired characteristics for the Digital Lens Annotations @NativeType:XrResult

public static int xrSetDigitalLensControlALMALENCE(XrSession session, XrDigitalLensControlALMALENCE digitalLensControl)

Sets DLVR status.

C Specification

The SetDigitalLensControlALMALENCE function is defined as:


XrResult xrSetDigitalLensControlALMALENCE(
    XrSession                                   session,
    const XrDigitalLensControlALMALENCE*        digitalLensControl);

Description

SetDigitalLensControlALMALENCE handles state of Digital Lens API Layer

Valid Usage (Implicit)

The XR_ALMALENCE_digital_lens_control extension must be enabled prior to calling SetDigitalLensControlALMALENCE
session must be a valid XrSession handle
digitalLensControl must be a pointer to a valid XrDigitalLensControlALMALENCE structure

Return Codes

On success, this command returns

On failure, this command returns

public Class ALMALENCEDigitalLensControl