.if n .ll 7.5i
.if n .nr LL 7.5i
.LP
.ce 1000
\s+2\fBSan Diego Supercomputer Center\fR\s-2
.sp 1
\s+4\fBImage File Format Conversion Tools\fR\s-4
.sp 1
\s+2\fBRelease Notes\fR\s-2
.sp 1
\s+1\fBBinary Release 1.0\fR\s-1
\s+1\fBMarch 1991\fR\s-1
.ce 0
.sp 3
\fB1. Introduction\fR
.LP
Binary release 1.0 of the San Diego Supercomputer Center (SDSC)
image file format conversion tools includes the following:
.LP
.if t .in +0.5i
.if n .in +5
.TS
l l.
imconv Convert between various image file formats
imfile Determine the image file format used by one or more files
imformats List the attributes of supported image file formats
.TE
.if t .in -0.5i
.if n .in -5
.sp 2
.LP
\fB2. Binary Release\fR
.LP
This is a binary release.
Host types supported in this release include the following:
.LP
.if t .in +0.5i
.if n .in +5
.TS
l l.
alliantfx80 Alliant Computer Systems Corp.
FX/80 minisupercomputers
alliantfx2800 Alliant Computer Systems Corp.
FX/2800 minisupercomputers
crayy Cray Research Inc.
Y-MP supercomputers
sgi4d Silicon Graphics Inc.
4D workstations
sun4 Sun Microsystems Inc.
Sun4 and SPARC workstations
.TE
.if t .in -0.5i
.if n .in -5
.LP
A separate release \fBtar\fR or \fBcpio\fR file is generated for each host type.
.sp 2
.if n .bp
.LP
\fB3. Image File Formats\fR
.LP
This release supports the following 20 image file formats:
.LP
.if t .in +0.5i
.if n .in +5
.TS
l l.
cgm Computer Graphics Metafile
gif Compuserve Graphics image file
hdf Hierarchical Data File
iff Sun TAAC Image File Format
mpnt Apple Macintosh MacPaint file
pbm Portable Bitmap file
pic PIXAR picture file
pict Apple Macintosh QuickDraw/PICT file
pix Alias image file
ps PostScript file
ras Sun Rasterfile
rgb SGI RGB image file
rla Wavefront raster image file
rle Utah Run length encoded image file
rpbm Raw portable Bitmap file
synu Synu image file
tiff Tagged image file
x Stardent AVS X image file
xbm X11 bitmap file
xwd X Window System window dump image file
.TE
.if t .in -0.5i
.if n .in -5
.LP
For most formats, multiple variants exist to handle different image depths
and compression schemes. You can obtain information on the supported variants
by executing
the \fBimformats\fR command with the \fB-long\fR option. For instance:
.sp 1
.LP
.if t .in +0.5i
.if n .in +5
% \fBimformats -long -hdf\fR
.br
.if t .ts 0.5i,1.0i,1.5i,2.0i,2.5i,3.0i
.if n .ts 8,16,24,32,40,48,56
hdf Hierarchical Data File
.br
.if t .in +0.5i
.if n .in +8
.if t .ts 0.5i,1.0i,1.5i,2.0i,2.5i,3.0i
.if n .ts 8,16,24,32,40,48,56
a.k.a.: df, ncsa
.br
.if t .ts 0.5i,1.0i,1.5i,2.0i,2.5i,3.0i
.if n .ts 8,16,24,32,40,48,56
Creator: NCSA
.br
Read support:
.br
.if t .in +0.25i
.if n .in +2
8-bit color index images, un- and RLE-compressed. 16-, 24-, and
32-bit color index images, un-compressed. 24-bit RGB, un- and
RLE-compressed, un-, scanline- and plane-interlaced. Raster image groups
as well as older Raster-8 files.
.br
.if t .in -0.25i
.if n .in -2
Write support:
.br
.if t .in +0.25i
.if n .in +2
8-bit color index images, un- and RLE-compressed. 16-bit color
index images, un-compressed. 24-bit RGB, un- and RLE-compressed, un-,
scanline-, and plane-interlaced. Raster image group and older Raster-8
tags included.
.if t .in -0.25i
.if n .in -2
.if t .in -0.5i
.if n .in -8
.if t .in -0.5i
.if n .in -5
.LP
Also refer to the man pages for the relevant image file format
(see "Documentation", next).
.sp 2
.if n .bp
.LP
\fB4. Documentation\fR
.LP
\fBMan\fR pages describe the tools
and all supported image file formats. \fBnroff\fR source is provided in files
with .n filename
suffixes and should be processed through \fBtbl\fR and \fBnroff\fR.
For instance:
.if t .in +0.5i
.if n .in +5
.LP
\fBtbl imconv.n | nroff -man > imconv.1l\fR
.br
or
.br
\fBtbl imtiff.n | nroff -man > imtiff.3l\fR
.if t .in -0.5i
.if n .in -5
.LP
Post-\fBnroff\fR versions of the \fBman\fR pages
in files with .1l and .3l filename suffixes have also been provided for sites
without access to \fBtbl\fR and \fBnroff\fR.
.sp 2
.LP
\fB5. Bug Reports and User Registration\fR
.LP
This software is supported by the San Diego Supercomputer Center, and we want
to hear from you. If you find bugs (heaven forbid), or want to be put on
our mailing list for future software releases, please fill out
and send us a bug report and/or user registration form. These forms may be
obtained by executing one of our tools with the \fB-feedback\fR
or \fB-register\fR options.
.LP
For instance, to generate a bug report feedback form for \fBimconv\fR, type:
.if t .in +0.5i
.if n .in +5
.LP
% \fBimconv -feedback\fR
.if t .in -0.5i
.if n .in -5
.LP
The feedback (bug report) form is written to a file named \fBimconv.fbk.0\fR
in the current directory.
When generating a feedback form, the tool dumps the form and exits without
doing anything else.
.LP
To generate a user registration form for \fBimconv\fR, type:
.if t .in +0.5i
.if n .in +5
.LP
% \fBimconv -register\fR
.if t .in -0.5i
.if n .in -5
.LP
Like the feedback form, the registration form is written to a file
named \fBimconv.reg.0\fR
in the current directory. When
generating a registration form, the tool dumps the form and exits without
doing anything else.
.LP
User registration is not required, but we'd like to hear from you anyway.
We'll put you on a mailing list for notification of future releases of
SDSC software tools, and read with interest who you are and what you
are doing with our software.
.LP
After you have filled out the form, please send the form, and any
accompanying data, source fragments, sample output, or whatever, to SDSC:
.if t .in +0.5i
.if n .in +5
.if n .bp
.LP
.TS
l l.
E-mail: info@sdsc.edu
Surface mail: Software Products Information
San Diego Supercomputer Center
P.O. Box 85608
San Diego, CA 92138-5608
FAX: (619) 534-5152
.TE
.if t .in -0.5i
.if n .in -5
.LP
If you have questions about this form or any of our software products, please
contact us via any of the above methods or call us at:
.if t .in +0.5i
.if n .in +5
.LP
(619) 534-5100 8am-5pm, Pacific time
.if t .in -0.5i
.if n .in -5
.sp 2
.LP
\fB6. Features that may cause confusion\fR
.LP
.IP "-" 0.25i
While the GIF read code can handle multi-image GIF files, the write code
can only write out GIF files with one image to a file.
.IP "-" 0.25i
CGM reading uses the Pittsburgh Supercomputing Center's \fBgplot\fR program,
as modified by SDSC. \fBgplot\fR interprets the CGM geometry and creates
an HDF image file that is then read back in by the SDSC tools. See the
\fBimcgm\fR \fBman\fR page for more details. If your site does not have
\fBgplot\fR installed, CGM translation won't work.
.IP "-" 0.25i
PICT files are always mapped to RGB images during conversion. A command line
like the following will result in an RGB Sun Rasterfile instead of the
expected color index Rasterfile:
.LP
.if t .in +0.5i
.if n .in +5
\fBimconv image.pict image.ras\fR
.if t .in -0.5i
.if n .in -5
.IP "-" 0.25i
IFF format files are Sun's TAAC images, not Amiga images. Both Sun and
Commodore used the same mnemonic for their image files.
.IP "-" 0.25i
Mac PICT handles PICT2 as well.
.IP "-" 0.25i
Wavefront RLA handles RLB as well.
.IP "-" 0.25i
PBM handles all three ASCII variants of the format: pbm, pgm, and ppm.
RPBM handles all three raw binary variants of the format: rpbm, rpgm, and rppm.
.sp 2
.LP
\fB7. Known Bugs\fR
.LP
.IP "-" 0.25i
XWD files work sporadically on the Cray.
.sp 2
.LP
\fB8. Future Directions\fR
.LP
The SDSC image tool suite is built atop a portable image manipulation
library that will be released in binary form in the near future, and
in source form soon thereafter.
.LP
This project is an ongoing concern of SDSC. Plans for expansion include
extending the depth of support for the current set of image file formats:
.LP
.if t .in +0.5i
.if n .in +5
.nf
- 32-bit Sun Rasterfiles (RGB + Alpha)
- Monochrome and RGB X Window System XWD files. XY and Z pixmaps.
- Multi-image GIF file write.
- Color PostScript.
- HDF IMCOMP compression
.fi
.if t .in -0.5i
.if n .in -5
.LP
Additional file formats that we are considering include:
.LP
.if t .in +0.5i
.if n .in +5
.nf
fbm (Fuzzy Bitmap)
flux (apE)
fps (SDSC)
icon (Sun)
ilbm (Amiga)
pcx (PC Paintbrush)
tga (Targa)
viff (Khoros)
vst (Vista)
.fi
.if t .in -0.5i
.if n .in -5
.sp 2
.LP
\fB8. Copyright\fR
.LP
Users and possessors of the files of this release are hereby granted a
nonexclusive, royalty-free copyright and design patent license to use
this code in individual software. License is not granted for commercial
resale, in whole or in part, without prior written permission from SDSC.
This release is provided "AS IS" without express or implied warranty of any
kind.
.sp 2
.LP
\fB9. Conclusion\fR
.LP
Use these tools and send us feedback: let us know what you like and what
you don't like about this software. We will consider seriously your comments
when we create future updates. We look forward to hearing from you.
.sp 2
.LP
\fB10. Release File List\fR
.LP
Binary release 1.0 of the SDSC image file format conversion tools is
contained in a \fBtar\fR or \fBcpio\fR archive.
When un\fBtar\fRed, or un\fBcpio\fRed,
the archive builds the following directory tree of files:
.if t .in +0.5i
.if n .in +5
.LP
.nf
README
INDEX
imtools/
.if t .in +0.5i
.if n .in +5
bin/
.if t .in +0.5i
.if n .in +5
imconv
imfile
imformats
.if t .in -0.5i
.if n .in -5
man/
.if t .in +0.5i
.if n .in +5
Makefile
imconv.1l
imconv.n
imfile.1l
imfile.n
imformats.1l
imformats.n
.if t .in -0.5i
.if n .in -5
.if t .in -0.5i
.if n .in -5
libim/
.if t .in +0.5i
.if n .in +5
man/
.if t .in +0.5i
.if n .in +5
Makefile
imcgm.3l
imcgm.n
imgif.3l
imgif.n
imhdf.3l
imhdf.n
imiff.3l
imiff.n
immpnt.3l
immpnt.n
impbm.3l
impbm.n
impic.3l
impic.n
impict.3l
impict.n
impix.3l
impix.n
imps.3l
imps.n
imras.3l
imras.n
imrgb.3l
imrgb.n
imrla.3l
imrla.n
imrle.3l
imrle.n
imrpbm.3l
imrpbm.n
imsynu.3l
imsynu.n
imtiff.3l
imtiff.n
imx.3l
imx.n
imxbm.3l
imxbm.n
imxwd.3l
imxwd.n
.if t .in -0.5i
.if n .in -5
.if t .in -0.5i
.if n .in -5
release/
.if t .in +0.5i
.if n .in +5
release1.0.doc
release1.0.n
.if t .in -0.5i
.if n .in -5
.if t .in -0.5i
.if n .in -5
.LP
The \fBimtools\fR directory tree includes the image file format conversion
tool binaries and their \fBman\fR pages.
.LP
The \fBlibim\fR directory tree only includes the file format \fBman\fR
pages for the underlying image library. The library itself is not included
in this release (coming very soon). In the next release the \fBlibim\fR
directory tree will include the object library, include files, and \fBman\fR
pages.
.LP
The \fBrelease\fR directory tree includes this document.