Reference Manual of the Photo Show tool

Kurt Nørmark © normark@cs.auc.dk Department of Computer Science Aalborg University Denmark

Source file: tools/photo-show/photo-show.scm
LAML Version 22.00 (December 4, 2003, alpha-4)

The photo show tool generates a continous presentation of gif or jpg pictures from a particular directory. The kernel of the tool is a Javascript mechanism which navigates automatically from one HTML page to the other. The function make-photo-show generates a set of trivial HTML pages (two per picture). The function photos-in-current-directory generates a list photo entries of the jpg and gif file in the current directory. As an alternative you can make this list manually. Photos-in-current-directory depends on the non-standard Scheme function directory-list (which is supported by MzScheme).
Tool Usage: Define a simple LAML script in the directory which contains the photos. See the examples for concrete information. By LAML processing the script the necessary HTML files are defined in an html sub-directory (made by this tool).
The index.html file, generated in the current directory, is a natural starting point of the photo show. The file index-visual.html is an alternative index.
Each execution of make-photo-show genererates a file first.lsp, which contains the name of the first photo in the collection (a string with no extension). The function first-url-in-directory (which generates a continutation url for another collection) uses the first.lsp file of the other directory. Thus, this must be taken into consideration when a more complex collection of photos are organized.
The procedure make-photo-show also generates index-visual-editor.html, which is a page that submits a request to a photo service program at www.cs.auc.dk. The server returns a zip file with all necessary html stuff for a photo show, including new index files. Please notice that this facility is experiment, and not yet meant for general use.
Obsolete. Use the XML-in-LAML Photo Show Tool.

Table of Contents:
1. Example script. 3. Other important variables.
2. Default settings. 4. Top level functions.

Alphabetic index:
default-lower-caption default-lower-caption A default string for the lower captions of pictures (a string)
default-lower-size default-lower-size A default string for the lower font size of pictures (a number between 1 and 6)
default-photo-height default-photo-height The default height of a photo.
default-photo-width default-photo-width The default width of a photo.
default-time default-time A default time (a number, in seconds).
default-upper-caption default-upper-caption A default string for the upper captions of pictures (a string)
default-upper-size default-upper-size A default string for the upper font size of pictures (a number between 1 and 6)
first-url-in-directory (first-url-in-directory dir) Return the URL of the first photo page (a html page) in dir.
home-url home-url A URL which allows us to exit from the photo index.
last-url last-url The relative URL of the continuation of this photo show.
make-photo-show (make-photo-show photo-list) Make the photo-show from photo-list in terms of individual HTML files and an index file.
photo-destination-dir photo-destination-dir The directory in which to write the output html files from this tool.
photo-show-title photo-show-title The title of the show.
photo-show-verbose photo-show-verbose A variable that controls if the tool can generate informative messages.
photos-in-current-directory (photos-in-current-directory) Return a list of photo-entries, sorted alphabetically, in the LAML startup directory.
take-subset-by-numbers (take-subset-by-numbers number-list photo-input-list) Return a sublist of photo-input-list, namely the photo entries in number-list.
url-of-first-picture (url-of-first-picture photo-list) Return a URL to the first picture in the photo list.
visual-index-photo-width visual-index-photo-width The width of photos in the visual index

1. EXAMPLE SCRIPT.
Here follows an example script which makes a photo show. Place it in the directory with you photos.

(load (string-append laml-dir "laml.scm"))
(load (string-append laml-dir "tools/photo-show/photo-show.scm"))

(define default-upper-caption "Some title to appear above photo")
(define default-upper-size 6)  ; font size - a number between 1 and 6
(define default-lower-caption #f)  ; no lower caption
(define default-lower-size 1)

(define photo-show-title "Title of show")

(define default-time 2)  ; show each picture 2 seconds

(define photo-list (photos-in-current-directory))   ; extract photos from current dir
(define last-url (url-of-first-picture photo-list))  ; show cyclic show

(make-photo-show photo-list)