=============================
g3vga Fax viewer version 0.5f
=============================

As received faxes are usually in g3 format here is a g3 fax viewer for Linux
I hacked up quickly as I didn't fancy starting up X everytime I wanted to
view a fax and also didn't want to have all those pbm utils just to convert
my received fax to a format suitable for viewing in VGA viewers like spic,
zgv, grav etc...

Also to print your faxes the program "g32ps" will convert your faxes to
PostScript which is then easily converted to a variety of formats for printing
on you laserjet, deskjet or dotmatrix printers. 

==========
Compiling:
==========

You need the svga libs and includes installed before you can compile this
package. I used `svgalib126.tar.gz' to get the executable compiled. To compile
after adjusting any defines in the Makefile just type

	% make

On Linux console:
-----------------

This prog MUST be suid root to access the console.

	% g3vga g3vga.ps.*

This probably looks jagged on your machine. Instead of the default scale
of 0.5 which I enforce for viewing on a 640x480 screen try the following

	% g3vga -s 1.0 g3vga.ps.*

Somewhat better ?

You can try out different display modes by setting the environment variable
GSVGAMODE (try 1 to 8). Mode 4 is the best which is 640x480x16 unless your
card and svgalib supports higher resolutions.


Scrolling on linux console:
---------------------------

I have implemented the following keys for scrolling:

	[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

======
Colors
======

I appreciate some people might not agree with my choice of colors. Please
check the Makefile and g3vga.h for any changes.

======================
It doesnt work for me:
======================

I have used MODE 4 (ie. 640x480x16) as this is the maximum resolution I can
achieve on my Paradise card with the most colors. At least with this mode you
can view 3/5 of a page of A4 per screen. You may change the mode settings in
g3vga.c or using the environment variable GSVGAMODE if you desire - but the
colors may be different in this case. I dont think this works on BW modes :-(
Try 

	% setenv GSVGAMODE 5; g3vga g3vga.ps.001

which is the standard 320x200x256 mode.

=========
Efax Plug
=========

Just as aside I use Ed Casas's efax (currently efax06b.tar.gz) for sending and
receiving fax'es on both my Sun and Linux machine. It is extremely simple to
use and setup. Personally I have had the most success with this. In fact the
g3vga.ps.00x file included was generated with the command

	% groff -man g3vga.1 > g3vga.ps
	% fax make g3vga.ps

====
BUGS
====

None :-)

====
TODO
====

   X	Scroll left/right support. 			    (Done version 0.2)
   X	Multiple page viewing.				    (Done version 0.4)
   X	Write a manpage.				    (Done version 0.4)
   X	Speed improvements perhaps by direct mmap()'ing.    (Done version 0.4)
   X	A page selector ?				    (Done version 0.5)
   X	An invert option ?				    (Done version 0.5c)
   X	A print option ?				    (Done version 0.5c)
	A X11 interface ?

Any suggestions ?

-----------------------------------------------------------------------------
Bugs, suggestions, compliments, complaints, and encouragement to me

Mitch
Mitch@Dubai.Sun.COM
