Source Code 1994 March/Source_Code_CD-ROM_Walnut_Creek_March_1994.iso/compsrcs/misc/volume33/icontact/part01

Text File | 1992-11-01 | 26.4 KB | 625 lines

Newsgroups: comp.sources.misc
From: [e-mail] (Mark Hanson)
Subject:  v33i030:  icontact - perl script to create contact sheets of images, v1.3, Part01/02
Message-ID: <csm-v33i030=[e-mail]>
X-Md4-Signature: bc686c1ace80866ec91b350311326bb9
Date: Mon, 2 Nov 1992 05:21:43 GMT
Approved: [e-mail]

Submitted-by: [e-mail] (Mark Hanson)
Posting-number: Volume 33, Issue 30
Archive-name: icontact/part01
Environment: UNIX, perl, pbmplus
Supersedes: icontact: Volume 30, Issue 77

icontact-1.3 (25oct92)

This is the fourth release of icontact.

New features include (look at the man page for specifics):
  - the colors of all the different parts of the contact sheets (label
    text, background, border stripes, etc.) are now user configurable.
  - smarter input image filename processing.
  - the rows of contact sheets can now be left justified.
  - a nice value may be specified for the child processes.
  - signal names instead of signal numbers when a signal is caught.
  - icontact does not give up as easily as it used to when a child dies.
  - user specifiable color quantization program.

I would appreciate hearing from you if you find icontact useful or have
suggestions on how to make it better.  I only have access to a
SPARCstation running SunOS 4.1.2, so icontact has only been tested in
this environment.  If icontact fails in your environment, let me know
so I can fix it.

Send all e-mail regarding icontact to [e-mail].

Here is the DESCRIPTION section from the man page:

  icontact is a perl script that takes a bunch of image files and creates
  contact sheets.  icontact determines the file format by the file name
  extension of the input files and then uses internal tables to look up
  the commands it needs to convert the images to the ppm format.  Once in
  the ppm format, icontact uses various pbmplus commands to create the
  contact sheets.  icontact is particularly useful if you have lots of
  image files in all sorts of different formats and you want to create an
  index of all of them without converting them all to a common format
  first.

  icontact is highly configurable.  It can probably do anything you would
  ever want this type of program to do - and more.  If you think of
  additional features that would be useful for a program of this type to
  do, tell me and I'll see what I can do.

  Besides perl, icontact requires the pbmplus package by Jef Poskanzer.
  The Independent JPEG Group's package (cjpeg, djpeg) is also necessary
  if you are going to be processing any JPEG files.  It should not be
  difficult to add filters from other packages as long as there is a way
  to go to and from the ppm format with them.

I hope you find icontact useful,
mark

-------------------------------------------------------------------------------
#! /bin/sh
# This is a shell archive.  Remove anything before this line, then unpack
# it by saving it into a file and typing "sh file".  To overwrite existing
# files, type "sh file -c".  You can also feed this as standard input via
# unshar, or by typing "sh <file", e.g..  If this archive is complete, you
# will see the following message at the end:
#        "End of archive 1 (of 2)."
# Contents:  README icontact.1
# Wrapped by mark@eggman on Sun Oct 25 15:29:45 1992
PATH=/bin:/usr/bin:/usr/ucb ; export PATH
if test -f 'README' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'README'\"
else
echo shar: Extracting \"'README'\" \(2729 characters\)
sed "s/^X//" >'README' <<'END_OF_FILE'
Xicontact-1.3 (25oct92)
X
XThis is the fourth release of icontact.
X
XNew features include (look at the man page for specifics):
X  - the colors of all the different parts of the contact sheets (label
X    text, background, border stripes, etc.) are now user configurable.
X  - smarter input image filename processing.
X  - the rows of contact sheets can now be left justified.
X  - a nice value may be specified for the child processes.
X  - signal names instead of signal numbers when a signal is caught.
X  - icontact does not give up as easily as it used to when a child dies.
X  - user specifiable color quantization program.
X
XI would appreciate hearing from you if you find icontact useful or have
Xsuggestions on how to make it better.  I only have access to a
XSPARCstation running SunOS 4.1.2, so icontact has only been tested in
Xthis environment.  If icontact fails in your environment, let me know
Xso I can fix it.
X
XSend all e-mail regarding icontact to [e-mail].
X
XHere is the DESCRIPTION section from the man page:
X
X  icontact is a perl script that takes a bunch of image files and creates
X  contact sheets.  icontact determines the file format by the file name
X  extension of the input files and then uses internal tables to look up
X  the commands it needs to convert the images to the ppm format.  Once in
X  the ppm format, icontact uses various pbmplus commands to create the
X  contact sheets.  icontact is particularly useful if you have lots of
X  image files in all sorts of different formats and you want to create an
X  index of all of them without converting them all to a common format
X  first.
X
X  icontact is highly configurable.  It can probably do anything you would
X  ever want this type of program to do - and more.  If you think of
X  additional features that would be useful for a program of this type to
X  do, tell me and I'll see what I can do.
X
X  Besides perl, icontact requires the pbmplus package by Jef Poskanzer.
X  The Independent JPEG Group's package (cjpeg, djpeg) is also necessary
X  if you are going to be processing any JPEG files.  It should not be
X  difficult to add filters from other packages as long as there is a way
X  to go to and from the ppm format with them.
X
XTHANKS TO:
X  - Roger Hayes ([e-mail])
X    for sending me an implementation of the -W option.
X  - Larry W. Virden ([e-mail])
X    for suggesting the -O option and the feature that allows you to take an
X    old contact sheet and add new images to it.
X  - Marco Pauck ([e-mail])
X    for pointing out that I was using some possibly uninitialized variables.
X  - Mark Valentine ([e-mail])
X    for suggesting the -L option and all the color options.
X
XI hope you find icontact useful,
Xmark
END_OF_FILE
if test 2729 -ne `wc -c <'README'`; then
    echo shar: \"'README'\" unpacked with wrong size!
fi
# end of 'README'
fi
if test -f 'icontact.1' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'icontact.1'\"
else
echo shar: Extracting \"'icontact.1'\" \(19275 characters\)
sed "s/^X//" >'icontact.1' <<'END_OF_FILE'
X.nh
X.TH ICONTACT 1 "icontact\-1.3 (25oct92)"
X.SH NAME
Xicontact \- create contact sheets from images of different formats
X.SH SYNOPSIS
X\fBicontact\fP [ \fIswitches\fP ] [ { \fIimage file\fP | \fIparameter
Xfile\fP } ... ]
X.SH DESCRIPTION
X.PP
X\fIicontact\fP is a \fIperl\fP script that takes a bunch of image files
Xand creates contact sheets.  \fIicontact\fP determines the file format
Xby the file name extension of the input files and then uses internal
Xtables to look up the commands it needs to convert the images to the
Xppm format.  Once in the ppm format, \fIicontact\fP uses various
X\fIpbmplus\fP commands to create the contact sheets.  \fIicontact\fP is
Xparticularly useful if you have lots of image files in all sorts of
Xdifferent formats and you want to create an index of all of them
Xwithout converting them all to a common format first.
X.PP
X\fIicontact\fP is highly configurable.  It can probably do anything you
Xwould ever want this type of program to do \(em and more.  If you think
Xof additional features that would be useful for a program of this type
Xto do, tell me and I'll see what I can do.
X.PP
XBesides \fIperl\fP, \fIicontact\fP requires the \fIpbmplus\fP package
Xby Jef Poskanzer.  The Independent JPEG Group's package (\fIcjpeg\fP,
X\fIdjpeg\fP) is also necessary if you are going to be processing any
XJPEG files.  It should not be difficult to add filters from other
Xpackages as long as there is a way to go to and from the ppm format
Xwith them.
X.SH OPTIONS
X.PP
XSwitches that do not take arguments may be combined into a single
Xswitch: \fB\-abBlv\fP.  Switches that take
Xarguments must be followed by their arguments with space in between:
X\fB\-c\ 10\ \-r\ 5\fP.  The fancy way combine all these switches is:
X\fB\-abBlvc\ 10\ \-r\ 5\fP.  That is, you can combine the switches
Xtogether in any way you like so long as the switches that take an
Xargument are followed by said argument with a space in between.  If you
Xdon't want to get fancy, just specify each switch by itself:
X\fB\-a\ \-b\ \-B\ \-c\ 10\ \-l\ \-r\ 5\ \-v\fP.
X.\"
X.PP
XIn all cases in which a switch does not take an argument,
X\fB\-switch\fP will turn the switch on, and \fB+switch\fP will turn the
Xswitch off.  For example, \fB\-l\fP will turn labels on, and \fB+l\fP
Xwill turn labels off.  This can be useful if you have a particular set
Xof switches set in a configuration file and you want to temporarily
Xdisable a switch to make a sheet without changing the configuration
Xfile.  If a set of switches are combined into a single switch that
Xleads with either a \fB+\fP or a \fB\-\fP, the \fB+\fP or \fB\-\fP
Xaffects all the switches in that set of switches.  If a switch that
Xtakes an argument is specified with a leading \fB+\fP, it is assumed
Xthat you meant \fB\-\fP.
X.\"
X.PP
XAn argument of \fB\-\-\fP terminates the options list and signals the
Xbeginning of the file list.
X.\"
X.PP
XSwitches can be specified in two places: the command line and a
Xconfiguration file.  The command line switches are the most potent \(em
Xthey override everything.  The switches in a configuration file are the
Xnext most potent \(em they are only overridden by the command line
Xswitches.  The internal defaults of \fIicontact\fP are overridden by
Xboth the command line and configuration file.
X.\"
X.IP \fB\(+-a\fP
XMake the output sheets fit into the size specified with the \fB\-x\fP
Xand \fB\-y\fP switches.  Setting the \fB\-x\fP and \fB\-y\fP switches
Xto the size of your screen will yield contact sheets which are no
Xlarger than your screen.  The \fB\-r\fP and \fB\-c\fP switches will be
Xignored if the \fB\-a\fP switch is present because the number of rows
Xand columns is figured out dynamically and will probably change from
Xsheet to sheet unless the \fB\-i\fP switch is specified or all the
Xsource images are of the same size to begin with.
X.\"
X.IP \fB\(+-B\fP
XAdd a border to each image in the contact sheet.  The colors of the border
Xstripes may be specified with the \fB\-z\fP switch.
X.\"
X.IP \fB\(+-b\fP
XUse the \fIbasename(1)\fP of the file name instead of the whole path
Xname to the file in labels.  This switch will be ignored if the
X\fB\-l\fP switch is not specified.
X.\"
X.IP "\fB\-C\fP \fIcolor\fP"
XUse \fIcolor\fP for the background of the contact sheet.  The default
Xvalue is ``black''.
X.\"
X.IP "\fB\-c\fP \fIn\fP"
XMake the contact sheets with \fIn\fP columns of images.  This switch is
Xignored if the \fB\-a\fP switch is specified.  The default value is 7.
X.\"
X.IP "\fB\-D\fP \fIformat\fP"
XIf a file without a suffix is processed, assume it is a \fIformat\fP file.
XThe default value is ``.gif''.
X.\"
X.IP "\fB\-d\fP \fIdir\fP"
XPut the contact sheets in \fIdir\fP when completed.  The default value
Xis ``.''.
X.\"
X.IP "\fB\-F\fP \fIfile\fP"
X\fIfile\fP will be used with \fIpbmtext\fP as a font for labels.  Each
Ximage's height will be increased by the height of the characters in the
Xfont.  This switch will be ignored if the \fB\-l\fP switch is not
Xspecified.  By default, \fIpbmtext\fP's internal font is used.
X.\"
X.IP "\fB\-f\fP \fIformat\fP"
XEncode the finished contact sheets as \fIformat\fP files.
XThe default value is ``.ppm.Z''.
X.\"
X.IP \fB\(+-g\fP
XGenerate a parameter file for each contact sheet produced.  This
Xparameter file will be named \fIprefix###.format.suffix\fP, where
X\fIprefix\fP is the contact sheet name, \fI###\fP is the number of the
Xcontact sheet, \fIformat\fP is the file format of the contact sheet,
Xand \fIsuffix\fP is the parameter file suffix specified with the
X\fB\-P\fP switch.  When \fIicontact\fP sees one of these files on the
Xcommand line, it looks in the parameter file for the names and
Xlocations of images inside the sheet specified by removing the
X\fIsuffix\fP from the parameter file name.  These images will be cut
Xout and put in the new output sheets instead of being fully processed
Xagain.  For best results when using parameter files on the command
Xline, select no quantization and a lossless file format both when the
Xsheet is first created and also when its parameter file is used on the
Xcommand line.  This will prevent information loss if this operation is
Xperformed multiple times.
X.\"
X.IP \fB\-help\fP
XThis is a special case which will print out a help message explaining
X\fIicontact\fP's switches.  Any other unrecognized switch will do the
Xsame.
X.\"
X.IP "\fB\-h\fP \fIn\fP"
XMake each image in the contact sheets a maximum of \fIn\fP pixels
Xhigh.  The aspect ratio of the images will not be changed.  This switch
Xwill be ignored if the \fB\-X\fP switch is also specified.  The default
Xvalue is 100.
X.\"
X.IP "\fB\-I\fP \fIcolor\fP"
XUse \fIcolor\fP for the area around the images when the \fB\-i\fP switch
Xis used.  This switch will be ignored if the \fB\-i\fP switch is not also
Xspecified.  The default value is ``black''.
X.\"
X.IP \fB\(+-i\fP
XMake all of the images the same size.  The size of the images is
Xdetermined by the dimensions specified with the \fB\-w\fP and \fB\-h\fP
Xswitches.  Use of this switch can create contact sheets with lots of
Xblank space between images.  This switch cannot be used with the
X\fB\-X\fP or \fB\-Y\fP switches.
X.\"
X.IP "\fB\-K\fP \fIfile\fP"
XUse \fIfile\fP as the configuration file.  The default configuration
Xfile name is ``~/.icrc''.  Putting this switch in the configuration
Xfile will have no effect since once you're in a configuration file,
Xit's too late to switch to another one.
X.\"
X.IP \fB\(+-k\fP
XDon't reference the configuration file.  Putting this switch in the
Xconfiguration file will have no effect since once you're in the
Xconfiguration file, it's too late to back out.
X.\"
X.IP \fB\(+-L\fP
XWhen creating sheets, use left justification on the rows instead of
Xthe default center justification.
X.\"
X.IP \fB\(+-l\fP
XAttach a label containing the image's file name below each image.  This
Xname may be truncated if the label is wider than the image.  The
Xbehavior of this switch can be changed with the \fB\-b\fP, \fB\-F\fP, and
X\fB\-T\fP switches.
X.\"
X.IP "\fB\-N\fP \fIvalue\fP"
XUse \fIvalue\fP as the nice value for all child processes.  The default
Xvalue is 0.  Only root may specify negative nice values.
X.\"
X.IP "\fB\-n\fP \fIfile\fP"
XTake the file names from \fIfile\fP and add them to the ones specified
Xon the command line, if any.  The file names in \fIfile\fP must be one
Xper line.  These file names will be processed after the file names
Xspecified on the command line.
X.\"
X.IP \fB\(+-O\fP
XFind the number for the first sheet by looking in the destination
Xdirectory for sheets with the same prefix and format that we are going
Xto create.  Take the highest numbered one, increment, and this is the
Xnew starting number for the new sheets.  If there are no files with the
Xsame prefix and format in the destination directory, the new sheets
Xwill start with 001.  This switch cannot be used with the \fB\-o\fP
Xswitch.
X.\"
X.IP "\fB\-o\fP \fIn\fP"
XThe output sheet numbering will begin with \fIn\fP and increase from
Xthere.  This switch cannot be used with the \fB\-O\fP switch.  The
Xdefault value is 001.
X.\"
X.IP "\fB\-P\fP \fIsuffix\fP"
X\fIsuffix\fP will be used as the extension of the contact sheet
Xparameter files if the \fB\-g\fP switch is specified.  See the
X\fB\-g\fP switch description for more details.  The default value is
X``.icp''.
X.\"
X.IP "\fB\-p\fP \fIprefix\fP"
XName the contact sheets \fIprefix###.format\fP, where \fI###\fP is the
Xnumber of the contact sheet and \fIformat\fP is the format of the
Xcontact sheet.  The default value is ``ic\-''.
X.\"
X.IP "\fB\-Q\fP \fIquantization program\fP"
XUse \fIquantization program\fP to quantize the contact sheets.  The
X\fIquantization program\fP should accept ppm format files as input and
Xtake one numeric argument specifying the number of colors to be left in
Xthe contact sheets.  It is possible to use a pipeline such as: ``cjpeg
X-Q 100 | djpeg -q''.  The default value is: ``ppmquant -fs''.
X.\"
X.IP "\fB\-q\fP \fIn\fP"
XQuantize the contact sheets down to \fIn\fP colors.  A value of 0 will
Xturn off quantization.  The default value is 0.
X.\"
X.IP "\fB\-r\fP \fIn\fP"
XMake the contact sheets with \fIn\fP rows of images.  This switch is
Xignored if the \fB\-a\fP switch is specified.  The default value is 7.
X.\"
X.IP \fB\(+-S\fP
XSort the file names taken from the command line (and, optionally, from
Xthe file specified with the \fB\-n\fP switch) into alphabetical order
Xbefore making the sheet.
X.\"
X.IP \fB\(+-s\fP
XDon't output anything except warnings and fatal errors.
X.\"
X.IP "\fB\-T\fP \fIcolor\fP"
XUse \fIcolor\fP as the color of the text of the image labels.  The
Xformat of \fIcolor\fP may be any that \fIpgmtoppm\fP understands.  The
Xdefault value is ``white''.
X.\"
X.IP "\fB\-t\fP \fItempdir\fP"
XUse \fItempdir\fP to hold \fIicontact\fP's intermediate files.
X\fIicontact\fP tries to minimize the amount of temporary space it
Xneeds, but it's disk space requirements can be large depending upon the
Xparticular operation it is performing.  If you have a tiny /tmp
Xdirectory, you'll want to use this switch to aim \fIicontact\fP at a
Xlarger chunk of disk.  The default value is ``/tmp''.
X.\"
X.IP \fB\(+-u\fP
XDelete duplicate entries in the list of image file names.  The first
Xfile with any particular name will make it through, but following files
Xwith the same name will be deleted from the file name list.  The
Xdefault it to allow duplicate file names.
X.\"
X.IP \fB\(+-v\fP
XCause all sorts of possibly interesting output to be printed to the
Xscreen.  The output includes the current parameters of \fIicontact\fP
Xand all the shell commands it is running.  If you're having difficulty
Xgetting \fIicontact\fP to do what you want it to do, try using this
Xswitch to see what \fIicontact\fP is doing behind your back.
X.\"
X.IP "\fB\-w\fP \fIn\fP"
XMake each image in the contact sheets a maximum of \fIn\fP pixels
Xwide.  The aspect ratio of the images will not be changed.  This switch
Xwill be ignored if the \fB\-Y\fP switch is also specified.  The default
Xvalue is 100.
X.\"
X.IP \fB\(+-X\fP
XThis switch will make all the images the same width.  Their heights
Xwill be whatever they are when the image comes out of \fIpnmscale\fP.
XThe aspect ratios of the images will not be changed.  Wide images will
Xbe short and tall images will be tall.  This switch cannot be used with
Xthe \fB\-i\fP or \fB\-Y\fP switches.
X.\"
X.IP "\fB\-x\fP \fIn\fP"
XWhen used with the \fB\-a\fP switch, \fIn\fP specifies the width of the
Xoutput sheets in pixels.  This switch will be ignored unless the
X\fB\-a\fP switch is specified.  The default value is 1152.
X.\"
X.IP \fB\(+-Y\fP
XThis switch will make all the images the same height.  Their widths
Xwill be whatever they are when the image comes out of \fIpnmscale\fP.
XWide images will be wide and tall images will be skinny.  The aspect
Xratios of the images will not be changed.  This switch cannot be used
Xwith the \fB\-i\fP or \fB\-X\fP switches.
X.\"
X.IP "\fB\-y\fP \fIn\fP"
XWhen used with the \fB\-a\fP switch, \fIn\fP specifies the height of
Xthe output sheets in pixels.  This switch will be ignored unless the
X\fB\-a\fP switch is specified.  The default value is 900.
X.\"
X.IP "\fB\-z\fP \fIcolor [color ...]\fP"
XWhen used with the \fB-B\fP switch, the layers of the borders around
Xthe images will be striped (from the inside out) with the colors
Xspecified after this switch.  Double quotes should be used to group the
Xcolors together with whitespace in between.  The colors can be in any
Xformat that \fIppmmake\fP understands.  The default is ``white black white''.
X.\"
X.SH ENVIRONMENT
X.IP "\fBTMPDIR, TEMPDIR\fP"
XThese environment variables can be used to set the location of
X\fIicontact\fP's temporary directory.  If both \fBTMPDIR\fP and
X\fBTEMPDIR\fP are set, a warning will be printed and the value of
X\fBTMPDIR\fP will be used.  If only one of them is set, that one will
Xbe used.  This value will be overridden if the \fB\-t\fP switch is used
Xon the command line or in the configuration file.
X.\"
X.SH FILES
X.IP "configuration file"
XThe name of the default configuration file is \fB.icrc\fP in your home
Xdirectory.  The proper syntax of this file is as follows:  Comments
Xbegin with a \fB#\fP and terminate with a newline.  Lines may be
Xblank.  Double quotes may be used to group words together after the
Xkeyword \fBswitches\fP.  Configuration lines begin with one of the
Xfollowing keywords:  \fBencode\fP, \fBdecode\fP, \fBswitches\fP, or
X\fBquantize\fP.  Lines beginning with \fBencode\fP are used to define
Xcommands \fIicontact\fP will use to encode files into a specific
Xformat.  Lines beginning with \fBdecode\fP are used to define commands
X\fIicontact\fP will use to decode files of a specific format.  Lines
Xbeginning with \fBquantize\fP are used to define the quantization value
Xof sheets created in a specific format.  The format of lines beginning
Xwith \fBencode\fP, \fBdecode\fP or \fBquantize\fP is this:
X.sp
X.ce
X<\fIkeyword\fP>\ <\fIformat\fP>\ <\fIvalue\fP>
X.sp
X<\fIformat\fP> may not contain whitespace, but <\fIvalue\fP> may.  If
X<\fIkeyword\fP> is \fBquantize\fP, then <\fIvalue\fP> must be a non
Xnegative integer.  The format of lines beginning with \fBswitches\fP is
Xthis:
X.sp
X.ce
X\fBswitches\fP\ <\fIcommand\ line\ switches\fP>
X.sp
X<\fIcommand\ line\ switches\fP> may be any set of switches that you can
Xspecify on the command line and may contain whitespace.
X.sp
X.nf
X.in +0.5i
X.ft CW
X# sample icontact configuration file
X
Xswitches    -g             # parameter file generation
Xswitches    -B             # borders
Xswitches    -l             # add labels
Xswitches    -b             # basename(1) the labels
Xswitches    -S             # sort all the filenames
Xswitches    -v             # verbose
Xswitches    -a             # automatic sizing
Xswitches    -x 640         # screen width
Xswitches    -y 480         # screen height
Xswitches    -Q ppmquant    # quantization program
X# OR:
X# switches  -gBlBSvWax 640 -y 480 -Q ppmquant
X
Xencode      jpg     cjpeg -o
Xdecode      jpg     djpeg
X
Xencode      ppm
Xdecode      ppm
X
Xquantize    gif     256
Xquantize    jpg     0
X.ft R
X.in -0.5i
X.sp
X.fi
X.\"
X.IP "contact sheet parameter files"
XThese files are lists of file names (one per line) followed by the
Ximage's \fIx\fP and \fIy\fP offsets into the contact sheet and then the
Ximage's height and width.  They are created by using the \fB\-g\fP
Xswitch.  These files allow blank lines and comments beginning with
X\fB#\fP and terminating with a newline.
X.\"
X.IP \fBTMPDIR/icb\-$$\fP
Xa temporary file for storing the image border when the \fB\-i\fP and \fB\-B\fP
Xswitches are specified
X.\"
X.IP \fBTMPDIR/icc\-$$\fP
Xtemporary file for storing a color pixmap for background colorization
X.\"
X.IP \fBTMPDIR/ice\-$$\fP
Xa temporary file for holding the image pad when the \fB\-i\fP switch is
Xspecified
X.\"
X.IP \fBTMPDIR/ici#\-$$\fP
Xtemporary files for storing images before they are made into rows
X.\"
X.IP \fBTMPDIR/icp#\-$$\fP
Xtemporary files for holding expanded sheets while \fIicontact\fP cuts
Ximages out of them
X.\"
X.IP \fBTMPDIR/icr#\-$$\fP
Xtemporary files for storing rows before they are made into sheets
X.\"
X.IP \fBTMPDIR/ict\-$$\fP
Xa temporary file for storing labels and borders
X.\"
X.SH "SEE ALSO"
X\fIbasename(1)\fP, \fIperl(1)\fP, \fIpbm(5)\fP, \fIpgm(5)\fP,
X\fIppm(5)\fP, \fIcjpeg(1)\fP, \fIdjpeg(1)\fP
X.\"
X.SH DIAGNOSTICS
XThe diagnostic messages are intended to be self explanatory.  If
X\fIicontact\fP dies and tells you that a pipeline returned an
Xunsuccessful exit code and you can't tell what caused the crash, try
Xrunning the same command with the \fB\-v\fP switch.  You should then be
Xable to see what part of the pipeline was not successful.
X.\"
X.SH BUGS
X.PP
XIf an image's file name has ``.'''s in it that do not come before a
Xrecognized file format extension, the unrecognized extensions will be
Xignored and \fIicontact\fP will try to decode the image using the
Xremaining extensions.  It may guess wrong, though, and the decode
Xcommand may fail.
X.PP
X\fIicontact\fP allows you to specify stupid output formats like
X``.gif.Z''.
X.PP
XWhen in automatic sheet sizing mode (\fB\-a\fP), if a single processed
Ximage is larger than the dimensions of a sheet, this image will appear
Xin a sheet all by itself, and the sheet will be larger than you
Xspecified with \fB\-x\fP and \fB\-y\fP.
X.PP
X\fIicontact\fP will most likely fail if it is used on filenames that
Xcontain whitespace.
X.PP
XWhen images are cut out of previously made contact sheets by specifying
Xa parameter file on the command line, they are not rescaled.  So, even
Xthough you may have specified \fB\-w 100 \-h 100\fP this time, the
Ximages cut from the previously made contact sheet will be the same size
Xthey were when that sheet was first made.  This shouldn't be a problem for
Xyou if you choose an image size early and stick with it.
X.\"
X.SH AUTHOR
XMark Hanson
X.br
X8693 Via Mallorca #15
X.br
XLa Jolla, CA 92037\-2575
X.br
[e-mail]
X.sp
XBug reports, patches, suggestions, questions, and money are all welcome.
X.sp
X\fIicontact\fP is:
X.br
XCopyright (C) 1992 Mark B. Hanson
X.br
XPermission to use, copy, modify, and distribute this software and its
Xdocumentation for any purpose and without fee is hereby granted,
Xprovided that both the above copyright notice and this permission
Xnotice appear in all copies and in supporting documentation.  This
Xsoftware is provided ``as is'' without express or implied warranty.
END_OF_FILE
if test 19275 -ne `wc -c <'icontact.1'`; then
    echo shar: \"'icontact.1'\" unpacked with wrong size!
fi
# end of 'icontact.1'
fi
echo shar: End of archive 1 \(of 2\).
cp /dev/null ark1isdone
MISSING=""
for I in 1 2 ; do
    if test ! -f ark${I}isdone ; then
    MISSING="${MISSING} ${I}"
    fi
done
if test "${MISSING}" = "" ; then
    echo You have unpacked both archives.
    rm -f ark[1-9]isdone
else
    echo You still need to unpack the following archives:
    echo "        " ${MISSING}
fi
##  End of shell archive.
exit 0

exit 0 # Just in case...