Frequently Asked Questions
1. My gauge doesn't appear at all. All I see is a blank canvas!
This happens when the tool doesn't find the gauge.swf file. To verify this, right-click or control-click the canvas. If the flash file wasn't found, then you should see the line "movie not loaded". To fix this, make sure the gauge.swf URL is correct (try an absolute URL instead of relative.) If your server is case-sensitive, use the correct case.
2. The tool takes 30 seconds to load, then I get a "Loading .. timed out" error message. Why is that?
This usually happens when the tool can't find, or can't access the file shown in the error message. In this case, place the file on the same server as gauge.swf, and make sure the URL is correct (try an absolute URL instead of relative.) If your server is case-sensitive, use the correct case. If the file is protected, make sure the tool can access it without passwords. Type the file's url in a browser to verify that it's accessible.
If the timeout is caused by a slow server or connection, we recommend addressing and fixing this delay. If you must increase the default timeout, append a timeout parameter to the gauge.swf url like this:
3. I can only generate the default gauge. Why is that?
This happens when gauge.swf can't recognize the content of the source file.
The source file must be free of errors, or it'll generate unrecognizable data. Make sure the source file is constructed in exactly the same way shown in the tutorial.
4. Why doesn't the tool recognize the latest changes I made to the source file?
Your browser is likely to be using a previously cached version of the source file instead of reading the latest version. To fix this, see the "Caching" section on this page.
If you're using a meta tag in your html page to control caching, you might have to delete it.
5. I can't make some features work. Is this a bug?
Re-download XML/SWF Gauge to make sure you have the latest version. If this doesn't work, test the feature by copying the related sample code from the reference section. Test it without adding any other code to it. If it works, then add the same code to your gauge and modify it.
6. How do I display gauges on a secure server (https)?
Use absolute URLs that start with https for both the gauge.swf and the gauge's source files.
Also, in the flash html code, make the URLs in the "codebase" and "PLUGINSPAGE" attributes secure. You can do this by simply replacing the "http" with "https".
6. How do I display charts on a secure server (https)?
1) Use absolute URLs that start with https for both the gauge.swf and the gauge's source files. In the flash html code, make the URLs in the "codebase" and "PLUGINSPAGE" attributes secure. You can do this by simply replacing the "http" with "https".
2) If the tool produces a timeout error, this is an Internet Explorer bug related to loading files in Flash over SSL connections (see this page). To fix this, if you're using PHP sessions inside the source file, add this line before starting a session (add it only when serving to Internet Explorer):
If you're building your own headers, add:
7. How do I display gauges behind a firewall?
Macromedia Flash Player makes connections over ports 1935, 443, and 80. Make sure all these ports stay open.
8. Why does the tool occasionally render the graphics from the center of the canvas instead of the top-left corner?
This is a rare Internet Explorer bug that occurs when the Flash tool is loaded before a complex web page is fully constructed by the browser. There are 3 ways to deal with this:
1) Re-download the tool to make sure you have the latest files, empty the browser's cache, and test again.
2) Prevent fast caching and force the tool to re-download every time it is displayed. See the "Caching" section on this page. If you're using a meta tag in your html page to control caching, you might have to delete it.
3) Simplify the web page's structure to speed up its construction.
9. How do I work around the "Click here to activate this " message on the latest version of Internet Explorer?
Use the workaround on this page.