PictureShow Parameters
Click an item in the list to the left to find out more about it.


Width & Height
The width and height of the applet are set in the HTML code you add to the web page. Be sure to change the dimensions in the <object> and the <embed> tags.

The applet's width and height should be at least as wide and as tall as your largest images. You can make the applet as large as you like: images always appear in the center of the applet (or slide to the center of the applet if UseSliding is set to 'yes').

Parameters
The parameters below should be added to your datafile in the form NAME=VALUE (for instance, BgColor=FF0000). Each parameter should be on a separate line. You can leave blank lines in the list to organize the parameters into groups if you want to. The parameter names are not case-sensitive, and neither are the values, so BgColor=FF0000 is the same as bgcolor=ff0000. You can add the parameters to your file in any order. Most parameters have a default value which we show in bold text below: if you don't include the parameter in your datafile, the default value will be used automatically.

AnimateDelay
Along with AnimatePercent, this sets the speed of PictureShow's animation by setting the delay time between each animation step. The default is 20 milliseconds. Reduce this value to make the animation faster.

AnimatePercent
This parameter (combined with AnimateDelay) sets the speed of PictureShow's animation. This sets the percentage amount by which the animation advacnes for each animation step. Valid values are 1 - 100, and the default value is 3. Increase this value to make the animation faster.

BgColor
Sets the background color of the applet, if Transparent is set to 'no'. The default value is FFFFFF (white). (Note that PictureShow can only change the background color after it has loaded. To have the same background color shown before the browser starts loading the applet, change the BgColor setting in the HTML code too.)

DefaultSelectorColor
When the mouse moves over an image, a selection-border can be drawn around it (this can be useful if the image is a link). This parameter lets you choose the default color of the border (if ShowSelectors is set to 'yes'). The default color is to match your chosen BgColor, which makes the image appear to shrink when focused. Each image can override this by specifying its own SelectorColor.

DefaultTarget
Every image can link to a separate URL, and it can open it into a separate frame or window: we provide numbered Target parameters for that. However, you probably want most (or maybe all) the links to open into one particular frame. Enter the frame name in this parameter, and every item without its own Target parameter will open the link into this 'default' frame. You can use the HTML names _self, _top, _parent, _blank or _new. If you leave this parameter out of your datafile, links will open into _self (the frame or window containing the applet).

Hold
Sets the number of seconds that each image should remain on the screen (after animation finishes) before the next image's animation starts. The default is 3 seconds. (You can use 0 as a value, so that image's barely stop animating before the next appears.)

HoldBackground
If SwitchToBackground is set to 'yes', this sets the number of seconds that the empty applet background should be shown before the next image starts to appear. The default is 0 seconds (so the next image starts to animate as soon as the first has disappeared).

LoadProgressBorderColor
While PictureShow loads the images you are using, it displays a progress bar. This parameter sets the border color of that bar. The default is 606060 (dark gray).

LoadProgressFillColor
This parameter sets the fill color of the progress bar (the part of the bar that indicates the loading progress). The default is 00FF00 (green). (The background color of the progress bar will match your BgColor.)

LoadText
Specifies the text to be displayed while PictureShow loads the images you are using. The default text is Loading.... The text you choose must be short enough to fit into the width of the applet - PictureShow does not wrap this text onto a second line.

LoadTextColor
Sets the color of the LoadText shown while PictureShow loads images. The default is 00FF00 (green).

Name
Specifies a name for this instance of the applet. This is only necessary if you are using the applet in conjunction with our free Satellite add-on, and it's explained in the documentation for Satellite, available from the Cool Focus web site. If you are not using Satellite with this applet, it's best not to include this parameter in your datafile (although nothing bad will happen if you do). See also the SatelliteAuto parameter.

PauseOnEnter
A choice of yes or no (with a default of yes) to specify whether animation should pause when the mouse enters the applet. (Animatrion pauses only when the current image has finished animating, and is fully visible in the center of the applet.)

RandomOrder
A choice of yes or no (with a default of yes) to specify whether the images should be shown in random order. If set to 'yes', PictureShow will repeatedly show all images, but will display them in a random order each time (ensuring that one image is not shown more often than another). If set to 'no', the images will be shown in numerical order (according to the number in their Image parameters).

SatelliteAuto
A choice of yes or no, with a default of no. This parameter works with our Satellite add-on, and is only active if you are using Satellite and have specified a Name for this applet. By default, Satellite messages are sent when the user moves the mouse over and image in PictureShow. If you set this parameter to 'yes', mouse movement is ignored and the Satellite message will be sent automatically each time the image changes.

ShowSelectors
A choice of yes or no (with a default of yes) to specify whether a selection-rectangle should be shown when the mouse moves over an image. If you leave this set at 'yes', you can set the DefaultSelectorColor to be used for all images, and set different SelectorColors for individual images.

ShowVersion
A yes or no value. This parameter is included in all Cool Focus Flash applets, and its default is no. If set to 'yes', the version number of the applet (and other details) will be shown when the applet starts. This is included only for troubleshooting purposes, to help you determine which version of an applet you're using. It should be set to 'no' (or removed from your datafile) before you publish your page.

Note: If the applet is not registered, this information will always be shown when the applet starts, regardless of the ShowVersion parameter's setting.

SoundClick
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse is clicked on a linking image. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundRelease
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse is released after clicking a linking image. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SwitchToBackground
A choice of yes or no (with a default of yes) to specify whether to show the applet background between each image's animation. The default is no. If set to 'yes', the first image will be completely removed (and animation will pause for a number of seconds set in HoldBackground) before the second image starts to appear. If set to 'no', the animation for each image will overlap continuously.

Transparent
A choice of yes or no (with a default of no) to set whether the applet's background should be transparent in compatible browsers, showing the HTML page background or other content behind the applet. Note that in animated applets like PictureShow, the animation is much slower when transparent and uses much more of the computer's CPU power.

UseFading
A choice of yes or no (with a default of yes) to set whether or not images should fade into view. If this is set to 'yes', and UseSliding is also set to 'yes', images will fade while they are sliding.

UseSliding
A choice of yes or no (with a default of yes) to set whether or not images can slide into view from outside the applet. If set to 'no', images will always be at the center of the applet. The slide direction is chosen randomly by the applet, and (if UseZooming is set to 'yes') the images will sometimes zoom in or out instead of sliding.

UseZooming
A choice of yes or no (with a default of yes) to set whether or not images can zoom in and out of view. The UseSliding parameter must be set to 'yes' (its default) for this parameter to work. If set to 'yes', PictureShow will include the zoom effects in its range of slide effects so that images may slide or zoom.

Images
The parameters below are the most important ones: they set the images to be displayed by PictureShow, and the URLs (if required) that each image should link to. You must include at least one Image parameter or PictureShow will display nothing at all!

The parameters all have numbers after their names, and the numbers you use must be consecutive, starting from 1. If you want to show 10 images, but you forget to include an Image7 parameter, PictureShow will stop looking for any more, and will only find images 1 to 6.

Image1, Image2, ..., Imagen
These parameters specify the absolute or relative URLs of the images you want PictureShow to display. The images will be shown in numerical order, starting from 1, and you can include as many images as you like. The images must be in JPEG format. If you want to include GIF images, you must convert them to Flash .SWF files first (see Image Support in Flash Applets).

URL1, URL2, ..., URLn
The optional URL to which the image with the same number should link when clicked. If you don't want the item to act as a link, don't include a URL parameter for it. To make items behave like links in all respects except linking somewhere (which can be useful for testing), use a dollar sign ($, or when encoded, %24) as the first character of the URL.

Target1, Target2, ..., Targetn
The name of the frame or window into which the URL with the same number should open. If you don't include this parameter, the frame name set in the DefaultTarget parameter will be used.

Message1, Message2, ..., Messagen
An optional text message which will be displayed in the browser's status bar (in compatible browsers) when the mouse moves over the image with the same numeric suffix.

SelectorColor1, SelectorColor2, ..., SelectorColorn
If ShowSelectors is set to 'yes' (its default), a selection-rectangle is shown when the mouse moves over an image. The selector will be the color set in the DefaultSelectorColor parameter. For any individual image, you can use this parameter to set a different selector color for a particular image.