Boston 2

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

/ Boston 2 / boston-2.iso / DOS / PROGRAM / C / WINCLIP / README < prev next >

Wrap

Text File | 1993-12-01 | 18.9 KB | 545 lines

THE C WINDOW LIBRARY (c) Copyright P. A. McKenzie 1990 All Rights Reserved Version 1.01 Author: P.A. McKenzie CitySoft Software 100-3 Alcott Place Bronx, N.Y. 10475 Compuserve : [72537,17] Bix : "pmckenzie" CitySoft Software BBS : (212) 671 - 4379 (BBS operational on April 1st, 1991) The C Window Library Copyright 1990 P. A. Mckenzie. All Rights Reserved. PC-DOS, PC, PC XT, PC AT, and PS/2 are trademarks of IBM Corporation. MS-DOS, Microsoft C, and Quick C are trademarks of Microsoft Corporation. Turbo C and other mentioned Borland products are trademarks of Borland International Inc. Power C is a trademark of Mix Software. Zortech C++ is a trademark of Zortech Limited. Hercules is a trademark of the Hercules Corporation. 1-2-3 is a trademark of Lotus Development Corporation. DESQview is a trademark of Quarterdeck Office Systems. All others that have gone unmentioned are copyrights of their respective companies. INTRODUCTION TO THE C WINDOW LIBRARY Welcome to The C Window Library! The C Window Library is an add-on C library that will add powerful text windows, virtual window, menu, and other miscellaneous video goodies to your C programs. Included in the shareware package is a full 260+ page manual with descriptions of all functions and examples of every aspect of The C Window Library. Currently the library supports Microsoft, Quick, Turbo, Power C and Zortech C++. The C Window Library is written in 90% C, with the other 10% in assembly language. The goal of The C Window Library is to get the library up to par with the other expensive C libraries around, without draining your wallet. If you have used other shareware window libraries, you will be in for a pleasant surprise with The C Window Library. The features available with The C Window Library are very extensive, without locking you into rigid restrictions that other window libraries would give you. If you have downloaded this version of The C Window Library, you should have the following files: MSWINM.LIB -- Medium memory model version for Microsoft C 5.1 and above, and Quick C Version 1.0 and above. PCWINM.MIX -- Medium memory model version for Power C Version 2.0 and above. TCWINM.LIB -- Medium memory model version for Turbo C Version 2.0 and above or Turbo C++ Version 1.0 and above. ZCWINM.LIB -- Medium memory model version for Zortech C++ Version 2.0 and above. BSTRING.H ----\ CURSOR.H \ EFFECTS.H \ KEY.H \ KEYCODES.H \ MENU.H \ MISC.H \ Various header files. PROTO.H / USCORE.H / VIDSYS.H / WERROR.H / WINDOW.H / WSTRUCT.H ----/ MANUAL.DOC -- Manual for The C Window Library. BREAKUP.EXE -- Program that breaks the MANUAL.DOC into separate components. README -- This file. UPDATE.DOC -- Last minute changes to The C Window Library that did not make it into the manual. WHATSNEW -- Differences between current version of The C Window Library and previous versions. EXAMPLES.ZIP -- Examples from The C Window Library manual. DEMO.EXE -- Demo of The C Window Library (self-extracting). DEMO.C -- Source Code to DEMO.EXE MENUDEMO.EXE -- Demo of menu functions. MENUDEMO.C -- Source code to MENUDEMO.EXE If you have registered version of The C Window Library, these are the other files that will be given to you: MSWINS.LIB -- Small Memory Model for Microsoft and Quick C. MSWINM.LIB -- Medium Memory Model for Microsoft and Quick C. MSWINC.LIB -- Compact Memory Model for Microsoft and Quick C. MSWINL.LIB -- Large Memory Model for Microsoft and Quick C. TCWINS.LIB -- Small Memory Model for Turbo C. TCWINM.LIB -- Medium Memory Model for Turbo C. TCWINC.LIB -- Compact Memory Model for Turbo C. TCWINL.LIB -- Large Memory Model for Turbo C. PCWINS.MIX -- Small Memory model for Power C. PCWINM.MIX -- Medium memory model for Power C. PCWINL.MIX -- large memory model for Power C. ZCWINS.LIB -- Small Memory Model for Zortech C++. ZCWINM.LIB -- Medium Memory Model for Zortech C++. ZCWINC.LIB -- Compact Memory Model for Zortech C++. ZCWINL.LIB -- Large Memory Model for Zortech C++. SOURCE.ZIP -- Source code to The C Window Library in ZIPped format. REGISTRATION INFORMATION When you register your version of The C Window Library, you will receive a free update to the next major revision of The C Window Library. If you have paid the $45 registration fee, you will also receive the full source code to The C Window Library, plus all the library models. Since there are slight changes in the source code due to bug fixes, minor enhancements, etc., customers who have paid the $45 registration fee will receive updated source code no more than four times per calendar year. However, any major revision done to The C Window Library will entitle registered users to the source code immediately. Remember that the shareware version of the library IS NOT CRIPPLED. You can create real applications right away with the shareware version, and you get the full documentation. Therefore I am trusting you (the user) to send in the registration fee (see below for a description of shareware and what the responsibilities of the user of shareware products are). I am sure that you want to reward fellow programmers on what they have developed. The next version of the library (version 2.0) will include mouse support, expanded memory functions, and enhancements that will be suggested by the users out there. There are also third party developers who are creating data entry forms and code generators for The C Window Library. Watch out for these products in the future. Here is the enclosed order form to use when registering for The C Window Library: THE C WINDOW LIBRARY ORDER FORM Enclosed is $45 (check or money order) to register The C Window Library Version 1.01 Name: ______________________________________________________________ Address ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ Phone _____________ Compuserve ID _________ BIX Name ___________ Where You Received The C Window Library (circle one): Bulletin Board (Give Name) _________________________________________ Friend Other (Please explain) _______________________________________ Disk Size (Circle One): Size Capacity ---- -------- a) 5 1/4" 360K b) 5 1/4" 1.2M c) 3 1/2" 720K d) 3 1/2" 1.44M TECHNICAL SUPPORT Technical support is provided for registered as well as non-registered users of The C Window Library. Since The C Window Library is currently a shareware product, technical support will be provided for persons who are in the evaluation stages of the product. However, for any questions concerning internals of The C Window Library where the source code must be present to such persons asking technical assistance, only registered users will get technical support. You can get technical support in four ways: 1) E-Mail to Compuserve [72537,17] 2) E-Mail on BIX (Byte Information Exchange) to "pmckenzie" 3) E-Mail to the CitySoft Software bulletin board. The phone number is (212) 671 - 4379. 4) by mail Responses to questions on BIX or CompuServe will be done on a daily basis. If responding by Compuserve, or BIX, leave your name, registration number if necessary, compiler and version, version of The C Window Library, and Compuserve or BIX number. If responding by mail, please leave name, registration number if necessary, compiler and version, the version of The C Window Library, and a phone number where you can be reached during the times of 10:00 AM and 6:00 PM Eastern Time. You can also log into the CitySoft Software BBS at (212) 671 - 4379. You will have immediate access to the newest shareware version of the library. If you register your shareware version, you will be given access to download the registered version of the library. You should log on using the following parameters: a) 1200 or 2400 baud b) 8 data bits c) 1 stop bits d) no parity DEFINITION OF SHAREWARE Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you can continue using the software, full source code to the C Window Library, and free upgrades. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. DISCLAIMER - AGREEMENT Users of The C Window Library must accept this disclaimer of warranty: "The C Window Library is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or conse- quential, which may result from the use of The C Window Library." The C Window Library is a "shareware program" and is provided at no charge to the user for evaluation. Feel free to share it with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using The C Window Library and continue to use The C Window Library after a reasonable trial period, you must make a registration payment of $45 to CitySoft Software. The $45 registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Commercial users of The C Window Library must register and pay for their copies of The C Window Library within 30 days of first use or their license is withdrawn. Site-License arrangements may be made by contacting CitySoft Software. Anyone distributing The C Window Library for any kind of remuneration must first contact CitySoft Software at the address above for authorization. This authorization will be automatically granted to distributors recognized by the (ASP) as adhering to its guidelines for shareware distributors, and such distributors may begin offering The C Window Library immediately (However CitySoft Software must still be advised so that the distributor can be kept up-to-date with the latest version of The C Window Library.). You are encouraged to pass a copy of The C Window Library along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. All registered users will receive a copy of the latest version of the The C Window Library system. USING THE C WINDOW LIBRARY If you are not familiar with using third party libraries and how to link the library with the rest of your code, please consult the various documentation supplied with the compiler that you are working with. This is not a full tutorial on how to link third party libraries. Microsoft / Quick C ------------------- When compiling your programs, you must make sure that the constant MSC is defined. An example of how you would do this as follows: cl -Ax -DMSC -Ihfiles prog1.c prog2.c /link mswinx.lib the -Ax is the model used for compilation. The x stands for either S for small, M for medium, C for compact, or L for large. The -D option defines a constant, which in this case is MSC. You must use the -D switch with MSC as the constant. If not, you will get either syntax errors, link errors, or runtime errors. The -I option tells the compiler that the .h files are located in a directory on the default drive called hfiles. The /link option links the resulting object files (prog1.obj and prog2.obj) with the The C Window Library file mswinx.lib, where x stands for S, M, C, or L. The other method is to create a make file. If you are using the integrated environment of Quick C or using the Programmers Work Bench (PWB) for Microsoft C 6.0, you can create your make files by selecting the files you want to compile, and the libraries you want to link with and letting these integrated environments create the make file automatically. If you are more advanced you can create your make files by yourself without the aid of these programs. Consult the documentation for more information on make files. Turbo C and TurboC++ -------------------- If you will use the integrated environment, you must create a project file. This project file specifies the source code modules, object code modules, and libraries that will be linked in to produce an executable file. If you use the Turbo C Ver 2.0 integrated environment, you must edit this file yourself. If you use the Turbo C++ integrated environment, use the automatic Project File creator. You can also use make files to link in your program. Make sure that the desired library from The C Window Toolkit is specified. You can also use the TCC.EXE command line compiler with the desired library specified on the command line. Consult the Turbo C documentation on using make files and using the integrated environment. An example of using the TCC.EXE command line is a s follows: tcc -mm -G -r -ihfiles prog1.c tcwinm.lib The following command line uses -mm for the small memory model, -G to optimize for speed, -r for usage of register variables, and -i to tell the compiler that the header files are located in a directory on the default drive called hfiles. Power C ------- If you are using the POWER C compiler from Mix Software, you must define the constant POWERC on the command line. pc -dPOWERC -mm -ihfiles prog1.c You must have the constant POWERC defined on the pc.exe command line using the -d option. If not, you may get syntax, link, or runtime errors. The -mm tells the compiler to use the medium memory model, and the -i option tells the compiler that there are .h files located on the default drive in the directory hfiles. Depending on the number of windows your application will use and the code size, you will have to use different stack and heap options in the Power C linker, pcl. An example of this is as follows: pcl [20k,30k,200k] a;pcwinm This will link the object file a.mix with the pcwinm.mix library with 20k of stack space, 30k of near heap space, and 200k of far heap space. If your application has many or very large virtual windows, you should use the maximum far heap space allowable. If your program has many windows, you should increase the near heap space parameter, or use the pcwinl.mix library and increase the far heap space parameter. If your program has recursive or deeply nested functions, you should increase the stack parameter. However the stack and near heap space cannot exceed 64k. This includes global and static declarations in the program. Zortech C++ ----------- If you are using the Zortech C++ compiler, you should use the following options when compiling your program with The C Window Library: ztc -o -b -p -mm prog1.c zcwinm.lib The -o option turns on the global optimizer. The -b option lets ztc know to handle large programs. The -p turns off autoprotyping. The -mm option lets the compiler use the medium memory model. The programs prog1.c is compiled using these options and then linked with the medium memory model of The C Window Library's Zortech version, namely zcwinm.lib You can also use make files. Please consult the Zortech compiler reference for further examples.