home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / dev / misc / Gfx4PCQ.readme < prev    next >
Encoding:
Text File  |  1997-03-02  |  8.6 KB  |  218 lines
  1. Short:    Easy graphic support for the PCQ pascal compiler
  2. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Type:     dev/misc
  5.  
  6. Windowlib is a link module for use with the fine PD PCQ pascal compiler on
  7. the amiga. It provides useful functions to do graphics with this compiler,
  8. together with some intuition support (menus & gadgets). This is mostly
  9. maintained for the beginner in Pascal, to have nice graphics without much
  10. efford, and can be (and has been) used to teach pascal.
  11.  
  12. Together with the library itself and one include file which defines all its
  13. functions, several examples have been included to demonstrate the functions.
  14.  
  15. This package has been inspired by the graphics functions of the Atari XL
  16. basic and later on the GFABASIC (which used the syntax and the functions of
  17. the XL basic version). The gap that most pascal compilers do not come with
  18. graphic functions has been filled by this, giving higher attractivity to
  19. start with this language rather than with the (UGLY) basic. But don't expect
  20. too much, since this library goes not much behind the GFABASIC standards.
  21. In special, no "sprite" related graphics have been added yet.
  22.  
  23. Most of these examples has been worked out to teach pascal to my neighbor, 
  24. Ernst Besser, who is a teacher in arts. Since the usual pascal teach program
  25. (calculate the area of an rectangle) is quite boring, I started this project,
  26. resulting in a higher motivation for learning a computer language. After
  27. all, I think pascal should be the first language to start with, although 
  28. I'm not a fan of (it's to "german" compared to C.... :-).
  29.  
  30. ____________________________________________________________________________
  31.  
  32.                         The THOR-Software Licence
  33.  
  34.  
  35. This License applies to the computer programs known as "WindowLib" and
  36. its example programs, contained in this archive.
  37. The "Program", below, refers to such program.
  38.  
  39.  
  40. The programs and files in this distribution are freely distributable
  41. under the restrictions stated below, but are also Copyright (c)
  42. Thomas Richter.
  43.  
  44.  
  45. Distribution of the Program by a commercial organization without written
  46. permission from the author to any third party is prohibited if any payment
  47. is made in connection with such distribution, whether directly
  48. (as in payment for a copy of the Program) or indirectly (as in payment
  49. for some service related to the Program, or payment for some product
  50. or service that includes a copy of the Program "without charge";
  51. these are only examples, and not an exhaustive enumeration of prohibited
  52. activities). However, the following methods of distribution involving
  53. payment shall not in and of themselves be a violation of this restriction:
  54.  
  55.  
  56. (i) Posting the Program on a public access information storage and
  57. retrieval service for which a fee is received for retrieving information
  58. (such as an on-line service), provided that the fee is not
  59. content-dependent (i.e., the fee would be the same for retrieving the same
  60. volume of information consisting of random data).
  61.  
  62.  
  63.  
  64. (ii) Distributing the Program on a CD-ROM, provided that the files
  65. containing the Program are reproduced entirely and verbatim on such
  66. CD-ROM, and provided further that all information on such CD-ROM be
  67. redistributable for non-commercial purposes without charge.
  68.  
  69.  
  70.  
  71. Everything in this distribution must be kept together, in original
  72. and unmodified form.
  73.  
  74.  
  75.  
  76.  
  77. Limitations.
  78.  
  79. THE PROGRAM IS PROVIDED TO YOU "AS IS," WITHOUT WARRANTY. THERE IS NO
  80. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  81. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  82. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  83. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  84. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  85. SERVICING, REPAIR OR CORRECTION.
  86.  
  87.  
  88.  
  89. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE ALL FILES CONTAINED IN
  90. THIS ARCHIVE.
  91.  
  92. _____________________________________________________________________________
  93.  
  94.  
  95. Usage:
  96.         Unpack this archive. 
  97.  
  98.         Copy the contents of LIB to the library drawer of PCQ,
  99.         usually assigned to LIB:
  100.  
  101.         Copy the contents of the "Examples" folder whereever you
  102.         keep your sources.
  103.  
  104.         Copy the contents of the "Utils" drawer to the "Utils"
  105.         subdirectory of the PCQ include folder.
  106.  
  107.         Copy this file whereever you want it.
  108.  
  109.  
  110. To compile pascal programs with windowlib and the PCQ compiler, add the line
  111.  
  112. {$I "Include:Utils/windowlib.i"}
  113.  
  114. to your pascal program directly under the PROGRAM statement. Add the lines
  115.  
  116.     InitGraphics;
  117.  
  118.     {your main program goes here}    
  119.  
  120.     ExitGraphics;
  121.  
  122. to your main program to initialize and shut down the windowlib, where your
  123. private code that does the graphics should go between.
  124.  
  125. Compile your program as usual, but link your code with LIB:window.o like
  126. in the following line:
  127.  
  128. BLink FROM  "prog.o"  TO "prog" LIB LIB:window.o LIB:PCQ.lib SC ND
  129.  
  130. where "prog" is the name of your program.
  131.  
  132.  
  133. To make live even easier, the examples come with setting files for the
  134. graphical make utility "ClickMake", which is also available from THOR or
  135. from the aminet, but not contained in this archive. You may download it from
  136. the aminet sides or from my home page, given at the end of this text.
  137.  
  138. Using ClickMake, you can compile these examples with one click of a button.
  139.  
  140.  
  141. Besides the compiler, these examples are setup to work with:
  142.  
  143. 1) the most popular CED editor.
  144. 2) the PCQ compiler (-:
  145. 3) the PhxAss assembler. This one can be also downloaded from the AmiNet
  146. 4) the BLink PD linker. Again, this can be found on the net.
  147.  
  148. Each of them has been tested, but if you have trouble, contact me:
  149.  
  150.  
  151.         Thomas Richter
  152.  
  153. EMail:  thor@einstein.math.tu-berlin.de
  154.  
  155. WWW:    http://www.math.tu-berlin.de/~thor/thor/index.html
  156.  
  157.  
  158. To find out more about the functions of the windowlib, read the include file
  159. in Utils/windowlib.i or study the examples.
  160.  
  161.  
  162.     Thomas Richter        , February 1997
  163.  
  164.  
  165. ============================= Archive contents =============================
  166.  
  167. Original  Packed Ratio    Date     Time    Name
  168. -------- ------- ----- --------- --------  -------------
  169.      628     264 57.9% 09-Feb-97 22:06:08 +Examples.info
  170.      628     258 58.9% 09-Feb-97 22:06:06 +CircleMaze.info
  171.    32748   13839 57.7% 09-Feb-97 18:41:16 +CircleMaze
  172.     3666    1042 71.5% 16-Dec-95 19:24:26 +CircleMaze.cm
  173.     1807     930 48.5% 09-Feb-97 18:41:10 +CircleMaze.p
  174.      628     260 58.5% 09-Feb-97 22:06:06 +Circles.info
  175.    30824   13041 57.6% 09-Feb-97 18:02:40 +Circles
  176.     3684    1051 71.4% 09-Feb-97 22:09:02 +Circles.cm
  177.      915     516 43.6% 09-Feb-97 18:01:32 +Circles.p
  178.      628     257 59.0% 09-Feb-97 22:06:06 +Fractal.info
  179.    31660   13345 57.8% 09-Feb-97 18:10:40 +Fractal
  180.     3684    1051 71.4% 09-Feb-97 22:09:24 +Fractal.cm
  181.     2680    1016 62.0% 09-Feb-97 18:10:32 +Fractal.p
  182.      628     259 58.7% 09-Feb-97 22:06:06 +Fractal2.info
  183.    31680   13375 57.7% 09-Feb-97 18:15:58 +Fractal2
  184.     3684    1052 71.4% 09-Feb-97 22:09:36 +Fractal2.cm
  185.     2616     963 63.1% 09-Feb-97 18:15:52 +Fractal2.p
  186.      628     258 58.9% 09-Feb-97 22:06:06 +Jumper.info
  187.    30992   13153 57.5% 09-Feb-97 18:22:20 +Jumper
  188.     3682    1049 71.5% 09-Feb-97 22:09:48 +Jumper.cm
  189.     1168     670 42.6% 09-Feb-97 18:22:14 +Jumper.p
  190.      628     256 59.2% 09-Feb-97 22:06:06 +Jumper2.info
  191.    31008   13166 57.5% 09-Feb-97 18:27:12 +Jumper2
  192.     3684    1052 71.4% 09-Feb-97 22:10:00 +Jumper2.cm
  193.     1023     595 41.8% 09-Feb-97 18:27:06 +Jumper2.p
  194.      628     255 59.3% 09-Feb-97 22:06:06 +Jumper3.info
  195.    31012   13158 57.5% 09-Feb-97 18:30:06 +Jumper3
  196.     3684    1053 71.4% 09-Feb-97 22:10:10 +Jumper3.cm
  197.     1026     592 42.3% 09-Feb-97 18:30:00 +Jumper3.p
  198.      628     255 59.3% 09-Feb-97 22:06:08 +Jumper4.info
  199.    31464   13298 57.7% 09-Feb-97 18:33:26 +Jumper4
  200.     3684    1053 71.4% 09-Feb-97 22:10:18 +Jumper4.cm
  201.     1006     598 40.5% 09-Feb-97 18:33:20 +Jumper4.p
  202.      628     259 58.7% 09-Feb-97 22:06:08 +Liss.info
  203.    32452   13723 57.7% 09-Feb-97 18:53:04 +Liss
  204.     3680    1047 71.5% 09-Feb-97 22:10:30 +Liss.cm
  205.     3226    1519 52.9% 09-Feb-97 18:52:58 +Liss.p
  206.      628     256 59.2% 09-Feb-97 22:06:08 +WindowDemo.info
  207.    33144   14001 57.7% 09-Feb-97 19:36:30 +WindowDemo
  208.     3700    1050 71.6% 09-Feb-97 22:10:44 +WindowDemo.cm
  209.    11084    4406 60.2% 09-Feb-97 21:10:02 +WindowDemo.p
  210.     5977    2747 54.0% 09-Feb-97 22:04:50 +Gfx4PCQ.readme
  211.      537     286 46.7% 09-Feb-97 22:05:38 +Gfx4PCQ.readme.info
  212.      628     268 57.3% 09-Feb-97 22:05:48 +LIB.info
  213.    26412   11310 57.1% 09-Feb-97 21:29:36 +window.o
  214.      628     267 57.4% 09-Feb-97 22:05:56 +Utils.info
  215.    27633    9790 64.5% 09-Feb-97 21:27:26 +WindowLib.i
  216. -------- ------- ----- --------- --------
  217.   449090  183909 59.0% 11-Feb-97 13:41:48   47 files
  218.