home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 2255.dms / in.adf / Docs / oSnap.doc.text.pp / oSnap.doc.text
Encoding:
Text File  |  1992-03-22  |  6.5 KB  |  181 lines
  1.  
  2.                                     _   _                  _____
  3.                     /\        /\   | \ | |       /\       |  __ \
  4.                    /  \      / /   |  \| |      /  \      | | / /
  5.                   / /\ \     \ \   |     |     / /\ \     | |/ /
  6.                  / /  \ \     \ \  | |\  |    / /  \ \    |   /  
  7.                 / /    \ \     \ \ | | | |   / /____\ \   |  /  
  8.                / /      \ \    / / | | | |  / ________ \  | |  
  9.               / /        \ \  / /  | | | | / /        \ \ | | 
  10.               \ \________/ / / /   | | | | \ \        / / | |
  11.                \__________/  \/    |_| |_|  \/        \/  |_| v3.11
  12.  
  13.                (based on Snap version 1.3 by Mikael Karlsson)
  14.  
  15.  
  16.  
  17. 1. Description
  18. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  19.     oSnap let you select the text from any window and to insert it in any
  20. program which accept keyboard input.
  21.  
  22.     All parameters of the clipping and the insertion can be set and modified
  23. by a configuration window.  They can also be saved in a file.  oSnap can also
  24. clip graphics ans save them in an IFF file.
  25.  
  26.     Finally, it can also keep the serial port busy to fool BBS into thinking
  27. you're still in front of your computer when pressing needs arise.
  28.  
  29.  
  30. 2. Prerequisite
  31. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  32.     · The newgad, arp and iff libraries (.library).
  33.  
  34.     · The clipboard device.
  35.  
  36.  
  37. 3. Launching
  38. ¯¯¯¯¯¯¯¯¯¯¯¯
  39.     To launch oSnap, you must run it in a CLI or a shell.  It does not seem
  40. possible to launch it from workbench right now (why ??? dunno, I'll check it
  41. later... :-( ).  You can specify a configuration file and a file containing
  42. clips that were saved earlier.  The format of the clip file is simple: one
  43. clip per line...  So the syntax is:
  44.  
  45.     oSnap Config_File Clip_File
  46.  
  47.  
  48. 4. Operation
  49. ¯¯¯¯¯¯¯¯¯¯¯¯
  50.     After the required file have been installed and oSnap is running, you can
  51. begin some serious text clipping.  Since all qualifier and action keys can be
  52. changed via the configuration, the following instruction assume the default,
  53. as when you start oSnap with NO configuration file.
  54.  
  55.  
  56.     The clip text, you must hold the text-qualifier (control key) and select
  57. text with the left mouse button.  If you release the qualifier before letting
  58. the mouse button go the clipping is canceled.  Graphic clipping used the same
  59. method, but with the graphic qualifier (control+left alt keys).
  60.  
  61.  
  62.     To insert clipped texts, hold the text-qualifier (control key) and press
  63. the insertion action key (i).  The last text that was clipped will be sent to
  64. the active window just like if you typed it with the keyboard.  If you want
  65. to select which clip to insert, hold the choose-text qualifier (control +
  66. left shift key) and press the insertion key (i).
  67.  
  68.  
  69.     In this case, a window will open up and let you select which clips (zero,
  70. one or more) will be inserted (the selection order is preserved).  You can
  71. also erase clips, read the clipboard, write to the clipboard, save to file or
  72. read a clip file.  To insert selected clips, either click on paste or double
  73. click on the the last clip you want to be sent.
  74.  
  75.  
  76.     It is also possible to insert clip in 'quote mode'.  All operation are
  77. identical, but prefixes ans suffixes will be added to the whole text and to
  78. each line.  You use the quote key (o) instead of the insert key (i).
  79.  
  80.  
  81.     When you clip a graphic, a window will open on the Workbench.  You can
  82. save the graphic in an IFF file by clinking on the button with a litle disk
  83. drawn upon.
  84.  
  85.  
  86.     Finally, you can steal the serial port and send spaces and backspaces to
  87. it continually to make a BBS believe that your still there when duty call...
  88. You activate it by using the text clip qualifier (control) and the thief key
  89. (t).  You can stop it by clicking on the stop button on the window that will
  90. appear.
  91.  
  92.  
  93. 5. Configuration
  94. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  95.     To make the configuration window appear, you hold the text qualifier (the
  96. control key) and the preference key (p).  The window is divided in four main
  97. area: Prefixes & suffixes, Snap parameters, keys and qualifiers.
  98.  
  99.  
  100.     The first section let you set the prefixes and suffixes which will be
  101. inserted when the citation mode is used.  You can insert clip inside of the
  102. text prefix and suffix (only the text ones, not line).  By putting a %s,
  103. oSnap will put the last text clipped at that point in the prefix or suffix.
  104. By putting %S (upper case), oSnap will let you choose which clip to insert
  105. in the prefix to the inserted clips (confused ? :-).
  106.  
  107.  
  108.     The second area (parameters) let you select preferences:
  109.  
  110.     · Line length: the length of a line in quote mode.
  111.  
  112.     · Handler priority: the priority of the inout handler used to analyse
  113.         what is going on.  Don't touch it if you don't know what it does.
  114.  
  115.     · Character delay: the delay between each inserted character.
  116.  
  117.     · Line delay: the delay between each line inserted.
  118.  
  119.     · Add return: if you want a return to be inserted after the clips,
  120.         select this.
  121.  
  122.     · Strip end blank: let you choose to remove blank (space and tab) at the
  123.         end of clips.
  124.  
  125.     · Strip first blank: remove blank (space and tab) at the beginning of
  126.         the clips.
  127.  
  128.     · xxxx snap-frame: let you choose which type of selection box will be
  129.         used to highligth text:
  130.  
  131.             · Free: selection for a rectangular box.
  132.  
  133.             · Line: selection of whole lines.
  134.  
  135.     · Merge xxxxx: Which type of merge is used when multiple clips are
  136.         inserted:
  137.  
  138.             · in one block: all clip a concatened.
  139.  
  140.             · with spaces: a space is inserted between each clip.
  141.  
  142.             · with returns: a return is inserted between each clip.
  143.  
  144.  
  145.     The third serie of button let you choose which keyboard key is used for
  146. insertion, quotation, steal of serial port and open up configuration window,
  147. in that order.
  148.  
  149.  
  150.     The last section let you choose which qualifier keys are used to clip
  151. text, choose clip text and graphic clipping.  You choose which one you want
  152. to modify with the first button and modify the qualifers with the other two.
  153.  
  154.  
  155.     At the bottom of the window there are four buttons.  They will let you
  156. confirm or cancel modification, save them and load them from a file.
  157.  
  158.  
  159. 6. Thanks
  160. ¯¯¯¯¯¯¯¯¯
  161.  
  162.     I'd like to thank:
  163.  
  164.         · All the users of oSnap (especially those of the Montréal area)
  165.           who forced my to write this program and better it (with endless
  166.           suggestions...).
  167.  
  168.         · Mikael Karlsson who wrote the original Snap on which this program
  169.           is based.
  170.  
  171.  
  172.  
  173. ||\\/\||//
  174. ||///\||\\
  175.  
  176. internet: dak@info.polymtl.ca (132.207.12.4 to 132.207.12.17)
  177.  
  178.         and
  179.  
  180. Many BBS around Montréal (Electronic Image Électronique, Amiga ECS)
  181.