home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1994 #1
/
monster.zip
/
monster
/
PROG_BAS
/
PBASMLIB.ZIP
/
README.1ST
< prev
next >
Wrap
Text File
|
1994-02-12
|
3KB
|
67 lines
PBASMLIB V1.0
(C) Copyright 1994 by Tim Gerchmez
All Rights Reserved.
--------------------
Hello, and welcome to PBASMLIB version 1.0, an all-assembly language
toolbox for PowerBASIC 3.0. PBASMLIB includes hundreds of low-level
routines that give you access to DOS, BIOS, Mouse driver, Soundblaster,
EMS, XMS and other system-level functions with the lightning speed and
small code size of pure assembly language. You don't have to know assembly
language to use these routines, however. Using them is as easy as calling
a regular PowerBASIC subprogram or function.
Installing PBASMLIB
-------------------
To install PBASMLIB, first create a new directory under your main
PowerBASIC directory to hold all the files. You can do this with
a command similar to the following:
MD C:\PB3\PBASMLIB
Next, copy all the files in this package to the newly-created directory
with a command similar to the following:
COPY *.* C:\PB3\PBASMLIB
After this, you should copy PBASMLIB.PBL to your PowerBASIC LINK directory,
and PBASMLIB.INC to PowerBASIC's INCLUDE directory. These are the directories
specified in the OPTIONS/DIRECTORIES menu in the PowerBASIC IDE. PowerBASIC
needs to know where to find PBASMLIB.PBL and PBASMLIB.INC when linking
routines into your programs. To copy these files, use a command sequence
similar to the following:
CD C:\PB3\PBASMLIB
COPY PBASMLIB.PBL C:\PB3\PBU (or C:\PB3\LINK)
COPY PBASMLIB.INC C:\PB3\INCLUDE
You can optionally always switch to the PBASMLIB directory before compiling
and linking PBASMLIB programs, but it's far more convenient to tell PowerBASIC
where to find .PBL/.PBU and .INC files. For more information on default
PowerBASIC directories, see the online help or consult the PowerBASIC manuals.
Once you've installed PBASMLIB, the routines should be ready to use. They
will all be immediately accessible to your programs by including the following
commands at the top of programs that use PBASMLIB routines:
$LINK "PBASMLIB.PBL"
$INCLUDE "PBASMLIB.INC"
If you're using a version of PowerBASIC earlier than 3.0C, it may be
necessary to declare only the routines that you actually use in your
programs, otherwise PowerBASIC may pull in the entire PBASMLIB library,
making your programs larger than necessary. If you use an earlier version
of PowerBASIC, eliminate the $INCLUDE "PBASMLIB.INC" in your programs, and
use cut and paste to cut the DECLAREs for routines you need out of the
PBASMLIB.INC file and paste them into your programs.
You are now ready to try the demo programs included with PBASMLIB. As of
this version, most of the demos are for the SOUND (Soundblaster) module.
If you don't have a Soundblaster card, you can't use these demo programs.
A .DOC file for each module in PBASMLIB is included (XXXXX.DOC) that details
the routines available in each module. Also, please read PBASMLIB.DOC for
further information on PBASMLIB as a whole.