
                                    _   _                  _____
                    /\        /\   | \ | |       /\       |  __ \
                   /  \      / /   |  \| |      /  \      | | / /
                  / /\ \     \ \   |     |     / /\ \     | |/ /
                 / /  \ \     \ \  | |\  |    / /  \ \    |   /  
                / /    \ \     \ \ | | | |   / /____\ \   |  /  
               / /      \ \    / / | | | |  / ________ \  | |  
              / /        \ \  / /  | | | | / /        \ \ | | 
              \ \________/ / / /   | | | | \ \        / / | |
               \__________/  \/    |_| |_|  \/        \/  |_| v3.14

               (based on Snap version 1.3 by Mikael Karlsson)



1. Description
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    oSnap let you select the text from any window and to insert it in any
program which accept keyboard input.

    All parameters of the clipping and the insertion can be set and modified
by a configuration window.  They can also be saved in a file.  oSnap can also
clip graphics ans save them in an IFF file.

    Finally, it can also keep the serial port busy to fool BBS into thinking
you're still in front of your computer when pressing needs arise.


2. Prerequisite
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    · The newgad, iff library and either reqtools or arp library.
	  (by the way, ReqTools is Copyright (c) Nico François).

    · The clipboard device.


3. Launching
¯¯¯¯¯¯¯¯¯¯¯¯
    To launch oSnap, you must run it in a CLI or a shell.  You can specify a
configuration file and a file containing clips that were saved earlier.  The
format of the clip file is simple: one clip per line...  So the syntax is:

    oSnap Config_File Clip_File


4. Operation
¯¯¯¯¯¯¯¯¯¯¯¯
    After the required file have been installed and oSnap is running, you can
begin some serious text clipping.  Since all qualifier and action keys can be
changed via the configuration, the following instruction assume the default,
as when you start oSnap with NO configuration file.


    The clip text, you must hold the text-qualifier (control key) and select
text with the left mouse button.  If you release the qualifier before letting
the mouse button go the clipping is canceled.  Graphic clipping used the same
method, but with the graphic qualifier (control+left alt keys).


    To insert clipped texts, hold the text-qualifier (control key) and press
the insertion action key (i).  The last text that was clipped will be sent to
the active window just like if you typed it with the keyboard.  If you want
to select which clip to insert, hold the choose-text qualifier (control +
left shift key) and press the insertion key (i).


    In this case, a window will open up and let you select which clips (zero,
one or more) will be inserted (the selection order is preserved).  You can
also erase clips, read the clipboard, write to the clipboard, save to file or
read a clip file.  To insert selected clips, either click on paste or double
click on the the last clip you want to be sent.


    It is also possible to insert clip in 'quote mode'.  All operation are
identical, but prefixes ans suffixes will be added to the whole text and to
each line.  You use the quote key (o) instead of the insert key (i).


    When you clip a graphic, a window will open on the Workbench.  You can
save the graphic in an IFF file by clinking on the button with a litle disk
drawn upon.


    Finally, you can steal the serial port and send spaces and backspaces to
it continually to make a BBS believe that your still there when duty call...
You activate it by using the text clip qualifier (control) and the thief key
(t).  You can stop it by clicking on the stop button on the window that will
appear.


5. Configuration
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    To make the configuration window appear, you hold the text qualifier (the
control key) and the preference key (p).  The window is divided in four main
area: Prefixes & suffixes, Snap parameters, keys and qualifiers.


    The first section let you set the prefixes and suffixes which will be
inserted when the citation mode is used.  You can insert clip inside of the
text prefix and suffix (only the text ones, not line).  By putting a %s,
oSnap will put the last text clipped at that point in the prefix or suffix.
By putting %S (upper case), oSnap will let you choose which clip to insert
in the prefix to the inserted clips (confused ? :-).


    The second area (parameters) let you select preferences:

    · Line length: the length of a line in quote mode.

    · Handler priority: the priority of the inout handler used to analyse
        what is going on.  Don't touch it if you don't know what it does.

    · Character delay: the delay between each inserted character.

    · Line delay: the delay between each line inserted.

    · Add return: if you want a return to be inserted after the clips,
        select this.

    · Strip end blank: let you choose to remove blank (space and tab) at the
        end of clips.

    · Strip first blank: remove blank (space and tab) at the beginning of
        the clips.

    · xxxx snap-frame: let you choose which type of selection box will be
        used to highligth text:

            · Free: selection for a rectangular box.

            · Line: selection of whole lines.

    · Merge xxxxx: Which type of merge is used when multiple clips are
        inserted:

            · in one block: all clip a concatened.

            · with spaces: a space is inserted between each clip.

            · with returns: a return is inserted between each clip.


    The third serie of button let you choose which keyboard key is used for
insertion, quotation, steal of serial port and open up configuration window,
in that order.


    The last section let you choose which qualifier keys are used to clip
text, choose clip text and graphic clipping.  You choose which one you want
to modify with the first button and modify the qualifers with the other two.


    At the bottom of the window there are four buttons.  They will let you
confirm or cancel modification, save them and load them from a file.


6. Thanks
¯¯¯¯¯¯¯¯¯

    I'd like to thank:

        · All the users of oSnap (especially those of the Montréal area)
          who forced my to write this program and better it (with endless
          suggestions...).

        · Mikael Karlsson who wrote the original Snap on which this program
          is based.



||\\/\||//
||///\||\\

internet: dak@info.polymtl.ca (132.207.12.4 to 132.207.12.17)
