The Download frameit Page

This is the home page for frameit, a perl script I wrote that takes a bunch of JPG and MPG files from the current directory (or as specified on the command line) and formats them in to a set of frames and thumbnails for easy viewing. Of course, your definition of "easy" may vary and probably depends a lot upon how much you like frames. Most of the image pages I've posted on my home page were generated various incarnations of this script. I also include my rr script; I use this for rotating images because my camera doesn't seem to notice when I rotate it and compensate for me. *smirk*

Update 7 August 2003
Version 1.20

I've been remiss about updating frameit, but I finally broke down and did it. This release fixes a bug reported months ago by Bruce Pinsky dealing with rounding errors for non-standard size images. I now coerce the sizes to integers so the underlying utilities don't complain.

This release also adds JavaScript code to enforce loading of the frame layout in index.html, even if you try to load one of the other html files stand-alone. I've had problems with search engines indexing the captions I add to all.html, and wanted folks who follow those links to "do the right thing".

Update 14 January 2002
Version 1.18

With the latest update to frameit a little usage information might be helpful. Note first that all command line options are just that -- optional. By default, frameit will process all the JPGs and MPGs in the current directory and the defaults to the options should be reasonable. Should you wish to override them, however, here is the usage:

frameit [-t title] [-s subtitle] [-d date] [-b base] [-k] [-v] [<jpg|mpg>...]
-t title [Default: 'Title'] Set the document and page titles to title in the generated HTML.
-s subtitle [Default: 'Subtitle'] Set the page subtitle to subtitle in the generated HTML.
-d date [Default: 'Date'] Set the date to date for display in the generated HTML.
-b base [Default: (none)] Set the base URL for the help file and 1pxclear.gif links. The path '/misc/fhelp.html' will be appended to this URL for the help file, while '/images/1pxclear.gif' will be appended for the gif. (See below for details on the gif.) The default will look for these files in your server's /images and /misc directories.
-k [Default: (off)] Set the base URL to 'http://www.kensiski.org' to retrieve the help file and 1pxclear.gif off my web site. This saves you from having to create local copies at the expense of relying on me for them.
-v [Default: (off)] Spew verbose debugging output
[<jpg|mpg>...] [Default: all JPGs and MPGs] List of images and movies to process.

These files come pretty much as-is, though you can email me <[email protected]> with feedback, comments, constructive criticism, lewd jokes, etc, if you like. I'll implement any changes that sound cool, but I can't promise to do so in anything close to a timely manner.

One final note. These scripts rely on a couple of other tools. Word has it they come with Red Hat Linux, but for Solaris, I had to compile them myself. They include the cjpeg and djpeg programs from the Independent JPEG Group's free JPEG software. The version I am using is v6b, but I would imagine anything newer would work as well. The other tool this uses is Jef Poskanzer's PBMPLUS utitlities, currently available as the NetPBM suite of programs. (Jef no longer does much with the code; it is instead maintained by the NetPBM Group.)

The software is released under the GNU General Public License. You are free to use and copy the software under it's terms.

So what I have are the following perl v5 scripts and stuff:

frameit
The source to frameit, the script that generates the html and thumbnails. If you try to look at the source in your browser, the embedded HTML might make things unreadable. If so, save the file and look at it with a pager.
rr
The source to rr, the script that rotates images 90 degrees. Install as rr and it will rotate 90 degrees to the right, and as rl and it will rotate 90 degrees to the left. Finally, install as xy (or flip) and it will rotate about the horizontal axis (i.e. mirror image). [Kudos to Allan Leinwand for the xy code.]
1pxclear.gif
This is a tiny (43 bytes) one pixel transparent GIF image I use to provide spacing in the top frame. You can readily adjust the spacing by changing the WIDTH parameter in top.html. By default, frameit hopes to find this file on your server at /images/1pxclear.gif.

The to do list:


David L. Kensiski
$Id: index.html,v 1.8 2003/08/07 20:51:26 dlk Exp $