home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / util / cli / requestmode.lha / RequestMode.txt < prev    next >
Text File  |  1995-12-25  |  5KB  |  153 lines
  1.                              RequestMode v1.0
  2.                                 Adam Dawes
  3.                             25th December 1995
  4.  
  5.  
  6.  
  7. What is RequestMode?
  8. ======================
  9.  
  10. RequestMode is a little utility designed to complement the Commodore
  11. utilities, 'RequestChoice' and 'RequestFile', primarily of use in AmigaDos
  12. shell scripts and AREXX scripts.
  13.  
  14. The program displays a requester containing a list of monitor Display
  15. Modes, and waits for the user to select one of them. The selected mode will
  16. then be printed to stdout (in either hex format, or in English) -- so it's
  17. very convenient to redirect the output of RequestMode to an environment
  18. variable.
  19.  
  20.  
  21.  
  22. Using RequestMode
  23. =================
  24.  
  25. The parameter template for RequestMode is as follows:
  26.  
  27.  
  28.   RequestMode TITLE/A, GUI/S, FULLNAME/S, QUOTES/S, PUBSCREEN/K
  29.  
  30.  
  31.          Title: The title to be given to the ScreenMode requester that
  32.                 opens
  33.  
  34.            GUI: If this switch is present, only screenmodes that can be
  35.                 successfully used for a GUI will be available in the
  36.                 ScreenMode requester.
  37.  
  38.       FullName: This switch instructs RequestMode to print the selected
  39.                 screenmode in English, rather than as a Hex number.
  40.  
  41.         Quotes: If present, this switch instructs RequestMode to put
  42.                 double-quotes around the ScreenMode name printed. Note that
  43.                 if the FullName switch is not also set, this has no effect.
  44.  
  45.      PubScreen: Specified a PubScreen on which the ScreenMode requester
  46.                 should open.
  47.                 
  48.  
  49. An example application for RequestMode is supplied in the RequestMode
  50. archive, as "VT_SM.script". When executed, this 1-line script will open a
  51. ScreenMode requester, and will then use Viewtek to display all subsequently
  52. selected pictures in the selected screenmode. If you don't have a copy of
  53. Viewtek in your command path with the filename "Viewtek", you will need to
  54. slightly modify the script to contain the correct path/filename.
  55.  
  56.  
  57.  
  58. Requirements
  59. ============
  60.  
  61. RequestMode requires Kickstart 2 or greater, and also the ReqTools
  62. library by Nico François.
  63.  
  64.  
  65.  
  66. Known Bugs
  67. ==========
  68.  
  69. A couple of minor problems have shown themselves during the testing of
  70. RequestMode, though neither should stop it from being useful. The bugs
  71. found are:
  72.  
  73.  · RequestMode doesn't return a FullName when one of the following Screen-
  74.    Modes are selected:
  75.  
  76.         EURO72:160 x 400
  77.         EURO72:160 x 800-Interlaced
  78.         EURO72:320 x 400
  79.         EURO72:320 x 800-Interlaced
  80.  
  81.    The ModeID will still be returned as a hex number if you require. I've
  82.    no idea why this particular bug is occuring. The GetDisplayInfoData()
  83.    function just doesn't return me a name string for those resolutions! :(
  84.  
  85.  · There are some problems when using RequestMode in combination with the
  86.    backtick (`) character in C-Shell. If you experience problems with
  87.    RequestMode when using the backtick and C-Shell, try performing the same
  88.    command in AmigaDOS, or making an AmigaDOS shell script to perform the
  89.    same function. See the 'VT_SM.script' file for an example.
  90.  
  91.  
  92.  
  93. Legal stuff
  94. ===========
  95.  
  96. RequestMode is freeware. It may be distributed however and wherever you
  97. like.
  98.  
  99. I accept no responsibility for any damage done to your system, directly or
  100. indirectly, as a result of using RequestMode. You use the program
  101. entirely at your own risk.
  102.  
  103.  
  104.  
  105. History
  106. =======
  107.  
  108.   v1.0 (39.0)
  109.  
  110.         Initial release.
  111.  
  112.  
  113.  
  114. Contacting the author
  115. =====================
  116.  
  117. Please do write to me if you like RequestMode or if you have any problems
  118. with it or suggestions for a new version. I can't promise to reply quickly
  119. if you write via snail-mail, but I will always reply to email messages. I
  120. can be contacted at:
  121.  
  122.   InterNet
  123.      ad32@brighton.ac.uk
  124.      adam@beachyhd.demon.co.uk
  125.  
  126.   FidoNet
  127.      Adam Dawes@2:441/93.5
  128.  
  129.   SnailMail
  130.      Adam Dawes
  131.      47 Friar Road
  132.      Brighton
  133.      BN1 6NH
  134.      England
  135.  
  136.  
  137.  
  138. See Also
  139. ========
  140.  
  141. I have also written a couple of other utilities that complement this and
  142. the Commodore 'Request' commands:
  143.  
  144.  · 'RequestString', available from Aminet as 'util/batch/requeststring.lha'
  145.    provides a simple and easy way to prompt the user to enter some text
  146.    from within a script. Amongst other things, the requester can have a
  147.    default string already entered, and may have text entered invisibly (for
  148.    passwords, etc.).
  149.  
  150.  · 'RequestList' (from Aminet as 'util/cli/requestlist11.lha') allows the
  151.    user to select an item from a list of items. The list is built up from
  152.    text in a file you specify.
  153.