Tips and troubleshooting

This appendix explains how to use advanced Web browser settings to ensure that WebGL is displayed correctly, and what to do if it isn’t.

If your graphics board isn't compatible with WebGL, you may see the message shown in Figure H.1.

H1

Figure H.1 Loading HelloTriangle results in a red triangle

If this happens, you may still be able to get WebGL to work in your browser with a little bit of tweaking:

    1. If you are using Chrome, start the browser with the option --ignore-gpu-blacklist. To specify this option, right-click the Chrome browser shortcut icon and select “Properties” from the menu. It will show a pop-up window similar to that in Figure H.2. Then, add the option string at the end of command string in the “Target” column on the window. After that, Chrome is always started with the option so if this solves your problem then leave this option enabled.

H2

              1. Figure H.2 Specifying an option in the Google Chrome Properties window

    1. If you are using Firefox, enter about:config in the address bar of Firefox. Firefox shows “This might void your warranty!”. Push the button labeled “I’ll be careful, I promise!”. Type webgl in the text field labeled by “Search” or “Filter” and then Firefox will display the WebGL-related setting names (see Figure H.3). Double-click the webgl.force-enabled in the list to change its value from false to true. Again, if this solves your problem then leave this option enabled.

H3