76 lines
2.4 KiB
Text
76 lines
2.4 KiB
Text
Introduction
|
|
============
|
|
|
|
This document gives a brief description of the test programs in the
|
|
'tests' sub-directory.
|
|
|
|
The test programs were not intended as a flashy demo of the capabilities
|
|
of LIBGRX. Their purpose is to test the various services of the library.
|
|
The general syntax of their usage is:
|
|
|
|
go32 <prog> [<width> <height> [<color>]] <additional arguments>
|
|
-- or for the Turbo C tests --
|
|
<prog> [<width> <height> [<color>]] <additional arguments>
|
|
|
|
The test programs typically display several screens, hitting any key
|
|
will advance to the next screen. In a few cases the keyboard is used
|
|
differently, these programs will be described below.
|
|
|
|
|
|
Description of the test programs:
|
|
=================================
|
|
|
|
MODETEST:
|
|
perform video adapter speed test and test the basic primitives
|
|
of the library.
|
|
|
|
WINTEST, WINCLIP, CLIPTEST:
|
|
test graphics contexts sub-contexts and clipping
|
|
|
|
FRAMTEST:
|
|
demo of the framed box primitive
|
|
|
|
BLITTEST:
|
|
test the bit block transfer function. First it tests the bitblt
|
|
primitive for 64 possible alignment cases in planar modes (8
|
|
possible alignments for the source and destination each). It does
|
|
this test both for forward and backward copy (it depends on
|
|
whether the source address is bigger than the destination) and
|
|
for a system RAM graphics context source. A wide and a narrow
|
|
test pattern is used. After finishing the basic tests the program
|
|
gives a demo of tiling the screen with a pattern similar to the
|
|
one in FRAMTEST.
|
|
|
|
RGBTEST:
|
|
tests the 256 color RGB mode.
|
|
|
|
COLOROPS:
|
|
tests the four write modes: SET, XOR, OR, AND
|
|
|
|
CURSTEST:
|
|
tests the graphics cursor drawing routines, Keyboard usage:
|
|
u U (up) \
|
|
d D (down) move the cursor
|
|
l L (left) capitals faster
|
|
r R (right) /
|
|
q exit program
|
|
|
|
MOUSETST:
|
|
test the mouse cursor and the rubberband cursor options.
|
|
|
|
POLYTEST:
|
|
test the polygon filling algorithm. It takes the coordinates
|
|
of the polygons from the data file "polytest.dat"
|
|
|
|
CIRCTEST:
|
|
test the circle drawing algorithm with a circle, horizontal and
|
|
vertical main axis ellipse. It draws the exact points (calculated
|
|
using FP arithmetics) in red. The 'q' key aborts the test.
|
|
|
|
TESTPATT:
|
|
tests the pattern filled graphics primitives.
|
|
|
|
|
|
NOTE: these programs can also be used as examples for the usage of the
|
|
library. As always: CONSULT THE SOURCE!!!!
|
|
|