home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d03xx / d0302.lha / Chop / Chop.doc < prev    next >
Text File  |  1990-01-15  |  7KB  |  168 lines
  1.  
  2.  
  3.                             Chop 1.0 User Manual
  4.  
  5.                                  Nov 1, 1989
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.      This program is freeware, this means that you can copy it freely as long
  13. as you don't ask any more money for it than a nominal fee for copying.  If
  14. you want to distribute this program you should keep this document with it.
  15.      If you have suggestions or remarks about this program, or if you find
  16. any bugs, please let me know.
  17.  
  18.      Write to the following address:
  19.  
  20.                                 Nico Franτois
  21.                                 Corbielaan 13
  22.                              3060 Bertem BELGIUM
  23.  
  24.  
  25. Contents
  26. ========
  27.  
  28. 1. Introduction
  29.  
  30. 2. Usage
  31.  
  32. 3. Qualifiers
  33.  
  34.  
  35. 1. Introduction
  36. ==================
  37.  
  38.      Oh no !!!  Not another input handler !!!  'fraid so !
  39.  
  40.      But wait, there's something new:
  41.  
  42.      The main function this program was written for is the chopping of
  43. bitplanes, hence the name 'Chop'.  Chopping of bitplanes ???, well imagine
  44. this:  You have got no REAL fast memory (*) and you run a program that opens
  45. a screen of more than 4 planes lo-res or 2 planes hi-res, bingo, your Amiga
  46. slows down up to 50% of its normal speed !  This is because both the custom
  47. chips and the processor have access to the same memory area.  Now, wouldn't
  48. it be nice to chop the extra planes off on screen, but keep them internally
  49. so the processor can run at full speed ? Yes !!! Lo and behold:  Chop 1.0 !
  50.  
  51.      When you chop a screen only the display changes, internally the program
  52. will still continue to work with the full color palette.  Unchop the screen
  53. and everything will be back to normal.  For example:  In DPaint III, you are
  54. working in hi-res 4 planes (16 colors), you start a perspective fill (this
  55. can take a while).  The calculation will take TWICE as long as in hi-res 2
  56. planes (4 colors) !!  With Chop you can remove the two extra planes while the
  57. calculation is going on and bring'em back after it's finished, voila, a
  58. perspective fill that is twice as fast !!
  59.      Also included in this input handler are some of the more seen features,
  60. like a mouse accelerator, clicktofront (also with keys) and sunmouse.  Keys
  61. and qualifiers are user definable.
  62.  
  63. (*) In general you have real fast memory when you expand an Amiga 2000 or
  64.     when you expand and Amiga 500 EXTERNALLY (not with the A501).
  65.  
  66.  
  67. 2. Usage
  68. ========
  69.  
  70.      You can start 'Chop' from WorkBench or CLI.  To start it from the CLI
  71. type 'Chop <options>', there is no need to 'run' chop because it will just
  72. install a handler and exit.  To start it from the WorkBench select the icon
  73. and put 'ARGLINE=<options>' in the tooltypes (using 'Info' from the WorkBench
  74. menu) and then double-click it.  This way you can start Chop with your
  75. favourite options from WorkBench as well as the CLI.
  76.      When you start Chop it will try to load the Chop-Handler, copy this to
  77. your L: directory (or your current directory).  Chop uses less than 2K of
  78. memory once installed !!
  79.  
  80.      Type 'Chop ?' at the CLI prompt to get a usage message.  Chop accepts
  81. the following options:
  82.  
  83.   -c#   : Chop on/off
  84.   -C#.# : Set hex keycode and qualifier for chop
  85.           ( Use the key set with -C#.# to chop or unchop the front screen.
  86.             You can chop upto 8 screens.  Screens with user copper lists can
  87.             not be chopped. )
  88.   -w#.# : Win2Front on/off (1 = clicks, 2 = key, 3 = both) and # of clicks
  89.   -K#.# : Set hex keycode and qualifier for win2front (key)
  90.   -W#   : Set hex qualifier for win2front (clicks)
  91.   -b#   : Front2Back on/off
  92.           ( use -w#.# with 0 to 3 and any number of clicks to select the mode
  93.             for win2front.  When 'key' mode is selected you can move the
  94.             window under the pointer to the front by pressing the selected
  95.             key, this key can be set by -K#.#.  If you switch on front2back,
  96.             with -b1, now the window will be pushed to the back if it was
  97.             already in front of all the others.  With 1 (or 3) you select
  98.             'click' mode, now you can bring a window to the front by clicking
  99.             in it.
  100.               When you are working in the WorkBench the machine can hang up
  101.             if you use click2front when you are selecting an icon, e.g. when
  102.             you double-click an icon to start a program but you've also set
  103.             the number of clicks for click2front to 2.  Therefore it's best
  104.             to use a qualifier in the WorkBench for the click2front.  This
  105.             qualifier is automatically set to 0x30 when you start chop from
  106.             the WorkBench, so press either <ALT> key when you want to use
  107.             click2front in the WorkBench. )
  108.   -s#   : SunMouse on/off (1 = movement, 2 = rawkey, 3 = both)
  109.           ( When SunMouse is switched on the window under the mouse pointer
  110.             is always selected, so when you move the mouse over an inactive
  111.             window it will be automatically activated. )
  112.   -a#   : Mouse accelerator speed
  113.           ( This is for all who think the top mouse speed in Preferences is
  114.             not fast enough.  Accelerate the mouse N times by using -aN. )
  115.   -q    : Remove Chop-Handler (or execute twice from WB)
  116.  
  117.   Where # stands for a (hex) number. (1 is on, 0 is off)
  118.  
  119.      Default options are:
  120.  
  121.           Chop -c1 -C5f.30 -w2.0 -W0 -K5f.0 -b1 -s0 -a2      (CLI)
  122.  
  123.           Chop -c1 -C5f.30 -w2.0 -W30 -K5f.0 -b1 -s0 -a2     (WorkBench)
  124.  
  125.      This means press <HELP> to shuffle the windows, <ALT> <HELP> to (un)chop
  126. the front intuition screen.  Back2front is on and SunMouse is off.  The mouse
  127. is sped up 2 times.
  128.      When started from CLI click2front qualifier is 0x0, when started from
  129. WorkBench default qualifier is 0x30 (either ALT key).
  130.  
  131.  
  132. 3. Qualifiers
  133. =============
  134.  
  135.         Useful qualfiers for Chop (in hex):
  136.  
  137.      0000  No qualifier
  138.      0001  Left shift
  139.      0002  Right shift
  140.      0004  Caps lock
  141.      0008  Ctrl
  142.      0010  Left alt
  143.      0020  Right alt
  144.      0040  Left AMIGA
  145.      0080  Right AMIGA
  146.      1000  Middle mouse button (if you can find it :-)
  147.      2000  Right mouse button
  148.      4000  Left Mouse button
  149.  
  150.         Or (or add) these together to get a combination of qualifiers.
  151.  
  152.                                                   Enjoy !
  153.  
  154.  
  155.                               PROGRAM HISTORY:
  156.  
  157. *****************************************************************************
  158. VERSION 1.0
  159.  
  160.      First release.
  161.  
  162. *****************************************************************************
  163.  
  164. Chop 1.0 written by Nico Franτois (Yes, Nico is my first name :-),
  165.          bitplane chop function by Philip Marivoet.
  166.  
  167. (c) 1989 Nico Franτois / Philip Marivoet
  168.