home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / arq_upd.lzh / arq_upd / ARQ.doc < prev    next >
Encoding:
Text File  |  1991-05-31  |  7.3 KB  |  187 lines
  1.                                     Arq
  2.       Copyright ⌐ 1990,91 by Martin Laubach, Peter Wlcek and RenΘ Hexel
  3.                             All rights reserved
  4.  
  5.   1. Introduction      
  6.  
  7.        Arghh! There it is again... My favorite application just
  8.      wanted to inform me of some important event. And there it
  9.      appears, the much-hated standard system requester, that
  10.      itty-bitty window that seems glued forever to the upper left
  11.      edge of the screen, a requester that can only be acknoledged
  12.      using the mouse or some much too cryptic key combination (ugh!
  13.      been reading too much lyric lately?) 
  14.  
  15.        It seems that although appearance of these system requesters
  16.      has been improved in Kickstart 2.0 over 1.3, it wasn't nearly
  17.      enough. Close, but no banana...  
  18.  
  19.  
  20.   2. Who and why    
  21.  
  22.        Especially Peter was very unhappy with the new style
  23.      requesters in 2.0 (he doesn't like the 1.3 version either) --
  24.      "They have redone the Workbench, it now looks slick and shiny,
  25.      but those requesters are about as awful as they could be", and
  26.      "the design of the new requesters has already improved quite a
  27.      bit -- compared to Kickstart 1.3. But yet they are not yet
  28.      state-of-the-art".  
  29.  
  30.        Having seen one of my earlier tools, "CR", that remapped the
  31.      requesters under 1.3 to something a bit more appealing to the
  32.      eye (and IMHO, kinda much more user friendly), he came up with
  33.      the idea of redesigning those dialog boxes.  
  34.  
  35.        In the beginning, I was not quite happy about rewriting my
  36.      code to suit his rather perfectionist ideas ("now leave two
  37.      pixels here, and don't forget that line of gray to the
  38.      right...") -- no idea how he's done it, but he finally got me to
  39.      the point to do him the favor.  
  40.  
  41.        So here's the result. Note that it is trimmed to fit the "new
  42.      look" of Workbench 2.0 (hires interlace -- any other resolution
  43.      will make it look a bit weird).  
  44.  
  45.  
  46.   3. What      
  47.  
  48.        Arq, abreviation for -- well, I forgot --, is a little utility
  49.      to improve the look and feel of system requesters under AmigaOS
  50.      2.0.  Or, as Peter put it: 
  51.  
  52.        "If you were ever used to those really professional
  53.      Custom-Requesters for KS 1.3 from mjl, you were missing those
  54.      under AmigaOS-2. Well -- here they are!" 
  55.  
  56.        Since 1.57, Arq features a sound interface -- any appearing
  57.      requester now may be accompagnied by some user-definable sound.
  58.  
  59.  
  60.      What
  61.  
  62.      Please refer to the respective chapter for more information
  63.      about the sound interface.  
  64.  
  65.        Arq wedges into Intuition's AutoRequest(), EasyRequest() and
  66.      DisplayBeep() vectors (as well as CloseScreen(), but you won't
  67.      notice that one), and replaces each of those routines by our
  68.      artist's idea of a requester.  
  69.  
  70.        Note that the graphics are stored in fax-like compression
  71.      format. This means that you (a) won't be able to compress it
  72.      much further, (b) having several Arq requesters open on a plain
  73.      vanilla 68000 will slow down the system a bit.  
  74.  
  75.  
  76.   4. How to     
  77.  
  78.        Just "run arq" and enjoy the improved system messages. To stop
  79.      it, just send it a ^C via the "break" command (though I doubt
  80.      you'll ever want to quit it).  
  81.  
  82.        Under 2.0, you can control Arq with the Commodities Exchange
  83.      tool. You may freely enable, disable, or kill Arq. Also, when
  84.      you start Arq a second time, it will remove itself from the
  85.      system.  
  86.  
  87.        The main advantage of those requesters is (apart their look),
  88.      that we moved the strange combination of Left-Amiga-V and
  89.      Left-Amiga-B to the ESC and RETURN key, which makes life quite a
  90.      lot easier (no more knots in your fingers) -- though, of course,
  91.      those are working too.  
  92.  
  93.        Another possibility is to use the function keys, where F1
  94.      corresponds to the leftmost, F2 to the second, and so forth,
  95.      gadget -- that way you can answer requesters with more than two
  96.      buttons, like IconEdit's.  
  97.  
  98.        Though written with 2.0 in mind, Arq does work under 1.3 as
  99.      well -- but the layout will look a bit stretched in
  100.      non-interlace mode. We will come out with an adapted version
  101.      when the time is ripe (ie. bug me, and you'll probably get it
  102.      [sigh]).  
  103.  
  104.        Please also note that this command replaces some of the
  105.      library vectors in intuition.library -- restoring them is per
  106.      definitionem not a safe operation.  While this works most of the
  107.      time, you may witness wonderful things happening when there is
  108.      another tool wedged in after Arq. So please be careful.  
  109.  
  110.  
  111.   5. Sounding away     
  112.  
  113.        Instead of building the sound capability into Arq itself, we
  114.      chose to implement it following the client-server model:  a
  115.      sound playing server, as, for example the "upd" sound daemon by
  116.      Jonas Petersson will do all the hard work, giving you the
  117.      additional bonus of being able to play your favorite tunes from
  118.      your ARexx programs...  
  119.  
  120.        The following sound IDs are used, for the corresponding
  121.      requesters and DisplayBeep -- please refer to upd's
  122.      documentation how these work.  
  123.  
  124.           ╖ warn_write_protected
  125.           ╖ warn_insert_volume
  126.           ╖ warn_delete
  127.           ╖ warn_printer
  128.           ╖ error_task_held
  129.           ╖ error_read_write
  130.           ╖ error_general
  131.           ╖ warn_general
  132.           ╖ query_general
  133.           ╖ beep
  134.  
  135.  
  136.  
  137.   6. License      
  138.  
  139.        This material is ⌐ Copyright 1990 by Martin J. Laubach, Peter
  140.      Wlcek and RenΘ Hexel -- All rights reserved.   
  141.  
  142.        It may be distributed freely as long as the following
  143.      restrictions are met: 
  144.  
  145.        The distributor may charge a fee to recover distribution
  146.      costs. The fee for diskette distribution should not be more than
  147.      the cost to obtain the same diskette from Fred Fish.  
  148.  
  149.        The distributor agrees to cease distributing the programs and
  150.      data involved if requested to do so by the authors.  
  151.  
  152.        You may copy and distribute verbatim copies of the program's
  153.      executable code and documentation as you receive it, in any
  154.      medium, provided that you conspicuously and appropriately
  155.      publish only the original, unmodified program, with all
  156.      copyright notices and disclaimers of warranty intact and
  157.      including all the accompanying documentation, example files and
  158.      anything else that came with the original.   
  159.  
  160.        The author will not be liable for any damage arising from the
  161.      failure of this program to perform as described, or any
  162.      destruction of other programs or data residing on a system
  163.      attempting to run the program.  While I know of no damaging
  164.      errors, the user of this program uses it at his or her own
  165.      risk.   
  166.  
  167.   7. Acks and Naks    
  168.  
  169.           Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  170.           ARexx by William S. Hawes.
  171.           Perfectionism by Peter Wlcek.
  172.           Sporting events, transportation and girls by
  173.                    the Beach Boys.
  174.           upd by Jonas Petersson.
  175.           Window centering code by Holger Gzella, with additional comments
  176.                    by Peter Cherna.
  177.  
  178.  
  179.   8. Postscript      
  180.  
  181.         We are not really happy yet with the imaginery for "?" and
  182.      "!". Should you have "THE" idea, please get in touch with any of
  183.      us...  
  184.  
  185.        Also, don't hesitate to yell when you've got graphics you'd
  186.      like to see in the next version.
  187.