1vgatest(6)                    Svgalib User Manual                   vgatest(6)
2
3
4

NAME

6       vgatest - makes basic tests on any svgalib graphics mode
7

SYNOPSIS

9       vgatest
10
11

DESCRIPTION

13       Mode  test  program.   First  the program gives a list of the supported
14       modes, then you enter a number and vgatest displays a test  pattern  in
15       that mode.
16
17       The  test  pattern consists of a sequence of crosses (in different col‐
18       ors, if the mode support has different colors) in the top left corner.
19
20       Below you see either four horizontal color bars (white, red, green, and
21       blue with increasing intensity from left to right) or vertical stripes.
22
23       If  the  mode has 32K or more colors, six squares will appear on top of
24       that, each showing some different smooth color shades
25
26       The whole pattern is enclosed in a white border around the edge of  the
27       screen.
28
29       See  below  for  details of the test pattern in case you need to verify
30       that it is being displayed correctly or diagnose  a  problem  with  the
31       display.
32
33       It also shows some details from vga_getmodeinfo(3).
34
35       To  terminate  the  display and exit the program, hit any key.  If that
36       key is 'd', vgatest dumps the values of all the SVGA registers to Stan‐
37       dard Output, in the manner of vga_dumpregs() before exiting.
38
39       This  demo  is part of svgalib and can be found in the demos/ subdirec‐
40       tory of the original svgalib distribution. However, it is not installed
41       in  the  system by default, s.t. it is unclear where you can find it if
42       your svgalib was installed by some linux distribution. Even then,  when
43       you  have  the demo on your system, you probably won't have the sources
44       s.t. it is only of limited use for you.
45
46       In case of any such problem, simply get an  svgalib  distribution  from
47       the  net.  You  even  don't need to install it. Just make in the demos/
48       subdirecty. As of this writing,  svgalib-1.2.12.tar.gz  is  the  latest
49       version   and   can   be  retrieved  by  ftp  from  sunsite.unc.edu  at
50       /pub/Linux/libs/graphics and tsx-11.mit.edu at  /pub/linux/sources/libs
51       which will most probably be mirrored by a site close to you.
52
53
54   The Test Pattern
55       Here are the details of the test pattern that vgatest displays.
56
57       The screen is surrounded by a white frame which is at the very edges of
58       the screen and one pixel thick.
59
60       At the top of the screen is a set of 16 overlapping crosses,  lined  up
61       horizontally  5  pixels  apart.   Each cross is composed of a one pixel
62       thick line sloping down at 45 degrees and one sloping up at 45  degrees
63       meeting  in  the center.  The top of each of these lines is at the 11th
64       raster line on the screen and the bottom is at the 90th, so the crosses
65       are  80  lines  high.  The leftmost pixel of the crosses is in the 11th
66       column of the screen and the rightmost is in  the  165th  column.   The
67       lines  are in multiple colors, but each line is one color (except where
68       it intersects another line).
69
70       Below the crosses are either 4 horizontal bands of  color  or  vertical
71       bars.   If  the mode has 2 or 16 colors, you get the vertical bars.  If
72       the mode has 256, 32K, 64K, or 16M colors, you get the horizontal bands
73       of color.
74
75       For  a  2  color  mode,  the vertical bars are are one pixel wide white
76       bars, spaced 4 pixels apart all the way across the screen  on  a  black
77       background.  The first white bar is in the 3rd column.  (But don't for‐
78       get the white border described above).
79
80       For a 16 color mode, the vertical bars are one pixel wide and  contigu‐
81       ous,  filling  the 3rd column from the left through the 3rd column from
82       the right.  The bars cycle through each of the 16 colors from  left  to
83       right.
84
85       The  vertical  bars  start  in the 101st raster line and end in the 3rd
86       line from the bottom of the screen.
87
88       For a higher color mode, the color bands fill the 3rd column  from  the
89       left through the 3rd column from the right.  (leaving a column of black
90       and the aforementioned white border at the edges).  The bands  are  all
91       the  same  height with nothing between them.  They are as large as will
92       fit starting in the 101st line of the screen and ending  at  or  before
93       the  3rd  line from the bottom.  So depending on the number of lines on
94       the screen, there are 1, 2, 3, or 4 black lines between the lowest  bar
95       and the white bottom border.
96
97       The  hues  of the bands are, from top to bottom, white, red, green, and
98       blue.  Each band goes from zero to  maximal  brightness  from  left  to
99       right.
100
101       In addition to the color bands, for a mode with 32K or more colors, six
102       squares, 64 pixels on a side are arranged in a matrix centered  on  the
103       screen,  spaced  32  pixels  apart.  They replace any other part of the
104       test pattern.  These are actual squares only if your  monitor  displays
105       square  pixels  in  this mode, i.e. 64 columns is the same length as 64
106       lines.  Normal monitors, properly adjusted, display square  pixels  for
107       1024 x 768 modes, but may not for other geometries.
108
109       Each  square  contains  4096  different colors, one pixel per color, in
110       smooth transition.  In each  top  square,  one  color  component  (red,
111       green,  or blue) is zero another varies linearly in the vertical direc‐
112       tion and the other varies linearly in  the  Y  direction.   The  bottom
113       squares are the same except that one color component is maximum instead
114       of zero.
115
116

SEE ALSO

118       svgalib(7), vgagl(7), libvga.config(5), vga_getmodeinfo(3),  threed(6),
119       accel(6),  bg_test(6),  eventtest(6),  forktest(6), fun(6), keytest(6),
120       mousetest(6),  scrolltest(6),  speedtest(6),   spin(6),   testaccel(6),
121       testgl(6), testlinear(6), plane(6), wrapdemo(6)
122
123

AUTHOR

125       This  manual  page  was  edited by Michael Weller <eowmob@exp-math.uni-
126       essen.de>. The exact source of the referenced demo as well  as  of  the
127       original documentation is unknown.
128
129       It is very likely that both are at least to some extent are due to Harm
130       Hanemaayer <H.Hanemaayer@inter.nl.net>.
131
132       Occasionally this might be wrong. I hereby asked to be excused  by  the
133       original author and will happily accept any additions or corrections to
134       this first version of the svgalib manual.
135
136
137
138Svgalib (>= 1.9.13)             01 January 2001                     vgatest(6)
Impressum