This chapter is for help on getting the interactives (previously referred to as widgets) working. The current interactives are prototypes and have not been heavily tested across different browsers and operating systems. Most of the interactives will work in the latest version of Chrome. The interactives are currently not designed for mobile or touch devices, but are a focus when we redesign them over the coming months. ## 17.3.1\. WEBGL ON WINDOWS, LINUX AND MAC OS X[](http://csfieldguide.org.nz/appendices/Interactives.html#webgl-on-windows-linux-and-mac-os-x "Permalink to this headline") The graphics chapter makes a lot of use of the WebGL system, which can render 3D images in a web browser. It is relatively new, so older browsers and operating systems may not have it setup correctly. ### 17.3.1.1\. QUICK FIXES[](http://csfieldguide.org.nz/appendices/Interactives.html#quick-fixes "Permalink to this headline") If you are using an up-to-date version of Chrome or Firefox and the drivers for your operating system are up-to-date and the computer has a suitable GPU, then it should work. It won’t be possible to use it in Internet Explorer. For Safari you will need to adjust some settings. The details for getting WebGL set up are below. **Updating your operating system** If you’re on **Windows**, make sure you have [the Microsoft DirectX runtime](http://www.microsoft.com/en-us/download/details.aspx?id=35) installed — this is a free download from Microsoft. Once you’ve done that, make sure that you’ve got the very latest versions of the drivers for your graphics card. We recommend doing this manually, there are good tutorials on the internet. There is a good[video](http://www.pctecmech.com/tutorials/Video-Card-Drivers.php) here that explains how to do this. The easiest way is to install an free driver update program like [SlimDriver](http://download.cnet.com/SlimDrivers-Free/3000-18513_4-75279940.html) which will find missing and out-of-date drivers. For **MacOS**: 1\. Click the Apple logo. 2\. On the “Apple” menu, click “Software Update.” 3\. If there is a Mac OS X update available, you can install it. If there is a graphics driver update, it will be included in the Mac OS X update. **Updating your browser** This depends on which browser you are using. If you can use Chrome it can be a little easier to get working. * [Firefox](http://www.mozilla.org/en-US/firefox/new/): just make sure you have version 4 or higher. * Chrome: all you need to do is [install it](https://www.google.com/intl/en/chrome/browser/), or if you’re already using it, just check whether it’s updated itself to version 10 or later — this will almost certainly have happened automatically (it was released in March 2011), but you can check from the “About Google Chrome” option on the tools menu to confirm. * Safari: on Macs, OS X 10.7 has WebGL support, but it’s switched off by default. To switch it on, enable the developer menu and check the “[Enable WebGL](http://www.google.com/url?q=http%3A%2F%2Fwww.ikriz.nl%2F2011%2F08%2F23%2Fenable-webgl-in-safari&sa=D&sntz=1&usg=AFQjCNFn42c02vQLy95tRoAoDxdprFGPJA)” option. All older version of these browsers require manual enabling of WebGL. For more information on getting a WebGL implementation follow this [link](http://www.google.com/url?q=http%3A%2F%2Fwww.khronos.org%2Fwebgl%2Fwiki%2FGetting_a_WebGL_Implementation&sa=D&sntz=1&usg=AFQjCNEnTnBdVMIaarDTponyCLS5rHphOA). ### 17.3.1.2\. TROUBLE IN LINUX, WINDOWS OR MAC OS X[](http://csfieldguide.org.nz/appendices/Interactives.html#trouble-in-linux-windows-or-mac-os-x "Permalink to this headline") If the above doesn’t work then you may unfortunately have a blacklisted GPU / graphics card, or your graphics drivers may be out of date because the company has discontinued their support. In most cases we can get around this (see below). You can find an explanation of [blacklisted](http://www.google.com/url?q=http%3A%2F%2Fwww.khronos.org%2Fwebgl%2Fwiki%2FBlacklistsAndWhitelists&sa=D&sntz=1&usg=AFQjCNFATCzIoQU6-Fo8xMSQZPPKtYktjQ) cards/GPU’s for Chrome. As of January 2013 the “blacklisted” Chrome GPU’s are as follows; some may be removed from the list later. **All operating systems** * NVIDIA GeForce FX Go5200 **Windows** * Intel GMA 945 * ATI FireMV 2400 **Mac** * ATI Radeon HD2400 * ATI Radeon 2600 series * ATI Radeon X1900 * ATI Radeon HD 6490M on OS X 10.6 * GeForce 7300 GT **Linux** * AMD/ATI cards * Nvidia QuadroFX 1500 * Nvidia cards with Nouveau drivers * Nvidia cards with Nvidia drivers older than 295 * Optimus dual-GPU configurations * Intel for Mesa drivers earlier than 7.9 (just update drivers) ### 17.3.1.3\. THE WORK-AROUND[](http://csfieldguide.org.nz/appendices/Interactives.html#the-work-around "Permalink to this headline") To work around this it is easiest done in Chrome by typing “[about:flags](about:flags)” in the address bar, it will open a page. On this page find “Override software rendering list” in the list and click ‘enable’. Then look for and click the “relaunch google chrome” button or close all chrome browser windows and restart/reload Chrome. In Firefox type “[about:flags](about:flags)” in the address bar. (On this page there is a search input available) Search in this for “force-enabled”. Double click on both*layers.acceleration.force-enabled* and *webgl.force-enabled* which will set their value **true**. Then close all firefox browser windows and restart/reload firefox. ### 17.3.1.4\. EXTRA TROUBLE[](http://csfieldguide.org.nz/appendices/Interactives.html#extra-trouble "Permalink to this headline") Graphics drivers must be working, some graphics cards are not fully compatible with some operating systems. In the case of Linux OS make sure is fully updated ie. Intel Mesa drivers should be higher than 7.9 otherwise it will default to software rendering. ### 17.3.1.5\. DIAGNOSE YOUR GPU IN CHROME[](http://csfieldguide.org.nz/appendices/Interactives.html#diagnose-your-gpu-in-chrome "Permalink to this headline") You can diagnose what’s happening by typing ‘chrome://gpu’ in the location bar. You can also see your driver version in here and other details. If webgl is enabled then you should get a graphics feature status, ie. - Canvas: Hardware accelerated - WebGL: Hardware accelerated - WebGL multisampling: Hardware accelerated - Flash 3D: Hardware accelerated - Flash Stage3D: Hardware accelerated The GL_RENDERER also should have the name of your GPU, otherwise if its not working correctly it may have something like “Software Rasterizer” and will be really slow. In this case again check your drivers are up to date.