eResearch

You are here

Troubleshooting

Table of contents

1 - Failed to load WebGL
2 - Failed to load WebGL even in latest Chrome and Firefox
3 - Crash in 3DSA while creating annotations

If this troubleshooting is not helpful, please contact the developer.

1 - Failed to load WebGL

WebGL is a new standard as well as a part of HTML5, therefore, not all browsers will adopt the newly created standard. Currently, Mozilla Firefox and Google Chrome have a strong support of WebGL. The first resolution is to download the latest stable version of Mozilla Firefox or Google Chrome - especially for the IE users. Safari has also a good support of WebGL, but the prototype has not been tested in Safari. If your Firefox and Chrome browser is not up-to-date, please upgrade to the latest stable version.

2 - Failed to load WebGL even in latest Chrome and Firefox

The browser vendors may choose to disable WebGL by default for certain graphical hardware (mostly the older ones). To enable WebGL in Window system, please follow the below instructions.

Mozilla Firefox in Windows
  1. Input "about:config" at the address bar (Textfield where you input the Web address).
  2. If "This might void your warranty!" pops up, do not have to worry about this message, click the button to proceed.
  3. Input "webgl" at the "Filter" field at the top.
  4. If "webgl.disabled" is disabled, enable it by double click the section.
  5. If "webgl.force-enabled" is disabled, enable it by double click the section.
  6. Finally, close the "about:config" tab, reload the 3DSA system"
Google Chrome in Windows
  1. Before running the browser, right click on the Chrome's icon/shortcut.
  2. A menu will pop-up, select "Properties"
  3. Click on the "Shortcut" tab at the top of the pop-up window.
  4. In the "Target:" field, add the following extension:

    --enable-webgl --ignore-gpu-blacklist --enable-accelerated-2d-canvas --enable-accelerated-layers

  5. Finally, click "Ok", run the Chrome browser and reload the 3DSA system.

(P.S. The browser vendors have good reasons to disable WebGL by default for certain hardware and system. Enable it at your own risk.)

3 - Crash in 3DSA while creating annotations

One of the reason is that the annotation functionality is having a conflict with the browser settings. This usually happens in Windows system, while the default setting uses ANGLE to run WebGL on top of DirectX instead of OpenGL. There is a temporary solution that requires user to run 3DSA using a proper OpenGL to avoid crashes. The following are the instructions to enable native OpenGL for Firefox and Chrome in Windows system(P.S. You will need a graphic card and up-to-date OpenGL driver installed):

Mozilla Firefox in Windows
  1. Input "about:config" at the address bar (Textfield where you input the Web address).
  2. If "This might void your warranty!" pops up, do not have to worry about this message, click the button to proceed.
  3. Input "webgl" at the "Filter" field at the top.
  4. If "webgl.prefer-native-gl" is disabled, enable it by double click the section.
  5. Finally, close the "about:config" tab, reload the 3DSA system"
Google Chrome in Windows
  1. Before running the browser, right click on the Chrome's icon/shortcut.
  2. A menu will pop-up, select "Properties"
  3. Click on the "Shortcut" tab at the top of the pop-up window.
  4. In the "Target:" field, add the following extension:

    --use-gl=desktop

  5. Finally, click "Ok", run the Chrome browser and reload the 3DSA system.

If these procedures cause 3DSA to come up an error message saying your browser does not support WebGL, this means either you do not have an up-to-date OpenGL drivers, or the computer is still using an older graphics card or Intel's graphical chips (have very limited OpenGL support). The solution is to upgrade your graphical hardware or update the driver to supports OpenGL 2.0 .