TiltViewer - Frequently Asked Questions:

Check here first if you have a question about using TiltViewer or TiltViewer-Pro.


1: When I view my gallery I see the message 'TiltViewer requires the Flash Player', even though I have Flash installed.

First check here to determine the version of Flash you have installed. If you have Flash 9.0.28 or higher installed and you still see the message, check javascript is not disabled in your browser settings. Also, check the 'swfobject.js' file is in your tiltviewer gallery folder.

2. When I run my Flickr gallery locally I don't see any images or Flash displays an error popup: 'Adobe Flash Player has stopped a potentially unsafe operation...'. How do I fix this?

Flickr galleries will only work when uploaded to a web server. This is due to a security restriction in the Flash Player. If you want to run the gallery locally, you can edit your Flash player security settings. To do this,

  • Click the 'Settings...' button on the warning popup.
  • In the 'Flash Player Global Security Settings' dialog box, select 'Add location' from the 'Edit locations...' drop down.
  • Click 'Browse for folder' and select the folder where your example gallery is located.
  • Click Confirm

4: My images are displaying too big and overlapping each other and my browser is crashing. How do I fix this?

To reduce the display size of the the images increase the maxJPGSize config option. Set this value to the largest dimension (width or height) of your largest image.

5. My XML gallery does not show any images. Why not?

First check your XML document does not have syntax errors. To do this, open it in any browser. The browser will warn you if there is an syntax error. Next check the image paths are correctly specified in the imageurl values . Relative paths are relative to the HTML page that contains the swf.

6. The link buttons on my images do not work or I get a security warning: "Adobe Flash Player has stopped a potentially unsafe operation".

This is caused by a security restriction in the Flash player. This only occurs when you run your gallery locally. To avoid this warning, upload your gallery to a web server, or edit your Flash player security settings. Check Q2 for how to do this.

7. My Flickr gallery is not showing any images. Why not?

TiltViewer can only display Flickr images marked as 'public'. Check your images are not private. Also, Flickr galleries will only work when uploaded to a web server. Check Q2.

8. How do I embed TiltViewer in an existing HTML Page?

The TiltViewer swf can be embedded in any web page. Check the Embedding Guide.

9. Can I use a Flickr set ids to display specific flickr photo sets?

No. TiltViewer does not support the 'set_id' search parameter due to a limitaion in the Flickr API. Use 'user_id' and 'tags' to select your photos.

10. When I view my gallery in Firefox it gets cropped to a small height. Why?

Check your CSS. Firefox requires that you explicitly set the height of the 'html' and 'body' tags, plus the div that contains TiltViewer. Try setting them all to '100%' or the height you require in pixels. For an example, check the CSS in the 'index.html' file that comes in the TiltViewer download.

11. How do I change the 'go to Flickr page' text on the back of the images?

Use the linkLabel XML option to specify the text on the link button.

12. Non-English characters are not showing in my TiltViewer text. Why?

To allow non-English characters to show, you must save the 'gallery.xml' XML document with 'UTF-8' encoding (in Windows Notepad you can set this is the 'Save As' dialog). Check the documentation for your text editor.


1. How do I change the angle at which the Image grid is tilted?

Use the 'tiltAmountIn' and 'tiltAmountOut' config options (added in TiltViewer-Pro v1.3.1)

2. After I load TiltViewer-Pro into my shell swf, the shell swf will not resize. Why not?

TiltViewer uses StageScaleMode.NO_SCALE and StageAlign.TOP_LEFT. Check the code in the example flash_embed.fla in the pro download for an example of how to scale the elements in your flash movie.