g3vga(1)

NAME
g3vga - view g3 fax(es) on a color linux console.
g32ps - convert g3 fax(es) for printing on a PostScript(TM) printer.

SYNOPSIS
g3vga [ -d ] [ -r ] [ -s scale ] filename...
g32ps [ -l ] [ -r ] filename...

OPTIONS

-d  switch debugging on.

-r  switch bit reversal on (lsb to msb).

-s  scale the fax page by the factor scale. Only values between 0 and 1.0 are permissible.

DESCRIPTION
Electronic faxes received by programs like efax, mgetty are usually in g3 format and need to be converted to other more common formats for viewing or printing. g3vga provides a fast and convenient means of viewing g3 encoded faxes on a linux console. The complimentary program g32ps converts a g3 fax file into PostScript format for printing. Neither programs require X11 or other conversion tools. Upon invocation of g3vga and once within the display window the following keys are available for manipulating, scrolling and loading faxes.

[PgUp]
    Page up key move the page up by the screen height

[PgDn]
    Page Down key move the page down by screen height

[Up]
    Up arrow scrolls up by half the screen height

[Dn]
    Down arrow scrolls down by half the screen height

[Right]
    Right arrow scrolls right by half the screen width

[Left]
    Left arrow scrolls down by half the screen width

[Home]
    Home key goes to the top of the page

[End]
    End key goes to the bottom of the page

<i> The `i' or `I' key inverts the current page.

<n> The `n' or `N' key displays the next file or page.

<p> The `p' or `P' key displays the previous file or page.

<h> The `h' or `H' key pops up the help window.

<q> The `q' or `Q' key quits the program

<-> The `-' key reduces the scale by 10% to a minimum of 10%.

<+> The `+' key increases the scaling by 10% up to a maximum of 100%.

<^f>
    The Control-f key(s) pops up file selector.

<^p>
    The Control-p key(s) pops up page selector.

A position indicator on the left of the display indicates the approximate vertical location of the current viewport.

When the page-selector key sequence is pressed and a page number is entered in the pop-up, g3vga looks for the corresponding page number by applying the NAME_TEMPLATE, as defined in the Makefile on compilation, and substituting %s with the basename of the current file and %d with the chosen page number. In this context the basename of the current file is defined as any string before the last period character `.'. So for example if your files are numbered

    foo.g3.001, foo.g3.002....foo.g3.100

then with the template "%s.%03d" the basename gets set to "foo.g3" and the selected page is appended with leading zeros up to a maximium of 3. The above template, (the default), works well with faxes received with efax.

RESOLUTION
Screen resolution may be changed via the svgalib resource GSVGAMODE. If your video card and svgalib supports higher resolution you may change the screen resolution with an appropriate setting to the environment variable GSVGAMODE.

PRINTING
You can print faxes on your PostScript printer using the command

    g32ps g3_fax_filename | lpr

For other types of printers (e.g. HP laserjet) you can use the gs(1) intertepreter. If your received faxes are from low resolution fax machines then your printed page will appear 1/2 the original length. You can use the -l switch to g32ps before printing your fax. E.g

    g32ps -l g3_fax_filename | lpr

AUTHOR
g3vga, g32ps was written by Mitch DSouza. Send comments or bug reports to Mitch.Dsouza@Dubai.Sun.COM. Please include the g3 file which produces the fault and a short description on how it may be reproduced.

COPYRIGHT
g3vga, g32ps is copyright 1994,1995 Mitch Dsouza. It may be used, copied and modified under the terms of the GNU Public License.

DISCLAIMER
Although g3vga has been tested, it may have errors that will prevent it from working correctly on your system. Some of these errors may cause serious problems with text mode restoration and other video corruption. Most of these are probably attributed to svgalib however.

SEE ALSO
efax(1). gs(1).

BUGS
The PostScript generated file from g32ps is horrendously large (but very simple).