home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / util / wb / magica2024 / magica2024_engl.doc < prev    next >
Text File  |  1994-08-14  |  5KB  |  175 lines
  1. MagicA2024 1.0 - Documentation
  2. ******************************
  3.  
  4. Copyright
  5. *********
  6.  
  7.    MagicA2024 (C) 1994 kMel, Klaus Melchior
  8.  
  9.    This program is freely distributable, but copyrighted by me. This
  10. means you may freely copy it as long as you do not charge more than a
  11. nominal fee for copying. This program may be put on PD disks,
  12. especially on Fred Fish's CDROMs, AminetCD or other cheap CDROMs. If
  13. you want to distribute this program you MUST keep this document with
  14. it. The program and the documents must be distributed in their original
  15. unmodified form.
  16.  
  17.    This program cannot be used for commercial purposes without written
  18. permission by the author. The author can not be made responsible for
  19. any damage which is caused by using this program.
  20.  
  21.    This program has a GiftWare option. If you like it and use it very
  22. often, you should consider to send a little donation to honor the work
  23. that the author has put into this program.
  24.  
  25.    Send comments, suggestions or bug reports, and the gifts to:
  26.  
  27.      Klaus Melchior, Schulstrasse 17
  28.      D-52156 Monschau, Germany
  29.      Phone: +49 (0)2472 4710
  30.      
  31.      DE:   kmel@eifel.oche.de
  32.      ADSP: kmel@eifel.adsp.sub.org
  33.      DE:   kmel@cwg.fido.de
  34.      FIDO: 2:2452/158.2@fidonet
  35.  
  36. What is MagicA2024 ?
  37. ********************
  38.  
  39.    MagicA2024 is a commodity and patches the private routines of the
  40. icon.library to recolor MagicWB icons to the four A2024 colors. The
  41. bitmap is adjusted on the fly, extra chip memory is needed for the new
  42. image, the blitter is used.
  43.  
  44.    While installing MagicWB or using a remapping tool like MUIReIcon,
  45. the remapped icon is shown, but the original icon is in work. But before
  46. using an icon-editor switch off MagicA2024.
  47.  
  48.    All icons with three or more bitplanes are modified. It's not
  49. possible to recognize non-MagicWB icons.
  50.  
  51.    Two remap routines are implemented, the default one uses the blitter,
  52. check out which one is faster with your configuration.
  53.  
  54.    It can also be used on a standard workbench with normal four-color
  55. palette. Feel free to use it with a workbench which has more than four
  56. colors, even non-MagicWB colors.
  57.  
  58. Arguments
  59. *********
  60.  
  61.    CLI Template: BLANK/S,NOBLITTER/S,CXPRI/K/N,ON/S,OFF/S,REMOVE/S
  62.  
  63. BLANK/S - ToolType: BLANK
  64.      display a blank icon instead of the MagicWB icon <grin>
  65.  
  66. CXPRI/K/N - ToolType: CX_PRIORITY=x
  67.      priority of MagicA2024 commodity
  68.  
  69. OFF/S
  70.      deactivate the already running MagicA2024, now new icons are
  71.      displayed with their original colors
  72.  
  73. ON/S
  74.      switch on the sleeping MagicA2024, new icons are remapped to A2024
  75.      colors
  76.  
  77. NOBLITTER/S - ToolType: NOBLITTER
  78.      a non-blitter routine is used for remapping
  79.  
  80. REMOVE/S
  81.      remove the running MagicA2024 from the commodities list
  82.  
  83. What you need !
  84. ***************
  85.  
  86.    - Kickstart >= 2.0
  87.  
  88.    - Workbench >= 2.0
  89.  
  90.    - A2024 monitor
  91.  
  92.    - MagicWB-Icons
  93.  
  94. How to install
  95. **************
  96.  
  97.    The main directory contains MagicA2024. Copy the "MagicA2024" to a
  98. drawer which contains your utilities.
  99.  
  100.      copy MagicA2024 bin:
  101.  
  102.    To start MagicA2024 automatically you have to insert some lines in
  103. your 's:user-startup'. Like this:
  104.  
  105.      ;BEGIN MAGICA2024
  106.      run >nil: <nil: "bin:MagicA2024"
  107.      ;END MAGICA2024
  108.  
  109.    It's possible to start MagicA2024 within the WBStartup drawer, but
  110. then the recolorization hasn't access on the already opened icons.
  111.  
  112.    PS: It's easier to use the Installer script !!!
  113.  
  114. History of MagicA2024
  115. *********************
  116.  
  117.  
  118.       1.0  15.08.94  * release to aminet & Fred Fish
  119.  
  120. This is restricted ...
  121. **********************
  122.  
  123.    - Bugs ? I hope not ...
  124.  
  125.    - 2 kiske units: patch private routines of icon.library
  126.  
  127. What is to do in future ?
  128. *************************
  129.  
  130.    - german documentation
  131.  
  132.    - patch routine to remap ToolManager docks
  133.  
  134.    - patch routine to remap WorkBench patterns
  135.  
  136. Thanks are going to ...
  137. ***********************
  138.  
  139.    - Stefan Stuntz [ss] for several tips & testing
  140.  
  141.    - Martin Huttenloher for MagicWB
  142.  
  143.    - Andreas Harrenberg [ah], Gottfried Janik [gj] for testing
  144.  
  145.    - Kai Iske (Mr Patch) for the icon.library hint
  146.  
  147.    - and all I forgot to mention ...
  148.  
  149. Index
  150. *****
  151.  
  152.  
  153.  
  154.  Arguments                              Arguments
  155.  Authors address                        Copyright
  156.  Bug reports                            Copyright
  157.  Bugs                                   Bugs & Limitations
  158.  CLI arguments                          Arguments
  159.  Comments                               Copyright
  160.  Copyright                              Copyright
  161.  Credits                                Credits
  162.  Description                            Description
  163.  Distribution                           Copyright
  164.  E-Mail                                 Copyright
  165.  GiftWare                               Copyright
  166.  History                                History
  167.  Installation                           Installation
  168.  Limitations                            Bugs & Limitations
  169.  MagicA2024                             Description
  170.  Requirements                           Requirements
  171.  Thanks                                 Credits
  172.  ToDo                                   ToDo
  173.  ToolTypes                              Arguments
  174.  
  175.