PostcardViewer Options

PostcardViewer 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.

Option Name Default Value Description
cellDimension 800 The size of the square 'cell' that contains each image (pixels). Make this at least as big as your biggest image to avoid the images overlapping.
columns 4 Number of columns of images. Rows are calculated automatically from the number of images in the gallery.
zoomOutPerc 15 The amout of scale when zoomed out (percentage).
zoomInPerc 100 The amout of scale when zoomed in (percentage).
frameWidth 20 Width of image frame (pixels).
frameColor 0xFFFFFF Color of image frame (hexadecimal color value).
captionColor 0xFFFFFF Color of captions (hexadecimal color value).
enableRightClickOpen false Whether to display the "Open Image in New Window..." right-click menu option.

HTML Options

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

fo.addVariable("xmlURL", "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
xmlURL "gallery.xml" Relative or absolute URL of the gallery XML file. Relative paths are relative to the HTML page that contains the swf.
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 PostcardViewer into a non-English language.
langAbout "About" The text displayed for the right-click 'About' menu option. Can be used to translate PostcardViewer into a non-English language.

Pro Options

These ActionScript options are supported by PostcardViewer-Pro only. These options are modified by editing the Options.as file, then republising your SWF. For instructions on how to do this, check here.

Option Name Default Value Description
maxRotation 12 Maximum rotation of images (degrees). Set to zero to disable rotation.
randomize true Whether to randomize the order of the images on load.
showInstructions false

Whether to show the instructions at bottom left. Instructions are defined in the 'sInstructions' symbol in the FLA library.

captionPadding 20

Padding between captions and image edge (pixels).

xmlURL null Relative or absolute path to XML file (overides HTML option). Relative paths are relative to the HTML page that contains the swf.
zoomLength 15 Time of zoom animation (frames)
useSmoothing true Whether to smooth resized images. Setting this to true improves image quality but uses more CPU resources. If you have a large gallery that is running slowly, setting this to false may help.
zoomOutToFit false Whether to have the image grid scale to fit the stage when zoomed out.
pcvStageWidth null Fixed width for PostcardViewer stage. Useful when loading the PostcardViewer sSWF in another flash movie.
pcvStageHeight null Fixed height for PostcardViewer stage. Useful when loading the PostcardViewer sSWF in another flash movie.