|
Zoom 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.
Zoom attempts to manage layout at any dimensions in various ways: it adds scrollers to the Gallery area if the thumbnails are wider than the applet; it scales down any Small image that won't fit into the available space; and it sizes the zoom area at the right of the applet according to whatever space is available to the right of the Small image currently being displayed.
Ideally, however, the applet's width should be at least 1½ times the width of your widest Small image. The applet's height should be at least the height of your tallest Small image + the height of your tallest thumbnail image + the total number of pixels specified for the DisplayMargins and GalleryMargins parameters.
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.
BgColor
Sets the primary background color of the applet. The default value is FFFFFF (white). (Note that Zoom 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.)
SelectedImage
Specifies the index of the image to be selected and displayed when the applet starts. The default is 1 (the first image specified in the parameters). If only one image is listed in the parameters, this is ignored and that single image will be loaded.
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.
Transparent
A yes or no parameter, with a default of no. If set to 'yes', the applet's background will be made transparent in compatible browsers, showing the HTML content (such as a page background) behind the applet.
DisplayMargins
Sets the minimum amount of space (in pixels) to place between the pictures and the edges of the applet and the top of the Gallery area. The default margin size is 2 pixels.
DisplaySpacing
Sets the amount of space (in pixels) between the Small and Large images. The default spacing is 8 pixels.
ImgBorderColor
Sets the color of the border around the Small and Large images. The default color is 3366CC (light blue).
ImgSelectorBorderColor
Sets the border color of the selector that tracks the mouse movement around the Small image. The default color is C0C0C0 (light gray).
ImgSelectorFillColor
Sets the fill color of the selector that tracks the mouse movement around the Small image. The default color is F0F0F0 (off-white).
ImgSelectorFillOpacity
The opacity of the ImgSelectorFillColor, where 0 is fully-transparent and 100 is fully-opaque. The default is 35.
GalleryBgColor
Sets the background color of the Gallery area. The default color is E0E0E0 (very light gray).
GalleryLineColor
If ShowGalleryLine is set to Yes, this sets the color of the single-pixel horizontal line above the Gallery area. The default color is C0C0C0 (light gray).
GalleryMargins
Sets the minimum amount of space (in pixels) to allow above and below the thumbnails. The minimum value is 2: any smaller value will result in a margin size of 2 pixels. The default value is 4 pixels.
GalleryTransparent
A yes or no parameter. If Transparent is set to Yes, this specifies whether the Gallery area should also be transparent in compatible browsers (causing the GalleryBgColor parameter to be ignored). The default is No.
ShowGalleryLine
A yes or no parameter which specifies whether or not the horizontal line above the Gallery area should be displayed. The default is Yes.
ThumbSelectorBorderColor
Sets the border color of the selector shown when the mouse moves over a thumbnail in the Gallery. The default color is 3366CC (light blue).
ThumbSelectorFillColor
Sets the fill color of the selector shown when the mouse moves over a thumbnail in the Gallery. The default color is 3399FF (light blue).
ThumbSelectorFillOpacity
Sets the opacity of the ThumbSelectorFillColor, where 0 is fully-transparent and 100 is fully-opaque. The default is 20.
ThumbSpacing
Sets the amount of horizontal space (in pixels) to place between each thumbnail. The default spacing is 4 pixels.
ZoomAlwaysOn
A choice of yes or no which specifies whether the Large image should always be visible. If set to Yes, Zoom will always display both the Large image and the Gallery, and the ZoomHideGallery parameter is ignored. The default in No.
ZoomHideGallery
A choice of yes or no which specifies whether or not the Gallery should be hidden when the Large image is shown. If Yes, Zoom can usually make the Large image display bigger (by extending it into the Gallery area), thus showing more detail at once. The default is No.
ScrollArrowBgColor
Sets the background color of the scroll-arrow sections added to either end of the Gallery if a large number of thumbnails are displayed. The default color is C0C0C0 (light gray).
ScrollArrowBgOpacity
Sets the opacity of the ScrollArrowBgColor, where 0 is fully-transparent and 100 is fully-opaque. The default is 100. You might wish to reduce this figure (or set it to 0) if you are making the applet transparent by setting Transparent and GalleryTransparent both to Yes.
ScrollArrowColor
Sets the color of a scroll arrow when enabled but not focused. The default color is 3366CC (light blue).
ScrollArrowDisabledColor
Sets the color of a scroll arrow when disabled (i.e. scrolling isn't possible in that direction). The default color is 808080 (gray).
ScrollArrowFocusColor
Sets the color of an enabled scroll arrow when the mouse moves over it. The default color is 3399FF (light blue).
LoadText
While Zoom is loading images as it starts, it displays a progress bar. This parameter specifies the text to be displayed while the applet is loading images. The default text is Loading...
LoadTextColor
Sets the text color used for the LoadText, with a default of 3366CC (light blue).
LoadProgressBorderColor
Sets the color of the border around the progress bar shown while Zoom loads images. The default color is C0C0C0 (light gray).
LoadProgressFillColor
Sets the primary fill color of the progress bar shown while the applet loads. The default color is 3399FF (light blue).
LoadProgressGradientColor
Sets the gradient color of the progress bar which gives it a 3D look. If a solid (non-gradient) bar is wanted, set this to match the LoadProgressFillColor. The default color is 3366CC (light blue).
TestLoading
A yes or no parameter. When set To Yes, this freezes the applet at the "Loading..." screen to make the parameters above easier to test. Set this to No before publishing.
ProgressBorderColor
The animated progress indicator is shown when the user has clicked a thumbnail and Zoom is loading the corresponding Small and Large images. This parameter sets the border around the rectangular animated indicator, with a default color of C0C0C0 (light gray);
ProgressFillColor
Sets the fill (background) color of the rectangular progress indicator. The default is FFFFFF (white).
ProgressFont
Sets the name, size and style of font to use for the text caption shown above the progress indicator, with each part separated by commas. The default is Sans,8,plain.
- Name: You can include any number of font names, separated by pipe symbols (|), and the applet will use the first font available on the user's system. To ensure compatibility, finish with one of these generic names: Sans, Serif or Typewriter.
- Size: The size of the font in points.
- Style: The style can be plain, bold, italic or bold-italic.
An example font parameter would be: Comic Sans MS|Verdana|Arial|Sans,9,bold.
ProgressIndicatorColor
Sets the color of the animated indicator in the progress bar. The default color is 3366CC (light blue).
ProgressText
Sets the text displayed above the progress indicator while the new Small and Large images are loading. The default text is "Loading image, please wait...".
ProgressTextColor
Sets the color of the ProgressText, with a default of 000000 (black).
Images
The parameters below are the most important ones: they set the images to be displayed by Zoom. If you want to display just one image, you must specify a Small1 and Large1 parameter. If you want to display multiple images (placing thumbnails of each in the Gallery area) you must specify a Thumb, Small and Large parameter for each image.
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 a Thumb7 parameter, Zoom will stop looking for any more, and will only find images 1 to 6.
Thumb1, Thumb2, ..., Thumbn
These parameters specify the absolute or relative URLs of the thumbnails you want Zoom to display in the Gallery area at the bottom of the applet. The thumbnails will be shown in numerical order from left to right, 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).
- If you only want to display a single image in Zoom, you can leave out the Thumb parameter and you needn't supply a thumbnail copy of that image. When used with a single image, Zoom doesn't display the Gallery area and doesn't try to load any thumbnails. It loads your single Small and Large images (Small1 and Large1) as it starts.
- If you want to display multiple images in Zoom, you must specify a Thumb parameter for each image to be displayed. Zoom loads all the thumbnails as it starts, along with the Small and Large images specified to be shown first by the SelectedImage parameter.
Small1, Small2, ..., Smalln
These parameters specify the Small images displayed by Zoom, the images shown at the left of the applet around which the user moves the mouse. When the user clicks a Thumb in the Gallery, the Small and Large images with the same number-suffix are loaded and displayed.
Large1, Large2, ..., Largen
These parameters specify the Large images displayed by Zoom, the detailed images shown in the zoomed section at the right of the applet. When the user clicks a Thumb in the Gallery, the Small and Large images with the same number-suffix are loaded and displayed.
|