g3toxwd(1)

g3toxwd1

Converts a group 3 fax file into a displayable xwd file

Usage

g3toxwd [-kludge] [-reversebits] [-scale N] [-aspect N] [-skiprows N] [-name xwdname] [g3file]

Overview

Reads a Group 3 fax file (raw or digifax) as input. If no filename is given, stdin is used. Produces a displayable xwd file as output.

Options

-kludge

Tells g3toxwd to skip the first lines for synchronisation.

-reversebits

Tells g3toxwd to interpret bits least-significant first, instead of the default most-significant first. Apparently some fax modems do it one way and others do it the other way. If you get a whole bunch of "invalid code" messages, try using this flag.

-scale N

Scale the output to match the printer resolution and paper size, the default of 0.58 will do in most cases.

-aspect N

Scale the output to match the printer resolution and paper size, the default of 1.0 will do for high resolution faxes, 2.0 will do for low resolution faxes.

-skiprows N

N faxrows of the input file will be skipped.

-name <name>

The name <name> will be put in the output file for xwd.

The standard for Group 3 fax is defined in CCITT Recommendation T.4.

References

Releases

Unchanged in 14 releases since Debian 1.2 (Rex).

  1. 1.2–13

Bugs

Long fax files are not handled properly. Output size fixed 1000x1350 pixels defined at compile time. Please report bugs to [email protected]

Author

g3toxwd is Copyright (C) 1994 by Chel van Gennip, <[email protected]>. Sources of g3topbm and pbmtoxwd programs in Jef Poskanzers pbmplus package have been used, but al lot of code has been changed or added to simplify its use for displaying faxes. Value added: low use of memory, fast scaling.

From mgetty-fax 1.2.1-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.