File: pgmtoimgv.1.in

package info (click to toggle)
imgvtopgm 2.0-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 876 kB
  • ctags: 270
  • sloc: ansic: 1,670; sh: 449; makefile: 109
file content (142 lines) | stat: -rw-r--r-- 4,293 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
.\" @(#)$Mu: imgvtopgm/pgmtoimgv.1.in 1.3 1999/05/09 08:27:51 $
.\"
.\" pgmtoimgv.man
.\"	Man page for pgmtoimgv.
.\"
.\" Copyright (C) 1997 Eric A. Howe
.\"
.\" 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.
.\"
.\"   Authors:  Eric A. Howe (mu@trends.net)
.\"
.TH PGMTOIMGV 1 "Sept 1997"
.\"----------------------------------------------------------------------------
.SH NAME
pgmtoimgv \- Portable Graymap to Pilot Image Viewer converter, version @VERSION@.
.\"----------------------------------------------------------------------------
.SH SYNOPSIS
.B pgmtoimgv
.RI [ -h ]
.RI [ -v ]
.RI [ -4 ]
.RI [ "-t title" ]
.RI [ "-n notefile" ]
.RI [ "-{c|m|u}" ]
.RI [ in " [" out ]]
.\"----------------------------------------------------------------------------
.SH DESCRIPTION
\fBpgmtoimgv\fR is a simple filter for converting Portable Graymaps to
grayscale Pilot Image Viewer pdb files.
The input pgm file \fBmust\fR use the following palette unless you specify
the \fI-4\fR switch:
.nf
	P3
	4 1
	255
	  0   0   0
	 85  85  85
	170 170 170
	255 255 255
.fi
if you specify \fI-4\fR, then your grayscale image must use this palette:
.nf
	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
.fi
If your PGM file doesn't use one of these palettes, use \fBppmquant\fR(1)
to convert your palette.
.PP
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.
.\"----------------------------------------------------------------------------
.SH OPTIONS
.TP
.I -h
Display a short summary of the command line options and exit.
.TP
.I -v
Display the version and exit.
.TP
.I -4
Use 4 bit grayscale (16 shades of gray).
.TP
.I -t title
Specify the title of the image (up to 31 characters).
.TP
.I -n notefile
Specify the note file.  No note is attached to the image by default.
.TP
.I -c
Produce a compressed image.
.TP
.I -m
Produce a compressed image if it is smaller than the uncompressed version.
This is the default compression mode.
.TP
.I -u
Produce an uncompressed image.
.TP
.I in
The input file.  The default is the standard input.
.TP
.I out
The output file.  The default is the standard output.
.\"----------------------------------------------------------------------------
.SH "SEE ALSO"
.BR imgvinfo (1),
.BR imgvtopnm (1),
.BR imgvview (1),
.BR pbmtoimgv (1),
.BR ppmimgvquant (1),
.BR pbm (5),
.BR pgm (5).
.\"----------------------------------------------------------------------------
.SH BUGS
Bug reports should be sent to Eric A. Howe (mu@trends.net).
.\"----------------------------------------------------------------------------
.SH LICENSE
Copyright (C) 1997,1998 Eric A. Howe <http://www.trends.net/~mu>.
.PP
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.
.PP
This program is distributed in the hope that it will be useful,
but \fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of
\fBMERCHANTABILITY\fR or \fBFITNESS FOR A PARTICULAR PURPOSE\fR.  See the
GNU General Public License for more details.
.PP
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.