simpleviewer.netPRODUCTS | SUPPORT | NEWS | ABOUT

SimpleViewer 1.9 Options

This document applies to SimpleViewer version 1.9. SimpleViewer has been upgraded to version 2.3.0. View upgrade information.

SimpleViewer 1.9 can be customized by setting the following options.

XML Options

Modify XML Options by editing gallery.xml in any text editor. The XML options are found at the top of the file as attributes of the 'gallery' tag. All of thes items are optional.

Option Name Default Value Description
maxImageWidth 480 Width of the widest image in the gallery. Used to determine the best layout for your gallery (pixels).
maxImageHeight 480 Height of tallest image in the gallery. Used to determine the best layout for your gallery (pixels).
textColor 0xFFFFFF Color of title and caption text (hexadecimal color value).
frameColor 0xFFFFFF Color of image frame, navigation buttons and thumbnail frame (hexadecimal color value).
frameWidth 20 Width of image frame (pixels).
stagePadding 40 Width of padding around gallery edge (pixels). To have the image flush to the edge of the swf, set this to 0.
navPadding 40 Distance between image and thumbnails (pixels).
thumbnailColumns 3 Number of thumbnail columns. To disable thumbnails completely set this value to 0
thumbnailRows 3 Number of thumbnail rows. To disable thumbnails completely set this value to 0.
navPosition left Position of thumbnails relative to image. Can be "top", "bottom","left" or "right".
vAlign center

Vertical placment of the image and thumbnails within the SWF. Can be "center", "top" or "bottom".

For large format galleries this is best set to "center". For small format galleries setting this to "top" or "bottom" can help get the image flush to the edge of the swf.

hAlign center

Horizontal placement of the image and thumbnails within the SWF. Can be "center", "left" or "right".

For large format galleries this is best set to "center". For small format galleries setting this to "left" or "right" can help get the image flush to the edge of the swf.

title SimpleViewer Gallery Text to display as gallery Title
enableRightClickOpen true Whether to display a 'Open In new Window...' dialog when right-clicking on an image. Can be "true" or "false"
backgroundImagePath  

Relative or absolute path to a JPG or SWF to load as the gallery background.

Relative paths are relative to the HTML document that contains SimpleViewer. For example: "images/bkgnd.jpg".

imagePath  

Relative or absolute path to images folder. This value is only required if you don't want to put your images in the 'images' folder.

Relative paths are relative to the HTML document that contains SimpleViewer. Note that this path should include a trailing forward slash. For example: imagePath="my_image_folder/").

thumbPath  

Relative or absolute path to thumbnail images folder. This value is only required if you don't want to put your thumbnail images in the 'thumbs' folder.

Relative paths are relative to the HTML document that contains SimpleViewer. Note that this path should include a trailing forward slash. For example: thumbPath="my_thumb_folder/").

HTML Options

Modify HTML Options by editing the HTML file that contains SimpleViewer in any text editor. HTML options are set with JavaScript in this format:

fo.addVariable("xmlDataPath", "gallerydata.xml");  

The first parameter is the name of the option. The second parameter is the required value. Both parameters require quotation marks.

Option Name Default Value Description
xmlDataPath "gallery.xml" Relative or absolute URL of the gallery XML file. Relative paths are relative to the HTML page that contains the swf.
firstImageIndex 0 Index of image to display when gallery loads. Images are numbered beginning at zero. You can use this option to display a specific number based on the URL. Check here for details.
langOpenImage "Open Image in New Window" The text displayed for the right-click 'Open Image in New Window' menu option. Can be used to translate SimpleViewer into a non-English language.
langAbout "About" The text displayed for the right-click 'About' menu option. Can be used to translate SimpleViewer into a non-English language.
preloaderColor 0xFFFFFF Preloader color (hexadecimal color value).

SimpleViewer-Pro ActionScript Options

SimpleViewer-Pro can be customized by using the ActionScript options, listed here.