.TH testlinear 6 "29 July 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
testlinear, lineart \- test a linear frame buffer
.SH SYNOPSIS

.B testlinear

.SH DESCRIPTION
Program to test linear addressing on Cirrus cards and on Mach32 (and other cards which
may support it).

Selects 640x480x256 and tries to enable a linear frame buffer
(its virtual address is printed). Fills the screen in some color,
then draws pixels in random positions.

For Cirrus cards some
direct hardware access is then made for highspeed screen access.
Except for the last (Cirrus only) test no speeds are printed, but
you are welcome to use 'time' to measure it. The program draws
714400 one byte pixels plus a forced 1s delay and various rand()
calls for the pixels.

The
.B testlinear
demo needs a few presses of
.B <Return>
after each
minimal demo step. Even when it does not prompt for it. When it
appears to be stuck, just press
.BR <Return> .

The
.B lineart
demo is the same, but it accepts a command line with an arbitrary
number of modes.  The modes may be either mode numbers or names, or
both.  For example,

.I lineart 11 17 "G800x600x32k" 22

will give a display of mode 11.  If a key is pressed mode 17 will
appear, followed by mode 20 and 22 as succesive keys are pressed.

This demo is part of svgalib and can be found in the
.I demos/
subdirectory of the original svgalib distribution. However, it is not installed in the system
by default, s.t. it is unclear where you can find it if your svgalib was installed by some
linux distribution. Even then, when you have the demo on your system, you probably won't have
the sources s.t. it is only of limited use for you.

In case of any such problem, simply get an svgalib distribution from the net. You even
don't need to install it. Just
.B make
in the
.I demos/
subdirecty. As of this writing,
.I svgalib-1.2.12.tar.gz
is the latest version and can be retrieved by ftp from
.IR "sunsite.unc.edu" " at " "/pub/Linux/libs/graphics"
and
.IR "tsx-11.mit.edu" " at " "/pub/linux/sources/libs"
which will most probably be mirrored by a site close to you.

.SH SEE ALSO

.BR svgalib (7),
.BR vgagl (7),
.BR libvga.config (5),
.BR threed (6),
.BR accel (6),
.BR bg_test (6),
.BR eventtest (6),
.BR forktest (6),
.BR fun (6),
.BR keytest (6),
.BR mousetest (6),
.BR scrolltest (6),
.BR speedtest (6),
.BR spin (6),
.BR testaccel (6),
.BR testgl (6),
.BR vgatest (6),
.BR plane (6),
.BR wrapdemo (6)

.SH AUTHOR

This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
exact source of the referenced demo as well as of the original documentation is
unknown.

It is very likely that both are at least to some extent are due to
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.

Occasionally this might be wrong. I hereby
asked to be excused by the original author and will happily accept any additions or corrections
to this first version of the svgalib manual.