home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / RiscOS / APP / DEVS / LIB / GSTOBJ.ZIP / GstObjects / readme < prev    next >
Text File  |  1994-09-26  |  4KB  |  121 lines
  1. Objects for Adhesive
  2. (C) George Taylor 1994
  3.  
  4. Adhesive (not included in this archive) is a program which allows objects
  5. (groups of procedures) to be shared between many programs. The archive contains
  6. some FREEWARE objects for use with Adhesive.
  7.  
  8. You can contact the author (please do - all comments welcome) at:
  9.  
  10.         George Taylor
  11.         16 Newton Crescent
  12.         Dunblane
  13.         Perthshire
  14.         FK15 ODZ
  15.  
  16. Or you can EMAIL me (much quicker during term time) at
  17.  
  18.         george@tardis.ed.ac.uk
  19.         
  20. if this fails try gst@dcs.ed.ac.uk (may only be valid until July 95).
  21.  
  22.  
  23. Please include your Adhesive registration number (if you have one)
  24. in all correspondence. Always state the VERSION NUMBER of the object and
  25. the version number of Adhesive you have.
  26.  
  27.  
  28.  
  29. I may add your questions (unless you ask otherwise) to the FAQ supplied
  30. with this distribution.
  31.  
  32.  
  33. This distribution contains some useful objects for use with Adhesive. You
  34. may distribute some or all of these objects with your own software provided
  35. the copies are UNMODIFIED (ie do not change/remove/add any files from/to
  36. the xxx directory for each object).
  37.  
  38. You may use the whole / parts of the example programs in whatever way you
  39. wish in your own programs.
  40.  
  41. Please remember that you are not allowed to distribute Adhesive with your
  42. own software if you have not registered for Adhesive.
  43.  
  44.  
  45. The following objects are provided. All the routines (unless indicated
  46. otherwise) are APCS conformant. This means you can call them from C.
  47. Some of the routines MUST be called from an APCS environment as they
  48. use C Library functions or other objects which require this. Other
  49. routines although compatible with APCS callers do not require the APCS
  50. environment and so can be called from simple assembler or simple BASIC.
  51.  
  52. If you wish to call routines which must be called from a C environment from
  53. BASIC then use the 'basicC' object provided with Adhesive.
  54.  
  55.  
  56.         128     time+
  57.         129     string+
  58.         130     file
  59.         131     block
  60.         132     hash
  61.         133 *   stack
  62.         134     throwback
  63.         135     list
  64.         136     hourglass
  65.         137     cli
  66.         138     geometry (double)
  67.         139     geometry (integer)
  68.         140     quadtree
  69.         141     handler
  70.         143     screen
  71.         144     tree
  72.         145 *   squash
  73.         146     token
  74.         148 *   message
  75.         149 *   joystick
  76.         150 *   fasttimer
  77.         151 *    set
  78.         
  79.         * Example of use provided - see below
  80.  
  81.  
  82. All objects have been tested but there are bound to be some remaining bugs.
  83. Do not hesitate to contact the author if you think you may have found one.
  84.  
  85. The following objects come with examples. Note that the examples are NOT
  86. part of the object (they are not in the xxx.vvv directory) and need not be
  87. distributed with the object if you distribute the object with your own
  88. program.
  89.  
  90.     message     Example program written in BASIC. Requires the basicC
  91.                 object supplied with the Adhesive distribution to be
  92.                 installed along with the message and string+ objects
  93.                 (as message depends on string+).
  94.  
  95.     squash      Example program written in BASIC. Requires the basicC
  96.                 object supplied with the Adhesive distribution to be
  97.                 installed (as well as the Squash object).
  98.  
  99.     joystick    Example program written in C. Requires the
  100.                 joystick object to be installed and the .h and
  101.                 .o files supplied with Adhesive (in the tools directory).
  102.                 
  103.     stack       Example program written in Pascal. This also demonstrates
  104.                 how to use Adhesive from Pascal. A Pascal header file for
  105.                 Adhesive is included.
  106.  
  107.  
  108.     fasttimer   Example program written in assembler using the BASIC
  109.                 assembler. This also demonstrates how to use Adhesive
  110.                 and the Shared C Library from a stand alone machine code
  111.                 program which was assembled from BASIC.
  112.  
  113.     set        Example program written in C. Requires the set object
  114.             to be installed and the .h and .o files supplied
  115.             with Adhesive (in the tools directory).
  116.  
  117.  
  118. To get a one line description of the objects first install them all
  119. (double click on the InstallAll script) and then run the 'AdhInfo'
  120. utility supplied with Adhesive.
  121.