Top Description Fields Constructors Methods
org.lwjgl.openxr

public Class FBEyeTrackingSocial

extends Object
Class Inheritance
Imports
org.lwjgl.*, org.lwjgl.system.*

The XR_FB_eye_tracking_social extension.

This extension enables applications to obtain position and orientation of the user’s eyes. It enables applications to render eyes in XR experiences.

This extension is intended to drive animation of avatar eyes. So, for that purpose, the runtimes may filter the poses in ways that are suitable for avatar eye interaction but detrimental to other use cases. This extension should not be used for other eye tracking purposes. For interaction, XR_EXT_eye_gaze_interaction should be used.

Eye tracking data is sensitive personal information and is closely linked to personal privacy and integrity. It is strongly recommended that applications that store or transfer eye tracking data always ask the user for active and specific acceptance to do so.

If a runtime supports a permission system to control application access to the eye tracker, then the runtime must set the isValid field to FALSE on the supplied XrEyeGazeFB structure until the application has been allowed access to the eye tracker. When the application access has been allowed, the runtime may set isValid on the supplied XrEyeGazeFB structure to TRUE.

Field Summary

Modifier and TypeField and Description
public static final int
XR_EYE_POSITION_COUNT_FB

XrEyePositionFB - Enumerates eyes.

public static final int
XR_EYE_POSITION_LEFT_FB

XrEyePositionFB - Enumerates eyes.

public static final int
XR_EYE_POSITION_RIGHT_FB

XrEyePositionFB - Enumerates eyes.

public static final String
public static final int
XR_FB_eye_tracking_social_SPEC_VERSION

The extension specification version.

public static final int
XR_OBJECT_TYPE_EYE_TRACKER_FB

Extends XrObjectType.

public static final int
XR_TYPE_EYE_GAZES_FB

Extends XrStructureType.

public static final int
XR_TYPE_EYE_GAZES_INFO_FB

Extends XrStructureType.

public static final int
XR_TYPE_EYE_TRACKER_CREATE_INFO_FB

Extends XrStructureType.

public static final int

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
public static int
nxrCreateEyeTrackerFB(XrSession session, long createInfo, long eyeTracker)

Unsafe version of: CreateEyeTrackerFB

public static int
nxrGetEyeGazesFB(XrEyeTrackerFB eyeTracker, long gazeInfo, long eyeGazes)

Unsafe version of: GetEyeGazesFB

public static int
xrCreateEyeTrackerFB(XrSession
an XrSession in which the eye tracker will be active.
session
,
XrEyeTrackerCreateInfoFB
the XrEyeTrackerCreateInfoFB used to specify the eye tracker.
createInfo
,
PointerBuffer
the returned XrEyeTrackerFB handle.
eyeTracker
)

Create an eye gaze handle.

public static int
xrDestroyEyeTrackerFB(XrEyeTrackerFB
an XrEyeTrackerFB previously created by CreateEyeTrackerFB.
eyeTracker
)

Destroy an eye gaze handle.

public static int
xrGetEyeGazesFB(XrEyeTrackerFB
an XrEyeTrackerFB previously created by CreateEyeTrackerFB.

a pointer to XrEyeGazesFB receiving the returned eye poses and confidence.

eyeTracker
,
XrEyeGazesInfoFB
the information to get eye gaze.
gazeInfo
,
XrEyeGazesFB eyeGazes)

Locate eye gaze directions.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

XR_EYE_POSITION_COUNT_FBback to summary
public static final int XR_EYE_POSITION_COUNT_FB

XrEyePositionFB - Enumerates eyes.

Enumerant Descriptions
See Also

XrEyeGazesFB

Enum values:
XR_EYE_POSITION_LEFT_FBback to summary
public static final int XR_EYE_POSITION_LEFT_FB

XrEyePositionFB - Enumerates eyes.

Enumerant Descriptions
See Also

XrEyeGazesFB

Enum values:
XR_EYE_POSITION_RIGHT_FBback to summary
public static final int XR_EYE_POSITION_RIGHT_FB

XrEyePositionFB - Enumerates eyes.

Enumerant Descriptions
See Also

XrEyeGazesFB

Enum values:
XR_FB_EYE_TRACKING_SOCIAL_EXTENSION_NAMEback to summary
public static final String XR_FB_EYE_TRACKING_SOCIAL_EXTENSION_NAME

The extension name.

XR_FB_eye_tracking_social_SPEC_VERSIONback to summary
public static final int XR_FB_eye_tracking_social_SPEC_VERSION

The extension specification version.

XR_OBJECT_TYPE_EYE_TRACKER_FBback to summary
public static final int XR_OBJECT_TYPE_EYE_TRACKER_FB

Extends XrObjectType.

XR_TYPE_EYE_GAZES_FBback to summary
public static final int XR_TYPE_EYE_GAZES_FB

Extends XrStructureType.

Enum values:
XR_TYPE_EYE_GAZES_INFO_FBback to summary
public static final int XR_TYPE_EYE_GAZES_INFO_FB

Extends XrStructureType.

Enum values:
XR_TYPE_EYE_TRACKER_CREATE_INFO_FBback to summary
public static final int XR_TYPE_EYE_TRACKER_CREATE_INFO_FB

Extends XrStructureType.

Enum values:
XR_TYPE_SYSTEM_EYE_TRACKING_PROPERTIES_FBback to summary
public static final int XR_TYPE_SYSTEM_EYE_TRACKING_PROPERTIES_FB

Extends XrStructureType.

Enum values:

Constructor Detail

FBEyeTrackingSocialback to summary
protected FBEyeTrackingSocial()

Method Detail

nxrCreateEyeTrackerFBback to summary
public static int nxrCreateEyeTrackerFB(XrSession session, long createInfo, long eyeTracker)

Unsafe version of: CreateEyeTrackerFB

nxrGetEyeGazesFBback to summary
public static int nxrGetEyeGazesFB(XrEyeTrackerFB eyeTracker, long gazeInfo, long eyeGazes)

Unsafe version of: GetEyeGazesFB

xrCreateEyeTrackerFBback to summary
public static int xrCreateEyeTrackerFB(XrSession session, XrEyeTrackerCreateInfoFB createInfo, PointerBuffer eyeTracker)

Create an eye gaze handle.

C Specification

An application creates an XrEyeTrackerFB handle using CreateEyeTrackerFB function.


XrResult xrCreateEyeTrackerFB(
    XrSession                                   session,
    const XrEyeTrackerCreateInfoFB*             createInfo,
    XrEyeTrackerFB*                             eyeTracker);
Description

If the system does not support eye tracking, the runtime must return ERROR_FEATURE_UNSUPPORTED from CreateEyeTrackerFB. In this case, the runtime must return FALSE for supportsEyeTracking in XrSystemEyeTrackingPropertiesFB when the function GetSystemProperties is called, so that the application can avoid creating an eye tracker.

Valid Usage (Implicit)
Return Codes
On success, this command returns
On failure, this command returns
See Also

XrEyeTrackerCreateInfoFB

Parameters
session:XrSession

an XrSession in which the eye tracker will be active.

createInfo:XrEyeTrackerCreateInfoFB

the XrEyeTrackerCreateInfoFB used to specify the eye tracker.

eyeTracker:PointerBuffer

the returned XrEyeTrackerFB handle.

Annotations
@NativeType:XrResult
xrDestroyEyeTrackerFBback to summary
public static int xrDestroyEyeTrackerFB(XrEyeTrackerFB eyeTracker)

Destroy an eye gaze handle.

C Specification

DestroyEyeTrackerFB function releases the eyeTracker and the underlying resources when the eye tracking experience is over.


XrResult xrDestroyEyeTrackerFB(
    XrEyeTrackerFB                              eyeTracker);
Valid Usage (Implicit)
Thread Safety
  • Access to eyeTracker, and any child handles, must be externally synchronized
Return Codes
On success, this command returns
On failure, this command returns
Parameters
eyeTracker:XrEyeTrackerFB

an XrEyeTrackerFB previously created by CreateEyeTrackerFB.

Annotations
@NativeType:XrResult
xrGetEyeGazesFBback to summary
public static int xrGetEyeGazesFB(XrEyeTrackerFB eyeTracker, XrEyeGazesInfoFB gazeInfo, XrEyeGazesFB eyeGazes)

Locate eye gaze directions.

C Specification

The GetEyeGazesFB function is defined as:


XrResult xrGetEyeGazesFB(
    XrEyeTrackerFB                              eyeTracker,
    const XrEyeGazesInfoFB*                     gazeInfo,
    XrEyeGazesFB*                               eyeGazes);
Description

The GetEyeGazesFB function obtains pose for a user’s eyes at a specific time and within a specific coordinate system.

Valid Usage (Implicit)
Return Codes
On success, this command returns
On failure, this command returns
See Also

XrEyeGazesFB, XrEyeGazesInfoFB

Parameters
eyeTracker:XrEyeTrackerFB

an XrEyeTrackerFB previously created by CreateEyeTrackerFB.

a pointer to XrEyeGazesFB receiving the returned eye poses and confidence.

gazeInfo:XrEyeGazesInfoFB

the information to get eye gaze.

Annotations
@NativeType:XrResult