ImageViewer v1.4

by Branton Boehm

    This is the configuration details for ImageViewer version 1.4.  It was written by Branton Boehm (email) in July of 2000.  It's purpose is to allow a large number of pictures to be viewed on one page without loading all the pictures at once on an HTML page and without having to load a new page for each picture.  The size of the class file is smaller than most pictures (6.58KB) meaning you won't have to wait forever just for the applet to load.

Sections:

  1. Param Tags
  2. Configuration
  3. Sample Configuration File
  4. Common Errors
  5. Updates
  6. Questions & Suggestions
  7. Special Thanks

Param Tags:

There are seven param tags, with only one being required.  They are:

    config
    bgcolor
    fontcolor
    loadspeed
    next
    last
    menu

"config" is the one required param tag.  The value is the file name of the configuration text file--where all the picture file names and captions are located.  It MUST be a relative path name to the ImageViewer.class file.

Obviously, "bgcolor" and "fontcolor" control the background and font colors.  They must be in hexadecimal format ("00FA3B", for example).  Make sure you do not include a '#' as is common in web pages.

This version now supports background loading of images once the applet starts.  "loadspeed" can have four values:

Value Speed
0 Option turned off
1 Minimum
2 Normal
3 Maximum

The faster the speed, the more system resources are used.  Normal speed usually works fine but you can adjust it to your preference.  If the "loadspeed" tag is omitted, the value is set to 0.

"next", "last", and "menu" set the text to be displayed on the buttons and the label for the menu.

Return to top


Configuration:

A problem with past versions (1.2 and earlier) of ImageViewer were all the <PARAM> tags.  There were two for each group specified and two for each picture in each group.  If you wanted a large number of pictures, your HTML page got pretty messy.  Also, each picture had to be numbered sequentially.  So if you wanted to add a picture to the first group, you had to renumber every picture (and caption) following it.  This is fixed by putting all of the group names, file names, and captions in a separate text file.  If you want to add a new picture or group, you simply insert it in the text file where you want it.  The text file is described below:

GROUPS:

For each group in the pull-down menu, a "GROUP" must be declared in the text file.  An example follows:

GROUP Family Pictures

Simply put a space after "GROUP" and type the name to appear in the menu following it.  The name can be any length, but if it is too long it will run off the edge of the menu.

PICTURES:

To add a picture to a group, a file name and optional caption follow the "GROUP" declaration.  An example follows:

picnic.jpg|Fun at the park

The relative path to the picture (from the ImageViewer.class file) begins the line.  If you wish to include a caption, it is followed by that cool little vertical line character.  If you can't find it on your keyboard, look at the backslash and it is probably the shift of that.  The caption then follows.  Again, this can be any length but can run off the edge of the applet window.

Return to top


Sample File:

Here is an example file.  You should, of course, replace the group names, file names, and captions with your own.

config.txt

GROUP Family Picnic
food.jpg|I think Mom cooked enough!
ants.jpg|What's a picnic without ants?
frisbee.jpg|A little fun after the food.
grandparents.jpg

GROUP Christmas
nativity.jpg|The birth of Jesus remembered
dinnertable.jpg|Everyone made it home this year
babies.jpg|The kids and their presents...

GROUP Graduation
wholeclass.jpg
valedictorian.jpg
salutatorian.jpg
brian.jpg

Return to top


Common Errors:

There are some errors that are easy to make and happen fairly frequently:

Return to top


Update History:

ImageViewer 1.4 (released 7/7/00):

ImageViewer1.3 (released 6/30/00):

ImageViewer1.2 (released 6/29/00):

Return to top


Questions & Suggestions:

Please send any questions and suggestions to me at bxb57@cwru.edu.  I'm looking for ways to make this applet better and easier to use, so I'd be happy to hear from you.

Return to top


Special Thanks:

I'd like to thank Dave Marsh, the webmaster of http://www.blinki.net/.  They're an up and coming Canadian rock band and he has given me great input, suggestions, and feedback.


2000, Branton Boehm; bxb57@cwru.edu; http://brantonboehm.com/