Man Linux: Main Page and Category List

NAME

       pgmtoimgv - Portable Graymap to Pilot Image Viewer converter.

SYNOPSIS

       pgmtoimgv [-h] [-v] [-4] [-t title] [-n notefile] [-{c|m|u}] [in [out]]

DESCRIPTION

       pgmtoimgv is a  simple  filter  for  converting  Portable  Graymaps  to
       grayscale  Pilot  Image  Viewer pdb files.  The input pgm file must use
       the following palette unless you specify the -4 switch:
            P3
            4 1
            255
              0   0   0
             85  85  85
            170 170 170
            255 255 255
       if you specify -4, then your grayscale image must use this palette:
            P3
            16 1
            255
              0   0   0
             17  17  17
             34  34  34
             51  51  51
             68  68  68
             85  85  85
            102 102 102
            119 119 119
            136 136 136
            153 153 153
            170 170 170
            187 187 187
            204 204 204
            221 221 221
            238 238 238
            255 255 255
       If your PGM file doesn’t use one of these palettes, use ppmquant(1)  to
       convert your palette.

       If  an image’s width is not a multiple of 16 pixels, enough extra white
       pixels will be added at the right side  to  ensure  alignment.   Images
       will  be  padded,  with  white  pixels, to a width and height of 160 if
       needed.

OPTIONS

       -h     Display a short summary of the command line options and exit.

       -v     Display the version and exit.

       -4     Use 4 bit grayscale (16 shades of gray).

       -t title
              Specify the title of the image (up to 31 characters).

       -n notefile
              Specify the note file.  No note is  attached  to  the  image  by
              default.

       -c     Produce a compressed image.

       -m     Produce   a   compressed   image  if  it  is  smaller  than  the
              uncompressed version.  This is the default compression mode.

       -u     Produce an uncompressed image.

       in     The input file.  The default is the standard input.

       out    The output file.  The default is the standard output.

SEE ALSO

       imgvinfo(1), imgvtopnm(1), imgvview(1), pbmtoimgv(1),  ppmimgvquant(1),
       pbm(5), pgm(5).

BUGS

       Bug reports should be sent to Eric A. Howe (mu@trends.net).

LICENSE

       Copyright (C) 1997,1998 Eric A. Howe <http://www.trends.net/~mu>.

       This program is free software; you can redistribute it and/or modify it
       under the terms of the GNU General Public License as published  by  the
       Free  Software Foundation; either version 2 of the License, or (at your
       option) any later version.

       This program is distributed in the hope that it  will  be  useful,  but
       WITHOUT   ANY   WARRANTY;   without   even   the  implied  warranty  of
       MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PURPOSE.   See  the  GNU
       General Public License for more details.

       You should have received a copy of the GNU General Public License along
       with this program; if not, write to the Free Software Foundation, Inc.,
       675 Mass Ave, Cambridge, MA 02139, USA.

                                   Sept 1997