code/svgalib-1
1
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions

Initial. Don't... just don't ask.

Browse source
This commit is contained in:
Ryan McGrath 2011-02-24 00:22:00 -08:00
commit 00bae13bba
586 changed files with 129057 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

402
doc/man6/accel.6 Normal file
View file

@ -0,0 +1,402 @@
.TH accel 6 "29 July 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
accel \- tests the new style svgalib accelerator interface
.SH SYNOPSIS
.B accel
.SH DESCRIPTION
Test new-style accelerated functions (As of this writing: Ark, Cirrus, Chips &
Technologies cards, and Mach32 only).
For other cards the demo will not work (well it will complain about missing accelerator
support). Don't worry about this.
During the development of the Mach32 new style driver for 1.2.12, this demo was massively
extended to check the Mach32 functions.
Upon startup it lists all supported SVGA modes and asks you to enter a number
identifying the mode to be tested. The supported subfunctions of
.BR vga_accel (3)
in this mode are listed and the demo instructs to press
.B <Return>
to start the demos.
If supported, all drawing operations are performed in the background.
Then the following tests are performed:
.SS Positioning tests
These tests were originally intended to check that the accelerator commands work on the
proper screen locations. The screen shows 12 (4 x 3) smaller areas with red crosses in the
corners. When everything is ok, the drawings should reach right in the corners of the crosses.
A given card may not support all operations listed here. In that case the resp. test area
just shows the red crosses. For tests performed, the name of the test is printed below the
area. The tests are (from left to right, top to bottom):
.IP 1.
A green box is drawn with
.BR vga_accel(ACCEL_FILLBOX) .
.IP 2.
A cross of green lines is drawn with
.BR vga_accel(ACCEL_DRAWLINE) .
.IP 3.
A linux pixmap just fitting into the crosses is drawn with
.BR vga_accel(ACCEL_PUTIMAGE) .
.IP 4.
A pixmap just fitting into the crosses is drawn into the red crosses (by
.BR vgagl (5)
which may or may not use the accelerator). The pixmap is then copied to a few lines/columns
below. Green crosses mark the intended destination position.
.IP 5.
Works like 3. but copies to an area above the origin. The accelerator must ensure that the
overlapping areas are handled non corrupting. Thus, watch that the copy operation is properly
performed.
.IP 6.
A green triangle is drawn above the top/left to bottom/right diagonal by use of
.BR vga_accel(ACCEL_DRAWHLINELIST) .
.IP 7.
Certain bitmaps are copied to the screen. In the corners you'll see the digits
.RS
.IP 0
top/left, green on red.
.IP 1
top/right, red on green.
.IP 2
bottom/left, black on white.
.IP 3
bottom/right, white on black. Note that some black border, not the digit will be aligned
to the red crosses.
.RE
.IP
Finally, a yellow wizard image is drawn into the center.
The bit ordering for bitmaps is a bit weird. Please check that the digits are not mirrored or
flipped.
.IP 8.
This time bitmap transparency is tested by drawing wizard images onto the aforementioned
linux pixmap (left to right, top to bottom) in yellow, red, green, and cyan. The background
of the yellow wizard is masked out by a black border bitmap.
Note that the wizard will not reach into the red corners because the bitmap has some
(transparent) border.
.IP 9.
The text below this box is copied as a monochrome bitmap from the screen into the corners
listed under 7. in the same colors.
.IP 10.
Two green rectangles with an edge cut out from the bottom is drawn using
.BR vga_accel(ACCEL_POLYLINE) . There is an intended bug which draws the center of the
top line twice. If supported, the lower rectangle is drawn in cyan and with the xor
raster operation s.t. the buggy point is not drawn thus leaving a pin hole.
.IP 11.
.BR vga_accel(ACCEL_POLYHLINE) is used to draw some green lines which makes this area look
like a green box with a cut out, black M-style shape.
.IP 12.
A weird green polygon is filled in red with
.BR vga_accel(ACCEL_POLYFILLMODE)
using the techniques given in
.BR vga_accel (3).
This needs some offscreen memory. If VGA memory is tight in that resolution the test cannot
be performed.
.PP
After this screen, you'll have to hit
.B <Return>
to continue.
.SS Raster operations
Again, red cross bordered areas are drawn on the screen, this time for each of the supported
raster operations. For
.BR ROP_AND " and " ROP_XOR
the areas are filled in white first.
Three overlapping boxes
.BR A ", " B ", " C
are drawn such that you see the following areas.
.RB AAAAAA dddd BBBBBB
.br
.RB AAAAAA dddd BBBBBB
.br
.RB AAAAAA dddd BBBBBB
.br
.RB AAAA ee gggg ff BBBB
.br
.RB AAAA ee gggg ff BBBB
.br
.RB AAAA ee gggg ff BBBB
.br
.RB " CCCCCCCC"
.br
.RB " CCCCCCCC"
.br
.RB " CCCCCCCC"
The pictures should show:
.IP 1.
Replace mode. A, B, C are red, green, blue. They just overlap, yielding
d - green and e, f, g - blue.
.IP 2.
The colors mix using
.B ROP_OR
(and a nice color table). The overlapping areas become the additive color mix:
d - yellow, e - magenta, f - cyan, and g - white.
.IP 3.
.B ROP_AND
is used. The background is filled white first, s.t. there is something in video memory
to and with non trivially. We have A, B, C in cyan, magenta, yellow and d, e, f, g
in blue, green, red, black.
.IP 4.
.B ROP_XOR
is used and the background filled white first too. A, B, C are red, green, blue again, but
the overlapping areas d, e, f, g become blue, green, red, white.
.IP 5.
.B ROP_INV
is used, s.t. A, B, C are all white and d, e, f, g become black, black, black, white.
Note that this is not done by using
.B ROP_XOR
and drawing A, B, C in white. Instead A, B, C are drawn in the usual
red, green, blue. However, the accelerator just inverts the memory contens.
.PP
If the accelerator supports raster operations for
.B ACCEL_DRAWHLINELIST
actually disks (well, ellipses) are drawn instead of boxes.
.PP
After this screen, you'll have to hit
.B <Return>
to continue.
.SS Replace QuixDemo
If
.B ACCEL_DRAWLINE
is supported, a Quix like bouncing series of lines in varying colors is drawn. The lines
are removed from the screen by overdrawing them in black, thus erasing the dots and text
on the background.
The test lasts about 5 seconds and some statistics are printed to stdout.
.SS XOR Mode QuixDemo
As before, but this time all lines are drawn in
.B ROP_XOR
mode (if
.B ACCEL_DRAWLINE
supports raster operations). Thus the background will not be destroyed this time.
The test lasts about 5 seconds and some statistics are printed to stdout.
.SS FillBox Demo
The screen is
.BR ACCEL_FILLBOX
filled with a series of boxes of increasing colors.
In truei/high color modes you'll probably only see a series of varying blue tones (because these
are at the beginning of the color table and there are soo many of them).
The test lasts about 5 seconds and some statistics are printed to stdout.
.SS ScreenCopy Demo
Some random dots are drawn on the screen and thirds of the screen contents are moved
around using
.BR ACCEL_SCREENCOPY .
The test lasts about 5 seconds and some statistics are printed to stdout.
.SS Scroll Demo
Some random dots are drawn on the screen and moved one line up with
.BR ACCEL_SCREENCOPY .
In offscreen memory a new line is prepared which will be cleared by
.BR ACCEL_FILLBOX and move in from below. This test requires some offscreen and will not
be performed if video memory is very tight.
The test lasts about 5 seconds and some statistics are printed to stdout.
.SS FillBox with DrawHLineList Demo
Like the FillBox test, but no box fill is done but the screen is filled with a list of
horizontal lines drawn with
.BR ACCEL_DRAWHLINELIST .
The test lasts about 5 seconds and some statistics are printed to stdout.
.SS FillBox XOR Mode Demo
Like the FillBox test, but the XOR raster operation is used.
The test lasts about 5 seconds and some statistics are printed to stdout.
.SS PutBitmap Demo
The screen is filled with bitmasks consisting of tiny vertical lines alternating in red and
blue.
The test lasts about 5 seconds and some statistics are printed to stdout.
.SH SOME DATAPOINTS
Here is a list of speed listings for some cards. Please keep in mind that also the
calling overhead for the program is measured. This seems to be esp. true for the
QuixDemo.
.SS "Results on a Cirrus GD5434-E with 2Mb:"
.TP
.B "640x480x256 60 Hz"
.br
FillBox: 200.3 Mpixels/s (200.3 Mbytes/s)
.br
ScreenCopy: 51.0 Mpixels/s (51.0 Mbytes/s)
.br
Scroll Demo: 50.5 Mpixels/s (50.5 Mbytes/s)
.br
FillBox XOR: 83.2 Mpixels/s (83.2 Mbytes/s)
.TP
.B "320x200x256 70 Hz"
.br
FillBox: 200.1 Mpixels/s (200.1 Mbytes/s)
.br
ScreenCopy: 52.3 Mpixels/s (52.3 Mbytes/s)
.br
Scroll Demo: 51.2 Mpixels/s (51.2 Mbytes/s)
.br
FillBox XOR: 87.1 Mpixels/s (87.1 Mbytes/s)
.TP
.B "640x480x32K 60 Hz"
.br
FillBox: 90.9 Mpixels/s (181.8 Mbytes/s)
.br
ScreenCopy: 23.1 Mpixels/s (46.3 Mbytes/s)
.br
Scroll Demo: 23.0 Mpixels/s (46.1 Mbytes/s)
.br
FillBox XOR: 37.2 Mpixels/s (74.5 Mbytes/s)
.TP
.B "640x480x16M (32-bit) 60 Hz"
.br
FillBox: 35.5 Mpixels/s (142.3 Mbytes/s)
.br
ScreenCopy: 9.3 Mpixels/s (37.3 Mbytes/s)
.br
Scroll Demo: 9.2 Mpixels/s (37.1 Mbytes/s)
.br
FillBox XOR: 14.6 Mpixels/s (58.6 Mbytes/s)
.SS "On a Cirrus Logic 5426 VLB (50 MHz MCLK):"
.TP
.B "640x480x256 60 Hz"
.br
FillBox: 32.8 Mpixels/s (32.8 Mbytes/s)
.br
ScreenCopy: 16.4 Mpixels/s (16.4 Mbytes/s)
.br
Scroll Demo: 16.3 Mpixels/s (16.3 Mbytes/s)
.br
FillBox XOR: 16.5 Mpixels/s (16.5 Mbytes/s)
.TP
.B "640x480x32K 60 Hz"
.br
FillBox: 12.2 Mpixels/s (24.4 Mbytes/s)
.br
ScreenCopy: 6.1 Mpixels/s (12.2 Mbytes/s)
.br
Scroll Demo: 6.0 Mpixels/s (12.1 Mbytes/s)
.br
FillBox XOR: 6.1 Mpixels/s (12.2 Mbytes/s)
.SS "Tweaked to 60 MHz MCLK:"
.TP
.B "640x480x256 60 Hz"
.br
FillBox: 42.1 Mpixels/s (42.1 Mbytes/s)
.br
ScreenCopy: 21.0 Mpixels/s (21.0 Mbytes/s)
.br
Scroll Demo: 20.9 Mpixels/s (20.9 Mbytes/s)
.br
FillBox XOR: 21.1 Mpixels/s (21.1 Mbytes/s)
.TP
.B "640x480x32K 60 Hz"
.br
FillBox: 16.7 Mpixels/s (33.5 Mbytes/s)
.br
ScreenCopy: 8.3 Mpixels/s (16.7 Mbytes/s)
.br
Scroll Demo: 8.3 Mpixels/s (16.7 Mbytes/s)
.br
FillBox XOR: 8.3 Mpixels/s (16.7 Mbytes/s)
.SS Results on a Mach32 EISA with 2Mb VRAM:
.TP
.B 1280x1024x256 60 Hz
Replace QuixDemo: 12.1 Klines/s (6.7 Mpixels/s or 6.7 Mbytes/s)
.br
Xor QuixDemo: 9.9 Klines/s (5.1 Mpixels/s or 5.1 Mbytes/s)
.br
FillBox: 75.4 Mpixels/s (75.4 Mbytes/s)
.br
ScreenCopy: 26.4 Mpixels/s (26.4 Mbytes/s)
.br
Scroll Demo: 28.7 Mpixels/s (28.7 Mbytes/s)
.br
FillBox with DrawHlineList: 73.1 Mpixels/s (73.1 Mbytes/s)
.br
FillBox XOR: 37.9 Mpixels/s (37.9 Mbytes/s)
.br
PutBitmap: 15.6 Mpixels/s (15.6 Mbytes/s)
.TP
.B 1024x768x64K 72Hz
Replace QuixDemo: 12.3 Klines/s (5.2 Mpixels/s or 10.5 Mbytes/s)
.br
Xor QuixDemo: 9.0 Klines/s (5.1 Mpixels/s or 10.3 Mbytes/s)
.br
FillBox: 37.6 Mpixels/s (75.2 Mbytes/s)
.br
ScreenCopy: 13.2 Mpixels/s (26.4 Mbytes/s)
.br
Scroll Demo: 13.2 Mpixels/s (26.4 Mbytes/s)
.br
FillBox with DrawHlineList: 37.0 Mpixels/s (74.0 Mbytes/s)
.br
FillBox XOR: 18.9 Mpixels/s (37.8 Mbytes/s)
.br
PutBitmap: 15.2 Mpixels/s (30.5 Mbytes/s)
.PP
You're encouraged to send in more data.
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 vga_accel (3),
.BR threed (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 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
demo and most of its documentation is due to
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.

90
doc/man6/bg_test.6 Normal file
View file

@ -0,0 +1,90 @@
.TH bg_test 6 "8 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
bg_test \- test the background mode of svgalib
.SH SYNOPSIS
.BI "bg_test [" linear ]
.SH DESCRIPTION
Tests the enhanced support of recent svgalibs to draw while
switched to the background. Draws a small centered white box
then waits until you switch to another vc. Draws some outer
box frame around it
.B while
background, which you can see
when you switch back to it. For obvious reasons, your version
of svgalib must have
.B BACKGROUND
support enabled (which is the
default as of this writing).
When finished, press any key to end
.BR bg_test .
The demo uses a
.B G320x200x256
mode or the one you set with
.BR SVGALIB_DEFAULT_MODE .
If you specify the
.I linear
parameter the demo will use
.BR vgagl (7)
and
.BR vga_setlinearaddressing (3)
to test linear mode in background.
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 vga_runinbackground (3),
.BR threed (6),
.BR accel (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 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.

80
doc/man6/buildcsr.6 Normal file
View file

@ -0,0 +1,80 @@
.\" Process this file with
.\" groff -man -Tascii buildcsr.1
.\"
.TH BUILDCSR "FEBRUARY 2001" Linux "User Manuals"
.SH NAME
buildcsr - builds a cursor
.SH SYNOPSIS
.B buildcsr [-p
.I name
.B -b
.I name
.B -m
.I mode
.B -s]
.SH DESCRIPTION
.B buildcsr
presents a blank screen with a cursor. One may hold down the left
mouse button and draw the color1 part of the cursor on the
screen. Typing
.B 2
on the keyboard will cause color2 to be drawn. The cursor can be
viewed as a cursor by typing
.BR n .
To modify the cursor type
.B o
to go back to the original cursor. Pixels may be erased by clicking
on them with the right mouse button. The left mouse button will draw
either color1 or color2, depending on whether
.B 1
or
.B 2
was chosen from the keyboard last. The current color is displayed at
the bottom of the screen.
.SH OPTIONS
.IP -p
and
.IP -b
followed by name will produce a cursor file with the name
.BR name .
.IP -p
will produce a c language definition of the cursor suitable for
inclusion in a program as a header file.
.IP -b
will produce a binary cursor file which may be read into a user
program at execution time.
.IP -m
mode , a mode number will cause the program to run in mode
.BR mode .
This will not make a difference in the screen representation of the
cursor, but the cursor itself will be much smaller in high resolution
modes. Thus, for high resolution it is wise to construct the cursor
using the resolution at which it is intended to be used. Typing
.B n
will show the cursor as it will look at the resolution of the screen.
If no mode is given using
.B -m
the mode will be
.B SVGALIB_DEFAULT_MODE
if that has been defined in an environment variable. If no default
has been given and no
.B -m
was used, the screen mode will be mode 5, G320x200x256, which is
default for this program. The hardware cursor will be used if a
hardware cursor exists for the video card in use, otherwise the
software cursor will be used.
.IP -s
option will force the software cursor to be used even if a hardware
cursor exists.
.SH ENVIRONMENT
.IP SVGALIB_DEFAULT_MODE
will be used if it has been defined and
.B -m
was not given. If neither of these are in effect the mode will be
mode 5, G320x200x256.
.SH AUTHOR
Don Secrest <secrest@uiuc.edu>
.SH "SEE ALSO"
.BR VGA_CURSOR (3)
.BR VGA_GETDEFAULTMODE (3)

94
doc/man6/eventtest.6 Normal file
View file

@ -0,0 +1,94 @@
.TH eventtest 6 "8 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
eventtest \- test the waitevent function of svgalib
.SH SYNOPSIS
.B eventtest
.SH DESCRIPTION
This is a kind of an upgraded
.BR keytest "(6) and " mousetest (6)
demo using the
.BR vga_waitevent (3)
function.
Use mouse to move cursor.
.BR <1> - <9> ", " <0>
to set the cursor size.
.B <Space>
to change
the cursor color. Left button to draw. Right button or
.B <Q>
to bailout.
The cursor goes on/off every half second by usage of a
.I timeout
passed to
.BR vga_waitevent (3).
Every 5 seconds a string from a child process (the time)
arrives asynchronously and is displayed by the frontend. This comes
in through a
.BR pipe (2)
which is monitored by
.BR vga_waitevent (2).
You can set a videomode
to use by setting the environment variable
.B SVGALIB_DEFAULT_MODE
to a number (see vgatest
for a list) or a string like G0x1x2 where you replace 0 with desired x
resolution, 1 with the desired y rez, and 2 with the desired number of
colors (2, 16, 256, 32K, 64K, 16M, 16M4). Again, only certain choices are
available, see vgatest for a list.
In case nothing is selected, G320x200x256 is choosen.
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 vga_waitevent (3),
.BR threed (6),
.BR accel (6),
.BR bg_test (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 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
demos as well as the
.BR vga_waitevent (3)
function is due to him.

87
doc/man6/forktest.6 Normal file
View file

@ -0,0 +1,87 @@
.TH forktest 6 "8 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
forktest \- tests the vga_safety_fork() function.
.SH SYNOPSIS
.B forktest
.SH DESCRIPTION
This is a copy of the
.BR keytest (6)
demo (look there). However, it uses
.BR vga_safety_fork (3)
to start a background process to restore the
console in case the fore ground process crashes. It removes all
automatic restore functions of svgalib. Thus, in case you kill
this program with
.BR kill (1)
or
.BR <Ctrl>-C ,
only the background process will
save your system from being hosed up.
You can set a videomode
to use by setting the environment variable
.B SVGALIB_DEFAULT_MODE
to a number (see vgatest
for a list) or a string like G0x1x2 where you replace 0 with desired x
resolution, 1 with the desired y rez, and 2 with the desired number of
colors (2, 16, 256, 32K, 64K, 16M, 16M4). Again, only certain choices are
available, see vgatest for a list.
In case nothing is selected, G320x200x256 is choosen.
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 vga_safety_fork (3),
.BR threed (6),
.BR accel (6),
.BR bg_test (6),
.BR eventtest (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 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.

73
doc/man6/fun.6 Normal file
View file

@ -0,0 +1,73 @@
.TH fun 6 "29 July 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
fun \- draw pixels accumulating in clusters
.SH SYNOPSIS
.B fun
.SH DESCRIPTION
Random moving pixels accumulate in clusters. Uses virtual screens
for frame animation. This uses basic VGA functionality and works
only in 320x200x256.
Hit
.B <Ctrl>-C
to abort. The bottom row shows all
'clustered' pixels (on the screen a blue circle marks the seed of the
largest cluster and its size), frames drawn, and (after some time)
average frames per second. Once the screen is filled, a new random
setup is run.
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 keytest (6),
.BR mousetest (6),
.BR scrolltest (6),
.BR speedtest (6),
.BR spin (6),
.BR testaccel (6),
.BR testgl (6),
.BR testlinear (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.

81
doc/man6/joytest.6 Normal file
View file

@ -0,0 +1,81 @@
.TH joytest 3 "14 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
joytest \- test the svgalib joystick package in text mode
.SH SYNOPSIS
.BI "joytest " number
.SH DESCRIPTION
This demo program tries to open the joystick with the given
.I number
and calibrates it. The user is prompted to press
.B <Return>
after which any state change of the joystick is reported until the program is killed.
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.3.0.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 CAVEATS
The functions used by this demo are only available in ELF versions of svgalib. Due to backwards
compatibility issues it cannot be used with shared a.out libs.
.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 scrolltest (6),
.BR speedtest (6),
.BR spin (6),
.BR testaccel (6),
.BR testgl (6),
.BR testlinear (6),
.BR vgatest (6),
.BR plane (6),
.BR wrapdemo (6),
.BR vgatest (6),
.BR mjoytest (6),
.BR joystick_init (3),
.BR joystick_close (3),
.BR joystick_update (3),
.BR joystick_sethandler (3),
.BR joystick_setdefaulthandler (3),
.BR joystick_getnumaxes (3),
.BR joystick_getnumbuttons (3),
.BR joystick_getaxis (3),
.BR joystick_getbutton (3),
.BR joystick_button1 (3),
.BR joystick_getb1 (3),
.BR joystick_x (3),
.BR joystick_getx (3).
.SH AUTHOR
The svgalib joystick handler was mostly done by Daniel Engstr\\"om <daniel.engstrom@riksnett.no>.
Multiple joystick, VC switching support and code to glue it into svgalib by Michael Weller
<eowmob@exp-math.uni-essen.de>. Part of the code is based on code from C. Smith and
Vojtech Pavlik.

107
doc/man6/keytest.6 Normal file
View file

@ -0,0 +1,107 @@
.TH keytest 6 "8 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
keytest \- tests the svgalib raw keyboard functions
.SH SYNOPSIS
.B keytest
.SH DESCRIPTION
A program to test the low-level keyboard interface. This uses basic
VGA functionality (or an svga mode you specify). Works only in 256
color modes.
Cursor keys or keypad
.BR <1> ", "
.BR <2> ", "
.BR <3> ", "
.BR <4> ", "
.BR <5> ", "
.BR <6> ", "
.BR <7> ", "
.BR <8> ", and "
.BR <9>
move the cursor.
Keypad
.BR <0> " or " <Enter>
changes color.
.BR <Q> " or " <Ctrl>-C
quits. (autoquit after 60
seconds).
Note that the svgalib diagonal
.BR <7> ", "
.BR <9> ", "
.BR <1> ", and "
.BR <3>
keypad keys
emulation is flawed in that it emulates the vertical/horizontal
keys. If one of these is pressed too, it's release confuses svgalib.
The top pixel line shows a blue pixel for each key which is reported
to be pressed.
You can set a videomode
to use by setting the environment variable
.B SVGALIB_DEFAULT_MODE
to a number (see vgatest
for a list) or a string like G0x1x2 where you replace 0 with desired x
resolution, 1 with the desired y rez, and 2 with the desired number of
colors (2, 16, 256, 32K, 64K, 16M, 16M4). Again, only certain choices are
available, see vgatest for a list.
In case nothing is selected, G320x200x256 is choosen.
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 mousetest (6),
.BR scrolltest (6),
.BR speedtest (6),
.BR spin (6),
.BR testaccel (6),
.BR testgl (6),
.BR testlinear (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.

1
doc/man6/lineart.6 Normal file
View file

@ -0,0 +1 @@
.so man6/testlinear.6

97
doc/man6/mach32info.6 Normal file
View file

@ -0,0 +1,97 @@
.TH mach32info 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
mach32info \- read out configuration information of a Mach32
.SH SYNOPSIS
.B mach32info {info|force}
.SH DESCRIPTION
.B mach32info
prints out almost all the info about your mach32 card from configuration
registers and Mach32 EEPROM. It also measures the Mach32 clocks. A
completely idle system is required when these measurements are being
performed. During these measurements, the video signals will be screwed up
for about 3-4 seconds.
If your monitor does not switch off when getting a video signal it can't
stand (fixed freq. monitors) better switch it off before starting
mach32info. Your computer will beep when it is finished probing.
You can redirect the 'stdout' of
.B mach32info
to some file for viewing the results easier or mailing them.
Do not redirect 'stderr' as you won't hear the beep.
This tool is part of svgalib. Although it's output maybe useful to debug
Xfree86 Mach32 Servers, I am
.B NOT
related to Xfree86!
.B Please do not send me (Michael Weller) any Xfree86 bug reports!
Thanx in advance.
Note that this tool comes
.B without any warranty!
Use it at your
.B own
risk!
.BR Warning ,
this tool does not check for VC changes etc.. Just let it run in
its own virtual console as root and don't try to fool it.
Actually this is due to it not using svgalib at all but simply accessing the
Mach32.
Please report any problems with running
.B mach32info
or with configuring the
.BR svgalib (7)'s
Mach32 driver to Michael Weller <eowmob@exp-math.uni-essen.de>.
Include the results from running this test with your report.
.SH OPTIONS
.TP
.B info
print out the configuration information. Without
.B info
.B mach32info
prints a usage message (looking almost like this manpage ;-)).
.TP
.B force
The
.B force
option disables the sanity check that tries to detect the
presence of the mach32 prior to printing the information.
Do not use this option unless you are really,
really sure that you have a Mach32 compatible vga card installed.
.PP
This utility is part of svgalib and can be found in the
.I mach32/
subdirectory of the original svgalib distribution. However, it is not installed
by default, s.t. it is unclear where you can find it if your svgalib was install
by a linux distribution.
In case of any such problem, simply get an svgalib distribution from the net. You
don't need to install it. Just
.B make
in the
.I mach32/
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 svgalib.mach32 (7),
.BR vgagl (7),
.BR libvga.config (5).
.SH AUTHOR
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>.
He also wrote the referenced utility as well as of the original documentation.

111
doc/man6/mjoytest.6 Normal file
View file

@ -0,0 +1,111 @@
.TH mjoytest 3 "14 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
mjoytest \- test the svgalib joystick package in graphics mode
.SH SYNOPSIS
.BI "mjoytest [-j " joystick "] [[-m] " "video mode" ]
.SH DESCRIPTION
This demo program utilizes joysticks
.BR 0 " and " 1
in graphics mode.
If you specify a
.I joystick
number, only this is used. The demo separates the screen in two parts where you
can move a cursor around with the resp. joystick. Pressing button
2 changes the color, pressing button 1 draws.
It also prints the current joystick position to the screen.
Internally the demo also shows the use of custom joystick handlers and how to
recalibrate a joystick in graphics mode (press key
.BR <1> " and " <2>
respectively.
After the demo runs and the joysticks are initialized it is possible to share the
joysticks with another application (as long as it releases the joysticks upon a VC
switch as well).
Pressing
.BR <Q>
exits.
.SH BUGS
After a vc switch the demo occasionally hangs in
.BR vga_waitevent (3)
not timing out (hence the joysticks block). It is
not clear if it is a conceptional problem or bug in
.BR vga_waitevent (3)
or the kernel.
Simply press any key to revive the demo.
.SH NOTES
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.3.0.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 CAVEATS
The functions used by this demo are only available in ELF versions of svgalib. Due to backwards
compatibility issues it cannot be used with shared a.out libs.
.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 scrolltest (6),
.BR speedtest (6),
.BR spin (6),
.BR testaccel (6),
.BR testgl (6),
.BR testlinear (6),
.BR vgatest (6),
.BR plane (6),
.BR wrapdemo (6),
.BR vgatest (6),
.BR joytest (6),
.BR joystick_init (3),
.BR joystick_close (3),
.BR joystick_update (3),
.BR joystick_sethandler (3),
.BR joystick_setdefaulthandler (3),
.BR joystick_getnumaxes (3),
.BR joystick_getnumbuttons (3),
.BR joystick_getaxis (3),
.BR joystick_getbutton (3),
.BR joystick_button1 (3),
.BR joystick_getb1 (3),
.BR joystick_x (3),
.BR joystick_getx (3).
.SH AUTHOR
The svgalib joystick handler was mostly done by Daniel Engstr\\"om <daniel.engstrom@riksnett.no>.
Multiple joystick, VC switching support and code to glue it into svgalib by Michael Weller
<eowmob@exp-math.uni-essen.de>. Part of the code is based on code from C. Smith and
Vojtech Pavlik.

82
doc/man6/mousetest.6 Normal file
View file

@ -0,0 +1,82 @@
.TH mousetest 6 "8 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
mousetest \- tests the svgalib mouse driver
.SH SYNOPSIS
.B mousetest
.SH DESCRIPTION
A simple program to test mouse functionality.
This uses basic VGA functionality (or an
svga mode you specify, you should stick to 256 color modes).
The proper setup mouse should move the cursor (drawing spots in the
current color). Left button changes color, right button (or
.BR <Ctrl>-C)
aborts.
You can set a videomode
to use by setting the environment variable
.B SVGALIB_DEFAULT_MODE
to a number (see vgatest
for a list) or a string like G0x1x2 where you replace 0 with desired x
resolution, 1 with the desired y rez, and 2 with the desired number of
colors (2, 16, 256, 32K, 64K, 16M, 16M4). Again, only certain choices are
available, see vgatest for a list.
In case nothing is selected, G320x200x256 is choosen.
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 scrolltest (6),
.BR speedtest (6),
.BR spin (6),
.BR testaccel (6),
.BR testgl (6),
.BR testlinear (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.

116
doc/man6/plane.6 Normal file
View file

@ -0,0 +1,116 @@
.TH plane 6 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
plane \- draw a 3 dimensional plane
.SH SYNOPSIS
.B plane
.SH DESCRIPTION
A greyscale-shaded rendered-on-the-fly turbo-prop that you can rotate
and scale however you like.
The demo prompts your for a mode to be used and several details. Just
follow the instructions on the screen and make your selections.
Once the program runs you can use the following keys:
.TP
.BR <Q> " and " <A> ", " <Z> " and " <X> ", " <O> " and " <P>
to rotate the plane around the space axes.
.TP
.BR <T> " and " <V> ", " <F> " and " <G> ", " <W> " and " <S>
to move up, down, north, south, east, west. (world view only)
.TP
.B
<Space>
to toggle rendering vs. wire frame.
.TP
.BR <W> " and " <S>
to scale in non-world view compilation -- see plane.h
.TP
.BR <1> " and " <2>
to change rotation increment.
.TP
.BR <3> " through " <9>
to change surface density.
.TP
.BR <R>
to change shading method.
.TP
.BR <C>
to quit the program.
.TP
.BR <I>
to reset the rotation to the startup values.
.PP
This demo is part of svgalib and can be found in the
.I threeDkit/
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 threeDkit/
subdirectory. 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 triangle (3),
.BR striangle (3),
.BR wtriangle (3),
.BR swtriangle (3),
.BR trisetcolorlookup (3),
.BR trigetcolorlookup (3),
.BR trisetdrawpoint (3),
.BR threedkit (7),
.BR vgatest (6),
.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 wrapdemo (6)
.SH AUTHOR
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
demos, the initial documentation and the whole threedkit stuff was done by
Paul Sheer <psheer@icon.co.za>.
Paper mail:
.RS
Paul Sheer
.br
P O BOX 890507
.br
Lyndhurst
.br
Johannesburg 2106
.br
South Africa
.RE
Donations (by check or postal order) will be appreciated and will encourage
further development of this software. However this is strictly on a voluntary
basis where this software falls under the GNU LIBRARY GENERAL PUBLIC LICENSE.

80
doc/man6/printftest.6 Normal file
View file

@ -0,0 +1,80 @@
.TH printftest 6 "8 April 1997" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
printftest \- tests the vgagl gl_printf function
.SH SYNOPSIS
.BI "printftest " x " " y
.SH DESCRIPTION
This test utility reads keys from the keyboard and displays them on the
screen at pixel position
.RI ( x ", " y )
using
.BR gl_printf (3).
It must be linked with the ELF svgalib libraries.
You can set a videomode
to use by setting the environment variable
.B SVGALIB_DEFAULT_MODE
to a number (see vgatest
for a list) or a string like G0x1x2 where you replace 0 with desired x
resolution, 1 with the desired y rez, and 2 with the desired number of
colors (2, 16, 256, 32K, 64K, 16M, 16M4). Again, only certain choices are
available, see vgatest for a list.
In case nothing is selected, G320x200x256 is choosen.
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 mousetest (6),
.BR scrolltest (6),
.BR speedtest (6),
.BR spin (6),
.BR testaccel (6),
.BR testgl (6),
.BR testlinear (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.

76
doc/man6/scrolltest.6 Normal file
View file

@ -0,0 +1,76 @@
.TH scrolltest 6 "29 July 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
scrolltest \- tests some scrolling algorithms with svgalib
.SH SYNOPSIS
.B scrolltest
.SH DESCRIPTION
Smooth scrolling demo. Uses three different techniques. Useful for
testing Mode X functionality (not that I would recommend it over
320x240x256 linear). Press
.B <Space>
to cycle through the demos.
The demos works only in 320x240x256 for the first 2 tests
and with 320x200x256 in the last. Demos 1 & 3 use a virtual screen
buffer, mode 2 (jumpy) works on screen. This is more a skeleton if
you want to write some animation program, rather than a nice demo.
Shows frames per second (multiplied by 10) for method 1 & 3. Thus
works also a kind of memory speed tester
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 speedtest (6),
.BR spin (6),
.BR testaccel (6),
.BR testgl (6),
.BR testlinear (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.

70
doc/man6/speedtest.6 Normal file
View file

@ -0,0 +1,70 @@
.TH speedtest 6 "29 July 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
speedtest \- tests the speed of memory access under svgalib
.SH SYNOPSIS
.B speedtest
.SH DESCRIPTION
Video memory speed tester. Selects the given mode and makes linear
screen accesses. Prints the overall run time of the test and
deduces the speed with which the CPU can transfer data to the cards
memory.
The demo gives a list of modes supported and prompts your for an integer
indentifying the mode to test.
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 spin (6),
.BR testaccel (6),
.BR testgl (6),
.BR testlinear (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.

98
doc/man6/spin.6 Normal file
View file

@ -0,0 +1,98 @@
.TH spin 6 "29 July 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
spin \- test a 6-dimension mouse or pointer device with svgalib
.SH SYNOPSIS
.B spin
.SH DESCRIPTION
Another mouse test program. This is the first svgalib program to
use the 6-dimensional mouse routines. It draws a wireframe spheroid
on the screen which can be moved left/right, up/down, in/out, or
rotated along the x, y, or z axes.
.B Button bindings are:
.br
.PD 0
.TP
.BR A " - Decrease Sensitivity (Right Mouse Button)"
.TP
.BR B " - Change color (Middle Mouse Button)"
.TP
.BR C " - Increase Sensitivity (Left Mouse Button)"
.TP
.BR D " - Increase Number of Sides"
.TP
.BR E " - Decrease Number of Sides"
.TP
.BR F " - Quit (" <Ctrl>-C )
.PD
.P
If you only have a two dimensional mouse with three or fewer buttons
you will only be able to move the mouse in two dimensions
(left/right and in/out) and will not be able to move up/down or
spin the spheroid.
Note: the initial mouse sensitivity is optimised for the Spacetec
series of controllers, which are much more sensitive than the usual
mouse. Increasing the sensitivity is advised for users of other
types of devices.
The demo works always in mode 320x200x256. It prompts your for an
integer, the number of sides the sphere has (the higher the smoother
looks the spere).
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 mouse_setposition_6d (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 testaccel (6),
.BR testgl (6),
.BR testlinear (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.

55
doc/man6/svidtune.6 Normal file
View file

@ -0,0 +1,55 @@
.TH vgatest 6 "10 June 1999" "Svgalib (>= 1.4.0)" "Svgalib User Manual"
.SH NAME
svidtune - tunes svgalib modes
.SH SYNOPSIS
.B svidtune mode
.SH DESCRIPTION
.I mode
is an svgalib mode number for the mode to be tuned. The number of colours
is irrelevant, but the mode must be supported by the hardware.
svidtune displays the mode timing parameters, and a rectangle around the
screen. You can then adjust the parameters to have the display tuned
properly.
Please note that modelines (and this program) only affects display when
the driver uses the timing.c interface. Specifically, it has no affect on
the VESA driver.
.SH KEYS
.IR l,r,d,u
move the displayed portion of the screen left, right, down or up.
.IR w,n
increase or decrease the screens horizontal size.
.I s,o
increase or decrease the screens vertical size.
.I p
print the current modeline to the standard error.
.I P
print the current modeline to the config file, so it will be used by
svgalib from now on.
.I q
quit
.SH BUGS
The program does not test that the modes remain within the monitor limits.
.SH SEE ALSO
.BR vga_getcurrenttiming (3),
.BR vga_changecurrenttiming (3),
.BR libvga.config (5)
.SH AUTHOR
This man page was written by Matan Ziv-Av.

397
doc/man6/testaccel.6 Normal file
View file

@ -0,0 +1,397 @@
.TH testaccel 6 "29 July 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
testaccel \- test the old style blitter functions and vga_ext_set()
.SH SYNOPSIS
.BI "testaccel [ -nowait ] [ { all | " videomodes "... } ]
.SH DESCRIPTION
Program to test the old blitter functions in a screen mode. Checks
the 8-bit wide color lookup tables on Mach32's with type 2 DACs
as well.
[I think '6bpp' and '8bpp' are silly names for the 8-bit
LUT thing -- bpp is bits per pixel, in the framebuffer - HH :-)]
After each test it waits for a key press except when
.B -nowait
is
given.
You can specify names of modes to test on the command line
or specify
.B all
to loop over all svgalib modes.
The program will run on any card, however, most of the tests can
only be performed on a Mach32.
The subtest are in turn:
.TP
.B 1 -
For each 256 color mode the program sees if it is possible to
enable a special mode with 8 bits per color in the RGB lookup
table. If so, for example 256 different shades of blue can
be implemented.
The program displays as much blue shades as possible in a shade
from dark (left) to bright (right) and some text in an
opposite direction on top of it. In case 56 different shades
are supported, the screen is divided and shows a rough 64 shades
scale (ordinary vga) on top and the smooth shade below.
Right now 256 different shades are only possible on a Mach32 with
RAMDAC of type 2.
For modes with few pixels only, the program might fail to print
the text properly and will 'wrap' it around the screen edges.
.TP
.B 2 -
Draws a bouncing 'linux' logo stopping after a fixed amount of
1 pixel steps. Uses
.BR vga_bitblt (3)
on the image plus a one pixel
outline in border color to move the pixel around the screen.
The Mach32 is
.B very
fast in this discipline.
.TP
.B 3 -
Draws filled rectangles using
.BR vga_fillblt (3).
At first a series
of larger to smaller centered rectangles is drawn to fill the
screen.
For 256 or less color modes these will use a sequence of 256
random colors. For 32K or more color modes it will use colors
0 up too, however, you'll usually just see a repeating series
of blues (limitations of monitor/human eye, the blue's differ
not enough for the eye to see). Then a bunch of random boxes
in random places is drawn overwriting each other.
The Mach32 is
.B very
fast in this discipline.
.TP
.B 4 -
Draws small fish bitmaps and then larger linux logos in random
positions using
.BR vga_imageblt (3).
They just overlap each other
The Mach32 is poor in this discipline. If you have a linear
frame buffer enabled, it is used instead to perform this function
(even if the program does not use a linear frame buffer otherwise).
Usually this is twice as fast for Mach32.
.TP
.B 5 -
Use
.BR vga_hlinelistblt (3)
o do some simple polygon fills: squares,
circles, diamonds of random sizes, positions and colors. Again,
the Mach32 is
.B very
fast in this discipline, but somehow slowed
down by the imperfect prototype of this function. Again,
the polygons just overlap each other.
The resp. tests will only be performed where supported by the
hardware. For Mach32 this means only SVGA 256, 32K, 64K color modes.
The linear frame buffer emulated
.BR vga_imageblt (3)
works for all SVGA modes
though.
.P
The program prints the number of pixels drawn and the time required
plus the resulting rate of pixels per second. For Mach32 the rate
depends on the amount of screen accesses (2 per pixel move for
.BR vga_bitblt (3),
1 per pixel move for
.BR vga_fillblt "(3) and "
.BR vga_hlinelistblt (3);
also twice bytes
are affected for 32K, 64K color modes). On a non VRAM card you'll
also note the effect of the memory access caused by the generation
of the video frames (more colors/rez/sync rates => less speed).
Also, higher modes draw more pixels per call, thus less call and
setup overhead.
Here are the rates for my card on an almost idle 486 EISA system
which should be fairly optimal (2MB VRAM EISA Mach32) except maybe
the linear frame buffer emulated imageblt which might be faster on
PCI card:
.br
.B Testing mode 1: G320x200x16...
.br
.B Dacwidth test not applicable.
.br
.B Testing mode 2: G640x200x16...
.br
.B Dacwidth test not applicable.
.br
.B Testing mode 3: G640x350x16...
.br
.B Dacwidth test not applicable.
.br
.B Testing mode 4: G640x480x16...
.br
.B Dacwidth test not applicable.
.br
.B Testing mode 5: G320x200x256...
.br
.B Warning: Resolution too small, displayed text is
.br
.B probably scrambled.
.br
.B " "
.br
.B Has support for CLUT width 8 bit
.br
.B Testing mode 6: G320x240x256...
.br
.B Dacwidth test not applicable.
.br
.B Testing mode 7: G320x400x256...
.br
.B Dacwidth test not applicable.
.br
.B Testing mode 8: G360x480x256...
.br
.B Dacwidth test not applicable.
.br
.B Testing mode 9: G640x480x2...
.br
.B Dacwidth test not applicable.
.br
.B Testing mode 10: G640x480x256...
.br
.B Has support for CLUT width 8 bit
.br
.B Has BitBlt: 176610000 Pixels in 6.49 seconds -> 27.21 Megapels
.br
.B Has FillBlt: 217884171 Pixels in 4.55 seconds -> 47.89 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 3.07 seconds -> 5.57 Megapels
.br
.B Has HlineLst: 20192124 Pixels in 0.57 seconds -> 35.42 Megapels
.br
.B Testing mode 11: G800x600x256...
.br
.B Has support for CLUT width 8 bit
.br
.B Has BitBlt: 176610000 Pixels in 6.65 seconds -> 26.56 Megapels
.br
.B Has FillBlt: 343102613 Pixels in 6.23 seconds -> 55.07 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 3.06 seconds -> 5.58 Megapels
.br
.B Has HlineLst: 33166399 Pixels in 0.78 seconds -> 42.52 Megapels
.br
.B Testing mode 12: G1024x768x256...
.br
.B Has support for CLUT width 8 bit
.br
.B Has BitBlt: 176610000 Pixels in 6.88 seconds -> 25.67 Megapels
.br
.B Has FillBlt: 603141286 Pixels in 9.78 seconds -> 61.67 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 3.07 seconds -> 5.57 Megapels
.br
.B Has HlineLst: 52958845 Pixels in 1.08 seconds -> 49.04 Megapels
.br
.B Testing mode 13: G1280x1024x256...
.br
.B Has support for CLUT width 8 bit
.br
.B Has BitBlt: 176610000 Pixels in 7.10 seconds -> 24.87 Megapels
.br
.B Has FillBlt: 1063820849 Pixels in 16.16 seconds -> 65.83 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 3.07 seconds -> 5.57 Megapels
.br
.B Has HlineLst: 95798478 Pixels in 1.75 seconds -> 54.74 Megapels
.br
.B Testing mode 14: G320x200x32K...
.br
.B Dacwidth test not applicable.
.br
.B Has BitBlt: 176610000 Pixels in 12.30 seconds -> 14.36 Megapels
.br
.B Has FillBlt: 41317334 Pixels in 3.61 seconds -> 11.45 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 5.93 seconds -> 2.88 Megapels
.br
.B Has HlineLst: 3411068 Pixels in 0.23 seconds -> 14.83 Megapels
.br
.B Testing mode 15: G320x200x64K...
.br
.B Dacwidth test not applicable.
.br
.B Has BitBlt: 176610000 Pixels in 12.29 seconds -> 14.37 Megapels
.br
.B Has FillBlt: 42351016 Pixels in 4.12 seconds -> 10.28 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 5.93 seconds -> 2.88 Megapels
.br
.B Has HlineLst: 3561694 Pixels in 0.23 seconds -> 15.49 Megapels
.br
.B Testing mode 16: G320x200x16M...
.br
.B Dacwidth test not applicable.
.br
.B Has ImageBlt: 17085000 Pixels in 8.83 seconds -> 1.93 Megapels
.br
.B Testing mode 17: G640x480x32K...
.br
.B Dacwidth test not applicable.
.br
.B Has BitBlt: 176610000 Pixels in 13.38 seconds -> 13.20 Megapels
.br
.B Has FillBlt: 217723964 Pixels in 7.95 seconds -> 27.39 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 5.94 seconds -> 2.88 Megapels
.br
.B Has HlineLst: 19579110 Pixels in 0.74 seconds -> 26.46 Megapels
.br
.B Testing mode 18: G640x480x64K...
.br
.B Dacwidth test not applicable.
.br
.B Has BitBlt: 176610000 Pixels in 13.37 seconds -> 13.21 Megapels
.br
.B Has FillBlt: 221608034 Pixels in 8.28 seconds -> 26.76 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 5.93 seconds -> 2.88 Megapels
.br
.B Has HlineLst: 21048202 Pixels in 0.79 seconds -> 26.64 Megapels
.br
.B Testing mode 19: G640x480x16M...
.br
.B Dacwidth test not applicable.
.br
.B Has ImageBlt: 17085000 Pixels in 8.82 seconds -> 1.94 Megapels
.br
.B Testing mode 20: G800x600x32K...
.br
.B Dacwidth test not applicable.
.br
.B Has BitBlt: 176610000 Pixels in 13.97 seconds -> 12.64 Megapels
.br
.B Has FillBlt: 357205415 Pixels in 12.22 seconds -> 29.23 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 5.92 seconds -> 2.89 Megapels
.br
.B Has HlineLst: 34391335 Pixels in 1.16 seconds -> 29.65 Megapels
.br
.B Testing mode 21: G800x600x64K...
.br
.B Dacwidth test not applicable.
.br
.B Has BitBlt: 176610000 Pixels in 13.97 seconds -> 12.64 Megapels
.br
.B Has FillBlt: 348943970 Pixels in 11.87 seconds -> 29.40 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 5.93 seconds -> 2.88 Megapels
.br
.B Has HlineLst: 34510200 Pixels in 1.17 seconds -> 29.50 Megapels
.br
.B Testing mode 22: G800x600x16M...
.br
.B Dacwidth test not applicable.
.br
.B Has ImageBlt: 17085000 Pixels in 8.83 seconds -> 1.93 Megapels
.br
.B Testing mode 23: G1024x768x32K...
.br
.B Dacwidth test not applicable.
.br
.B Has BitBlt: 176610000 Pixels in 14.60 seconds -> 12.10 Megapels
.br
.B Has FillBlt: 608000981 Pixels in 18.62 seconds -> 32.65 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 5.93 seconds -> 2.88 Megapels
.br
.B Has HlineLst: 53767429 Pixels in 1.72 seconds -> 31.26 Megapels
.br
.B Testing mode 24: G1024x768x64K...
.br
.B Dacwidth test not applicable.
.br
.B Has BitBlt: 176610000 Pixels in 14.60 seconds -> 12.10 Megapels
.br
.B Has FillBlt: 601666798 Pixels in 18.80 seconds -> 32.00 Megapels
.br
.B Has ImageBlt: 17085000 Pixels in 5.92 seconds -> 2.89 Megapels
.br
.B Has HlineLst: 52037798 Pixels in 1.67 seconds -> 31.16 Megapels
.br
.B Testing mode 32: G720x348x2...
.br
.B Dacwidth test not applicable.
.br
.B Testing mode 33: G320x200x16M32...
.br
.B Dacwidth test not applicable.
.br
.B Has ImageBlt: 17085000 Pixels in 11.60 seconds -> 1.47 Megapels
.br
.B Testing mode 34: G640x480x16M32...
.br
.B Dacwidth test not applicable.
.br
.B Has ImageBlt: 17085000 Pixels in 11.62 seconds -> 1.47 Megapels
.br
.B Testing mode 35: G800x600x16M32...
.br
.B Dacwidth test not applicable.
.br
.B Has ImageBlt: 17085000 Pixels in 11.62 seconds -> 1.47 Megapels
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 vga_ext_set (3),
.BR vga_bitblt (3),
.BR vga_fillblt (3),
.BR vga_hlinelistblt (3),
.BR vga_imageblt.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 testgl (6),
.BR testlinear (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>. He
also wrote thise demo and it's documentation.

92
doc/man6/testgl.6 Normal file
View file

@ -0,0 +1,92 @@
.TH testgl 6 "8 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
testgl \- test the vgagl library
.SH SYNOPSIS
.B testgl
.SH DESCRIPTION
Demo program for
.BR vgagl (7)
framebuffer library. Runs in any mode preset
from the environment.
First draws pixels in random locations, then
random boxes, then random lines and finally some bit image in random
locations (all just over the previous drawings).
Then the
test is repeated clipping the screen output to a smaller screen
portion (using a
.BR vgagl (7)
function). Finally a (lousy) 'rotating'
linux logo is shown in the top left quadrant and then is drawn
over the whole screen.
Depending on internal development state of svgalib, it may use an
accelerator for some of the functions.
You can set a videomode
to use by setting the environment variable
.B SVGALIB_DEFAULT_MODE
to a number (see vgatest
for a list) or a string like G0x1x2 where you replace 0 with desired x
resolution, 1 with the desired y rez, and 2 with the desired number of
colors (2, 16, 256, 32K, 64K, 16M, 16M4). Again, only certain choices are
available, see vgatest for a list.
In case nothing is selected, G320x200x256 is choosen.
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 testlinear (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.

96
doc/man6/testlinear.6 Normal file
View file

@ -0,0 +1,96 @@
.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.

128
doc/man6/threed.6 Normal file
View file

@ -0,0 +1,128 @@
.TH threed 6 "8 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
.SH NAME
threed \- The svgalib 3d demo
.SH SYNOPSIS
.B 3d
.SH DESCRIPTION
Well, the 3d demo...
I, Michael, the current svgalib maintainer, do not have any source for it.
Thus, you may experience weird problems with new svgalib versions
and you need installed a.out libc and svgalib versions.
Also the demo is known to be buggy in several aspects. Thus, do not
panic if it appears not to work for you.
If it works in a certain mode for you be happy and
play around with it. For example, with recent svgalibs,
.B 3d
is
unable to initialize the mouse if not started directly in a linux
console for unknown reasons.
Otherwise:
.B "Don't worry at all."
.SS "Here's the author's (Harm's) info about it:"
There's also a
.B 3d
demo binary included in this directory. It has been
in a similar state for several months now, but I'm planning to get
some work done (although it probably won't be the amazing multi-player
networked 3D lightsource-shaded real-time VGA virtual reality
simulation). I'll release the source code at some point (when it has
some degree of flexibility). I'm sorry that there's no scene
description file; it will come. So now you know you can do this kind
of thing in Linux. And it's practically 100% C code.
You can set the graphics mode to be used with the
.B SVGALIB_DEFAULT_MODE
environment
variable (e.g. G640x480x256). All linear 256 color, 32K color and 16M
color modes are supported, with page flipping used if available. Planar
256 color VGA modes also work. This should do 800x600 full screen 3D
animation at near 10 fps with a good system.
Request: Please report if page flipping goes wrong on a particular
chipset (e.g. ET4000, Trident) in 320x200x256. Also 32-bit pixel
truecolor modes don't work correctly, this will be fixed.
The user interface is somewhat primitive at this point:
- Use the mouse to rotate.
.br
- Left button accelerates, right decelerates.
.br
- Press
.B <W>
to move upwards,
.B <S>
to go down again.
.br
- Use
.B <R>
and
.B <F>
to control the zoom factor.
.br
-
.BR <q> " or " <Ctrl>-C
exits.
Note that the light source rotates quickly at an infinite distance.
This is not something that will easily occur naturally (as far as I
know)...
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 BUGS
Countless.
.br
In addition, source is still not available. Sorry, I just don't have it.
.SH SEE ALSO
.BR svgalib (7),
.BR vgagl (7),
.BR libvga.config (5),
.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 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
demo and most of it's documentation is due to
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.

157
doc/man6/vgatest.6 Normal file
View file

@ -0,0 +1,157 @@
.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.

116
doc/man6/wrapdemo.6 Normal file
View file

@ -0,0 +1,116 @@
.TH wrapdemo 6 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
.SH NAME
wrapdemo \- demonstrates surface wrapping of pixmaps
.SH SYNOPSIS
.B wrapdemo
.SH DESCRIPTION
Demonstrates surface wrapping of pixmaps by wrapping a picture or
Susanna Rubens around a 3-dimensional ball.
The demo prompts your for a mode to be used and several details. Just
follow the instructions on the screen and make your selections.
Once the program runs you can use the following keys:
.TP
.BR <Q> " and " <A> ", " <Z> " and " <X> ", " <O> " and " <P>
to rotate the plane around the space axes.
.TP
.BR <T> " and " <V> ", " <F> " and " <G> ", " <W> " and " <S>
to move up, down, north, south, east, west. (world view only)
.TP
.B
<Space>
to toggle rendering vs. wire frame.
.TP
.BR <W> " and " <S>
to scale in non-world view compilation -- see plane.h
.TP
.BR <1> " and " <2>
to change rotation increment.
.TP
.BR <3> " through " <9>
to change surface density.
.TP
.BR <R>
to change shading method.
.TP
.BR <C>
to quit the program.
.TP
.BR <I>
to reset the rotation to the startup values.
.PP
This demo is part of svgalib and can be found in the
.I threeDkit/
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 threeDkit/
subdirectory. 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 triangle (3),
.BR striangle (3),
.BR wtriangle (3),
.BR swtriangle (3),
.BR trisetcolorlookup (3),
.BR trigetcolorlookup (3),
.BR trisetdrawpoint (3),
.BR threedkit (7),
.BR vgatest (6),
.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)
.SH AUTHOR
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
demos, the initial documentation and the whole threedkit stuff was done by
Paul Sheer <psheer@icon.co.za>.
Paper mail:
.RS
Paul Sheer
.br
P O BOX 890507
.br
Lyndhurst
.br
Johannesburg 2106
.br
South Africa
.RE
Donations (by check or postal order) will be appreciated and will encourage
further development of this software. However this is strictly on a voluntary
basis where this software falls under the GNU LIBRARY GENERAL PUBLIC LICENSE.