Package org.lwjgl.openxr

Class ALMALENCEDigitalLensControl

java.lang.Object

org.lwjgl.openxr.ALMALENCEDigitalLensControl

public class ALMALENCEDigitalLensControl
extends Object

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 does not 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

Fields

Modifier and Type	Field	Description
static final String	XR_ALMALENCE_DIGITAL_LENS_CONTROL_EXTENSION_NAME	The extension name.
static final int	XR_ALMALENCE_digital_lens_control_SPEC_VERSION	The extension specification version.
static final int	XR_DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE	XrDigitalLensControlFlagBitsALMALENCE - XrDigitalLensControlFlagBitsALMALENCE
static final int	XR_TYPE_DIGITAL_LENS_CONTROL_ALMALENCE	Extends XrStructureType.

Method Summary

Modifier and Type	Method	Description
static int	nxrSetDigitalLensControlALMALENCE(XrSession session, long digitalLensControl)	Unsafe version of: SetDigitalLensControlALMALENCE
static int	xrSetDigitalLensControlALMALENCE(XrSession session, XrDigitalLensControlALMALENCE digitalLensControl)	Sets DLVR status.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

XR_ALMALENCE_digital_lens_control_SPEC_VERSION

public static final int XR_ALMALENCE_digital_lens_control_SPEC_VERSION

The extension specification version.

See Also:

• Constant Field Values

XR_ALMALENCE_DIGITAL_LENS_CONTROL_EXTENSION_NAME

public static final String XR_ALMALENCE_DIGITAL_LENS_CONTROL_EXTENSION_NAME

The extension name.

See Also:

• Constant Field Values

XR_TYPE_DIGITAL_LENS_CONTROL_ALMALENCE

public static final int XR_TYPE_DIGITAL_LENS_CONTROL_ALMALENCE

Extends XrStructureType.

See Also:

• Constant Field Values

XR_DIGITAL_LENS_CONTROL_PROCESSING_DISABLE_BIT_ALMALENCE

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

See Also:

• Constant Field Values

Method Details

nxrSetDigitalLensControlALMALENCE

public static int nxrSetDigitalLensControlALMALENCE(XrSession session,
 long digitalLensControl)

Unsafe version of: SetDigitalLensControlALMALENCE

xrSetDigitalLensControlALMALENCE

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 - a handle to a running XrSession.

digitalLensControl - the XrDigitalLensControlALMALENCE that contains desired characteristics for the Digital Lens