!Help file for !WebGallery v1.17 (26th Nov 2008)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

For more comprehensive instructions, please see the printed manual.


Purpose
~~~~~~~
To quickly and easily create and edit web-based photo galleries, with the maximum of flexibility
for more advanced users.

It requires ChangeFSI in order to do the actual image processing and resizing. Therefore it
should cope with all graphics formats understood by ChangeFSI. However, at the moment, I've
restricted it to only handling web format graphics, such as JPEG and GIF.

Although RISC OS Select can now handle PNG graphics, WebGallery does not currently support PNG
format graphics. This is due to development being carried out under RISC OS 5 on the Iyonix
computer. If and when native PNG support is added to RISC OS 5, I will add support to
WebGallery.


Licence
~~~~~~~
WebGallery is SHAREWARE. If you use it and find it useful, you should register by sending a
cheque for 30.00 to

Digital Phenomena Ltd.,
104 Manners Road,
Southsea,
Hampshire,
PO4 0BG.

Please make cheques payable to "Digital Phenomena Ltd."


Use
~~~
This !Help file is fairly rudimentary at the moment, as I'm still writing much of the
documentation.
Registered users do receive a full, printed manual though.


Quick Guide
~~~~~~~~~~~
Load !WebGallery by double-clicking on it's icon. If you don't have a registration code, simply
click on the "Register Later" link when prompted. This will enter 'demo' mode, but some
features may be unavailable.

Once loaded, it's best to configure all the settings required simply by clicking on each panel
icon one by one, starting with the 'Files' panel.

Clicking on its iconbar icon will open/close the main configuration window.

WebGallery supports Acorn's interactive !Help, so you can hover the pointer over icons for a
brief description of their function.


IMPORTANT CONSIDERATIONS
~~~~~~~~~~~~~~~~~~~~~~~~
There are some important things to consider when using the current version of WebGallery.

1. In the process of previewing or processing JPEG images, should WebGallery encounter a JPEG
   image with a broken header (ie. not starting with bytes &FF &D8, then it will attempt to
   automatically    repair the file before subsequent previewing/processing.
   Users should be aware of this as it is capable of modifying your original source images.
   
2. Related to point 1 (ie. altering original source images) is that WebGallery is capable of
   renaming the original files if you have the 'Rename source files' option set to anything
   other than "Leave alone" in the 'Files' panel.


General
~~~~~~~
The top part of the panel displays the registered user and code.
Clicking on Re-Register will reset everything and make WebGallery revert back to being
un-registered. Use with care (warning given)

The choices tab probably doesn't need to to be changed, but is provided for completeness and
personal choice. If ticked, it will store the profile and -wbdirs (see later) inside
Boot:Choices. If off, choices will be stored inside !WebGallery itself.
Clicking on the small ^ icon underneath the toggle icon will open the WebGallery choices
directory.

Validation icons are fairly self-explanatory and will merely add the relevant W3C validated
icons to the bottom of all pages produced. You can optionally set the positioning of the icons.
The link buttons control whether or not a the icon is a clickable link back to the W3C online
validation service.

Suppress WebGallery adverts will not include little WebGallery banners on the pages created.


Files
~~~~~
From this panel you can set the source and destination directories.
The source directory is wherever the master copies of your images are stored. You can either
drag the entire directory to this icon, or drag a single image to it. WebGallery will then
automatically set the parent directory as the location of source images.

N.B. If you hold SHIFT down whilst you drag a directory, WebGallery will use any existing
dirlisting file (the file containing all the image filenames) rather than creating a new one.
This will keep the order of any re-arranged images from a previous session.

Convert images only. No web output will suppress any HTML output, effectively turning WebGallery
into a batch converter for ChangeFSI.

Rename source files will determine whether any of the source files are renamed. This is the only
option which can change your original master image files. Obviously, this option only works if
the source images are stored on a writable medium.

There are two ways of setting the desination directory. Either drag the directory icon to a
filer window, or drag an existing directory from a filer window into this icon.

Table only will produce just an HTML table for your thumbnail images, whereas toggling this
option off will produce a full index.html file.

Merge output files will simply create the output files in a previous/existing output directory,
whereas toggling this option OFF will wipe the output file prior to processing new files.

Force overwrite will ensure that all image files are always processed and re-saved into the
destination directory. Sometimes however, you may be simply re-processing the gallery and don't
want to wait whilst the images are re-processed again. Leaving this option off (the default)
will dramatically reduce processing time and enable you to re-generate galleries very quickly.
Only enable if you wish to re-process all the image files (which may be the case if you've
changed some or added to them).

Leaf name is the name to use for the individual image files. You can set how many digits that
numbers will be rounded to, by entering the requisite number of 0's in the next icon.
Lastly, a drop down menu will allow you to set any file suffix.

The max image size is the size for the resulting images. You can either select a preset size
from the menu, or enter your own dimensions.


Web Output
~~~~~~~~~~
Sets whether or not to use HTML templates for the output files.

Make html page for each image will create a new page for each image in the final gallery.

Open images in a new browser window will ensure that when you click on a thumbnail image, each
large image is opened in a new window.

Use template will allow you to use a custom template for each page.
See printed manual for more information.

Templates are stored in their own directories inside !WebGallery.Templates and consist of a
number of files:-

	next.gif	Next image graphic
	prev.gif	Previous image graphic
	title.gif	title graphic
	Profile 	(optional profile, if stored with templates)
	template	The actual web template (see below)
	wg_styles/css	stylesheet for pages
	
The 'template' file can be your own HTML template for the image pages.
It can contain a number of 'tags' which will be automatically substituted for specific text when
WebGallery processes your output. The ones defined so far are:

	-FIL-	Insert filename of current image (minus filetype suffix)
	-III-	Insert number of current index page.
	-NNN-	Link to next image
	-PPP-	Link to previous image
	-PAG-   Insert HTML page filename, minus .html
	-XXX-	Image number
	-MAX-	Total number of photos in gallery
	-YYY-	Insert image
	-ZZZ-	Insert caption
	
	-AAA-	Custom text, defined in web output panel
	-BBB-	Custom text, defined in web output panel
	-CCC-	Custom text, defined in web output panel
	-DDD-	Custom text, defined in web output panel
	-EEE-	Custom text, defined in web output panel
	-FFF-	Custom text, defined in web output panel
	
I've included some of my own templates which you can examine as examples.

Clicking on the 'background' icon (bottom right) will cycle through the available background
images, or clicking on the number above the icon will let you choose a plain colour from the
available palette.
Extra backgrounds can be stored within the !WbGallery.Graphics.backgrounds directory. See the
manual for additional information on how to create your own.


Thumbnails
~~~~~~~~~~
Sets options for the thumbnails produced by WebGallery.
Fairly self-explanatory....

Thumbnails per row will set how many thumbnails go across the page.

Max rows per page will set how many rows of thumbnails on each page to allow. Exceed this and
new index/table pages will be created.

Thumbnail spacing - sets the spacing between thumbnails

Labels - determines what type of labels are used, and where they should be positioned, relative
to the image.

Image border - If on, a single line, black border will be turned on for each image.

Font size - Sets the HTML font size for captions next to each image.
            If you set to 0, WebGallery will use a CSS style called wg_caption for the text.
            This is defined within the templates.

Maximum size - sets the maximum size for each thumbnail image.

Caching - Turn on to enable caching of thumbnail images. This will greatly improve processing
speeds, but requires EXIF thumbnails to be present in the source images. This works by
automatically extracting the thumbnails in the file, and using these for generating the
thumbnails in Webgallery.
Clicking on the re-cache button will force WebGallery to re-read thumbnails for all the source
images.

Frames - If on, puts a frame around each image.

Spacing - Sets the size of the frame to put around each image. There are two values here.
          The left hand one will set the frame around thumbnail images on the index page(s).
          The right hand one will set the frame around the large images on the individual 
          gallery pages.

Colour - Sets the colour of the frame

Show filenames - Add the filename to each image.

Show image size - Add the file size to each image.


Captions
~~~~~~~~
Allows you to step forwards and backwards through each image and set a caption for each image.
Up to 4 lines of captions are allowed, with the first line being used for thumbnail captions and
all four lines being used for the main image page for each image.

Clicking on the small 'arrow' to the left of the image indicator icon at the top will rotate the
current image. Select rotates right (clockwise) and Adjust rotates left (anti-clockwise). There
are four arrangements:-
Normal, 90 degrees clockwise, 180 degrees and 90 degrees anti-clockwise.

Clicking on the diagonal arrow icon just below the 'rotation' button will load the current image
into your favourite graphics viewer application.

Clicking on the large/small > thumbail icon (third from the top) only works if you've enabled
caching (see above) and if there's an EXIF thumbnail available for the current image.
Toggle this option to tell WebGallery whether or not to generate the final thumbnails from the
embedded thumbnails. N.B. The actual gallery pages are always generated from the original 
source images, for quality. However, by creating the thumbnails from the EXIF thumbnails can
dramatically improve processing speeds.

Clicking on the red 'X' icon to the bottom right of the image will delete the ORIGINAL image.
You are asked for confirmation twice before the original image is deleted, along with any copies
in the final destination and captions.

Open -wgdir will open the -webgallery directory (more below)

Rearrange will open a window containing a small thumbnail of every image on the page, so that
you can drag and drop them to rearrange the layout.
Just dragging a single image will swap the position with the image wherever you drop it, whereas
holding SHIFT down will shift all images in between forward or backwards.
WARNING!! This option can take some time, if there are a lot of images, as it will generate a
mini-thumbnail for every image! Again, the speed of generating the rearrangement thumbnails can
be vastly improved by turning on caching (see above) if EXIF thumbnails are available.

The caption is saved automatically when you move to the next image, select a different panel or
click 'Process'.


ChangeFSI
~~~~~~~~~
Sets various ChangeFSI parameters.
If changing the ChangeFSI parameters you may wish to turn the 'Force overwrite' option in the 
'Files' panel ON, to ensure that reprocessing does actually regenerate all the images again.


Page text
~~~~~~~~~
Sets the text to be used for page links. You can also select from a library of icons if you
prefer. If 'Use icons' is toggled on, then clicking on the preview image will step through all
the available preset icon styles.
Position will allow you to set the positioning of the navigation icons.

Page title, heading and copyright are simple text entry icons for setting the relevant text for
each page.

Auto slideshow controls whether or not each page in your gallery will automatically move onto
the next image after a predetermined time (set by the delay value, in seconds). This adds a 
meta refresh tag to the page and requires a base URL to be entered, pointing to the final web
location of your image directory (WebGallery will add the relevant filenames to the end of the
URL).

Note that copyright does NOT add the copyright symbol (&copy;) to the HTML, simply because I
thought that some people may want to just add some footer text in this setting and not want an
automatic copyright symbol appearing before their text. If you require the copyright symbol,
simply add &copy; to the beginning of your text or toggle the small  icon in the bottom left
corner.


Meta tags
~~~~~~~~~
Lets you define keywords and description for your gallery.
name/content allows you to define a custom name/content pair of metatags http-equiv/content
allows you to define a custom http-equiv metatag

charset allows you to set the required character encoding.

No-Cache will tell WebGallery to generate pages which prevent browsers from caching the pages.

The Search Engines section allows you to control two aspects of search engine control:-
Don't Index, will generate pages which won't be indexed by search engines.
Don't Archive/Cache will tell search engines not to archive or cache the pages.


Profiles
~~~~~~~~
Allows you to set a profile with which to save all your choices.
A profile is basically a custom choices file, so that you can store multiple sets of choices.
If you store it within a template, WebGallery will store the choices inside any web template directory you are using. This helps keep everything together.

You can also force the location of the -webgallery directory (more later)

Lastly, you can do a factory reset to reset all settings to their original default values.

The Debug mode should only be enabled if you're having problems and the author advises turning
this on. It will produce a log file giving diagnostic information.


Processing
~~~~~~~~~~
Displays some statistics whilst processing your web gallery.


Process
~~~~~~~
Click on the Process button in order to start processing and generate your web gallery. If any
incompatible options have been set, you will be warned and given the chance to go back and set
them again.

Clicking 'Save' will save the current settings without actually processing the gallery.
Quit will quit the application (asking for confirmation if anything has changed since the last
save)


Tutorial
~~~~~~~~
I'd like to thank beta tester Tricia Garner for allowing me to use her Orchid Talk gallery
website as a worked example in this tutorial. You can visit her website at
http://www.orchid-talk.co.uk/

The example gallery we're going to attempt to produce is the one online at
http://www.orchid-talk.co.uk/archives/2006/images/10october/pages/page1.html
and I will describe two different ways of producing a gallery like this.
The first will be via standard output using the various options provided within WebGallery. The
second example will be by using web templates in order to get an identical match with the
existing site.

We have 19 images in the source directory of original images. These have been scaled to the
required size before processing by WebGallery. This means that WebGallery will merely copy the
images from the source directory into the destination directory rather than filtering each one
through ChangeFSI.
This will dramatically speed up the processing time, because WebGallery will check the size of
each image before processing and if the source/original is already smaller than the maximum
size you've set in WebGallery's 'File' panel, it will be copied instead of copied and re-scaled.

Method 1 - Standard WebGallery options
--------
Load !WbGallery and, to ensure you're starting with a 'fresh slate' and haven't got any
automatically reloaded settings from a previous run of WebGallery, click on the 'Profiles'
button and Reset to the original default values.
Now click on the 'General' button. In this example, everything there can be left alone, so you
can immediately click on the 'Files' tab.
Drag the directory containing your source images to the 'Original images' icon at the top of the
window. That will set the location of where to find all your original images.
We want to create a full gallery (as opposed to just processing the images) so leave the
'Convert images only. No web output' option turned off.
Leave the 'Rename source files' to Leave alone.
Now grag the output directory icon somewhere on your hard disc, where you want the output
gallery to be stored.
Leave 'Table only' and 'Merge output files' turned off.
Set the 'Max.final image size' to 400x300.

Now click on the 'Web output' button and set the following:-
Make html page for each image - on/yes
Use template - off (for method 1)
Click on the background image until you get the yellow background (8)

Click on the 'Thumbnails' button and set the following:-
Thumbnails per tow - 5
Max rows per page - 2
Thumbnail spacing - 12 (default)
Labels - none (default)
Image border - off
Max thumbnail size - 100
Frames - off (default)
Spacing - 6, 12
Colour - #ffffff
Show filenames and show image size - both off

As we've not used captions you can skip the 'Captions' button and go straight to ChangeFSI. We
don't really need to change the default ChangeFSI settings either, so you can now click on the
'Page text' button.

Tick the 'Use icons instead' toggle icon and select a relevant set of icons.
Change the 'Position' to 'Top'.

Enter "October 2006" for the page title.
Enter "&copy; Orchid-Talk for the page heading.
Enter "Orchid-Talk" for the Copyright and click on the little (greyed-out)
copyright icon, to enable it and add the symbol.

Meta tags can be ignored for this example, so now click on the 'Profiles' button.
It's always best to create a new profile for each new set of choices, before you start
processing. This means that all the choices you've just set will be saved under their own
profile, for rapid reloading if you want to use the same settings in the future. For this
example, I'll enter 'Tricia' in the 'Profile name' and click 'Save'.

You're now ready to process all the images and create your web gallery.
Before you click on the 'Process' button (to start processing) you may want to quickly go back
over each panel, checking your settings to make sure everything is how you want it.

Now click 'Process' and WebGallery will start processing all your images in order to create your
new web gallery in the destination directory. This may take a few minutes depending upon how
many images you have and how large they are.

Whilst WebGallery is processing the files, the panel will automatically change to the
'Processing' panel so that you can see which image is currently being processed, along with a
number of useful statistics and processing settings.

When processing is complete you can open the destination directory and double-click on the
'index/html' file to see your finished web gallery.
This will load the first index page into your favourite web browser so that you can see how
close to your intended design it is.

In this particular example, it's similar but not identical - mainly because WebGallery follows a
fairly standard format when creating it's own output web pages. However, that has hopefully
shown you a brief example from start to finish.

We can now examine ways of achieving a closer look to the original, but for this we need to use
a web template, so lets go onto method 2....

Method 2 - Using a web template
--------
I'll now explain how to reset things to use a template instead of the built-in options. Click
back on 'Files' to start the process of setting choices again.
Everything in this screen can stay the same, but it's always worth starting back at the
beginning, just so we don't forget anything. Now click on the 'Web output' button.
This time we want to use a template, so tick the 'Use template' option and then select the
template we want - in this case, a specially prepared 'Tricia' template (more on how to create
it later).

For -AAA- enter "October 2006" (these will be explained later when we come to create and explain
the actual template)
For -BBB- enter "&copy; Orchid-Talk
You can leave the other boxes blank.

Now click on the 'Thumbnails' button and confirm that the various settings are as we want them -
they should be the same as the last run (ie. method 1)
However, you'll notice that the 'Frames' section is greyed out. This is because we're now using
a template, so this is largely irrelevant.

Again, we don't require the 'Captions' and 'ChangeFSI' panels and, because we're using a
template, the 'Page text' and 'Meta tags' buttons are greyed out (because those things are all
defined within our web template).
Indeed, unless you want to re-save the changed settings as a new profile (possibly "Tricia2"),
you can now go straight to processing and click the 'Process' button.

Now if you view the index/html file in the destination directory and click on a thumbnail, you
should see a much more accurate copy of the original design. In fact it should be pretty much
identical.
The only difference is to the index pages generated, as these are still automatically generated,
although -AAA- and -BBB- are substituted for the page title and header respectively.

If you want to use your own index pages, and get WebGallery NOT to create index pages for you,
then go back to the 'Files' panel and tick the 'Table only' button and ALSO tick the 'Merge
output files' button. The latter one is important because you don't want WebGallery overwriting
any previous files in your desination directory, such as a manually created index page.
WebGallery will now create only a table containing the thumbnail images.
You can thus manually cut and paste the table into your own index file.

The other thing to remember when using templates is to manually copy any related graphics or
supplementary files such as a background image - as these can be stored outside your destination
directory space.

We'll now examine how we create a web template.....

Open the templates directory by clicking on the small ^ button underneath the name of the
current template (in the 'Web output' panel). This will open the templates directory inside
!WbGallery. In true Blue Peter style, we made one earlier - called Tricia. However, to create a
new one you would simply create a new directory (ie. called Tricia) and inside this new 
directory you would place various files:-

	index.gif	a GIF image which will be the 'return to index' graphic.
	next.gif	a GIF image which is the 'next image' graphic.
	prev.gif	a GIF image which is the 'previous image' graphic.
	template	your HTML template (see below)
	wg_styles/css	your CSS stylesheet (see below)
	
The HTML template (called "template")
This file is a standard HTML text file containing the revelant HTML code comprising each 'image'
page in your gallery. You should create this exactly as you would create the pages on your
website. However, in place of any 'variable' values which change for each image created by
WebGallery, you should substitute various WebGallery tags. These consist of three capital
letters between minus signs, eg. -AAA-
WebGallery will automatically detect these and replace them with specific dynamic content when
it processes your gallery. Thus, if you want to link back to the previous image page from the
current one, simply insert a standard "a href" tag but instead of having a fixed filename URL to
link to, insert -PPP- (for previous image). Thus your segment of code will look like
<a href="-PPP-">

A full list of WebGallery tags is listed above, in the Web Output section of this documentation
file.


                        More Advanced Documentation
                        ---------------------------

The -webgallery directory
~~~~~~~~~~~~~~~~~~~~~~~~~
This is a special directory created in which to store image captions as well as a directory
listing of all the images in the required order.
WebGallery is fairly intelligent in that it endeavours to store the -webgallery directory in the
most sensible place. This has a priority of 'favourtism' such that it will store within the
original source image directory (which is the most logical place, as it's with the images) IF it
is a writable directory (ie. not on a CD or write-protected disc).
If it can't store them there, it will store them in the output directory, and failing that
inside Wimp$Scrap.
However, you can overrule all of these options by enabling the 'Use dedicated -webgallery
location' option in the Profiles panel. You can then drag a specific directory to the writable
icon.

You may wish to check where -webgallery is being stored, especially if you're repositioning the
images. This is because Wimp$Scrap is not very safe and the output directory is also not very
safe if you've turned the 'Merge output files' option off (Files panel).

I would advise either storing within the original source directory or specifically setting a
dedicated location, via the Profiles panel.


Notes
~~~~~
WebGallery is merely another utility in the arsenal of the web designer.
It's not intended to replace all other web utilities. To this end, there is quite a bit it
doesn't do. It doesn't replace other graphics utilities for amending and processing the images
before you feed them to WebGallery.

WebGallery doesn't attempt to resize images which are already below the sizes specified in the
Files panel. Thus, to save processing time, you may wish to rescale your source images before
feeding them to WebGallery.

The following additional utilities may be useful to WebGallery users:-

	JClean	- Cleanup and manipulation of JPEGs without losing quality.
	JCut	- Resizing JPEG images without losing quality.
	
	Both the above utilities can be downloaded from;
	http://www.dacha.freeuk.com/free/
	

Adding extra graphics
~~~~~~~~~~~~~~~~~~~~~
Advanced users can add their own navigation icons or background images.
Background images are stored inside !WebGallery.Graphics.backgrounds and each one is in a
sequentially numbered directory. The actual background image should be in GIF format and called
"back/gif". A sprite file called "preview" should accompany it, which is the small graphic
displayed in the 'Web output' panel. This should be a sample of the background image sized at
60x60 pixels in 256 colours (mode 28).

Navigation icon sets are stored inside the !WebGallery.Graphics.iconsets directory and again
are in sequential numbered order. To add your own create a new directory in numeric order and
add the relevant GIF format navigation graphics to it. These should be called "index/gif",
"next/gif" and "prev/gif" for the 'return to index', 'Next image' and 'Previous image'
respectively. A sprite file called preview is the image displayed in the 'Page text' panel. This
should be 129x54 pixels, again in 256 colours (mode 28) and should illustrate the three
navigation icons.

WebGallery will automatically calculate the size of GIF images so you don't need to define the
sizes etc., and they can be any size you want. It's only the preview (sprite) images which
should follow the convention above.


Limitations
~~~~~~~~~~~
There are a number of known limitations, which will be listed here. These are not bugs but
moreover design limitations.

- All source images have to be in the same directory. WebGallery is not a multi-purpose photo
  indexer, but rather a utility for web design. Thus if you're sourcing images from all over the
  place, you should copy them into a specific directory before using WebGallery.
  

Known Bugs
~~~~~~~~~~
WebGallery is a very complex application which allows 100s of different permutations of options,
depending upon which things you've turned on or off.
Although it's designed to be simple and take the pain out of creating web sites manually, it's
always possible that it may get confused and create unexpected output. If this happens, please
try to remember the exact sequence of events that you did prior to it going wrong.

If you report this to me at nospam@vigay.com I will endeavour to fix it for future versions.

Always check the website at http://www.vigay.com/software/webgallery.html for the latest
version.

It's possible that if WebGallery crashes whilst processing images, some files may be left open.
You can close any open files by using my !CloseFiles utility, available free from
http://www.vigay.com/software/closefiles.html

Again, please report any files being left open.

When rearranging images, memory is claimed from the system sprite area. If you don't have enough
memory in the machine, this could generate an error.
It can also take a very long time, depending upon the speed of your computer.

When converting images stored on remote filing systems or USB pen drives, processing can be
*very* slow. Please bear this in mind, or copy files to a local hard drive before processing.

- When switching profiles, if you switch to one with no pictures available (ie. no source path
  or photos available) the caption viewer will be left with the last available (cached) image,
  instead of reverting back to the 'no image'.
  This bug also raises its head when switching between various modes.


Discussion
~~~~~~~~~~
If you would like to discuss WebGallery with other users, please feel free to join my Vigay.com
discussion forum, on my website at http://forum.vigay.com/

Please feel free to offer comments, constructive criticism and thoughts for possible future
enhancements.


Author
~~~~~~
WebGallery is the copyright of Paul Vigay.

Email: nospam@vigay.com
  Web: http://www.vigay.com/software/


Version History
~~~~~~~~~~~~~~~
Latest versions listed first.

 v1.17 (26th Nov 2008)
        a) Bug fix: Amended icon drag routine so that the bounding box is the mouse pointer and
           not the icon edge.
        b) Bug fix: Correctly rename cache/thumbnail sprites with ROOL versions of ChangeFSI.
           
 v1.16 (3rd Sep 2008)
        a) Bug fix: When importing captions, allow drag and drop onto fifth icon of captions.
        b) Bug fix: Changed importing of images to allow with similar filepaths to source images
           (previously disallowed INSTR(importdir,sourcedir), IF in PROCimportimage)
        c) Bug fix: Don't create 'i' directory when converting images only (no web output)
        d) Bug fix: If no web output is enabled, don't save last thumbnail details with profile.
        e) Bug fix: Correctly re-update caption at end of processing.
        f) Added 'special case' batchfsi profile for batch ChangeFSI conversions.
           (name defined as 'bfsi' in messages file)
        g) Added text file encouraging feedback for unregistered versions.
           
 v1.15 (29th Jun 2008)
        a) Added hotkey support for changing panels (function keys 1-10)
        b) Bug fix: Avoided memory allocation error when changing profiles after re-arranging
           thumbnail images in the captions window.
        c) Added check for updates/website links to 'Info' window.
        d) Added additional mode information to processing window, so 'Force overwrite' status
           is also shown.
        e) Added -MAX- tag to inset total number of images.
        f) Added approx. page width calculation to (top right) of 'Thumbnails' panel.
        g) Added option to enable/disable links to W3C validators in 'General' panel.
        h) Bug fix: Corrected incorrect thumbnail scaling factors when extracting EXIF data
           from original images (to compensate for different cameras using a different aspect
           ratio between fullsize image and EXIF thumbnail)
        i) Changed default ChangeFSI JPEG quality to 75% (from 60%)
        j) Added a couple of new icon designs to the navigation icons in the 'Page text' panel.
        k) Bug fix: Correctly open rearrangement window if ChangeFSI options have been changed
           (ie. enabling sharpening etc)
        l) Added search routine to caption panel. WebGallery will search for filenames or
           caption text if you enter it within quotes in the number icon at the top.
        m) Bug fix: Correctly put number of images across page in rearrangement window, if the
           number of images per row has changed (in the thumbnails window).
        n) In the case of duplicate filenames when importing extra images, give the filename as
           part of the error message.
        o) Added additional debugging information to help track down potential problems.
        p) Added fifth line to quotes fields.
        q) Added ChangeFSI filepath to ChangeFSI panel, so you can see which ChangeFSI is in use
        r) Updated interactive help text for new options.
        s) Reworded 'Mode' wording in processing window to make it a bit clearer.
           
 v1.14 (12th Apr 2008)
        a) Major update: Added preliminary caching of thumbnails to speed up processing.
        b) Bug fix: Stopped rearrangement window toolbar jumping to front if another window is
           overlapping rearrangement window and toolbar is dragged.
        c) Bug fix: Issue error messages if there would be too many output files for the number
           of digits set in the leafname.
        d) Reset all settings prior to loading a new profile. This will ensure that when
           changing profiles any 'new' features will bereset to defaults, rather than previous
           settings.
 
 v1.13 (10th Apr 2008) *Not publicly released*
        a) Major update: Added facility to use PNG or GIF images for index/next/prev icons.
        
 v1.12 (8th Apr 2008)
        a) Made drags to destination output automatically detect the parent directory if you
           drag a file to the icon.
        b) Added option to enable/disable WebGallery advertising on individual gallery pages.
        c) Added automatic slideshow option (under Page text panel)
        d) Made frames (in Thumbnails panel) mutually exclusive with web templating system.
        e) Amended 'Show filenames' and 'Show image size' to work with web templating system.
        f) Made W3C menu options grey out if the relevant icon is turned off.
        g) Grey out WebGallery advert options if web templates are in use.
        h) Added email and web link buttons to 'Info' window.
           
 v1.11 (4th Apr 2008)
        a) Bug fix: Improved error handling for invalid or renamed source directories.
        b) Bug fix: Ensured that all window panes close correctly if an error occurs (see a).
        c) Bug fix: Reset default settings.
        
 v1.10 (30th Mar 2008)
        a) Bug fix: Prevented 'memory can't be moved' errors occurring when rearrangement
           window open and a source image is deleted.
        b) Bug fix: Correctly save/restore ChangeFSI 'Gamma' value, due to rounding error.
        c) Bug fix: Correctly update background and icon set images when changing profile.
        d) Bug fix: Correctly output 'Index' icon when creating gallery.
        e) Bug fix: Correctly interpret -FIL- as image filename in web templating system.
 	   
 v1.09 (12th Nov 2007)
        a) Add feature: Open output directory automatically after processing images.
        b) Bug fix: Improved caret handling so that it's not removed from non WebGallery windows
           when processing images. Also, the position is restored when navigating through
           captions.
        c) Tidied demo code so that 'Frame' settings are correctly saved within profiles when
           in demo mode.
        d) Added some more preset image sizes (128x95, 200x150,320x240 and 520x352)
        e) Updated some of the interactive !Help text to correct a couple of typos and also 
           describe new features.
 
 v1.08 (30th Oct 2007)
        a) Bug fix: Main window correctly jumps to the front if obscured by another window and
           you click on the iconbar icon.
        b) Bug fix: Amended scaling factor of rotated thumbnails so that tall 'portrait' mode
           ones are a better ratio next to 'landscape' ones. Made formula 0.1 greater than the
           reciprocal of width/height ratio.
           
 v1.07 (5th Sep 2007)
        a) Bug fix: Ensure that all parameters are saved correctly when you create a new
           profile.
        b) Changed meaning of some tags; -FFF- is now custom and filename is now -FIL-
        c) Added new tag -PAG- to insert HTML filename (minus the .html)
        d) Changed operation of captions so that <br> tag is only inserted if the previous line
           is not blank.
        e) Suppressed caption font size if it's equal to 3, as this is the default base size
           anyway.
        f) Added <p>...</p> tags around captions, only IF web templates are NOT being used.
        g) Bug fix: Don't output any <div>...</div> tags when there is no caption to add.
         
 v1.06 (10th Jul 2007)
        a) Bug fix: Save positions in rearrangement window if images have been moved around and
           new images are imported.
           
 v1.05 (30th May 2007)
        a) Major bug fix: Extended menu buffers to cope with maximum number of menu options from
           directory entries (profiles and web templates menus).
        b) Added facility to delete images.
        c) Bug fix: Doing anything that can affect the position of images now correctly resets
           the 'rearrange images' flag.
        d) Added auto-scroll to rearrangement window if you drag an image to the top or bottom
           of the window.
           
 v1.04 (6th May 2007)
        a) Added ^ icons to file panel, to open relevant directories.
        b) Added import image by dragging images to the 'Captions' panel (as well as the
           re-arrangement window).
        c) Upgraded drag and drop import to allow dragging from other apps via Wimp$Scrap so you
           can now import images direct from emails.
        d) Allowed drag and drop to captions window in order to add images to the source. This
           previously only worked in the re-arrangement window.
        e) Added error message if duplicate filename exists when importing an extra image into
           the source directory.
        f) Added support for Search engine control, such as no archive and no cache.
        g) Added no-cache option.
        h) Updated interactive !Help for recently added features.
        i) Bug fix: -XXX- tags now correctly decoded if they follow a non -tag- character in web
           templates.
        j) Removed some of the restrictions in the demo version.
        k) Allowed Frame controls to work with web templating enabled.
        l) Made source directory non-writable, to force people to drag source images.
        m) Added leafname of current image to preview icon in caption window.
        n) Bug fix: Prevented current caption being cleared after re-arranging images.
        o) Added 'Force overwrite' to Files panel and changed default operation to not
           overwriting existing image files. This dramatically reduces processing time because
           images are only re-processed if not already present in the destination directory, or
           if 'Force overwrite' is turned on.
        p) Speeded up rendering of preview icons slightly by turning off all non processing
           intensive ChangeFSI options when generating on-screen preview images.
        q) Added 'Fast' mode to ChangeFSI options, which changes into Mode 0 for faster JPEG
           processing (pretty useless option, because it waits for a key press/mouse click
           in-between each image!)
        r) Bug fix: Update thumbnail image in caption panel if position moves due to
           rearranging images.
        s) Improved error checking for coping with unintended user operations, such as deleting
           the 'dirlisting' file.
        t) Amended quit routine to not ask for confirmation if you've opened the captions panel
           but not changed anything.
        u) Made clicking on the 'Convert images only' (files panel) option toggle off
           non-relevant panels (for simplicity and to reduce confusion).
        
 v1.03 (6th Jan 2007)
        a) Amended template to remind SHIFT action on dragging source images.
        b) Added 'Open log' button to profiles panel.
        c) Improved logging for errors on merging images with arrangement window.
        d) Bug fix: Rearrangement window closes without warning when you click 'Cancel' if
           you've not moved anything.
        e) Made Cancel/OK buttons in re-arrangement window into a toolbar so that they're always
           visible, irrespective of scroll position.
        f) Added warning triangle image to warning window.
        g) Added button to Captions panel to open original source image in your favourite image
           viewer.
        h) Amended templates slightly to prevent invalid keypresses being entered in the wrong
           icons.
        i) Bug fix: Compensated for maximum image size correctly when output images are rotated.
        
 v1.02 (23rd Dec 2006)
	a) Bug fix: Won't tell you you haven't saved data when trying to quit after clicking on
	   the 'Save' button in the Profiles panel.
	b) Improved rotation icons in Captions panel slightly.
	c) Amended Prev/Next buttons in Captions panel to reverse action on Adjust click.
	   
 v1.01 (11th Dec 2006)
        a) Added ability to rotate each image (click on icon in captions panel)
     
 v1.00 (9th Dec 2006)
        a) Bug fix: Opening choices directory (^ icon in General panel) now correctly opens the
           correct directory, rather than always opening the choices in !Boot.

 v0.15 (7th Dec 2006) BETA 6 - First public release!
        a) Bug fix: Amended sprite name in warning window so that WebGallery icon correctly
           appears.
        b) Added two extra sizes to list of preset image sizes in 'Files' panel.
        c) Amended Max image size label in 'File' panel to read 'Max final image size' for
           additional clarity.
        d) Amended default final image size to be 520x390.
        e) Added confirmation warning when closing rearrangement window.
        f) Removed 'close' icon from rearrangement window.
        g) Wrote tutorial to go through a worked example of Tricia Garner's Orchid gallery,
           highlighting the differences between the standard output and that using a web
           template.
        h) Changed the -FFF- template tag to -GGG- (to allow for below).
        i) Added a new -FFF- web template tag to substitute the filename of the current image
           (stripped of any filetype suffix).
        j) Added new -III- web template tag to substitute the number of the current index page.
        k) Added a display of the current background number in the 'web output' panel.
        l) Added button to open templates directory (^ underneath template name)
           
 v0.14 (6th Dec 2006) BETA 5
        a) Added new feature - Set background colour, if no image.
        b) Changed application name to !WbGallery to make it conform to 10 character filenames.
        c) Created small filer sprite.
        d) Bug fix: No longer re-generates the dirlisting file when you click on the 'captions'
           button, overwriting any previous image re-positioning.
        e) Increased wimpslot to 512k
        f) Bug fix: No longer erases last caption when changing profile.
        g) Added 'Created by WebGallery' advertising icon.
 
 v0.13 (30th Nov 2006) BETA 4
        a) Added JPEG repair routines, to fix JPEG images which don't start with the correct
           marker.
        b) Added a space after the &copy; symbol.
        c) Tweaked code to detect image sizes slightly. This should allow WebGallery to detect
           some JPEG images which had rogue image sizes in them.
        d) Added new feature: Holding SHIFT down when dragging a directory of images will
           preserve any previous 'dirlisting' which will keep any rearrangement of images you
           may have made.
           (doing a normal drag will re-generate a new listing in filer order)
        e) Tidied up some of the initial directory listing generation code so that captions are
           displayed correctly on initial loading.
        f) Added debug mode for future diagnostic tests and bug finding.
           
 v0.12 (23rd Nov 2006) BETA 3
        a) Bug fix: Expanded shortcuts in interactive help text to work on all versions of RISC
           OS.
        b) Made 'Select click' options go in the reverse way if Adjust is clicked. Thanks to
           Steve Revill for spotting this.
        c) Stopped background and iconset selectors from auto-repeating.
           Thanks to Steve Revill for suggesting this.
        d) Implemented DragASprite for drag operations. Thanks again to Steve Revill for
           suggesting this.
        e) Bug fix: Disabled borders around W3C validation icons
        f) Bug fix: iconbar icon correctly initiated when registering (or not) for the first
           time.
        g) Added some more iconsets, plus made existing ones correctly have transparent
           backgrounds.
        h) Added support for interactive help on menus.
        i) Bug fix: Correctly grey out the image page border icons when frames are disabled.
        j) Improved handling of JPEG images to avoid occasional 'end of file' error when
           scanning image size.
        k) Improved error handling of corrupt source files, which should avoid files being left
           open if a duff image is encountered whilst processing.
 
 v0.11 (21st Nov 2006) BETA 2
        a) Added LED status warning to captions window, to alert the user if anything
           potentially suppressing 'caption' output is set.
           Click on the LED to go to the offending panel to rectify.
        b) Bug fix: Copy master default profile, if no default profile is found in profiles
           directory.
        c) Made default destination directory leafname configurable in Messages file (misc17).
        d) Added 'Help' button to 'General' panel - which will launch the !Help file.
        e) Added quotes around ChangeFSI filename parameters, to improve handling of filenames
           with spaces in them.
        f) Increased wimpslot to 464k.
        g) Changed background colour of first caption line, to distinguish between thumbnail
           caption and full caption.
        h) Added ability to import captions (drag a text file to captions window). Also added
           'Edit' button to load current caption into a text editor.
        i) Added check for presence !ChangeFSI in !Run file.
        j) Only generate thumbnail when you click on the 'Captions' panel, not when you drag a
           directory of images.
        k) Removed ability to drag source files into 'Captions' panel. This confused matters, so
           the only way to set the source directory is via the 'Files' panel.
        m) Added extra option to 'Page text' panel to toggle copyright symbol (&copy;) on or
           off. If on (dark), the copyright text will be preceded by &copy;
        n) Tidied 'reset profile' code a bit, so more things are reset to the default (such as
           page text)
        o) Bug fix: Correctly detects/sets Alias$ChangeFSI so that the 'changefsi not found'
           error shouldn't occur. Some people were seeing this due to a missing line from
           ChangeFSI's !Boot file in some versions of ChangeFSI.
        p) Split output into sub-directories for clarity.
        q) Bug fix: Correctly read navigation icon sizes for multiple index links.
           
 v0.10 (17th Nov 2006) BETA 1
	First beta version - should be all working ok though.


2006 Paul Vigay
