home *** CD-ROM | disk | FTP | other *** search
/ Microsoft Programmer's Library 1.3 / Microsoft-Programers-Library-v1.3.iso / sampcode / qc / qc20 / samples.doc < prev    next >
Encoding:
Text File  |  1988-12-02  |  3.4 KB  |  75 lines
  1.                                SAMPLES.DOC File
  2.  
  3.                        QuickC (R) Compiler, Version 2.00
  4.  
  5. ===========================< Samples List >================================
  6.  
  7. In addition to the reference and "C For Yourself" examples in the QC
  8. Advisor, the following sample programs are provided with QuickC.
  9.  
  10.      Files              Description
  11.      -----              -----------
  12.  
  13.      GRDEMO.MAK         GRDEMO illustrates general graphics techniques
  14.      GRDEMO.C           including drawing, animation, palette
  15.      MENU.C             switching, window adjustment, menus, and
  16.      MENU.H             turtle graphics. The MENU and TURTLE modules
  17.      TURTLE.C           are independent modules that could be used
  18.      TURTLE.H           in your own programs.
  19.  
  20.  
  21.      LIFE.MAK           LIFE illustrates general C and inline assembler
  22.      LIFE.C             techniques. In particular, it shows how to write
  23.      TOOLS.C            entire screens to the screen buffer. The TOOLS
  24.      TOOLS.H            module contains independent functions and
  25.                         macros that could be used in your own programs.
  26.  
  27.  
  28.      CHRTDEMO.MAK       CHRTDEMO illustrates presentation graphics
  29.      CHRTDEMO.C         techniques. You can use this program as a tool
  30.      CHRTSUPT.C         for testing different modes and options before
  31.      CHRTDEMO.H         building them into your own programs.
  32.  
  33.  
  34.      CRLF.C             CRLF is a tool for converting certain files that
  35.                         can not be loaded into the QC environment. It
  36.                         removes unwanted control characters and ensures
  37.                         that each line is terminated by a carriage-return/
  38.                         line-feed pair. CRLF.EXE is also provided on the
  39.                         utilities disk.
  40.  
  41.  
  42. ======================< Note on Graphics Libraries >=======================
  43.  
  44. GRDEMO and LIFE require GRAPHICS.LIB. CHRTDEMO requires GRAPHICS.LIB
  45. and PGCHART.LIB. If you did not request these libraries in your
  46. combined library files during setup, you will get "unresolved
  47. external" linker errors when you try to compile the programs.
  48.  
  49. If you are using the QC environment, you must add the appropriate
  50. library names to the program list (.MAK) files. For example, if you
  51. want to compile LIFE, select Edit Program List from the Make menu. A
  52. dialog box will appear showing the contents of the LIFE.MAK program
  53. list. Enter the name GRAPHICS.LIB at the File Name prompt and select
  54. the Save List button.
  55.  
  56. If you are using QCL, specify the library names on the command line.
  57. For example, use this command line to compile LIFE:
  58.  
  59.         QCL life.c tools.c graphics.lib
  60.  
  61.  
  62. ======================< Note on Naming Conventions >=======================
  63.  
  64. Two example programs, CHRTDEMO and GRDEMO, use a subset of the naming
  65. conventions used in OS/2 and Windows include files. In this
  66. convention, the first character of an identifier is a lowercase letter
  67. called a prefix. Common prefixes include p (pointer), a (array), i
  68. (index), and c (count). After the prefix, there may be an additional
  69. lowercase tag, usually indicating type. Common tags include ch (char),
  70. f (flag), sz (zero-terminated string) l (long), and x or y (x or y
  71. coordinate). Following this there may be one or more qualifiers, each
  72. beginning with an uppercase letter. For example, an identifier called
  73. achFileName is an array (a) of characters (ch) containing a file name
  74. (FileName).
  75.