imgtops tutorial

imgtops is a program written in Perl for converting images in almost any format to a postscript file. You need the following programs/packages to run it.

Perl 5. You may get the latest version of Perl from http://www.perl.com/perl/CPAN/src/5.0/.
The package netpbm. You may get it from ftp://ftp.cs.indiana.edu/pub/elisp/w3/images/.
The program djpeg (for jpeg files)

Command-line options

Usage: imgtops [-[d|g]hotv] image_file

Table: Command-line options for imgtops
option	meaning	default
`-d`	Save image in black and white dithered mode.	Retain the original color.
`-g`	Save image in grey scale.	Retain the original color.
`-h`	Print help message and quit.
`-o OUTFILE`	Output to file OUTFILE.	Same as the input image except with extension `.ps`.
`-t TMPDIR`	Set temp directory to TMPDIR. This is needed for writing several intermediate files. You should have permission to write in this directory.	`/tmp`
`-v`	Set up the verbose mode.	Non-verbose mode
`-V`	Print version info and quit.

Examples:
imgtops myimage.gif # Save to ./myimage.ps
imgtops -o ../yourimage.ps myimage.ppm # Save to ../yourimage.ps
imgtops -g -o ~/img-grey.ps img.jpg # Save image in grey scale
imgtops -t . /var/images/scene.bmp # Use . as temp directory

Image types

imgtops supports images with the following extensions:

jpg, jpe, jpeg (JPEG image)
gif (GIF image)
tif, tiff (TIFF image)
ras (raster file)
xbm (X bit map)
xpm (X pixel map)
xwd (X window dump)
bmp (DOS windows bit map)
pnm (portable any map) (raw and ascii)
ppm (portable pixel map) (raw and ascii)
pgm (portable grey map) (raw and ascii)
pbm (portable bit map) (raw and ascii)

For images with unknown extension, imgtops tries to convert using the anytopnm program which is part of the NETPBM package.

Conclusion

Though imgtops is designed for use by htmltotex, you may use it as an independent program for image-to-ps conversion. For problems contact me at abhij@csa.iisc.ernet.in. Enjoy imgtops !!

This page hosted by Get your own Free Home Page