=============================
g3vga Fax viewer version 0.5b
=============================

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...

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

You need the svga libs and includes installed before you can compile this
package. I used `svgalib111.tgz' 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
	<q>	The `q' or `Q' key quits the program

======
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 README.g3

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)

Any suggestions ?

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

Mitch
m.dsouza@mrc-apu.cam.ac.uk


