SvgaLib/doc/man6/vgatest.6

.TH vgatest 6 "01 January 2001" "Svgalib (>= 1.9.13)" "Svgalib User Manual"
.SH NAME
vgatest \- makes basic tests on any svgalib graphics mode
.SH SYNOPSIS

.B vgatest

.SH DESCRIPTION
Mode test program.  First the program gives a list of the supported
modes, then you enter a number and 
.B vgatest 
displays a test pattern in that mode.

The test pattern consists of a sequence of crosses (in different colors,
if the mode support has different colors) in the top left corner.

Below you see either four horizontal color bars (white, red, green,
and blue with increasing intensity from left to right) or vertical
stripes.

If the mode has 32K or more colors, six squares will appear on top of
that, each showing some different smooth color shades

The whole pattern is enclosed in a white border around the edge of the
screen.

See below for details of the test pattern in case you need to verify that
it is being displayed correctly or diagnose a problem with the display.

It also shows some details from
.BR vga_getmodeinfo (3).

To terminate the display and exit the program, hit any key.  If that key
is 'd', 
.B vgatest
dumps the values of all the SVGA registers to Standard Output, in the
manner of vga_dumpregs() before exiting.

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.

.SS The Test Pattern
Here are the details of the test pattern that 
.B vgatest
displays.

The screen is surrounded by a white frame which is at the very edges of 
the screen and one pixel thick.

At the top of the screen is a set of 16 overlapping crosses, lined up
horizontally 5 pixels apart.  Each cross is composed of a one pixel
thick line sloping down at 45 degrees and one sloping up at 45 degrees
meeting in the center.  The top of each of these lines is at the 11th
raster line on the screen and the bottom is at the 90th, so the
crosses are 80 lines high.  The leftmost pixel of the crosses is in
the 11th column of the screen and the rightmost is in the 165th
column.  The lines are in multiple colors, but each line is one color
(except where it intersects another line).

Below the crosses are either 4 horizontal bands of color or vertical
bars.  If the mode has 2 or 16 colors, you get the vertical bars.  If
the mode has 256, 32K, 64K, or 16M colors, you get the horizontal
bands of color.

For a 2 color mode, the vertical bars are are one pixel wide white
bars, spaced 4 pixels apart all the way across the screen on a black
background.  The first white bar is in the 3rd column.  (But don't
forget the white border described above).

For a 16 color mode, the vertical bars are one pixel wide and
contiguous, filling the 3rd column from the left through the 3rd
column from the right.  The bars cycle through each of the 16 colors
from left to right.

The vertical bars start in the 101st raster line and end in the 3rd 
line from the bottom of the screen.

For a higher color mode, the color bands fill the 3rd column from the
left through the 3rd column from the right.  (leaving a column of
black and the aforementioned white border at the edges).  The bands
are all the same height with nothing between them.  They are as large
as will fit starting in the 101st line of the screen and ending at or
before the 3rd line from the bottom.  So depending on the number of
lines on the screen, there are 1, 2, 3, or 4 black lines between the
lowest bar and the white bottom border.

The hues of the bands are, from top to bottom, white, red,
green, and blue.  Each band goes from zero to maximal brightness from
left to right.

In addition to the color bands, for a mode with 32K or more colors,
six squares, 64 pixels on a side are arranged in a matrix centered on
the screen, spaced 32 pixels apart.  They replace any other part of
the test pattern.  These are actual squares only if your monitor
displays square pixels in this mode, i.e. 64 columns is the same
length as 64 lines.  Normal monitors, properly adjusted, display
square pixels for 1024 x 768 modes, but may not for other geometries.

Each square contains 4096 different colors, one pixel per color, in
smooth transition.  In each top square, one color component (red,
green, or blue) is zero another varies linearly in the vertical
direction and the other varies linearly in the Y direction.  The
bottom squares are the same except that one color component is maximum
instead of zero.

.SH SEE ALSO

.BR svgalib (7),
.BR vgagl (7),
.BR libvga.config (5),
.BR vga_getmodeinfo (3),
.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 testlinear (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.