home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 7 / FreshFishVol7.bin / bbs / os20 / powersnap-2.2a.lha / PowerSnap / PowerSnap.doc < prev    next >
Text File  |  1994-02-10  |  41KB  |  962 lines
  1.  
  2.  
  3.      
  4.  
  5.  
  6.                            PowerSnap 2.2a User Manual
  7.  
  8.                                   Feb 10, 1994
  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.           Internet:   nico@augfl.be
  29.           FidoNet :   2:292/603.10
  30.           AmigaNet:   39:120/102.10
  31.  
  32.           Snail-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.2a  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.         PowerSnap 2.2  adds many new features, among which a font-sensitive
  87.      localized GUI, crawling ants and a possibility to save the settings.  
  88.  
  89.  
  90.      2. Installation 
  91.      --------------- 
  92.  
  93.         To install  PowerSnap  automatically use the installation script or
  94.      install  the  handler  manually by copying 'PowerSnap-handler' to your
  95.      L:  directory.   'PowerSnap-handler'  does not have to be in L: but it
  96.      is  best  if you put it there, PowerSnap will also find it if it is in
  97.      the current directory.  
  98.         If you  want  PowerSnap  to be part of your initial startup (so you
  99.      always  have  the comfort of snapping anything anywhere :-) you should
  100.      put  a simple line saying 'PowerSnap' in your 's:user-startup'. If you
  101.      wish  to  specify  options  include  these  on the same line, like for
  102.      example  'PowerSnap  SMARTSPACE  COLOR  2'.  To  disable the copyright
  103.      message redirect output to NIL: like in 'PowerSnap >NIL:'.  
  104.         The easiest  way  to  install  PowerSnap is to simply drag its icon
  105.      into  the  WbStartup  drawer  of  your  boot  disk/partition.  Specify
  106.      options  in  the  icon's  tooltypes (you will want to set the tooltype
  107.      'CX_POPUP=NO').  
  108.  
  109.  
  110.      3. Usage 
  111.      -------- 
  112.  
  113.      3.1 From CLI or Shell 
  114.  
  115.         Enter 'PowerSnap  ?' for a CLI usage template, 'PowerSnap ??' for a
  116.      more detailed usage report.  
  117.  
  118.  
  119.  
  120.                                      Page 2
  121.  
  122.  
  123.      
  124.  
  125.  
  126.         Note: when  PowerSnap  is  run  for  the  first  time  (when  it is
  127.      installed) the settings will be read from its icon.  
  128.  
  129.         Explanation of the options: 
  130.  
  131.      CX_PRIORITY n  : Set priority of commodity (default: 0).  
  132.  
  133.      CX_POPUP YES|NO: Set to NO to not open GUI window when PowerSnap is
  134.                       first installed (default: YES).  
  135.  
  136.      CX_POPKEY desc : Standard description of hotkey to pop up GUI window
  137.                       (default: control lalt p).  
  138.  
  139.      NOGUI          : Don't open GUI settings window.  
  140.  
  141.      QUAL qual      : Set snap qualifier (default: lalt). This is the
  142.                       qualifier that must be down when you press the left
  143.                       mouse button to start snapping. This is also the
  144.                       qualifier for inserting the snapped text. There are
  145.                       two ways to insert snapped text: using the paste key
  146.                       or using the right mouse button.  
  147.  
  148.      SLQUAL qual    : Set single line paste qualifier (default: lalt
  149.                       lshift). When this qualifier is down and you insert
  150.                       snapped text everything will be put on one single
  151.                       line.  All whitespace (spaces and newlines) between
  152.                       words will be changed to a single space. Very useful
  153.                       for inserting a lot of filenames from a directory
  154.                       for example.  
  155.  
  156.      MULTIQUAL qual : Set multisnap qualifier (default: lalt lshift). When
  157.                       you start snapping with this qualifier the snapped
  158.                       text will be appended after what you snapped before.
  159.                       A newline will be placed in between the snapped
  160.                       texts, so they are all on their own line. Paste
  161.                       snapped text using the single line qualifier to get
  162.                       everything on one line. Note that the default single
  163.                       line qualifier and the multisnap qualifier are the
  164.                       same. You can still toggle multisnap on or off when
  165.                       you are already snapping. Just change the qualifier,
  166.                       so in the default setup let go or press down the
  167.                       shift key. There is a small delay of 1/8 sec before
  168.                       toggling the snap mode. This was done so it is less
  169.                       likely that you accidently snap in the wrong mode
  170.                       when you release all qualifiers to stop snapping.  
  171.  
  172.      PASTEKEY c     : Set pastekey (default: V). This key is used to
  173.                       insert the snapped text. Insertion will follow when
  174.                       it is pressed with one of the three possible
  175.                       qualifiers down (QUAL, SLQUAL, PAQUAL).  
  176.  
  177.      SNAPCHARS      : Start with character snap (default).  
  178.  
  179.  
  180.                                      Page 3
  181.  
  182.  
  183.      
  184.  
  185.  
  186.      SNAPFRAME      : Start with frame snap. PowerSnap has two snap modes:
  187.                       character and frame.  The easiest to explain is
  188.                       frame snap, you just draw a rectangle and everything
  189.                       inside it will be snapped. Character snap will
  190.                       interpret the screen as line