___________________________________________________________________ SG C Tools 1.0 (C) 1993 Steve Goldsmith All Rights Reserved ___________________________________________________________________ * NOTICE THIS IS NOT FREE SOFTWARE! If you paid a public domain vendor or communications service for this product, you paid for the service of copying or transferring the product, and not for the product itself. I guarantee you that nothing ever gets to the originator of this product from such a sale. You may evaluate this product, but if you make use of it, you must register your copy. I offer several incentives for you to register. First of all, you receive the most up-to-date copy that I have which is updated on a regular basis. Future unregistered releases will not include most source code and/or object files. Support via GEnie, mail or phone from the author. Price is subject to change as more modules are added. * REGISTRATION INFORMATION The non-commercial registration fee for SG C Tools 1.0 is $5.00 plus $3.00 for shipping in US funds. Send a check or money order for the appropriate amount to: Steve Goldsmith 2805 Jamaica Street Sarasota, FL 34231 Please indicate what product you are ordering and if you have a requirement for 3.5" media. I normally ship 5.25" Commodore GCR format diskettes, but will furnish 3.5" media upon request. Customers outside of the United States and Canada should include an extra $5.00 for airmail. If you are a registered user of this product and desire an update, please contact me for upgrade prices. * DISTRIBUTION NOTICE This is "user-supported" software. You are hereby granted a license by Steve Goldsmith to distribute this evaluation copy of SG C Tools and its documentation, subject to the following conditions: 1. SG C Tools may be distributed freely without charge in evaluation form only. 2. SG C Tools may not be sold, licensed, or a fee charged for its use. If a fee is charged in connection with SG C Tools, it must cover the cost of copying or dissemination only. Such charges must be clearly identified as such by the originating party. Under no circumstances may the purchaser be given the impression that he is buying SG C Tools itself. 3. SG C Tools must be presented as a complete unit, including this documentation. Neither SG C Tools nor its documentation may be amended or altered in any way. 4. By granting you the right to distribute the evaluation form of SG C Tools, you do not become the owner of SG C Tools in any form. Any other use, distribution or representation of SG C Tools is expressly forbidden without the written consent of Steve Goldsmith. Commodore 128 is a trademark of Commodore Business Machines. CP/M and CP/M 3.0 are trademarks of Digital Research. MS-DOS is a trademark of Microsoft. IBM PC, PC-XT and PC-AT are trademarks of International Business Machines. * OVERVIEW SG C Tools provides a set of high level ANSI C modules to unlock the power of the C128 running CP/M. With a little modification it should compile with a native mode ANSI C compiler too! The first module provides lightning fast VDC functions for fills, copies, string output 9 times faster than puts(), page flipping, etc. This puts you in complete control of the VDC! Future releases will include more VDC functions, custom fonts, bit mapped graphics, SID sound and much more. If you have seen any of my Pascal code you know I like cutting edge stuff. After all, I was the first to produce .PCX graphics viewers, 4 bit digitized sound, multimedia etc. on the C128 in CP/M mode! * REQUIREMENTS + A C128 or C128D running CP/M 3.0 or a IBM PC running a CP/M emulator. + At least one 1581, two 1571s, large RAM disk or hard drive to compile on a C128. + 40 or 80 column monitor * COMPILING SOURCE CODE WITH HI-TECH C 3.09 First you will need to have a copy of HI-TECH C 3.09 (CP/M-80). You can download the following Freeware files from GEnie's CP/M RT (M685;3) or other source: 8149 LIBSRC.LZH X BRIAN-CPM 930616 80384 39 3 Desc: Source Code to Hitech C library 8148 Z80V309.LZH X BRIAN-CPM 930616 194304 51 3 Desc: Hitech C Compiler for CP/M 8147 Z80DOC.LZH X BRIAN-CPM 930616 89088 55 3 Desc: Documentation for Hitech C compiler You should look over HI-TECH C's manual and compile a simple "hello world" program before proceeding. I installed all the compiler related files on my 1581. My source and header files are on a 1571. You could get away with two 1571s, but a RAM disk or hard drive would be better. You could also use a CP/M-80 emulator on the IBM PC and copy compiled files to C128 for testing. The examples I give assume all files are on same drive. To compile the VDC.C module use: C -C -O -X VDC.C To compile sample programs use: C -O -X FILENAME.C VDC.OBJ You may want to leave to -O (optimize) and -X (strip local symbols) off until code is debugged and ready for release. This will improve compile time. Each module and program contains a generous of comments, so I will not waste time explaining it here. The best way to get a feel for SG C Tools is to experiment with the VDC module. * HOW TO CONTACT ME Please report any support questions (for registered users only), problems, suggestions, etc. to me via GEnie as S.GOLDSMITH2, voice phone (813) 925-1064 or mail to: Steve Goldsmith 2805 Jamaica Street Sarasota, FL 34231