home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 52 / af052sub.adf / PowerSnap.lha / PowerSnap / PowerSnap.doc < prev    next >
Text File  |  1992-11-22  |  35KB  |  902 lines
  1.  
  2.  
  3.      
  4.  
  5.  
  6.                            PowerSnap 2.1b User Manual
  7.  
  8.                                   Nov 22, 1992
  9.  
  10.  
  11.  
  12.      PREFACE 
  13.  
  14.         The programs   and   files   in   this   distribution   are  freely
  15.      distributable,  but  are also Copyright (c) Nico Francois. They may be
  16.      freely  distributed  as  long as no more than a nominal fee is charged
  17.      to cover time and copying costs.  
  18.         No commercial  usage  is  permitted without written permission from
  19.      the  author. Everything in this distribution must be kept together, in
  20.      original unmodified form.  
  21.         The above is generally known as freeware.  
  22.  
  23.         If you  have  suggestions  or remarks about this program, or if you
  24.      find any bugs, please let me know.  
  25.  
  26.         Contacting the author: 
  27.  
  28.           Fido:  2:292/603.10 (Nico Francois)
  29.  
  30.           UUCP:  Nico.Francois@p10.f603.n292.z2.FidoNet.Org
  31.  
  32.           Mail:  Nico François
  33.                  Corbielaan 13
  34.                  B-3060 Bertem
  35.                  BELGIUM
  36.  
  37.         If you  can  please use e-mail. That way you'll stand a much better
  38.      chance of getting a reply quickly.  
  39.  
  40.         NOTE: PowerSnap  2.1b  requires  Kickstart  and  Workbench  2.0  or
  41.      higher to run! 
  42.  
  43.  
  44.      1. Introduction 
  45.      --------------- 
  46.  
  47.         Snap, snap,  snap,  snap, eggs and snap :-)  Ahem...  (If you don't
  48.      get  this  don't  let  it bother you if you think I've gone completely
  49.      bananas :-) 
  50.  
  51.         PowerSnap is  a  utility  that  allows you to use the mouse to mark
  52.      characters  anywhere on the screen and paste them somewhere else, like
  53.      in  the  CLI  or in a string gadget. PowerSnap will check what font is
  54.      used  in  the  window  you snap from and will look for the position of
  55.      the  characters  automatically.  It  recognizes  all  non proportional
  56.      fonts  of  up to 24 pixels wide and of any height so this should cover
  57.      most  fonts  used.  Snapping and pasting text is done using the mouse,
  58.  
  59.  
  60.                                      Page 1
  61.  
  62.  
  63.      
  64.  
  65.  
  66.      making PowerSnap fast and easy to use.  
  67.         To try  PowerSnap out, double-click its icon, move the mouse over a
  68.      character  on  the  screen,  press  the left Alt key and while keeping
  69.      this  pressed  press  the  left  mouse  button.  After  a  short delay
  70.      (depends  on  how  big  the  font  is) PowerSnap will either flash the
  71.      screen,  indicating  it  hasn't found a character at this position (it
  72.      is  possible  PowerSnap  didn't  look  for  the  correct font), or the
  73.      character  you  are pointing at will be selected. Move the mouse while
  74.      keeping  the  left  Alt  key  and the mouse button down to select more
  75.      characters.  Once  you  are  satisfied  with  what  you  have selected
  76.      release  the  left  Alt key. You can now insert the text you have just
  77.      snapped  by  pressing  either  left  Alt + V or left Alt + right mouse
  78.      button.  
  79.         Both the   left  Alt  and  the  V  keys  mentioned  in  this  short
  80.      explanation   are   user-definable  (see  below).  Also,  don't  start
  81.      snapping  on  a  space because PowerSnap will almost certainly get the
  82.      character  positions  wrong.  You CAN start snapping on a space if you
  83.      have already snapped in the window.  
  84.         New to  PowerSnap  2.1  is the ability to keep a history of snapped
  85.      strings.  You may select from this history to re-paste something.  
  86.  
  87.  
  88.      2. Installation 
  89.      --------------- 
  90.  
  91.         To install  PowerSnap  automatically use the installation script or
  92.      install  the  handler  manually by copying 'PowerSnap-handler' to your
  93.      L:  directory.   'PowerSnap-handler'  does not have to be in L: but it
  94.      is  best  if you put it there, PowerSnap will also find it if it is in
  95.      the current directory.  
  96.         If you  want  PowerSnap  to be part of your initial startup (so you
  97.      always  have  the comfort of snapping anything anywhere :-) you should
  98.      put  a simple line saying 'PowerSnap' in your 's:user-startup'. If you
  99.      wish  to  specify  options  include  these  on the same line, like for
  100.      example  'PowerSnap  SMARTSPACE  COLOR  2'.  To  disable the copyright
  101.      message redirect output to NIL: like in 'PowerSnap >NIL:'.  
  102.         Workbench 2.0  users have the following extra possibility: drag the
  103.      PowerSnap  icon into the WbStartup drawer of your boot disk/partition.
  104.      And  that's  all  there  is  to  it.  Specify  options  in  the icon's
  105.      tooltypes (you will want to set the tooltype 'CX_POPUP=NO').  
  106.         In any case make sure PowerSnap is in your command path! 
  107.  
  108.  
  109.      3. Usage 
  110.      -------- 
  111.  
  112.      3.1 From CLI or Shell 
  113.  
  114.         Enter 'PowerSnap  ?' for a CLI usage template, 'PowerSnap ??' for a
  115.      more detailed usage report.  
  116.  
  117.  
  118.  
  119.  
  120.                                      Page 2
  121.  
  122.  
  123.      
  124.  
  125.  
  126.         Explanation of the options: 
  127.  
  128.      CX_PRIORITY n  : Set priority of commodity (default: 0).  
  129.  
  130.      CX_POPUP YES|NO: Set to NO to not open GUI window when PowerSnap is
  131.                       first installed (default: YES).  
  132.  
  133.      CX_POPKEY desc : Standard description of hotkey to pop up GUI window
  134.                       (default: control lalt p).  
  135.  
  136.      NOGUI          : Don't open GUI settings window.  
  137.  
  138.      QUAL qual      : Set snap qualifier (default: lalt). This is the
  139.                       qualifier that must be down when you press the left
  140.                       mouse button to start snapping. This is also the
  141.                       qualifier for inserting the snapped text. There are
  142.                       two ways to insert snapped text: using the paste key
  143.                       or using the right mouse button.  
  144.  
  145.      SLQUAL qual    : Set single line paste qualifier (default:
  146.                       lalt+lshift). When this qualifier is down and you
  147.                       insert snapped text everything will be put on one
  148.                       single line.  All whitespace (spaces and newlines)
  149.                       between words will be changed to a single space.
  150.                       Very useful for inserting a lot of filenames from a
  151.                       directory for example.  
  152.  
  153.      MULTIQUAL qual : Set multisnap qualifier (default: lalt+lshift). When
  154.                       you start snapping with this qualifier the snapped
  155.                       text will be appended after what you snapped before.
  156.                       A newline will be placed in between the snapped
  157.                       texts, so they are all on their own line. Paste
  158.                       snapped text using the single line qualifier to get
  159.                       everything on one line. Note that the default single
  160.                       line qualifier and the multisnap qualifier are the
  161.                       same. You can still toggle multisnap on or off when
  162.                       you are already snapping. Just change the qualifier,
  163.                       so in the default setup let go or press down the
  164.                       shift key. There is a small delay of 1/8 sec before
  165.                       toggling the snap mode. This was done so it is less
  166.                       likely that you accidently snap in the wrong mode
  167.                       when you release all qualifiers to stop snapping.  
  168.  
  169.      PASTEKEY c     : Set pastekey (default: V). This key is used to
  170.                       insert the snapped text. Insertion will follow when
  171.                       it is pressed with one of the three possible
  172.                       qualifiers down (QUAL, SLQUAL, PAQUAL).  
  173.  
  174.      SNAPCHARS      : Start with character snap (default).  
  175.  
  176.      SNAPFRAME      : Start with frame snap. PowerSnap has two snap modes:
  177.                       character and frame.  The easiest to explain is
  178.  
  179.  
  180.                                      Page 3
  181.  
  182.  
  183.      
  184.  
  185.  
  186.                       frame snap, you just draw a rectangle and everything
  187.                       inside it will be snapped. Character snap will
  188.                       interpret the screen as lines of text (like an
  189.                       editor) and will snap accordingly.  
  190.  
  191.      [NO]JOIN       : Join mode on/off (default: JOIN). Tells PowerSnap if
  192.                       it's ok to join two lines to a single long line when
  193.                       the first line has a non blank character as its last
  194.                       character. This only works when you are using
  195.                       character, word or line snap.  
  196.  
  197.      [NO]XEROX      : Xerox insert mode on/off (default: NOXEROX). When
  198.                       xerox mode is on snapped text will be inserted
  199.                       immediately when you stop snapping.  
  200.  
  201.      COLOR 1-3      : Set color of select box (default: 1). This sets the
  202.                       color of the complemented characters. Try all three
  203.                       and see what you like best.  
  204.  
  205.      MULTICOLOR 1-3 : Set color of multisnap select box (default: 2). This
  206.                       sets the color of the complemented characters when
  207.                       doing a multisnap. It is best to set this to a
  208.                       different color than the normal snap color. This way
  209.                       you'll have an easy way to see when you are using
  210.                       multisnap.  
  211.  
  212.      PAQUAL qual    : Set pre-/append qualifier (default: lalt+ctrl). When
  213.                       using this qualifier to insert snapped text a string
  214.                       will be prepended to each line and one will be
  215.                       appended.  
  216.  
  217.      PREPEND str    : Set prepend string (default: "> "). Use this to set
  218.                       the string that will be prepended when you paste
  219.                       with the PAQUAL down. This string can be up to 16
  220.                       characters long. To enter a '"' in the string escape
  221.                       it with a '*'.  E.g. 'PowerSnap PREPEND " *" "'.  
  222.  
  223.      APPEND str     : Set append string (default: ""). Use this to set the
  224.                       string that will be appended when you paste with the
  225.                       PAQUAL down. Can be up to 16 characters.  
  226.  
  227.      [NO]SMARTSPACE : If you do a word snap PowerSnap will normally guess
  228.                       at the boundaries of the word by simply looking for
  229.                       empty chars. If you switch SMARTSPACE on however
  230.                       PowerSnap will really try to recognize the
  231.                       characters and stop at spaces as well as unknown
  232.                       characters. This way you will no longer snap part of
  233.                       the 'scenery' when doing a word snap. Only drawback
  234.                       is that it is a bit slower, so it is disabled by
  235.                       default. If you have a faster Amiga (like the A3000)
  236.                       it is strongly recommended to switch this option on.
  237.                       If you don't exactly understand what I mean try
  238.  
  239.  
  240.                                      Page 4
  241.  
  242.  
  243.      
  244.  
  245.  
  246.                       snapping the contents of a qualifier text gadget in
  247.                       PowerSnap's settings window with SMARTSPACE switched
  248.                       on and off.  
  249.  
  250.      [NO]ALLFONTS   : If you switch ALLFONTS on PowerSnap will try all
  251.                       open fonts in memory when it is looking for
  252.                       characters. This will make the initial snap much
  253.                       slower (depending on how many fonts are open and how
  254.                       fast your Amiga is of course).  Once a specific font
  255.                       is recognized it is remembered and will be tried
  256.                       first next time you snap. So if you snap the same
  257.                       font several times you won't have the delay each
  258.                       time you snap. The default behaviour is to just
  259.                       consider the window's rastport font. Recognition of
  260.                       the window's rastport font is _not_ slower with
  261.                       ALLFONTS on. So with ALLFONTS off you won't
  262.                       recognize a non-rastport font, and with ALLFONTS on
  263.                       you will, but more slowly.  
  264.  
  265.      HISTORY n      : Set number of lines in history buffer.  PowerSnap
  266.                       will remember the last n snaps.  Pressing Left Alt-H
  267.                       (or whatever you defined to be the history key) will
  268.                       bring up a window with a listview containing these
  269.                       last snaps.  Selecting an entry from the listview
  270.                       will copy the entry to the clipboard so you can
  271.                       paste it again.  The history window is keyboard
  272.                       controllable:  you may use the up and down arrow
  273.                       keys to select an entry.  Press Enter or Return to
  274.                       copy the selected entry to the clipboard, press Esc
  275.                       to cancel.  Default is 0, so no history.  
  276.  
  277.      HISTORYKEY c   : Set the history key (default:  H).  Pressing this
  278.                       key together with the snap qualifier will pop up the
  279.                       history window.  The history window will appear on
  280.                       the active screen.  A safety has been built into
  281.                       PowerSnap to remove this window if the screen it is
  282.                       on closes.  
  283.  
  284.      CHARDELAY n    : Set character paste delay in microseconds (default:
  285.                       1).  Some programs have problems if text is pasted
  286.                       to quickly.  Using CHARDELAY you can tell PowerSnap
  287.                       to add a delay between pasting characters.  The
  288.                       delay is specified in microseconds (1 sec = 1000).
  289.                       I doubt you will have to set this higher than 20.  
  290.  
  291.      LINEDELAY n    : Set line paste delay in microseconds (default:  1).
  292.                       Same as CHARDELAY, but this delay will be added
  293.                       between pasting lines (after pasting a newline).  
  294.  
  295.  
  296.         Following qualifiers are recognized: 
  297.  
  298.  
  299.  
  300.                                      Page 5
  301.  
  302.  
  303.      
  304.  
  305.  
  306.         lshift       Left shift key
  307.         rshift       Right shift key
  308.         ctrl         Control key
  309.         control      Control key
  310.         lalt         Left alt key
  311.         ralt         Right alt key
  312.         lamiga       Left Amiga key
  313.         lcommand     Left Amiga key
  314.         ramiga       Right Amiga key
  315.         rcommand     Right Amiga key
  316.         midbutton    Middle mouse button (if you have one :-)
  317.  
  318.         Or any   combination   of  these  (separate  the  qualifiers  by  a
  319.      non-alpha  character  like  a  '+', '-' or '|'), e.g. 'lalt+lshift' or
  320.      'lalt-lshift'.  
  321.  
  322.         You may  run  PowerSnap  again once it has been installed to change
  323.      the settings. 'PowerSnap QUIT' will remove the handler from memory.  
  324.  
  325.         Examples: 
  326.  
  327.         o PowerSnap PREPEND "Type " APPEND " OPT N" 
  328.  
  329.         When  you paste some text 'Type ' will be inserted before each line
  330.         and  '  OPT N' after. If you e.g. snap 'PowerSnap.c' and press left
  331.         Alt  Ctrl  V  the following will be inserted: 'Type PowerSnap.c OPT
  332.         N' 
  333.  
  334.         o PowerSnap QUAL lshift+rshift+ctrl 
  335.  
  336.         This  sets the snap qualifier to both Shift keys plus the Ctrl key.
  337.         This  is  a rather silly example because unless your name is Zaphod
  338.         Beeblebrox  or  you are very good at doing things with your feet it
  339.         is quite impossible to snap anything with this qualifier :^) 
  340.  
  341.         o PowerSnap PASTEKEY i 
  342.  
  343.         Sets  the  paste  key to 'I' instead of 'V'. So pressing left Alt I
  344.         will feed the text in the clipboard to the keyboard.  
  345.  
  346.      NOTE: - You can toggle between character/frame snap once you have
  347.              started snapping. Just keep the left mouse pressed down while
  348.              you click the right one. Be careful, if you don't keep the
  349.              left button pressed you will insert the text you have
  350.              marked.  
  351.            - PowerSnap has the ability to do word oriented snapping. To
  352.              activate this double-click the left mouse button when you
  353.              start snapping. Note that word snapping forces character
  354.              snapping and frame snapping is no longer possible.  See
  355.              SMARTSPACE on how to improve word snapping.  Tripple-clicking
  356.              the left mouse button will put PowerSnap in line-snap mode,
  357.              this allows you to easily snap whole lines of text.  
  358.  
  359.  
  360.                                      Page 6
  361.  
  362.  
  363.      
  364.  
  365.  
  366.            - Press the left mouse button while PowerSnap is inserting to
  367.              abort.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.                                      Page 7
  421.  
  422.  
  423.      
  424.  
  425.  
  426.      3.2 From Workbench 
  427.  
  428.         PowerSnap recognizes   the   following   tooltypes  (see  CLI/Shell
  429.      options for a more complete explanation): 
  430.  
  431.      CX_PRIORITY=n  : Priority of commodity (default is 0).  
  432.      CX_POPUP=YES|NO: Set to NO to not open GUI window when PowerSnap is
  433.                       first installed. Set this tooltype to NO if you drag
  434.                       PowerSnap into your WbStartup drawer for a quiet
  435.                       startup (default: YES).  
  436.      CX_POPKEY=desc : Standard description of hotkey to pop up GUI window
  437.                       (default: control lalt p).  
  438.      QUAL=qual      : Snap qualifier (default: lalt).  
  439.      SLQUAL=qual    : Single line qualifier (default: lalt+lshift).  
  440.      MULTIQUAL=qual : multisnap qualifier (default: lalt+lshift).  
  441.      PASTEKEY=c     : Pastekey (default: V).  
  442.      SNAPFRAME      : Start with frame snap.  
  443.      COLOR=1-3      : Color of select box (default: 1).  
  444.      MULTICOLOR=1-3 : Color of multisnap select box (default: 2).  
  445.      NOJOIN         : Join mode off.  
  446.      XEROX          : Xerox insert mode on.  
  447.      PAQUAL=qual    : Pre-/append qualifier (default: lalt+ctrl).  
  448.      PREPEND=str    : Prepend string (default: "> ").  
  449.      APPEND=str     : Append string (default: "").  Do *NOT* put quotes
  450.                       around the pre-/append string.  
  451.      SMARTSPACE     : Switch SMARTSPACE on for improved word snapping.  
  452.      ALLFONTS       : Switch ALLFONTS on to try all open fonts in memory.  
  453.      HISTORY=n      : Set number of lines in history buffer (default: 0).  
  454.      HISTORYKEY=c   : Set history key (default: H).  
  455.      CHARDELAY=n    : Set character paste delay in microseconds (default:
  456.                       1).  
  457.      LINEDELAY=n    : Set line paste delay in microseconds (default: 1).  
  458.  
  459.         Select PowerSnap's  icon  and choose 'Information' from the 'Icons'
  460.      menu.   You  can  now edit PowerSnap's tooltypes, check your Workbench
  461.      manual for more information.  
  462.  
  463.         The provided  PowerSnap  icon  has  the following tooltypes already
  464.      set:  'SMARTSPACE'  and  'ALLFONTS'.   So edit the icon's tooltypes if
  465.      you  want  to  change  these.   All other tooltypes are also listed in
  466.      brackets.   The  brackets  are  used  to  'comment out' a tooltype, so
  467.      remove them if you want to use the tooltype.  
  468.  
  469.         Running PowerSnap  twice  will bring up the settings window. Select
  470.      'Quit'  from this window's 'Project' menu to remove PowerSnap. You can
  471.      of  course  use  the  system's  Commodities  Exchange  program to kill
  472.      PowerSnap.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.                                      Page 8
  481.  
  482.  
  483.      
  484.  
  485.  
  486.      4. Settings Window 
  487.      ------------------ 
  488.  
  489.         When you  start PowerSnap you will be presented with a window where
  490.      you  can  change all of PowerSnap's settings. You may open this window
  491.      at  any  time by using PowerSnap's hotkey (control lalt p, or whatever
  492.      you  set  using  CX_POPKEY)  or  by  using  the  standard  Commodities
  493.      Exchange program.  
  494.  
  495.         Everything in  this  window  should be fairly self-explanatory. The
  496.      window  has  a  project  menu with two items: Hide and Quit. Selecting
  497.      Hide  is  the  same as using the window's close gadget, selecting Quit
  498.      will remove PowerSnap from the system.  
  499.  
  500.         Most changes  you  make  will  be effective immediately, so you can
  501.      try  them  out  at  once. The qualifiers will only be changed once you
  502.      close the window used to set them.  
  503.  
  504.         Note that  the  code  for  this  window is located in the PowerSnap
  505.      program,  not  in  PowerSnap-handler.  The  window  code  will only be
  506.      loaded  when  actually  needed,  so  PowerSnap  will  use a minimum of
  507.      memory when hidden.  
  508.  
  509.  
  510.      5. Features 
  511.      ----------- 
  512.  
  513.        o Fully  supports  the clipboard.device. You can use snapped text in
  514.          all other programs that supports the clipboard.device.  
  515.  
  516.        o Snaps all printable characters, from ' ' (32) to 'ÿ' (255).  
  517.  
  518.        o Supports all keymaps.  
  519.  
  520.        o Uses  a relatively small handler that is about 11K long. PowerSnap
  521.          uses  about  20K  of memory once it is installed (excluding memory
  522.          used by the clipboard.device and commodities.library).  
  523.  
  524.        o Recognizes  all non-proportional fonts to up to 24 pixels wide and
  525.          of   any   height.   Also  recognizes  scaled  fonts  (bitmap  and
  526.          IntelliFonts).  
  527.  
  528.        o Recognizes  plain,  underlined,  bold,  inverse,  bold underlined,
  529.          inverse  underlined,  inverse  bold  and  inverse  bold underlined
  530.          characters :-) 
  531.  
  532.        o Works   with  fonts  with  kerning  data  (like  the  courier.font
  533.          supplied with Workbench 2.0).  
  534.  
  535.        o Will  remember  character  positions  in up to 8 windows. Once you
  536.          have  snapped  in  a window the initial character position will be
  537.          found immediately and you may also start snapping on spaces.  
  538.  
  539.  
  540.                                      Page 9
  541.  
  542.  
  543.      
  544.  
  545.  
  546.  
  547.        o Joins long lines.  
  548.  
  549.        o Pre-/appends strings to pasted text.  
  550.  
  551.        o Has  a  single-line  mode  to paste all snapped text onto a single
  552.          line. Whitespace and newlines will be changed to spaces.  
  553.  
  554.        o Supports  a  middle  mouse  button if one exists. Using the middle
  555.          button  as  qualifier  gives the possibility to snap/paste without
  556.          touching the keyboard! 
  557.  
  558.        o Inputhandler   is   written   in   assembly  for  lowest  possible
  559.          overhead.  
  560.  
  561.        New features for PowerSnap 2.0 & 2.1: 
  562.        ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ 
  563.        o Has  a  full  intuition/gadtools  interface to allow you to change
  564.          all  settings using the mouse. The window code is loaded from disk
  565.          when needed for minimum memory usage.  
  566.  
  567.        o PowerSnap  is  a  standard commodity. Use the standard Commodities
  568.          Exchange  program  to  enable/disable  it, kill it or to show/hide
  569.          the settings window.  
  570.  
  571.        o Multisnap  feature.  Allows  you  to  snap something and add it to
  572.          what  you  snapped  before. This append-snapping is very useful to
  573.          pick  up  several  words that you might want to join into one long
  574.          snap.  The snapped items are put in the clipboard, each on its own
  575.          line  (with  a linefeed between them). You can use the single-line
  576.          paste to paste them all onto one line.  
  577.  
  578.        o Recognizes  text  in all colors. Text in any color on a background
  579.          of any color will be recognized.  
  580.  
  581.        o SMARTSPACE  feature  to make PowerSnap consider unknown stuff as a
  582.          space.   This  way  you  can  do  _much_  better  word snapping in
  583.          non-shell windows.  
  584.  
  585.        o Can  be  told  to  try  and  recognize  text  in all open fonts in
  586.          memory.   PowerSnap  will  then  recognize  _all_ non-proportional
  587.          fonts  (up  to  24 pixels wide) also if the font is not set in the
  588.          window's rastport.  
  589.  
  590.        o Keeps   an  optional  history  of  snapped  text.   PowerSnap  can
  591.          remember  up  to  99  strings  you snap.  Pressing the history key
  592.          will  cause  a  history  window  to  pop  up and will allow you to
  593.          select a string to be re-pasted.  
  594.  
  595.  
  596.                                                        As always, enjoy! 
  597.  
  598.  
  599.  
  600.                                     Page 10
  601.  
  602.  
  603.      
  604.  
  605.  
  606.  
  607.                                 PROGRAM HISTORY
  608.  
  609.      ********************************************************************** 
  610.      VERSION 1.0 
  611.  
  612.      o First release.  
  613.  
  614.      ********************************************************************** 
  615.      VERSION 1.1 
  616.  
  617.      o Fixed  bug in reading from clipboard. Strange things could happen if
  618.        the  clipboard  did  not  contain  text.  Unknown clips are properly
  619.        ignored  now.   Incompatibility  with 'ConClip' (Workbench 2.0, V37)
  620.        resolved.   Default COLOR changed to 1.  Version string embedded for
  621.        Workbench 2.0 'Version' command.  
  622.      o To  put  the record straight: PowerSnap is not a modified version of
  623.        Snap  (by  Mikael  Karlsson).  It  is a completely different program
  624.        that  does  most  of the things Snap does. A lot of the features and
  625.        ideas  in  PowerSnap  were influenced by (read: stolen from :-) Snap
  626.        though.  I  just  thought  I'd  mention  this  because  some  German
  627.        magazine  almost  convicted  me  for plagiarism, oh boy :^D  I wrote
  628.        PowerSnap  because  I  was not happy with Snap taking up over 80K of
  629.        my precious memory (PowerSnap only uses about 12K).  
  630.      o The  Amiga  would  hang  if  you tried to snap something just when a
  631.        window  was  about  to  close.  Now all the Intuition functions that
  632.        open,  close  or  modify windows are patched so they will wait until
  633.        snapping  has  finished.  If  you are running Kickstart 2.0, the new
  634.        Intuition   functions   are   also  patched.  This  should  fix  all
  635.        deadlocks.  
  636.      o New  tooltype  'QUIET'  added  for  startup  from  Workbench without
  637.        window.  
  638.      o Tested with Enforcer and Mungwall debugging tools.  
  639.  
  640.      ********************************************************************** 
  641.      VERSION 2.0 
  642.  
  643.        ** ONLY RUNS ON KICKSTART 2.0 OR HIGHER! ** 
  644.  
  645.      o PowerSnap  is  a  commodity  now,  so it can be disabled/enabled and
  646.        killed  using the Commodities Exchange program. Note the replacement
  647.        of  the  'PRIORITY' argument by 'CX_PRIORITY' to set the commodity's
  648.        priority rather than that of the input handler (default is 0).  
  649.      o Now  has  a  hotkey to pop up a GUI window to set the settings. This
  650.        window  allows you to easily change all of PowerSnap's settings with
  651.        the  mouse.   Note  that  the  QUIET  tooltype has been removed. Use
  652.        CX_POPUP=NO now.  
  653.      o Fixed bug: no longer crashes on fonts with LoChar smaller than 32.  
  654.      o PowerSnap's  character  recognition  has  been  improved. Before you
  655.        could  only  snap  black  or  blue text, now you may also snap white
  656.        text.  In  fact  PowerSnap  now  recognizes  text  in any color on a
  657.        background of any color. How could you ever manage without this :) 
  658.  
  659.  
  660.                                     Page 11
  661.  
  662.  
  663.      
  664.  
  665.  
  666.      o New  SMARTSPACE  and NOSMARTSPACE arguments. Allows you to switch on
  667.        much  better,  but slower, word-snap detection. Once you get used to
  668.        this  I  think you won't mind it's a bit slower. It is no problem on
  669.        faster Amigas of course, like the A3000.  
  670.      o New  multisnap  feature: allows you to add what you snap now to what
  671.        you  snapped before. That way you can e.g. snap several files from a
  672.        directory without having to snap them all at once.  
  673.      o PowerSnap  will  now  optionally  consider every font currently open
  674.        instead  of just the window's rastport font. ALLFONTS and NOALLFONTS
  675.        arguments.  
  676.      o Will  abort  the  snap  if you release the snap qualifier before the
  677.        recognition routine has finished.  
  678.      o Allows you to use lamiga, ramiga and ctrl to specify qualifiers.  
  679.  
  680.      ********************************************************************** 
  681.      VERSION 2.0a 
  682.  
  683.      o Error  reporting  much improved.  If handler fails to initialize you
  684.        will  be  informed  of  the  problem  (instead  of just flashing the
  685.        display).  
  686.      o Fixed  bug:  if  handler  failed  to  initialize the settings window
  687.        would  appear  and  would  allow you to change settings that weren't
  688.        there :-) 
  689.      o Settings  window  changed to a simple refresh window.  Refreshing is
  690.        a  bit  slower,  but when the window is covered a lot of chip memory
  691.        is saved (especially on screens with a lot of colors/bitplanes).  
  692.      o The  handler  will  now  complain  if it can't find PowerSnap in the
  693.        command path.  
  694.  
  695.      ********************************************************************** 
  696.      VERSION 2.1 
  697.  
  698.      o PowerSnap  now  (optionally)  keeps  a  history  list of all snapped
  699.        text.   It is possible to pick a string from this history list to be
  700.        re-snapped.   Pressing  Left  Alt-H  (or another key you may choose)
  701.        will  bring  up  a  window on the currently active screen containing
  702.        the  snap  history.  This window will be automatically closed if the
  703.        screen it is on closes.  
  704.      o Somebody  reported  he  had  a  problem  when using QMouse (with the
  705.        sunmouse  feature)  and  PowerSnap together.  I have changed the way
  706.        PowerSnap  patches  the window functions of Intuition.  If a program
  707.        tries  to  use  an  Intuition  window  function snapping will now be
  708.        aborted.  This should fix all deadlock problems.  
  709.      o Using  the  middle  mouse button qualifier didn't work.  Fixed.  Now
  710.        you can finally snap and paste without using the keyboard.  
  711.      o On  Kickstart  3.0 the wait pointer in the settings window is set to
  712.        the standard Intuition wait pointer.  
  713.      o Two  new  switches:  CHARDELAY  and  LINEDELAY.  Allow you to set an
  714.        optional    delay    when   pasting   characters   and   lines   (in
  715.        milliseconds).   Default  delay is set to 1 microsecond (ok for most
  716.        programs).   MEmacs  (in  your  Workbench's  Tools  drawer  seems to
  717.        require a character delay of 5).  
  718.  
  719.  
  720.                                     Page 12
  721.  
  722.  
  723.      
  724.  
  725.  
  726.      o Recognition  of  underscore  character improved.  PowerSnap will try
  727.        to  be  smart about figuring out wether a character is an underscore
  728.        or an underlined space.  
  729.      o PowerSnap  will  check  the  version of PowerSnap-handler. This will
  730.        take  care  of  the  problem of an old handler still being installed
  731.        and causing weird things to happen.  
  732.      o Amazingly  stupid  bug  fixed  :)   Seems V37 of commodities library
  733.        doesn't  understand  the  'ctrl'  qualifier  (only 'control').  This
  734.        caused  the  default  popup  key  not  to work on Workbench 2.0.  On
  735.        Workbench  2.1  or  3.0 all worked perfectly.  Default popup key has
  736.        been changed to 'control lalt p'.  
  737.  
  738.      ********************************************************************** 
  739.      VERSION 2.1a 
  740.  
  741.      o New  feature: line snapping.  Tripple clicking the mouse button will
  742.        put  PowerSnap  in  line  snap mode.  This allows you to easily snap
  743.        whole  lines  of  text from a window.  Clicking again will bring you
  744.        back to character/frame snapping.  
  745.      o New  feature:  trailing  spaces  will be automatically stripped from
  746.        each  line  of  snapped  text.  Spaces will not be stripped from the
  747.        last line of text if you are in character snap mode.  
  748.      o Now   refuses   to   quit   when  some  other  program  has  patched
  749.        intuition.library.    Previous   versions   would   blindly  unpatch
  750.        intuition.library   causing  all  sorts  of  strange  and  wonderful
  751.        crashes :-) 
  752.      o PowerSnap  will  now  generate  both  key-down  _and_ key-up events.
  753.        Previously  only  a  key-down  event  was  sent to the input.device,
  754.        confusing some programs.  
  755.      o Bug  fix:  PASTEKEY  and HISTORYKEY arguments didn't work and caused
  756.        enforcer hits.  Fixed.  
  757.      o Bug  fix:  fixed  enforcer hit that occured when settings window was
  758.        popped up (using Commodities Exchange or popup key).  
  759.  
  760.      ********************************************************************** 
  761.      VERSION 2.1b 
  762.  
  763.      o Bug  fix:  inputevents  are now properly cleared before filling them
  764.        in  and  sending them to the input.device.  This should fix problems
  765.        with   corrupted   pastes   a   small   percentage   of   users  was
  766.        encountering.  
  767.      o History  window  made  keyboard controllable.  Use the up/down arrow
  768.        keys  to  select  an entry.  Press Return or Enter to accept, Esc to
  769.        cancel.   Will  look  best  on  Kickstart  3.0  because the listview
  770.        gadget  uses  a highlight box to show which item is selected, on 2.0
  771.        a text gadget is used.  
  772.      o Word  snapping  improved.   You  may  now  start  word snapping on a
  773.        space.   The space will be included in the snap.  Request from Roger
  774.        Nordin  (or  'a  major  problem' as he calls it).  I hope this makes
  775.        Roger happy :^) 
  776.  
  777.  
  778.  
  779.  
  780.                                     Page 13
  781.  
  782.  
  783.      
  784.  
  785.  
  786.      o Fixed  the  annoying  'DisplayBeep()  not  going  away  until I stop
  787.        snapping'  problem  :-)  Thanks to Roger Nordin for bugging me about
  788.        this.   This  bug(?)  has  been  in  PowerSnap  from  the day it was
  789.        released but I never bothered to fix it.  
  790.      o Changed  some code to use Kickstart 3.0 bitmap/rastport functions if
  791.        possible.  This should improve future compatibility.  
  792.  
  793.      ********************************************************************** 
  794.  
  795.      PowerSnap 2.1b by Nico François (Yes, Nico is my first name :-) 
  796.                     thanks to Jorrit Tyberghein, Ives Aerts, Philip
  797.                               Marivoet, Kenny Grant and Herman Stevens for
  798.                               beta testing.  
  799.  
  800.      Copyright (c) 1991/1992 Nico François 
  801.  
  802.                  //
  803.      Thanks to \X/ Amiga for being the best computer ever!
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.                                     Page 14
  841.  
  842.  
  843.      
  844.  
  845.  
  846.                                Table Of Contents
  847.  
  848.                                  PowerSnap 2.1b
  849.  
  850.      PREFACE.........................................................    1
  851.  
  852.      1. Introduction.................................................    1
  853.  
  854.      2. Installation.................................................    2
  855.  
  856.      3. Usage........................................................    2
  857.         3.1 From CLI or Shell........................................    2
  858.         3.2 From Workbench...........................................    8
  859.  
  860.      4. Settings Window..............................................    9
  861.  
  862.      5. Features.....................................................    9
  863.  
  864.      PROGRAM HISTORY.................................................   11
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.      
  901.  
  902.