A minimal xml file for the Carousel should look like this:
<slide_show> <photo>image1.jpg</photo> <photo>path/image2.png</photo> <photo>../folder/subfolder/image3.gif</photo> <movie>animation.swf</movie> <photo title="This is me in Rome">./photos/meInRome.jpg</photo> </slide_show>
I suggest you to use relative paths, but remember: they are relative to the location of the html page containing the Carousel (not to the Carousel.swf itself). Moreover, the xml file must be valid: modern browsers (like Firefox and IE) can be used to check xml files.
Prepare your images! Don't use huge images (like jpeg files from your 5 MegaPixel Camera)!
Scale images to a size (in pixels) proportional to the space they will occupy in the Carousel. Remember that, by default, images take up to 50% of vertical space, to allow for vertical movement; you can change this via
vertical_ratio option (see Carousel Options).
You can egnerate your images with scripts:
& sign MUST ALWAYS be escaped as
&. Read What you must know about XML files for more information.
You can associate a link to each photo specifying href and target exactly as you do for html anchor tags (you cannot specify anything else: no rel, no title, no class).
<photo href="mypage.html" target="_self">image.jpg</photo>
You can add links to any anchor, URL (even with CGI parameters), JS function, and FSCommand. See the Links on images example.
Further examples of what you can write are:
& sign MUST ALWAYS be escaped as
&, even inside attribute values! Read What you must know about XML files for more information.
aways (see Embedding Parameters).
You can add a title to each photo:
<photo title="This is me!">image.jpg</photo>
You can also use some very basic html tag (like <i>, <b>, and <br>) in your titles. Remeber that XML standards requeres you to replace < with < and > with > like this:
<photo title="This is a <b>bold</b> word">image.jpg</photo>
Refer to Flash Manual for a list of html tags supported by Flash (this is a custon subset of html tags).
Alternatively you can use the exploded syntax for your photo tag, like this:
<photo> <href>http://www.flshow.net/</href> <target>_blank</target> <src>../images/DCP_0730.png</src> <title>This photo title has <i>italic</i> and <b>bold</b> text.<br/>There is also a second line here!</title> </photo>
Do not mix inline and exploded syntax in the same photo and always remember that your XML file must be valid!
The default font and size is controlled via the
titles > style option (see Carousel Options); but you can change it using
textformat tags according with the flash-html specifications (see Flash Manual).
<photo> <src>../images/DCP_0730.png</src> <title>This is <font size="16" color="#FF9900">big orange</font> text.</title> </photo>
When you test an html page on your local computer Flash Player prevents Carousel to follow links to Internet addresses for security reasons (it can read data from your hard disk, it is not safe to let it communicate over the Internet). This apply also to JS function calls.
You can change this behaviour by declaring Carousel.swf as trusted:
- Right Click (ctrl+Click on Mac) on Carousel area;
- Click on “Settings…”;
- Click on the blue question mark, this leads you to the Flash Player Settings Manager;
- Go to “Global Security Settings Panel” (left menu);
- Add the Carousel.swf (with its full path on your computer) or a path that contains it (you can browse for files or folder);
- Close your browser and try again.
When you use images from a websites different from the one where the Carousel.swf is, cross-domain policy of the Flash Player apply.
This is all about copyright!
Carousel.swf is on a site (say
yoursite.com) and image are on a different site (say
anothersite.com) there is no evidence that you (your Carousel) have the right to manipulate those images. So you can display them but you cannot perform advanced image manipulation (like compute the reflection!).
The easy way to solve the problem is to put the
Carousel.swf and all images on the same site (it doesn't have to be the same of your html page).
anothersite.com should explicitly transfer copyright to
The way it must be done is by publishing a file named
crossdomain.xml in the root of
anothersite.com. Inside this file, with a proper xml syntax
yoursite.com have to be declared as “allowed”.
Please notice that http://www.mysite.com/ and http:/mysite.com/ are (formally) different domains.
Sorry, these are Adobe policies to avoid FlashPlayer be involved in copyright violations. I cannot change this behaviour.
Please refer to the Adobe documents for more information.
You can place swf files inside the Carousel using the tag
movie. This way you can add animated and interactive content to the Carousel. You can specify
title for movies also.
<movie> <href>http://www.flshow.net/</href> <target>_blank</target> <src>../animations/first.swf</src> <title>This is a flash movie</title> </movie>
Movies do not have automatic reflection. It is up to you to draw a reflection inside your swf file. The stage size of your movie will be used as image size, so carefully set the stage size and draw your reflection outside the stage area. Moreover, if you have bitmaps inside your movie, don't forget to allow smoothing (with Flash CS3 open the Library, right click (ctrl+click on mac) on your bitmap, select
properties and then check
Also notice that Carousel uses ActionScript 3, so your swf file must be AS3 in order to allow interaction (click, mouseOver) from Carousel.
Also notice that all movie are loaded with a simple
Loader instance, then
addEventListener method of the
Loader is invoked to register listeners for mouse events. All movies are loaded in the same isolated
ApplicationDomain so you can use a class with
static methods to perform simple communication between your movies. Flash Cross Domain Policies apply.