The html_gallery8 Script

The html_gallery8 Script
by Zachary X. Reiter and Clifford A. Reiter
October 2002

The image3 addon script, html_gallery8.ijs, contains functions used for creating web galleries of images in an automatic manner. Some utilities for organizing lists of images are also included.
Typical usage might be something like:

3 mk_html_gallery _320 _280 images_in '\pictures\2002_03\hike\'

which would create a gallery from the images (excluding thumbnails) in the indicated path with 3 columns and thumbnails with a maximal width of 320 and maximal height of 280. Since no output filename was specified, the html file would be named index.html in the same path as the first image.

File List Utilities

images_in 'path' results in the images (excluding 'th_*.*' type thumbnails) in the given directory
(boxed_extension_list) im_in 'path' results in the images in the given directory with the given extensions excluding those with 'th_*' prefixes; e.g. ('bmp';'png') ims_in 'path' would give all bmp and png (nonthumbnail) files in the directory. Prebuilt functions for individual image types are defined; e.g., bmps_in=:'bmp' im_in; likewise, tgas_in, jpegs_in, movs_in etc are defined.
dir_to_lc 'path' changes the name of all the files in the specified directory to lower case

High Level Functions

[out_filename] numcols mk_html_gallery thumb_bound filelist results in the images in the given file list shown as thumbnails in an html gallery with the (optional) specified name
[out_filename] (numcols [options]) update_html_gallery thumb_bound filelist results in the images in the given file list shown as thumbnails in an html gallery with the (optional) specified name. If possible, image descriptors are preserved. The options are a list specifying a Boolean value and a number; the boolean value indicates whether or not to preserve material before/after the image table (default is 1=yes); the number specifies which table to replace (default is 0).
[out_filename] (approx_num_rows,numcols) mk_html_gallery_seq thumb_bound filelist results in the images in the given file list shown as thumbnails in a sequence of html galleries with approximately approx_num_rows number of rows.

The file list should be a boxed array of file names specifying the images for the gallery.

Thumbnail Bounds

The thumb_bound is typically a list of the maximal desired width and height of the thumbnail. The actual size of the thumbnail fits inside those bounds while preserving the original image's aspect ratio. Negative bounds indicate that if the thumbnail already exists and is of the correct size, it should not be recreated. A thumb_bound of 0 indicates that the thumbnails should not be created.

Lower Level Utilities

Here we describe a few of the lower level facilities offered by the script. See the lab and sample scripts for some illustrations of usage and see the script itself for some self documentation.

thumb_wh mk_th_image 'infile';'outfile' creates a thumbnail fitting in the given width & height; default file name is used for the thumnail, if not given as part of the argument.
thumb_bounds cond_mk_th_image boxed_fn_th_nm_list conditionally creates thumbnails; the right argument is a boxed matrix with each row giving an image/thumbnail pair; thumbnails are created only if the desired thumbnail does not exist or is the incorrect size
'tag' ht_tags 'text' creates '<tag>text</tag>'
ht_table_prolog data that precedes the image table. Default value is <font size = 4><B><center>Image Gallery</center></B> <center>. This provides a simple header for the gallery and centers the table; see the html lab for an example of using an image as the gallery header.
ht_table_postlog is data that follows the table. The default value simply closes the centering of the image table: </center>
td_prolog and td_postlog are functions that are applied to the 'image';'thumbnail' filename list to produce the material before/after the the image link itself. Default is to center and include the short file name of the image.

ht_fmt_image may be used to create an image reference; for example:

   ht_fmt_image 'addons\image3\atkiln.jpg'
<img src="atkiln.jpg" width="468" height="700" alt= "133k">

ht_href_fmt_image may be used to create a html reference with a thumbnail image shown for the link; for example, he a thumbnail is created and a link to the image via the thumbnail is produced as the result of the function. 100 100 cond_mk_th_image 'addons\image3\atkiln.jpg' 3026 ht_href_fmt_image 'addons\image3\atkiln.jpg' <a href="atkiln.jpg"><img src="th_atkiln.jpg" width="66" height="100" alt= "133k"></a>

Flips and Rotations

While various flips and rotations for jpeg images were defined in the image3.ijs script, in this script several are defined so that other images may be manipulated as well.

rot_cw_90 'filename' rotates the image in the file 90 degrees clockwise
rot_cw_180 'filename' rotates the image in the file 180 degrees clockwise
rot_cw_270 'filename' rotates the image in the file 270 degrees clockwise
flip_v 'filename' flips the image vertically
flip_h 'filename' flips the image horizontally
transpose 'filename' transposes the image along its main diagonal

Link to:
Image3 Main Help