This software is distributed " as is " with no warranty or any responsibility
on the part of the author for any loss or damages due to use ( or misuse ) of
this software. I reserve all rights to this software and have applied and
received a copyright for this software. You may freely use this software in
any NON commercial usage for any non profit software package. No fee, royalty,
or charge of any kind shall accompany the distribution of this software.
Including the profitable distribution of diskettes using this software to
enhance the value of the diskettes beyond their normal market value.
Any mail order disribution will be construed as using the mail to violate my
rights by distribiting my copyrighted work without my permission and would
result in filing of charges with the postmaster general for using the mail to
illegally distribute copyrighted material.

If you wish to use these routines in any commercial venture you must first
receive permission from the author who can be reached at
(517) 351-4689.

QB-UTILS Copyright (c) 1986
Maverick Software
(517) 351-4689
HMODE(a%)

The call HMODE expects one integer size parameter and functions accordingly.
The syntax being call hmode(a%)
1. If a%=0 then enter text mode
2. If a%=1 then enter graphics mode and clear graphics screen
on entry to graphics mode
3. If a%=2 then enter graphics mode and don't clear graphics screen
on entry to graphics mode
4. If a%=3 then clear graphics screen but don't enter graphics mode
5. If a%=any other value then just enter graphics mode, don't clear
graphics screen on entry

HPOINT(x%,y%,kolor%)

The call hpoint expects 3 integer size parameters and functions accordingly.
The syntax being call hpoint(x%,y%,kolor%)
1. x% is the x coordinate of the point from x%=0 to 719,
not value checked.
2. y% is the y coordinate of the point from y%=0 to 347,
not value checked.
3. kolor%=0 to display a black dot ( erase a dot ) any other value
will display a white dot ( turn dot on )

HLINE(x1%,y1%,x2%,y2%,kolor%)

The call hline expects 5 integer size parameters and functions accordingly.
The syntax being call hline(x1%,y1%,x2,y2,kolor%)
1. x1%,y1% being the starting coordinates using the same limits for
x% and y% as in the hpoint call ( not value checked )
2. x2%,y2% are the end coordinates using the same limits for x% and y%
again not value checked
3. If kolor%=0 then draw a black line ( turn off line ) any other value
will draw a white ( visible ) line.

HPRINT(x%,y%,q%)

The call hprint expects 3 parameters and functions accordingly.
The syntax being call hprint(a$,x%,y%,q%)
1. Where a$ is the string descriptor. Only the lower 127 characters
are printed and all control characters are printed according to
their ascii representation.
2. x%,y% are the starting x,y coordinates for the text. The text is
pixel mapped so you can specify for the text to start at coordinates
ranging from x%=0 to 719 and y%= 0 to 347 ( not value checked )
3. The integer q% can have several values.
a. If q%=0 then the leftmost character of the string will
start at the given x%,y% coordinates. This is left justified.
b. If q%=1 then the text will be centered about the given x%,y%
coordinate pair.
c. If q%=2 the text will be right justified using the x%,y% pair
as the rightmost margin. This is right justified, jagged left
margin.
d. Any other value of q% is treated as right justified as explained
above

HGET(x%,y%,kolor%)

The call hget expects 3 integer size parameters and functions accordingly.
The syntax being call hget(x%,y%,kolor%)
1. The parameters x%,y% specify the x,y coordinates of the point in
question. If the point is off then the routine returns a zero in
kolor% the return VARIABLE. Any non zero value returned in q% means
the point is turned on.



You can run a short demo program that demonstrated the routines by typing
to the command prompt

C:> QB TEST /L QB-UTILS.EXE

after Quick Basic loads type a control R ( ^R ) to start the demo


If you have any suggestions or enhancements you would like to see leave me a
note on Gene Plantz's BBS, Hoffman Estates, Ill. Good luck


Mark Victor