
 ======================================================================
  webAlbum v1.0
  Copyright (C) 1998-2000                             Mario L. Mueller
 ======================================================================


 LICENSE AGREEMENT
 -----------------

 Please read the following terms and conditions, carefully, before
 using this software. Unless there has been a different license
 agreement signed by Mario L. Mueller ("AUTHOR") your use,
 distribution, or installation of this copy of webAlbum on your
 web site indicates your acceptance of this License Agreement.

 If you do not agree with any of the terms of this License Agreement,
 do not install, distribute, or use this copy of webAlbum.

 This software, and all accompanying files, data, and materials,
 are distributed "AS IS" and with no warranties of any kind, whether
 express or implied. Good data processing procedure dictates that any
 program be thoroughly tested with non-critical data before relying
 on it.

 In no event shall the AUTHOR or his affiliates be liable for any 
 incidental, consequential, or punitive damages whatsoever relating 
 to the use of webAlbum, or your relationship with the AUTHOR.

 Though this software has been thoroughly examined and tested, the AUTHOR
 makes no guarantees with how the software is intended to perform for
 its user(s). No warranties are made if the resulting outcome
 is unsatisfactory to its user(s) or the site administrator. Use this
 software at your own risk.

 The AUTHOR grants the site administrator the right to host this software
 on their web site at no cost, ONLY IF the site administrator and its
 organization is not making profit from the use of webAlbum. In the case
 that the administrator is running a commercial based organization,
 webAlbum may be evaluated for up to 30 days from its first day
 of use, to which a licensed copy must be obtained from the author
 for continuing usage thereafter.

 Licensed copies of webAlbum CANNOT be hosted on sites other than the
 site the copy was licensed for. Giving out licensed copies and license
 information to other people who have not registered with the AUTHOR
 would be a violation of this License Agreement.


 INTRODUCTION
 ------------

 webAlbum is an online, electronic photo album designed for use
 with personal and corporate web pages. Do you have an enormous
 number of pictures on your web site? webAlbum will take a series 
 of photographs and allow you to display them, flipbook style, on a 
 single page for easy viewing.

 webAlbum was created for the need of an attractive method of
 displaying pictures without having to make HTML pages for each image.
 The Java applet is relatively simple to install; depending
 on your knowledge of web design and Java applets.

 Best of all, non-profit organizations may use webAlbum at absolutely 
 no cost. Additional features and licenses for commercial users can
 be obtained by supporting webAlbum with a very small donation. Please 
 see the LICENSING section for more information on additional
 features and licensing.

 For instructions on installing webAlbum on your web site, please
 continue reading. For additional assistance and album 
 demonstrations, please visit the support site for webAlbum 
 at: http://goopers.com/programs/webAlbum/


 INSTALLATION
 ------------

 Just as any other Java applet, webAlbum must be installed through
 the use of an HTML document. Create or open the HTML document that
 you wish to install webAlbum in, and include the following lines
 of HTML code:

   <APPLET CODE="webAlbum.class" WIDTH=350 HEIGHT=350>
    <PARAM NAME="Album" VALUE="fishing.albm">
   </APPLET>

 The above example embeds webAlbum as a 350x350-sized Java applet
 in the current HTML document using the album named "fishing.albm".
 It is EXTREMELY important that "webAlbum.class" be entered using
 the case shown. Java is case sensitive, so entering "webalbum.class"
 with a lowercase 'A' may not work. (Unless the standards have
 changed ...)

 It is not required to install webAlbum in the same directory as your
 HTML documents. In fact, most administrators prefer to keep their
 Java applets in a designated directory. The following example
 demonstrates how this is done:

   <APPLET CODE="webAlbum.class" 
           CODEBASE="http://goopers.com/applets/" WIDTH=350 HEIGHT=350>
    <PARAM NAME="Album" VALUE="fishing.albm">
   </APPLET>

 This example defines "http://goopers.com/applets/" to be the
 base URL for where the "webAlbum.class" code is stored. Modify this
 path to fit your needs.


 CONFIGURATION
 -------------

 There are several parameters that webAlbum has which allow
 you to customize the behavior and display of the applet. Each of 
 these are outline below:

   Parameter       Values     Description
   --------------  ---------  ---------------------------------
   Album           URL        Associated album file [Required]
   ImageBuffering  On / Off   Buffer images ahead of time?
   Next            Text       Show: Next
   Previous        Text       Show: Previous
   Of              Text       Show: of
   Idle            Text       Show: Ready.
   ClickNext       Text       Show: Next Picture
   ClickPrevious   Text       Show: Previous Picture
   ClickPicture    Text       Show: Download Picture
   LoadingImage    Text       Show: Loading image ...
   LoadingAlbum    Text       Show: Loading album
   Moment          Text       Show: One moment, please ...

 Most of these parameters can be used to modify the text which
 webAlbum displays to its users. This is helpful for people who
 wish to use webAlbum in a language other than English.

 ImageBuffering causes webAlbum to queue each of the album images
 ahead of time, so that they are loaded in the background while the
 user flips through the album. This can save time with albums that
 contain a significant number of pictures. ImageBuffering is a
 special feature that is available only in the fully licensed copy of
 webAlbum. Licenses can be obtained by sending a small donation
 to the author. Please see the LICENSING section for more 
 information on getting a fully licensed copy of webAlbum.


 UPLOADING
 ---------

 In addition to creating HTML files, you will need to upload webAlbum
 somewhere on your server. webAlbum is made up of two classes, both
 being: "webAlbum.class" and "oButton.class". Each of these classes 
 should reside in the same directory and must be uploaded using the
 exact case shown. Java is case sensitive, and extremely 
 picky. Using any other file names may cause an error when running 
 the applet.

 A third file, "webAlbum.au", is optional. Upload this file if you
 have sound enabled in your albums. *.AU files are audio files
 supported by Java. You may change the sound played by the webAlbum
 applet by modifying this file. See the CREATING SOUNDS section
 for details on how this is done.


 CREATING ALBUMS
 ---------------

 webAlbum uses "album files" to define the images shown by the
 applet. Each album is made up of a title, color scheme, and set or
 URLs pointing to the images to be displayed in the album.

 Due to security reasons, typical Java applets are restricted to
 accessing files that are found on the same server as the applet
 is stored on. So, whichever server you have decided to upload
 webAlbum to MUST be the same server where your pictures are stored.

 Creating an album file is relatively simply. You may use a simple
 text editor, such as vi, lse, DOS edit, or Windows Notepad. Use the
 following structure to assist you with creating your album file:

    Line   Values      Description               Default
    -----  ----------  ------------------------  -----------
    1      Text        Title                     none
    2      RGB/Hex     Background color          eeeeee
    3      RGB/Hex     Border color              cccccc
    4      RGB/Hex     Color of corners          none
    5      RGB/Hex     Title color               000000
    6      RGB/Hex     Text color                000088
    7      RGB/Hex     Button label color        000088
    8      Courier     Default Font              Helvetica
           Dialog                                none
           Helvetica
           Symbol
           TimesRoman
    9      URL         Base path for graphics    none
    10     Yes / No    Enable sound?             yes
    11     Integer     Number of Pictures        0
    [...]  URL         Picture URLs

 Lines beginning with a semi-colon are ignored by the webAlbum
 applet, and therefore may be used as comments. In addition, any
 blank lines are skipped. (Careful with these)

 To create your first album, use the sample file included 
 with the distribution package as a template. Then use your newly
 created albums as templates to create newer ones.

 If you are a user of the Windows operating system, a free, compact,
 and handy editor is available for modifying album files. Using
 the editor is convenient for setting the color values, rearranging 
 image order, and writing picture captions. Visit the support site 
 of webAlbum to download a copy of this editor. Editors for other 
 platforms, such as UNIX, will be available if demand for such
 a tool exists.

 Changing the colors used by webAlbum is an option available in the
 fully licensed copy of webAlbum. Licenses can be obtained by sending 
 a small donation to the author. Please see the LICENSING section 
 for more information on getting a fully licensed copy of webAlbum.

 Once you have finished making your album files, you will need to
 upload them to your web server. When uploading, make sure your album files
 are stored in the same directory as the Java applet.


 CREATING SOUNDS
 ---------------

 To change the clicking sound that is played by the webAlbum
 applet, use a sound editing program such as "Sound Forge". Optionally,
 you may turn the sound off by disabling this setting in your
 album files.

 When creating sounds, you must use Sun's (AU) audio format--which
 is the only file type supported by Java v1.02 applets. Files can
 only be sampled at 8,000Hz, and must be saved as 8-bit mono files.
 If you have difficulties finding a program that supports *.AU files,
 visit Sun's web site for utilities that convert WAV files to AU.

 It is very important to append approximately 3/4 of second of
 silence to the end of your sound. Sounds that end abruptly are 
 often truncated by the browser if the user pushes the mouse
 button several times. Appending a silence will ensure your sounds
 are played properly


 LICENSING
 ---------

 Thank you for your interest in webAlbum. Non-profit organizations
 have the right to use webAlbum for free, with absolutely no cost.
 Commercial organizations, or anyone who would profit from the use of
 webAlbum, must obtain a fully licensed copy by making a small
 donation. This, in turn, supports the efforts put forth in the 
 webAlbum project, made by the author.

 Aside from the need of commercial use, there are some additional
 features which are available in the fully licensed version of
 webAlbum that may be of interest to non-profit organizations. They
 are listed below:

     Extended Feature      Description
     --------------------  ------------------------------------------
   - Image buffering       Loading of pictures in the background
                           while users browse the album (explained
                           in CONFIGURATION section of this file)
   - Color configurations  Ability to change the colors of the
                           album displayed by the applet
   - Seemlessness          Removes applet "Copyright" information
                          on browser status bar for seemlessness

 Please visit the webAlbum support site to download a copy of the
 latest licensing form at: http://goopers.com/programs/webAlbum/

 Your support is greatly appreciated!
