Troubleshooting - mbucchia/Quad-Views-Foveated GitHub Wiki

Instructions for troubleshooting issues

Location of the log file: %LocalAppData%\Quad-Views-Foveated\Quad-Views-Foveated.log

No log file or stale log file

Content of the log file

Here are a few tips for reading the log file.

2023-06-18 00:53:06 +0100: Application: DCS World

The line above can be used to confirm that your application was started in the correct mode (OpenXR). If you do not see that, make sure you are running the latest version of the application and that you configured it to use OpenXR.

2023-06-18 00:53:06 +0100: Using OpenXR runtime: [...]

The line above shows which OpenXR runtime is set up as active on your system.

If you are trying to use eye tracking, you want to see one of the following values depending on your headset:

If you are not seeing the expected value for your headset, click the link above corresponding to your headset for instructions on using eye tracking.

2023-06-18 00:53:06 +0100: Trying to locate configuration file at 'C:\Program Files\OpenXR-Quad-Views-Foveated\settings.cfg'...
2023-06-18 00:53:06 +0100:   Found option 'peripheral_multiplier=0.4'
2023-06-18 00:53:06 +0100:   Found option 'focus_multiplier=0.95'
2023-06-18 00:53:06 +0100:   Found option 'horizontal_focus_section=0.5'
2023-06-18 00:53:06 +0100:   Found option 'vertical_focus_section=0.5'
2023-06-18 00:53:06 +0100: Trying to locate configuration file at 'C:\Users\<user>\AppData\Local\Quad-Views-Foveated\settings.cfg'...
2023-06-18 00:53:06 +0100:   Found option 'turbo_mode=0'

The blob above can be used to troubleshoot loading and parsing of your configuration file.

2023-06-18 00:53:06 +0100: Eye tracking is supported

The lines above confirm that eye tracking can be used on your headset. If you do not see that, click the link below corresponding to your headset for instructions on using eye tracking.

2023-06-18 00:53:06 +0100: Recommended peripheral resolution: 1113x1145 (0.400x density)
2023-06-18 00:53:06 +0100: Recommended focus resolution: 1322x1360 (0.950x density)

The lines above can be used to inspect the effective resolutions used for each region.

Things that can go wrong

Foveated rendering is not following your eye gaze accurately / Resolution is very low in the eye-tracked region

Make sure your eye tracker is calibrated. Try the calibration procedure again. Click the link below corresponding to your headset for instructions.

(Meta Quest Pro) Developer mode is not working properly

2023-06-21 22:57:35 +0700: xrBeginSession: XrResult failure [XR_ERROR_RUNTIME_FAILURE]
    Origin: OpenXrApi::xrCreateEyeTrackerFB(session, &createInfo, &m_eyeTrackerFB)
    Source: D:\a\Meta-Foveated\Meta-Foveated\openxr-api-layer\layer.cpp:623

If you are seeing the above in your log file, you are victim of the Oculus Developer mode bug. Make sure you followed the Prerequisites section and enabled Developer mode in both the PC application and the phone application.

If the issue persist, please file a bug report to Meta. It is their bug and it has plagued many users of their headsets for several months now..

(Meta Quest Pro) Application crashes upon taking off your headset

This is a known issue that seems to affect only certain users. Please try disabling the Turbo Mode (in the Advanced Configuration to mitigate the issue.

Still need help?

You can join the OpenXR Toolkit Discord for support, in the #foveated-rendering channel.

IF YOU DON'T INCLUDE YOUR LOG FILE AND A CLEAR EXPLANATION OF YOUR ISSUE, YOUR MESSAGE WILL BE IGNORED.

⚠️ **GitHub.com Fallback** ⚠️