home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / PROGRAM / C / WINCLIP / README < prev    next >
Text File  |  1993-12-01  |  19KB  |  545 lines
  1.                           THE C WINDOW LIBRARY
  2.  
  3.  
  4.                     (c) Copyright P. A. McKenzie 1990
  5.                             All Rights Reserved
  6.  
  7.  
  8.                               Version 1.01
  9.  
  10.  
  11.  
  12.  
  13.               Author:            P.A. McKenzie
  14.                                  CitySoft Software
  15.                                  100-3 Alcott Place
  16.                                  Bronx, N.Y. 10475
  17.  
  18.               Compuserve            : [72537,17]
  19.  
  20.               Bix                   : "pmckenzie"
  21.  
  22.               CitySoft Software BBS : (212) 671 - 4379
  23.               (BBS operational on April 1st, 1991)
  24.  
  25.  
  26.   The C Window Library Copyright 1990 P. A. Mckenzie.  All Rights Reserved.
  27.  
  28.    PC-DOS, PC, PC XT, PC AT, and PS/2 are trademarks of IBM
  29.    Corporation.
  30.    MS-DOS, Microsoft C, and Quick C are trademarks of Microsoft Corporation.
  31.    Turbo C and other mentioned Borland products are trademarks of Borland
  32.    International Inc.
  33.    Power C is a trademark of Mix Software.
  34.    Zortech C++ is a trademark of Zortech Limited.
  35.    Hercules is a trademark of the Hercules Corporation.
  36.    1-2-3 is a trademark of Lotus Development Corporation.
  37.    DESQview is a trademark of Quarterdeck Office Systems.
  38.  
  39.    All others that have gone unmentioned are copyrights of their respective
  40.    companies.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                      INTRODUCTION TO THE C WINDOW LIBRARY
  70.  
  71.   Welcome to The C Window Library!  The C Window Library is an add-on C library
  72.   that will add powerful text windows, virtual window, menu, and other
  73.   miscellaneous video goodies to your C programs.  Included in the
  74.   shareware package is a full 260+ page manual with descriptions of all
  75.   functions and examples of every aspect of The C Window Library.  Currently
  76.   the library supports Microsoft, Quick, Turbo, Power C and Zortech C++.  The C
  77.   Window Library is written in 90% C, with the other 10% in assembly language.
  78.  
  79.   The goal of The C Window Library is to get the library up to par with the
  80.   other expensive C libraries around, without draining your wallet.  If you have
  81.   used other shareware window libraries, you will be in for a pleasant surprise
  82.   with The C Window Library.  The features available with The C Window Library
  83.   are very extensive, without locking you into rigid restrictions that other
  84.   window libraries would give you.
  85.  
  86.   If you have downloaded this version of The C Window Library, you should have
  87.   the following files:
  88.  
  89.      MSWINM.LIB -- Medium memory model version for Microsoft C 5.1 and above,
  90.                    and Quick C Version 1.0 and above.
  91.  
  92.      PCWINM.MIX -- Medium memory model version for Power C Version 2.0 and
  93.                    above.
  94.  
  95.      TCWINM.LIB -- Medium memory model version for Turbo C Version 2.0 and
  96.                    above or Turbo C++ Version 1.0 and above.
  97.  
  98.      ZCWINM.LIB -- Medium memory model version for Zortech C++ Version 2.0 and
  99.                    above.
  100.  
  101.  
  102.      BSTRING.H  ----\
  103.      CURSOR.H        \
  104.      EFFECTS.H        \
  105.      KEY.H             \
  106.      KEYCODES.H         \
  107.      MENU.H              \
  108.      MISC.H               \   Various header files.
  109.      PROTO.H              /
  110.      USCORE.H            /
  111.      VIDSYS.H           /
  112.      WERROR.H          /
  113.      WINDOW.H         /
  114.      WSTRUCT.H   ----/
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.      MANUAL.DOC -- Manual for The C Window Library.
  126.  
  127.      BREAKUP.EXE -- Program that breaks the MANUAL.DOC into separate components.
  128.  
  129.      README     -- This file.
  130.  
  131.      UPDATE.DOC -- Last minute changes to The C Window Library that did not
  132.                    make it into the manual.
  133.  
  134.      WHATSNEW   -- Differences between current version of The C Window Library
  135.                    and previous versions.
  136.  
  137.      EXAMPLES.ZIP -- Examples from The C Window Library manual.
  138.  
  139.      DEMO.EXE    -- Demo of The C Window Library (self-extracting).
  140.  
  141.      DEMO.C       -- Source Code to DEMO.EXE
  142.  
  143.      MENUDEMO.EXE -- Demo of menu functions.
  144.  
  145.      MENUDEMO.C   -- Source code to MENUDEMO.EXE
  146.  
  147.   If you have registered version of The C Window Library, these are the other
  148.   files that will be given to you:
  149.  
  150.         MSWINS.LIB -- Small Memory Model for Microsoft and Quick C.
  151.         MSWINM.LIB -- Medium Memory Model for Microsoft and Quick C.
  152.         MSWINC.LIB -- Compact Memory Model for Microsoft and Quick C.
  153.         MSWINL.LIB -- Large Memory Model for Microsoft and Quick C.
  154.  
  155.         TCWINS.LIB -- Small Memory Model for Turbo C.
  156.         TCWINM.LIB -- Medium Memory Model for Turbo C.
  157.         TCWINC.LIB -- Compact Memory Model for Turbo C.
  158.         TCWINL.LIB -- Large Memory Model for Turbo C.
  159.  
  160.         PCWINS.MIX -- Small Memory model for Power C.
  161.         PCWINM.MIX -- Medium memory model for Power C.
  162.         PCWINL.MIX -- large memory model for Power C.
  163.  
  164.         ZCWINS.LIB -- Small Memory Model for Zortech C++.
  165.         ZCWINM.LIB -- Medium Memory Model for Zortech C++.
  166.         ZCWINC.LIB -- Compact Memory Model for Zortech C++.
  167.         ZCWINL.LIB -- Large Memory Model for Zortech C++.
  168.  
  169.         SOURCE.ZIP -- Source code to The C Window Library in ZIPped format.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.                            REGISTRATION INFORMATION
  188.  
  189.   When you register your version of The C Window Library, you will receive a
  190.   free update to the next major revision of The C Window Library.  If you have
  191.   paid the $45 registration fee, you will also receive the full source code to
  192.   The C Window Library, plus all the library models.
  193.  
  194.   Since there are slight changes in the source code due to bug fixes, minor
  195.   enhancements, etc., customers who have paid the $45 registration fee will
  196.   receive updated source code no more than four times per calendar year.
  197.   However, any major revision done to The C Window Library will entitle
  198.   registered users to the source code immediately.
  199.  
  200.   Remember that the shareware version of the library IS NOT CRIPPLED.  You can
  201.   create real applications right away with the shareware version, and you get
  202.   the full documentation.  Therefore I am trusting you (the user) to send in
  203.   the registration fee (see below for a description of shareware and what the
  204.   responsibilities of the user of shareware products are).  I am sure that you
  205.   want to reward fellow programmers on what they have developed.
  206.  
  207.   The next version of the library (version 2.0) will include mouse support,
  208.   expanded memory functions, and enhancements that will be suggested by the
  209.   users out there.  There are also third party developers who are creating data
  210.   entry forms and code generators for The C Window Library.  Watch out for
  211.   these products in the future.
  212.  
  213.   Here is the enclosed order form to use when registering for The C Window
  214.   Library:
  215.  
  216.                         THE C WINDOW LIBRARY ORDER FORM
  217.  
  218.  
  219.     Enclosed is $45 (check or money order) to register The C Window Library
  220.     Version 1.01
  221.  
  222.     Name:   ______________________________________________________________
  223.  
  224.     Address ______________________________________________________________
  225.  
  226.             ______________________________________________________________
  227.  
  228.             ______________________________________________________________
  229.  
  230.             ______________________________________________________________
  231.  
  232.     Phone   _____________    Compuserve ID _________  BIX Name ___________
  233.  
  234.  
  235.  
  236.     Where You Received The C Window Library (circle one):
  237.  
  238.       Bulletin Board (Give Name) _________________________________________
  239.  
  240.  
  241.             Friend
  242.  
  243.  
  244.             Other (Please explain) _______________________________________
  245.  
  246.  
  247.  
  248.     Disk Size (Circle One):   Size     Capacity
  249.                               ----     --------
  250.                          a)   5 1/4"    360K
  251.  
  252.  
  253.                          b)   5 1/4"    1.2M
  254.  
  255.  
  256.                          c)   3 1/2"    720K
  257.  
  258.  
  259.                          d)   3 1/2"    1.44M
  260.  
  261.  
  262.                            TECHNICAL SUPPORT
  263.  
  264.   Technical support is provided for registered as well as non-registered users
  265.   of The C Window Library.  Since The C Window Library is currently a shareware
  266.   product, technical support will be provided for persons who are in the
  267.   evaluation stages of the product.  However, for any questions concerning
  268.   internals of The C Window Library where the source code must be present to
  269.   such persons asking technical assistance, only registered users will get
  270.   technical support.
  271.  
  272.   You can get technical support in four ways:
  273.  
  274.   1) E-Mail to Compuserve [72537,17]
  275.  
  276.   2) E-Mail on BIX (Byte Information Exchange) to "pmckenzie"
  277.  
  278.   3) E-Mail to the CitySoft Software bulletin board.  The phone number is
  279.      (212) 671 - 4379.
  280.  
  281.   4) by mail
  282.  
  283.  
  284.   Responses to questions on BIX or CompuServe will be done on a daily basis.
  285.   If responding by Compuserve, or BIX, leave your name, registration number
  286.   if necessary, compiler and version, version of The C Window Library, and
  287.   Compuserve or BIX number.  If responding by mail, please leave name,
  288.   registration number if necessary, compiler and version, the version of The C
  289.   Window Library, and a phone number where you can be reached during the times
  290.   of 10:00 AM and 6:00 PM Eastern Time.
  291.  
  292.   You can also log into the CitySoft Software BBS at (212) 671 - 4379.  You will
  293.   have immediate access to the newest shareware version of the library.  If
  294.   you register your shareware version, you will be given access to download the
  295.   registered version of the library.  You should log on using the following
  296.   parameters:
  297.                a)   1200 or 2400 baud
  298.                b)   8 data bits
  299.                c)   1 stop bits
  300.                d)   no parity
  301.  
  302.  
  303.  
  304.  
  305.                             DEFINITION OF SHAREWARE
  306.  
  307.   Shareware distribution gives users a chance to try software before buying it.
  308.   If you try a Shareware program and continue using it, you are expected to
  309.   register.  Individual programs differ on details -- some request registration
  310.   while others require it, some specify a maximum trial period. With
  311.   registration, you can continue using the software, full source code to the C
  312.   Window Library, and free upgrades.
  313.  
  314.   Copyright laws apply to both Shareware and commercial software, and the
  315.   copyright holder retains all rights, with a few specific exceptions as stated
  316.   below. Shareware authors are accomplished programmers, just like commercial
  317.   authors, and the programs are of comparable quality. (In both cases, there are
  318.   good programs and bad ones!) The main difference is in the method of
  319.   distribution. The author specifically grants the right to copy and distribute
  320.   the software, either to all and sundry or to a specific group. For example,
  321.   some authors require written permission before a commercial disk vendor may
  322.   copy their Shareware.
  323.   Shareware is a distribution method, not a type of software. You should find
  324.   software that suits your needs and pocketbook, whether it's commercial or
  325.   Shareware. The Shareware system makes fitting your needs easier, because you
  326.   can try before you buy.  And because the overhead is low, prices are low also.
  327.   Shareware has the ultimate money-back guarantee -- if you don't use the
  328.   product, you don't pay for it.
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.                             DISCLAIMER - AGREEMENT
  362.  
  363.   Users of The C Window Library must accept this disclaimer of warranty:
  364.  
  365.   "The C Window Library is supplied as is.  The author disclaims all warranties,
  366.   expressed or implied, including, without limitation, the warranties of
  367.   merchantability and of fitness for any purpose.  The author assumes no
  368.   liability for damages, direct or conse- quential, which may result from the
  369.   use of The C Window Library."
  370.  
  371.   The C Window Library is a "shareware program" and is provided at no charge to
  372.   the user for evaluation.  Feel free to share it with your friends, but please
  373.   do not give it away altered or as part of another system.  The essence of
  374.   "user-supported" software is to provide personal computer users with quality
  375.   software without high prices, and yet to provide incentive for programmers to
  376.   continue to develop new products.  If you find this program useful and find
  377.   that you are using The C Window Library and continue to use The C Window
  378.   Library after a reasonable trial period, you must make a registration payment
  379.   of $45 to CitySoft Software.  The $45 registration fee will license one copy
  380.   for use on any one computer at any one time.  You must treat this software
  381.   just like a book.  An example is that this software may be used by any number
  382.   of people and may be freely moved from one computer location to another, so
  383.   long as there is no possibility of it being used at one location while it's
  384.   being used at another.  Just as a book cannot be read by two different
  385.   persons at the same time.
  386.  
  387.   Commercial users of The C Window Library must register and pay for their
  388.   copies of The C Window Library within 30 days of first use or their license is
  389.   withdrawn.  Site-License arrangements may be made by contacting CitySoft
  390.   Software.
  391.  
  392.   Anyone distributing The C Window Library for any kind of remuneration must
  393.   first contact CitySoft Software at the address above for authorization.  This
  394.   authorization will be automatically granted to distributors recognized by the
  395.   (ASP) as adhering to its guidelines for shareware distributors, and such
  396.   distributors may begin offering The C Window Library immediately (However
  397.   CitySoft Software must still be advised so that the distributor can be kept
  398.   up-to-date with the latest version of The C Window Library.).
  399.  
  400.   You are encouraged to pass a copy of The C Window Library along to your
  401.   friends for evaluation.  Please encourage them to register their copy if they
  402.   find that they can use it.  All registered users will receive a copy of the
  403.   latest version of the The C Window Library system.
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.                           USING THE C WINDOW LIBRARY
  418.  
  419.   If you are not familiar with using third party libraries and how to link
  420.   the library with the rest of your code, please consult the various
  421.   documentation supplied with the compiler that you are working with.  This is
  422.   not a full tutorial on how to link third party libraries.
  423.  
  424.  
  425.   Microsoft / Quick C
  426.   -------------------
  427.  
  428.   When compiling your programs, you must make sure that the constant MSC is
  429.   defined.  An example of how you would do this as follows:
  430.  
  431.       cl -Ax -DMSC -Ihfiles prog1.c prog2.c /link mswinx.lib
  432.  
  433.   the -Ax is the model used for compilation.  The x stands for either S for
  434.   small, M for medium, C for compact, or L for large.  The -D option defines a
  435.   constant, which in this case is MSC.  You must use the -D switch with MSC as
  436.   the constant.  If not, you will get either syntax errors, link errors, or
  437.   runtime errors.  The -I option tells the compiler that the .h files are
  438.   located in a directory on the default drive called hfiles.  The /link option
  439.   links the resulting object files (prog1.obj and prog2.obj) with the The C
  440.   Window Library file mswinx.lib, where x stands for S, M, C, or L.
  441.  
  442.   The other method is to create a make file.  If you are using the integrated
  443.   environment of Quick C or using the Programmers Work Bench (PWB) for
  444.   Microsoft C 6.0, you can create your make files by selecting the files you
  445.   want to compile, and the libraries you want to link with and letting these
  446.   integrated environments create the make file automatically.  If you are more
  447.   advanced you can create your make files by yourself without the aid of these
  448.   programs.  Consult the documentation for more information on make files.
  449.  
  450.  
  451.   Turbo C and TurboC++
  452.   --------------------
  453.  
  454.   If you will use the integrated environment, you must create a project file.
  455.   This project file specifies the source code modules, object code modules, and
  456.   libraries that will be linked in to produce an executable file.  If you use
  457.   the Turbo C Ver 2.0 integrated environment, you must edit this file yourself.
  458.   If you use the Turbo C++ integrated environment, use the automatic Project
  459.   File creator.
  460.  
  461.   You can also use make files to link in your program.  Make sure that the
  462.   desired library from The C Window Toolkit is specified.
  463.  
  464.   You can also use the TCC.EXE command line compiler with the desired library
  465.   specified on the command line.  Consult the Turbo C documentation on using
  466.   make files and using the integrated environment.
  467.  
  468.   An example of using the TCC.EXE command line is a s follows:
  469.  
  470.           tcc -mm -G -r -ihfiles prog1.c tcwinm.lib
  471.  
  472.  
  473.   The following command line uses -mm for the small memory model, -G to
  474.   optimize for speed, -r for usage of register variables, and -i to tell the
  475.   compiler that the header files are located in a directory on the default
  476.   drive called hfiles.
  477.  
  478.  
  479.  
  480.   Power C
  481.   -------
  482.  
  483.   If you are using the POWER C compiler from Mix Software, you must define
  484.   the constant POWERC on the command line.
  485.  
  486.                      pc -dPOWERC -mm -ihfiles prog1.c
  487.  
  488.   You must have the constant POWERC defined on the pc.exe command line using
  489.   the -d option.  If not, you may get syntax, link, or runtime errors.
  490.   The -mm tells the compiler to use the medium memory model, and the -i option
  491.   tells the compiler that there are .h files located on the default drive in
  492.   the directory hfiles.
  493.  
  494.   Depending on the number of windows your application will use and the code
  495.   size, you will have to use different stack and heap options in the Power C
  496.   linker, pcl.  An example of this is as follows:
  497.  
  498.                      pcl [20k,30k,200k] a;pcwinm
  499.  
  500.   This will link the object file a.mix with the pcwinm.mix library with 20k of
  501.   stack space, 30k of near heap space, and 200k of far heap space.  If your
  502.   application has many or very large virtual windows, you should use the maximum
  503.   far heap space allowable.  If your program has many windows, you should
  504.   increase the near heap space parameter, or use the pcwinl.mix library and
  505.   increase the far heap space parameter.  If your program has recursive or
  506.   deeply nested functions, you should increase the stack parameter.  However the
  507.   stack and near heap space cannot exceed 64k.  This includes global and static
  508.   declarations in the program.
  509.  
  510.  
  511.   Zortech C++
  512.   -----------
  513.  
  514.   If you are using the Zortech C++ compiler, you should use the following
  515.   options when compiling your program with The C Window Library:
  516.  
  517.               ztc -o -b -p -mm prog1.c zcwinm.lib
  518.  
  519.   The -o option turns on the global optimizer.  The -b option lets ztc know to
  520.   handle large programs.  The -p turns off autoprotyping.  The -mm option lets
  521.   the compiler use the medium memory model.  The programs prog1.c is compiled
  522.   using these options and then linked with the medium memory model of The C
  523.   Window Library's Zortech version, namely zcwinm.lib
  524.  
  525.   You can also use make files.  Please consult the Zortech compiler reference
  526.   for further examples.
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544. 
  545.