Debian Codegraph @

upstream/debian-unstable/man1/pbmtog3.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pbmtog3 User Manual" 1 "20 April 2017" "netpbm documentation"
7
8 .SH NAME
9 pbmtog3 - convert a PBM image into a Group 3 MH fax file
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpbmtog3\fP
15 [\fB-reversebits\fP]
16 [\fB-nofixedwidth\fP]
17 [\fB-align8\fP|\fB-align16\fP]
18 [\fIpbmfile\fP]
19
20 .UN description
21 .SH DESCRIPTION
22 .PP
23 This program is part of
24 .BR "Netpbm" (1)\c
25 \&.
26 .PP
27 \fBpbmtog3\fP reads a PBM image as input and produces a Group 3 MH fax
28 file as output.
29 .PP
30 You can also generate a TIFF file that uses the same encoding
31 inside, with \fBpamtotiff\fP.
32 .PP
33 There is no program in Netpbm that generates other fax formats,
34 such as MR and MMR, but \fBpamtotiff\fP can generate TIFF files that
35 use those encodings.
36
37 .UN options
38 .SH OPTIONS
39 .PP
40 In addition to the options common to all programs based on libnetpbm
41 (most notably \fB-quiet\fP, see
42 .UR index.html#commonoptions
43 Common Options
44 .UE
45 \&), \fBpbmtog3\fP recognizes the following
46 command line options:
47
48
49 .TP
50 \fB-reversebits\fP
51 This option causes the output to have the bits in every byte
52 reversed so the least significant bit becomes the most significant bit.
53 Some fax modems expect bits in reverse order, and this compensates for
54 that. If you get a whole bunch of "bad code word" messages when you try
55 to read the G3 file (e.g. with \fBg3topbm\fP), try using this option.
56 Note that the output is not G3 when you use this option.
57
58 .TP
59 \fB-nofixedwidth\fP
60 Most fax machines expect the image to be 1728 columns wide, so
61 \fBpbmtog3\fP cuts the output to this width by default. If you want to
62 keep the width of the original image, use this option.
63 .sp
64 This option was new in Netpbm 10.6 (July 2002). Before that,
65 \fBpbmtog3\fP always kept the width of the original image.
66
67 .TP
68 \fB-align8\fP
69 .TP
70 \fB-align16\fP
71 These options say to align output rows to 8-bit or 16-bit boundaries,
72 respectively, by adding padding bits in front of EOL codes
73 .sp
74 Without these options, \fBpbmtog3\fP adds no padding and rows may begin
75 and ends anywhere within a byte.
76 .sp
77 You cannot specify both.
78 .sp
79 These options were new in Netpbm 10.79 (June 2017).
80
81
82
83 .UN seealso
84 .SH SEE ALSO
85 .BR "g3topbm" (1)\c
86 \&,
87 .BR "pamtotiff" (1)\c
88 \&,
89 .BR "pbm" (1)\c
90 \&,
91 .BR "fax formats" (1)\c
92 \&
93
94 .UN history
95 .SH HISTORY
96 .PP
97 Before Netpbm 10.79 (June 2017), there was a different program by the same
98 name in Netpbm, which was written by by Paul Haeberli
99 <\[email protected]\fP> in 1989
100 and then modified extensively by others.
101 .PP
102 Akira Urushibata <[email protected]> wrote the current version, with
103 an entirely different algorithm, in April 2017 and contributed his work to the
104 public domain.
105 .PP
106 The current program is backward compatible with the pre-10.79 version.
107 .SH DOCUMENT SOURCE
108 This manual page was generated by the Netpbm tool 'makeman' from HTML
109 source. The master documentation is at
110 .IP
111 .B http://netpbm.sourceforge.net/doc/pbmtog3.html
112 .PP