home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD2.img / d4xx / d400 / reqlib / read.me < prev    next >
Text File  |  1990-11-02  |  5KB  |  149 lines
  1.  
  2.  
  3. =============================================================================
  4. Official release of version 1.2, October '89
  5.  
  6.  
  7. Req.library  is Copyright (c)1989, 1990 by C.W.  Fox and Bruce Dawson.  It is
  8. freely  distributable.  No charge may be made for it's distribution, except
  9. for a nominal media fee.
  10.  
  11.      Feel free to distribute and use this library with your programs, along
  12. with a notice that the library is 'FreeWare'.
  13.  
  14. =============================================================================
  15.  
  16.     Hello! This is the introduction to the all-new "req.library"!
  17.  
  18.     What is it?
  19.  
  20.     Req.library  adds  user-friendliness  to  the  Amiga's  user interface.
  21. While  Intuition  does supply requesters, they have certain limitations and
  22. are awkward to set up.  We designed ours to be quick and easy to set up, as
  23. well  as  adding  features.  The text requester has PRINTF style formatting
  24. built  in!   There is a colour requester, a very powerful file requester, a
  25. string  requester  (allowing  the  user  to  enter  a line of text), and an
  26. integer  requester  (allowing  the user to enter an integer number).  There
  27. are  also low-level support routines, such as routines to create any of the
  28. Amiga's gadgets, as well as a real-time scroll routine.
  29.  
  30.     The  nice  thing about the gadget creation routines, is that they allow
  31. you to create gadgets from parameters, meaning that you can allocate memory
  32. and have your gadgets constructed there.  This allows you to use gadgets in
  33. code  that  is  meant to be re-entrant.  This normally wouldn't be possible
  34. with gadgets.  The size necessary for each gadget has been defined, and you
  35. will find the definitions in reqbase.i and reqbase.h.
  36.  
  37.     (Please see req.doc for a more comprehensive explanation).
  38.  
  39.   Here is an overview of the files included in this ZOO archive:
  40.  
  41.     areqglue.o            Gluecode for Aztec C. Link in with your programs.
  42.     lreqglue.o            Gluecode for Lattice C. Link in with your programs.
  43.     reqglue.asm           Sourcecode for the gluecode.
  44.     customizefile.asm     How to customize the file requester.
  45.     customizefile         The executable of the file requester customizer.
  46.     reqbase.h             The C include file. Put it in include/libraries
  47.     reqbase.i             The asm include file. Put it in include/libraries
  48.     showoffreq.c          The C source code for the req demo program.
  49.     showoffreq            The req demo executable.
  50.     req.library           The actual library. This goes in libs:
  51.     reqproto.h            The prototype file for Lattice C
  52.     req.doc               The instructions and calling conventions.
  53.     read.me               This file
  54.     macros.i              Some handy macros.
  55.  
  56. -----------------------------------------------------------------------------
  57.     Included is a demo program called Showoffreq, which opens a screen with
  58. text  gadgets in it, one per requester.  If you wish to experiment with the
  59. requesters, this might be a good place to start.
  60.  
  61.  
  62. To compile showoffreq.c under Lattice, use:
  63.  
  64.                lc -Lcd+lib:lreqglue.o showoffreq
  65.  
  66.  
  67.  
  68.  
  69. To compile showoffreq.c under Aztec, use:
  70.  
  71.                cc -o o/showoffreq.o showoffreq.c
  72.  
  73.                ln -w +Q -o showoffreq o/showoffreq.o lib:areqglue.o -lc
  74.  
  75. -----------------------------------------------------------------------------
  76.  
  77.                                For Assembly
  78.  
  79. -----------------------------------------------------------------------------
  80.  
  81.     To  use  req.library  from  assembly  language  is quite easy.  So far,
  82. nothing's been said about it, so here is some info.
  83.  
  84.     First  of  all,  the library is EXACTLY like system libraries; you open
  85. it, call functions, and then close it.  We've included some macros that may
  86. make working with it a bit easier.  All you have to include to actually use
  87. the req.library is reqbase.i.  This contains all the function offsets.  You
  88. may  wish  to call the functions directly, or use a bit of gluecode to make
  89. things even easier.  If you wish to do it all yourself, then all you've got
  90. to  do  is  include  reqbase.i.   If you wish to use some pre-made function
  91. setup, then you have to link with the appropriate reqglue.o (lreqglue.o for
  92. Lattice, and areqglue.o for Aztec).
  93.  
  94.  
  95.  
  96.  
  97.  
  98. \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
  99.  
  100.   To link with lreqglue.o (for Lattice), an example linkfile might look like
  101. this:
  102.  
  103. ---cut here---cut here---cut here---cut here---cut here---cut here---cut here
  104.  
  105. FROM
  106. lib:startup.o
  107. obj/file1.o
  108. obj/file2.o
  109. obj/data.o
  110. obj/menus.o
  111.  
  112. LIB
  113. lib:amiga.lib (or lib:lvo.lib if you have it)
  114. lib:lreqglue.o
  115.  
  116. TO
  117. file
  118.  
  119. nodebug smallcode smalldata
  120.  
  121. BATCH
  122.  
  123. ---cut here---cut here---cut here---cut here---cut here---cut here---cut here
  124.  
  125. and to use this linkfile, just say:
  126.  
  127.     blink with <linkfile>
  128.  
  129.  
  130.  
  131.  
  132. \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
  133.  
  134. To link with areqglue.o (for Aztec), and example linkfile might look like this:
  135.  
  136.  
  137.  
  138. ---cut here---cut here---cut here---cut here---cut here---cut here---cut here
  139.  
  140. ln -w +Q -o file1 o/file1.o lib:areqglue.o -lc
  141.  
  142. ---cut here---cut here---cut here---cut here---cut here---cut here---cut here
  143.  
  144. and to use this linkfile, just say:
  145.  
  146.     ln -f <linkfile>
  147.  
  148.  
  149.