Documentation for the Image Gallery

Before setting up the xml for the gallery, prepare all your images and thumbnails. The gallery can be set up as resizable or as nonresizeable. Depending on which variation you choose, resize your images and thumbnails accodringly, as images can appear pixelated if upsized too much by flash.

Once you have decided whether it is to be resizable or not, choose the correct gallery_*.html file and rename it to gallery.html.
When the gallery is resized it will always maintain a ration of 5x3
The thumbnails are square images, or they will be scaled down to fit inside that square area.

The xml is divided into various parts:


<?xml version="1.0" encoding="ISO8859-1" standalone="yes"?>
<GALLERY>
	<SETTINGS>
		
		the gallery settings come here, these include texts, colors, etc.

	</SETTINGS>
	<ALBUM>
		
		Album settings, things specific to that album, this is here as other versions of this gallery may provide for multiple albums, though this version only allows one album

		<IMAGE>
			
			Image data, multiple such image blocks can be placed inside the xml

		</IMAGE>
	</ALBUM>
</GALLERY>




The Gallery settings:

<SETTINGS>
	<col_bgnd>0x333333</col_bgnd>
	<col_img_border>0xffffff</col_img_border>
	<col_thmb_border>0xffffff</col_thmb_border>
	<col_txt_title>0xffffff</col_txt_title>
	<col_txt_imgtitle>0x999999</col_txt_imgtitle>
	<col_txt_imgdesc>0xcccccc</col_txt_imgdesc>
	<col_txt_copy>0x999999</col_txt_copy>
	<col_txt_purchase>0x6B94BF</col_txt_purchase>
	<col_txt_progress>0x000000</col_txt_progress>
	<col_btn_enabled>0xffffff</col_btn_enabled>
	<col_btn_disabled>0x666666</col_btn_disabled>
	<show_img_border>true</show_img_border>
	<show_thmb_border>true</show_thmb_border>
	<txt_copy></txt_copy>
	<purchase_img></purchase_img>
</SETTINGS>

This is the complete list of setting possible. The values stated are the default values. Those are the values that are used if that setting is omitted.

<col_bgnd> -> background color
<col_img_border> -> image border color
<col_thmb_border> -> thumbnail border color
<col_txt_title> -> text color of the title
<col_txt_imgtitle> -> text color of the image title
<col_txt_imgdesc> -> text color of the image description
<col_txt_copy> -> text color of the copyright text
<col_txt_purchase> -> text color of the "purchase" button text
<col_txt_progress> -> text color of the progress display when an image is loading
<col_btn_enabled> -> color of the arrow buttons when they are enabled
<col_btn_disabled> -> color of the arrow buttons when they are disabled
<show_img_border> -> set to true to show an border around the image else set to false
<show_thmb_border> -> same for the thumbnai border
<txt_copy> -> the copyright text
<purchase_img> -> if you want to provide your own image to replace the "purchase" button, place the path to that image here (swf and jpg allowed)



Album settings:

<ALBUM>
	<txt_title>My album title</txt_title>
	<path_imgs>images/</path_imgs>
	<path_thmbs>thumbs/</path_thmbs>
	<IMAGE>
		<path_img>img1.jpg</path_img>
		<path_thmb>img1.jpg</path_thmb>
		<txt_title>title 1</txt_title>
		<txt_desc>desc 1</txt_desc>
		<url>http://www.istockphoto.com</url>
	</IMAGE>
	<IMAGE>
		<path_img>img2.jpg</path_img>
		<path_thmb>img2.jpg</path_thmb>
		<txt_title>title 2</txt_title>
		<txt_desc>desc 2</txt_desc>
		<istock_id>123456</istock_id>
	</IMAGE>
</ALBUM>


<txt_title> -> title text
<path_imgs> -> you can provide a path to where your images are, this can be relative or absolute
<path_thmbs> -> path to the thumbnails


<path_img> -> image name and path (the <path_imgs> is inserted before this)
<path_thmb> -> thumbnail name and path (the is inserted before this)
<txt_title> -> image title
<txt_desc> -> image description
<url> -> you can either provide an URL or an istock id that will be opened when the "purchase" button is clicked, providing neither results in the "purchase button being hidden
<istock_id> -> istock image id


That's all there is to this gallery.