CD Actual 15

home *** CD-ROM | disk | FTP | other *** search

/ CD Actual 15 / CDACTUAL15.iso / cdactual / program / basic / QBA201.ZIP / README!.DOC < prev

Wrap

Text File | 1993-04-13 | 20.3 KB | 382 lines

QBA_201.ZIP QBAccel 2.01 Shareware Version PLEASE NOTE: References made to software and/or files not inclusive of the shareware version of this product (QBA_201.ZIP, compressed form) are bundled with the REGISTERED copy. The shareware version is intentionally sparse yet is fully functional. Programs may be compiled with all features available in the registerd version. Missing from the public domain copy (shareware version) are such items as the complete, printable user manual, all object files of all routines for the creation of "custom" libraries, and much more. You are requested to use the shareware version for no more than 30 days. Please, if by that time you are continuing to make use of QBAccel then obviously you are enjoying its benefits and should pay the minimal registration fee to obtain a legal, licensed copy, together with all the files and demos missing in this shareware version. Thank you. Please read on... S c i e n t i f i c E n g i n e s(TM) QQQQQQQQQQQQ BBBBBBBBB AAAAAA CCCCCCCCCC CCCCCCCCCC EEEEEEEEE LLL (TM) QQQ QQQ BBB BBB AA AA CCC CCC CCC CCC EEE LLL QQQ QQQ BBB BBB AAA AAA CCC CCC EEE LLL QQQ QQQ BBBBBBBBBB AAAAAAAAAA CCC CCC EEEEEEE LLL QQQ QQQ BBB BBB AAA AAA CCC CCC EEE LLL QQQ QQQQQQ BBB BBB AAA AAA CCC CCC CCC CCC EEE LLL QQQQQQQQQQQQ BBBBBBBBBB AAA AAA CCCCCCCCCC CCCCCCCCCC EEEEEEEEE LLLLLLLLL QQQ QBAccel rel 2.01 ***************************************************************** * COPYRIGHT(c)1993 Crady vonPawlak * * Worldwide Rights Reserved * ***************************************************************** Royalty free! QBAccel is a collection of powerful routines designed specifically for use in the Microsoft(TM) QuickBASIC(TM) 4.5+ programming environment. This library allows you, the software developer, to put more utility and power into your BASIC programs than you may have thought possible. MANUAL.DOC is the extensive user's guide of the functions within QBAccel. Please read each section thoroughly before programming with this library. Although simple to use, an understanding of the calling protocols here will save a great deal of "trial-and-error" frustration later on. Also, please read the MOUSEMAN.COM mouse usage manual and, consult your QBasic "Learning and Using" guide for in-depth information on library usage and inclusion. Some of the features within QBAccel ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * Easy to use one-line commands. * Access to extended VGA screen modes not supported by QuickBASIC(TM) 4.5+ * Advanced text WINDOWING with features and options not found in most libraries (including advanced libraries for `C' and PASCAL!). * Text screen ANIMATION of characters and special effects like true scrolling and text colors far beyond those available using QuickBASIC alone. * Low level DOS and BIOS functions for more complete system control. * Ultra fast text-to-screen PRINTING significantly speeds program execution. * Full support of MOUSE function calls including cursor programming. * Advanced binary and hexadecimal MATH functions for bit-by-bit manipulation. * Pop-up calendars and more! Dear Programmer, The file: MANUAL.DOC, is the "entire" QBAccel manual (both user guides) in a combined ASCII file which can be sent directly to any printer. This file has a large left margin when printed to allow 3-hole punching for placement in a notebook. Suggestion: copy the pages (after printing) onto quality "bond" paper stock first via laser printer, and then add to your notebook. If you will be using a laser printer, you may need to select a font slightly smaller than the default point-size normally associated with most laser printers. Formatting is for 8 1/2 x 11-inch stock. Re-formatting will be necessary if A4-size paper is used. R e v i s i o n s CHANGES FROM rel 1.10 and 1.52 Functions GOWINDOW and GrOWINDOW each have two(2) new additional variables. These have been added to the rightmost end of the calling parameter(s) line to allow for easy editing of pre-existing programs using these functions. For an in-depth explanation see ACCEL.COM under GoWINDOW. The new variables are explained at the end of the variables/functions listing. I think you will find the additions make your window possibilities far more versatile! Former copies of the ACCEL.COM and ACCELman.COM manuals showed the parameters for the function GETCHAR in error. This has been corrected. There are in fact three(3) parameters that must be passed to GETCHAR. My apologies. Changes have also been made to: CGASCREEN, EGASCREEN, and MCGASCREEN. See: CALL EGASCREEN in the accel.com documentation for details on these changes. Function HEX2DEC now supports values to: FFFFFFh (16777215d decimal). CHANGES FROM rel 1.52 to 1.53: Printable user manual added: MANUAL.DOC is an ASCII file that will print cleanly to any IBM(TM) compatible printer. A wide left-hand margin is pro- vided for 3-hole punching. Also, additional programming examples have been included for clarification of QBAccel usage. CALLs GoWindow and GroWindow: The shadow function in GOWINDOW and GROWINDOW has an additional parameter. Before, this variable was: 0 = no shadow, 1 = shadow. By setting the shadow to 2, a "light" colored shadow is created (1 = "dark" shadows). CHANGES FROM rel 1.53 to 2.00+ New function: CALL BRICKS for text screens has been added to the library. This function is demonstrated in the sample program: DEMOWIND.BAS/.COM. BRICKS allows creation of a "brick wall" in any 80-column text screen and is a great backdrop for shadowed windows (similar to FASTFLOOD). New function: CALL CURTAINS parts the text screen like a "curtain" revealing the contents of screen page 1-7 (depending upon display adapter). A great replacement for QuickBASIC PCOPY! New function: CALL CALENDAR returns valuable information about a specified month and year. See CALDEMO.BAS program for example of how you can create professional looking pop-up calendars with a real-time digital clock. New function: CALL DOSLINE returns any "switches" from the DOS command line. The number of switches returned can range from 0-6. The number of spaces be- tween switches can be any value from 1-n. An enhancement to the QB function: COMMAND$. All switches are returned as STRINGs. This function takes all the guesswork and tedium out of de-coding the COMMAND$. Allows your executable programs the facility of DOS command line options when launched. Changes to CALLs GoWindow and GroWindow: The method by which color is established in a window interior has been improved. Although there is absolutely no visible difference between new windows and previous revisions, the new method employed allows characters from CALLs; RAIN and STACK to remain visible should their path cross a blank region within a window. The old method essentially "turned off" these characters until they either passed over another character, or exited the window interior. A bug in CALL PushATKey is fixed and the manual(s) updated accordingly. Bugs in GETCHAR and CURSOR have also been fixed. Changes to CALL CURSOR: A new variable has been added. Page%, allows you to set the text cursor in any available screen page, visible or not. Changes to CALLs STACK and RAIN: Originally these text "animation" functions allowed text characters to glide across the text screen to their destinations without disturbing any text in their path. This has not changed. However, moving characters now assume the "colors" they pass over until they come to rest; at which time they are displayed in the color passed at the time the CALL was made. This feature lends a much more professional look than was originally available. Tip: When using these functions please follow these suggestions: When establishing the color of the text screen, set the text "color" to one other than the background color even if you do not use the PRINT statement. Example: COLOR 15, 1:CLS creates a blue screen background, and any text PRINTed (no effect with PENCIL or ZIPRINT) will be white. Use this method. COLOR 1, 1:CLS creates a blue screen background however, all text PRINTed will be invisible because the text attribute is also blue. If a CALL is now made to STACK or RAIN, the moving characters will be invisible each time they cross a blank area on the screen. Do NOT use this method. Also, if you use ZIPRINT to paint a blank region on the screen (in below example: a "blue bar") be sure to set the text attribute to a value that will "contrast" with the blank region, even if no characters are passed. The color formula for ZIPRINT is: (16 * BackgroundColor) + ForegroundColor. For blue text on a blue field (invisible) use: (16 * 1) + 1 = 17. For white text on a blue field (readable) use: (16 * 1) + 15 = 31. Example: CALL ZiPrint(" ", 17) prints a blue bar on the screen. The text attribute here matches the background (both blue) so, if characters from RAIN or STACK pass through this "bar", they will be momentarily invisible. Do not use this method. CALL ZiPrint(" ", 31) prints a blue bar exactly like the above example except; the text attribute is now "white". Any characters which RAIN or STACK now pass through this region will appear white. Use this method. USER MANUAL: The user's manual for QBAccel is constantly edited and is therefore in a state of perpetual change. Corrections in spelling, syntax and notes on CALLs are always popping up. If you find any errors in the QBAccel documentation, please make a note of the error(s) and pass it on to the address below. Suggestions for ways of improving this software are always welcome. HOW TO REGISTER: To receive a registered copy of QBAccel (includes .LIB/.OBJ/.QLB files) and its related manuals, demos (in .BAS form), and tools; send US$25.00 plus US$10.00 S/H (US$35.00 total) together with a blank, freshly formatted 5.25-inch or 3.5-inch flopply diskette (format with DOS 3.xx or later) to the address below. Sorry, no personal checks. Please do NOT mail cash. Foreign orders: Please do NOT use stamps when posting if it can be avoided. Have your local telecoms or post office apply metered postage as stamp collecting thieves may intercept your mail! Although it is quite rare for this to occur, I have experienced this misfortune in the past. Payment: Use money orders, cashier's checks, or if foreign order; a bank draft. Payment may be made out to: Crady Pawlak. No personal checks, please. Remember, funds sent must be bankable in Asia. Please check with your U.S. bank or (foreign telecoms office) prior to mailing. Thank you. Caveats: If you have written programs using the QBHyper library and experience prob- lems with QBAccel using the same "CALLS", consult the ACCEL.COM manual to ensure proper calling conventions and variable usage. There are changes! Please feel free to upload the QBA_*.ZIP file(s) on this disk to your local BBS. H o w * T o * O r d e r Send US$35.00 (total) to: Crady vonPawlak QBAccel Registration 1010 Park Drive Everett, WA 98203 U.S.A FAX: (206) 355 4478 As mail may be forwarded to Southeast Asia, please allow 2-6 weeks for delivery. Orders are shipped within 3-days of acceptance of payment by bank(s). Disks are shipped to you via Air Mail. IMPORTANT!! For REGISTERED users... All documentation and software COPYRIGHT(c) 1993 Crady vonPawlak, All rights reserved. SOURCE.ZIP contains "ALL" reserved .OBJ files for QBAccel. When linking these individually you may get the message: "duplicate definition ignored". You should "ignore" it. As some CALLs make their own CALLs to other functions, function duplication during a LINK is possible, and harmless. Only one (1) of each function is actually included in the final library. This is why some functions cannot be directly extracted from the QBAccel main library and are thus marked RESERVED. These functions are contained in the SOURCE.ZIP List of files sent to REGISTERD users as of April, 1993. CALDEMO BAS Demo/tutor. Pop-up calendars. CURTDEMO BAS Demo/tutor. Demonstartes CALL CURTAINS. DEMOWIND BAS Demo/tutor. Revised demonstration program of some of the more dramatic text functions available in QBAccel. DIRDEMO BAS Demo/tutor. Scrolling directory. Demo CALL SCROLLUP & DN. QWIKTIFF BAS Demo/tool/tutor. Fast 320x200x256 VGA TIFF-file generation. TIFF13H BAS Demo/tool/tutor. Universal TIFF file creation. Can be modified to accommodate SVGA screens (640x480x256+). TIFFCALC BAS Demo/tool/tutor. TIFF calculator/BINARY conv./HEX conv. TIFF Files created with QWIKTIFF can be viewed and edited with any commercial software package supporting the TIFF graphics format. QBA BAT QBAccel quick-start batch. Should be copied to your MS QuickBASIC directory. ACCEL COM ON-screen manual. Additional information in MOUSEMAN.COM MOUSEMAN COM On-screen mouse function manual. Includes an assembler- to-QuickBASIC tutor, and COM port CALLs. QBA_TSR COM TSR version of ACCEL.COM. Permits veiwing the QBAccel quick-reference without leaving the QuickBASIC environment via a "hot key." MANUAL DOC Complete QBAccel manual in formatted ASCII for printing a hardcopy user's guide. Latest revision is shipped. This document contains over 50 pages, and is in a semi-tutorial format. Please note that document is intended to printed on 8 1/2 x 11-inch paper. If A4-size paper is used then re- formatting in a suitable word-processor is advised. README! DOC This, or similar document. QBACCEL LIB QBAccel LIBrary file. QBACCEL OBJ QBAccel OBJect file. QBACCEL QLB QBAccel Quick-library for loading into QB editor. These 3 files (QBACCEL.*) should be copied to your MS QuickBASAIC directory. \QBA_FREE\*.* Shareware files. Please distribute freely. Thank you! \OBJFILES\*.* ALL QBAccel functions in OBJect files for "custom" library creation (70 or more .OBJ files included!). The contents of this sub-directory is inclusive of the file: SOURCE.ZIP which is within the file: REGISTER.ZIP. REGISTER.ZIP is the entire registered version compressed into one file for distribution on low-density diskettes. Note: Files may be added or deleted, to-and-from the above list without prior notification. System BIOS Disk I/O Error Codes -----------+--------------------------+------------+--------------------------- Error Code | Meaning | Error Code | Meaning -----------+--------------------------+------------+--------------------------- 0 No error 13 Invalid number of sectors on format (H) 1 Invalid command 14 Control data address mark detected (H) 2 Address mark not found 15 DMA arbitration level out of range (H) 3 Disk write-protected (F) 16 Uncorrectable CRC or ECC data error 4 Sector not found 17 ECC corrected data error (H) 5 Reset failed (H) 32 Controller failed 6 Floppy disk removed (F) 64 Seek failed 7 Bad parameter table (H) 128 Disk timed-out. Failure to respond 8 DMA overrun (F) 170 Drive not ready (H) 9 DMA crossed 64K boundary 187 Undefined error (H) 10 Bad sector flag (H) 204 Write fault (H) 11 Bad track flag (H) 224 Status register error (H) 12 Media type not found (F) 255 Sense operation failed (H) ------------------------------------------------------------------------------ (F) Indicates floppy disk related error only (H) Indicates hard/fixed disk related error only NOTE: The DOS error table above may be used with; CALL TESTDRIVE. ------------------------------------------------------------------------------ DISCLAIMER OF SOFTWARE WARRANTY This software (including instructions for its use) is provided "as- is" without warranty of any kind. Further, the retailer and the author do not warrant, guarantee, or make any representations regarding the use, or the results of the use, of the software or written materials concerning the software in terms of correctness, accuracy, reliability, currentness, or otherwise. The entire risk as to the results and performance of the software is assumed by you. If the software or written materials are defective, you, and not the author, the retailer, nor any persons or agencies in any way affiliated with this product in any form, assume the entire cost of all necessary servicing, repair or correction. Further, neither the author nor the retailer nor anyone else who has been involved in the creation, production, or delivery of this software shall be liable for any direct, indirect, consequential, or incidental damages (including damages for loss of business profits, business interruption, loss of business information, and such) arising from the use of or inability to use such software even if the author or retailer has been advised of the possibility of such damages. Registered users of this software are granted license of its use under U.S. and international copyright law. No royalties are requested. This applies to: One registered user-per-copy only! Site license and multi- user agreements are not available. You are not and cannot be given permission to use the tradenames under which this product is distributed for the means of alluding to any affiliation with products created by the use of this software. End document.