---
name: "g3toxwd"
section: "1"
platform: "linux"
package: "mgetty-fax"
version: "1.2.1-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/g3toxwd"
---

# g3toxwd(1)

converts a Group 3 fax file into a displayable xwd file

## NAME

g3toxwd - converts a Group 3 fax file into a displayable xwd file

## SYNOPSIS

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

## DESCRIPTION

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

## BUGS

Long fax files are not handled properly. Output size fixed 1000x1350 pixels defined at compile time. Please report bugs to chel@vangennip.nl

## SEE ALSO

[pbmtog3(1)](/pbmtog3/1.md), [pbm(5)](/pbm/5.md), [g3cat(1)](/g3cat/1.md), [sendfax(8)](/sendfax/8.md), mgetty(1)

## AUTHOR

*g3toxwd* is Copyright (C) 1994 by Chel van Gennip, \<chel@vangennip.nl\>. 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.