Section: mgetty+sendfax manual (1)
Updated: 27 Oct 93
g3cat - concatenate multiple g3 documents
g3cat [-l] [-a] g3-file1 ...
concatenates g3 files. These can either be 'raw', that is,
bitmaps packed according to the CCITT T.4 standard for one-dimensional
bitmap encoding, or 'digifax' files, created by GNU's GhostScript
package with the
drivers. Its output is a concatenation of all the input files, in raw G3
format, with two white lines in between.
If a - is given as input file, stdin is used.
If the input data is malformed, a warning is printed to stderr, and the
output file will have a blank line at this place.
separate files with a one-pixel wide black line.
- -h <blank lines>
specifies the number of blank lines
should prepend to each page. Default is 0.
- -L <lines>
limit length of output page to maximum <lines> lines.
- -w <width>
specifies the desired page width in pixels per line. Default is 1728 PELs,
and this is mandatory if you want to send the fax to a standard fax machine.
If one of the input files doesn't match this line width (for example because
it was created by a broken G3 creator), a warning is printed, and the line
width is transparently fixed.
byte-align the end-of-line codes (EOL) in the file. Every EOL will end at
a byte boundary, that is, with a 01 byte.
- -p <pad>
specifies a minimum number of bytes that each output line must be padded
to. Padding is done with 0-bits before the EOL code.
suppress output of end-of-page code (RTC).
The following example will put a header line on a given g3 page, 'page1'
and put the result into 'page2':
echo '$header' | pbmtext | pbm2g3 | g3cat - page1 >page2
Hopefully none :-).
is Copyright (C) 1993 by Gert Doering, <firstname.lastname@example.org