1vgatest(6) Svgalib User Manual vgatest(6)
2
3
4
6 vgatest - makes basic tests on any svgalib graphics mode
7
9 vgatest
10
11
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
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
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)