home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / programm / libs / lib_coll.lha / FRQLIB.LZH / fr_bypass.doc < prev    next >
Encoding:
Text File  |  1992-04-29  |  6.5 KB  |  197 lines
  1.  ---------------------
  2. |   FR Bypass 3.13    |
  3. |                     |
  4. | By: Khalid Aldoseri |
  5.  ---------------------
  6.  
  7. FR_Bypass allows the file requester in 'kd_freq.library' to be used with
  8. many programs that use other file requesters in libraries.
  9.  
  10. FR_Bypass will replace the file requesters in the following libraries:
  11.  
  12.   arp.library  The ARP file requester.
  13.   req.library  The file requester that comes with CED Pro 2.
  14.   asl.library  The standard file requester in AmigaDOS 2.0 and above.
  15.  
  16. Once the bypass is installed, every time a program calls any of the above
  17. file requesters, mine will come up instead!
  18.  
  19.  
  20. Installation:
  21. -------------
  22.  
  23. Copy FR_Bypass to your C: directory, and add it to your startup-sequence,
  24. or drag the FR_Bypass icon into your WBStartup drawer.
  25.  
  26. A window will come up informing you of the success of its installation.
  27. If it says 'Installation failed' then 'kd_freq.library' wasn't in the
  28. LIBS: directory.  Otherwise it will report the libraries found and bypassed.
  29. This can be something like this:
  30.  
  31.     'Installed: ARP REQ ASL Injector'
  32.  
  33. It will not allow you to run multiple copies of itself. You can quit it at
  34. any time by hitting 'right shift-right alt-q'.
  35.  
  36.  
  37. Required files:
  38. ---------------
  39.  
  40.  File name              Optional?   Version
  41.  --------------------   ---------   ------------
  42.  LIBS:kd_freq.library   Mandatory   3  or above
  43.  LIBS:asl.library       Optional    37 or above
  44.  LIBS:arp.library       Optional    any version
  45.  LIBS:req.library       Optional    any version
  46.  
  47.  
  48. Startup options:
  49. ----------------
  50.  
  51. You can disable bypassing of a specific library, or disabling the Inject
  52. facility by adding a specific letter to the <options> as follows:
  53.  
  54.     FR_Bypass <options>
  55.  
  56.     Where <options> is one or more of the following:
  57.  
  58.         q    Disables req.library bypass.
  59.         p    Disables arp.library bypass.
  60.         l    Disables asl.library bypass.
  61.         i    Disables injector.
  62.         w    Do not show startup window.
  63.         c    Always center requesters on screens.
  64.         o    Always force FR on its own hi-res screen.
  65.         d    Always force FR on its own hi-res/interlaced screen.
  66.         k   Clones the color palette of the program's screen when the FR
  67.             shows up on its own screen. (not working yet)
  68.         z    Force FR on its own hi-res screen only if destination screen 
  69.             is lo-res.
  70.         r   Resets the FR size to Normal size after each call.
  71.         s   FR doesn't automatically re-sort the display after it is done
  72.             reading the directory.
  73.         n   FR shows a text list of the available devices instead of disk
  74.             icons.
  75.  
  76.      <num>  You can provide up to 6 numbers each seperated by a space.  These
  77.             are taken to be the default width/height pairs for the 3 default
  78.             FR sizes.  The second pair is used to be the width/height of the
  79.             first time the FR is called.
  80.  
  81.             (error reports will still be shown)
  82.  
  83.  
  84. If FR_Bypass is running and you try to run it again, the new copy will
  85. simply exit, but will tell the original copy to bring up the Control
  86. Panel.  
  87.  
  88. Options can be grouped by using multiple letters in <options>.  i.e.
  89.  
  90.     FR_Bypass lq    Disables asl.library  & req.library bypass.
  91.  
  92.     FR_Bypass w 111 222 333 444 555 666
  93.                     Starts the program without the startup window, and sets
  94.                     the default width/heights to 111,222 333,444 and 555,666.
  95.                     (The FR will attempt to stay as close to these as possible,
  96.                      unless the numbers are too small or too big)
  97.  
  98.  
  99. Control Panel:
  100. --------------
  101.  
  102. You can control Bypass's settings at any time by hitting the
  103. right alt-right shift-E key.
  104.  
  105.  
  106. Programmer's Note:
  107. ------------------
  108.  
  109. FR_Bypass allows you to code for a standard file requester, like the
  110. asl.library requester, and still allow users access to a high-powered
  111. file requester if they wants one.
  112.  
  113. You do not have to worry about my library at all.  All you need to do
  114. is to code as usual for one of the above libraries and FR_Bypass will
  115. handle the differences in calling procedures between that FR and my FR.
  116.  
  117. e.g.  In the case or ARP, it will trap the normal ARP FR call, read the
  118. ARP FileRequester structure, set the right calling procedure for my FR,
  119. call my FR, return from it, and set the right results in ARP format,
  120. and return the call to your program.  Your program will not know the
  121. difference.  Of course, using this technique has one disadvantage:
  122. You cannot use some special features of my FR, like extended select.
  123.  
  124. FR_Bypass traps the official entry points into asl.library, namely
  125. RequestFile() and AslRequest().  AslRequestTags() is simply a stub that
  126. calls AslRequest(), so it is automatically trapped as well.
  127.  
  128.  
  129. Limitations:
  130. ------------
  131.  
  132. If the bypass code cannot handle a specific situation, e.g. if the
  133. req.library call is used to bring up a font requester, Bypass will
  134. call the original file requester since my f-r cannot handle this
  135. request reasonably.
  136.  
  137. FR_Bypass currently doesn't handle multi-file requests from req.library
  138. or asl.library.  The next version will hopefully fix that.
  139.  
  140.  
  141. File Injector:
  142. --------------
  143.  
  144. This uses my FR to allow you to select a directory/file at any time and
  145. 'inject' its name into the keyboard stream.
  146.  
  147. To invoke the FR hit the 'right shift-right alt-r' key and the FR will show
  148. up on the front screen.  You then select a file from the requester and click
  149. on OK.
  150.  
  151. After that, you can, at any time, hit the 'right shift-right alt-s' key and
  152. Inject will feed the directory/filename into the keyboard stream.  You can
  153. also feed only the directory name by using the 'right shift-right alt-d' key
  154. or the filename alone by using the 'right shift-right alt-f' key.
  155.  
  156. If the string to be output contains a space then it will be surrounded with
  157. double quotes.
  158.  
  159.  
  160. Summary of functions:  (all keys are with right shift-right alt combo)
  161.  
  162. Key    Action
  163. ---    --------------------------
  164.  r    Call up file requester.
  165.  s    Inject directory+filename.
  166.  d    Inject directory.
  167.  f    Inject filename.
  168.  e  Call up control panel.
  169.  q    Quit (unload) program.
  170.  
  171.  
  172. Note that the 'q' key still works even if the inject facility is disabled
  173. with the 'FR_Bypass i' command.
  174.  
  175.  
  176. Important:
  177.  
  178.   Read the 'changes' file for latest information.
  179.  
  180.  
  181.  
  182.  
  183.  ---------------------------------------
  184. | Copyright 1990-1992  Khalid Aldoseri. |
  185. |           29 April 1992.              |
  186.  ---------------------------------------
  187.  
  188. CygnusEd Professional & CED are Copyright 1987,1988,1989 CygnusSoft Software.
  189.  
  190. ARP is Copyright 1987,1988,1989 by ARP Authors.
  191.  
  192. Req.library was written by Colin Fox (of Pyramyd Designs) and Bruce Dawson
  193. (of CygnusSoft Software).
  194.  
  195. asl.library comes with AmigaDOS version 2.04 and above.
  196. I believe this is Copyright CBM.
  197.