The Image Gallery Distribution
Version 2004-06-12

The default method of creating an image gallery is to simply copy a single HTML file and edit it to reference the images and thumbnails for your show.  This default template references the code and application components stored on our server - there is no need for you to copy anything else.  Simply right-click on "template.htm" below, and select "Save Target As..." to save a copy on your local machine.

template.htm This is a copy of an empty image gallery template.  This is the file into which the XML data island must be placed.  You can also edit our Sample Gallery if you prefer not to start from a "blank slate".

You can cause the image gallery to display starting at a selected image by appending "?Image=N" where N is the image number.  For example:

http://myserver/myshow.htm?Image=3

will start the gallery at the 3rd image.


XML Data Island Documentation

The XML Data island that drives the slide show has the following format.  Note that the values show here are typically the default values of those attributes.  Attributes can be omitted from the XML and the default values will be used (newly implemented attributes are highlighted in yellow).

<XML id=xmlSlideShow>
    <Show
        Width="640"           // Default width and height for all slides in show
        Height="480"
        ImageBase=""          // Default location of image files (optional)
        ThumbBase=""          // Default location of thumbnail files
        Border="2"            // Size (in pixels) of borders around thumbs and main
                              // image
        BorderColor="white"   // Use any IE allowed color value
        Margin="10"           // Number of pixels around edge of screen and between
                              // thumbnails
        ThumbSize="40"        // Size (in pixels) of thumbnail images (square)
        ThumbMargin="<Margin>"// Unique margin just to use on thumbnails
        ThumbBorder="<Border>"// Unique border size to use on thumbnails
        NavHigh="false"       // When set to true, positions navigation control higher than the
                              // lower right corner if possible.
        UnselectedColor="black" // Color of border around "unselected" thumbnail images
        ErrorColor="red"      // Color of border around thumbnails of images that cannot be loaded
                              // (typically a missing image).
        BackColor="#3C3C3C"   // Background color of page
        TextColor="white"     // Text color
        Font="Verdana"        // Default Font to use on page
        FontSize="14"         // Default font size to use on page
        CreditsFontSide="10"  // Font size of credits and attribution text
        CreditsColor="<TextColor>" // Color to use for credits and attribution text
        SoundTrack="<URL>"    // URL to a standard windows sound format (eg., *.WAV, *.MP3, *.WMV).  The
                              // Windows Media Player must be installed on the user's machine to hear the
                              // background music track.
        SoundLoop="true"      // Background sound normally loops forever - set to false to stop at end of media.
        Delay="7"             // The number of seconds to dwell on each image when the user clicks the "Play"
                              // button in the slideshow.
        AutoPlay="false"      // Set to true if you want the slideshow Play to occur immediately on loading.
        PlayLoop="false"      // Set to true if you want the Play mode to wrap around the the last to first slide
        Upscale="false"       // Set to true to allow images to be shown larger than their native size
                              // (by default, embedded galleries will not scale images to the largest size that will
                              // fit the enclosing DIV).
        Transition="Fade"     // Image transitions cross-fade by default.  Other options are "Wipe" or "None" (immediate switch).
    >
    <SoundCredit></SoundCredit> // HTML for attribution for the SoundTrack
    <ImageCredit></ImageCredit> // HTML for attribution or copyright (&#169;) notice for all images in the gallery
    <Title
        ShowTitle="true"      // Set to false to keep the show title from being displayed at the top of the show
        TitleFont="<Font>"    // Font to use for the Title (default is the same as the "Font" attribute
        TitleFontSize="<FontSize>+4" // Font size to use for the Title (default is the page "FontSize" plus 4)
    >
    ...                        // A single line of (HTML) text to display as the show title

    </Title>
    <Home
        HREF="<URL>"          // Reference to a home page (link from Home button)
    />

followed by 1 or more <Slide>'s as follows:

        <Slide
            Src="<URL>"       // Relative URL of image file.  So that "foo.jpg" will refer to a
                              // file in the same directory as this htm file; "pictures/foo.jpg"
                              // refers to a file in the subdirectory "pictures".
            NoBase="false"    // If true, ignore Show.ImageBase and Show.ThumbBase (relative images will
                              // be relative to the location of this htm file.
            Thumb="<URL>"     // Numbnail image location - if not given, source.jpg's thumbnail defaults to
                              // source-t.jpg (note the LOWER CASE "t" - important on Unix based web servers).
            Width="<Show.Width>" // Width and height of rectangle to display for slide.  If not given,
                                 // the default size given in the <Show WIDTH= HEIGHT=> attributes are used.
            Height="<Show.Height>"
        >
            <Title></Title>   // HTML text to display as the slide title
            <Date></Date>     // Date of image - if omitted, nothing is displayed
            <Desc></Desc>     // Multiple lines of (HTML) text to display
                              // as the slide description.
            <ImageCredit><ImageCredit> // Image credit to apply to THIS Slide only (overrides Gallery-wide default).
        </Slide>

    </Show>
</XML>