SCREEN SNATCHER 4

by Dilwyn Jones

This Screen Snatcher program is a pointer driven version of
my older Screen Snatcher program. This version is pointer
driven and so needs the presence of either SMSQ/E or QDOS
with Pointer Environment extensions (PTR_GEN, WMAN and
HOT_REXT). This is version 4 and written originally for use
with the Launchpad desktop GUI system, although it is also
capable of working independently of Launchpad. If used within
Launchpad, it is called from the Accessories menu, which
expects the filename 'snatch4_obj' to be present in
Launchpad's system directory.

Screen Snatcher 4 is Copyright  2003 Dilwyn Jones.

Screen Snatcher is a screen copy grabber, a program which
takes a snapshot of the current screen display and saves it
as a file, which may be either an uncompressed screen, a PIC
file (pointer environment area save file) or as a graphical
item to the Scrap extensionof the Jochen Merz Menu Extension.
If the Scrap thing is not present, this latter option is
ignored.

CONFIGURATION

Before use, configure the program, using the standard Config
or MenuConfig programs. You need to specify:

1. Key to press with the CTRL key to do the actual screen
grabbing (I normally default this to CTRL s). Press the
letter key to be used, bearing in mind that certain keys are
used for other things, e.g. CTRL c cannot be used as it is
the key combination used to switch between jobs in QDOS and
SMSQ/E). It would only be necessary to change this if it
clashed with the same keypress in other programs.

2. Key to press with the CTRL key to abort or quit from
waiting for a screen snatch. I supply this preconfigured to
use the 'q' key (i.e. CTRL q to quit). It would only be
necessary to change this if it clashed with the same keypress
in other programs.

3. Default filename for snatched screen. This is the filename
used to save snatched screens or PIC files - it is normally
best to use a filename ending with _scr for uncompressed
screen files, or _pic for PIC files. It is supplied
defaulting to flp1_snatched_scr.

4. Default screen snatch type. May be an uncompressed screen,
a PIC file or a graphical object sent to the Scrap thing.

5. Sound off or on. The program usually beeps when an error
occurs. These may be turned off if required.


USING THE PROGRAM

Start the program with EXEC flp1_snatch4_obj. Substitute
whatever device/directory name required for FLP1_.

+------------------------------------------------------+
| [move] [Zzz]      [ SCREEN SNATCHER ]      [(C)] [X] |
|                                                      |
| Snatch activation key:    [ CTRL-S                  ]|
| Filename for saved screen [ flp1_snatched_scr       ]|
| Key to abort screen snatch[ CTRL-Q                  ]|
| Screen save format:       [ Uncompressed screen     ]|
|                                                      |
|                      [    GO    ]                    |
+------------------------------------------------------+

The [Move] symbol at the top left lets the Screen Snatcher
display be moved around the screen to wherever you find most
convenient.

The [Zzz] symbol puts Screen Snatcher to sleep in the QPAC2
button frame, if present.

The [(C)] symbol displays a short copyright notice, where
you'll also find the program version number.

The [X] symbol is the same as ESC - quit from the program.

The Snatch Activation Key box, accessed by pressing S or
clicking in the black box to the right of the name lets you
alter the CTRL key used to snatch a copy of the screen. It
has to be a CTRL key (i.e. hold down the CTRL key on the
keyboard and tap a letter key). When you select this item, a
key selection menu pops up:

+---------------------------------------------+
| [Move]      [ SELECT SNATCH KEY ]       [X] |
|                                             |
|      Select which key to use with CTRL:     |
|                                             |
| +-----------------------------------------+ |
| |  A  B  C  D  E  F  G  H  I  J  K  L  M  | |
| |                                         | |
| |  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  | |
| +-----------------------------------------+ |
+---------------------------------------------+

Click on the letter key you'd like to use in combination with
the CTRL key to activate a snatch, or press the letter key
required. Click on the [Move] symbol to move the window
around a little, and the [X] symbol to quit, leaving the key
unchanged. You will notice that when the window is first
shown, the currently selected key is highlighted by a small
red box around it.

Key To Abort Screen Snatch. The key which when pressed with
the CTRL key aborts the current screen snatch process.

Filename For Saved Screen. If the screen snatch is to be
saved to an uncompressed screen or PIC file, it is givent he
filename specified here. Click in the black box and type in
your preferred filename, the box defaukts to the filename
configured (see above).

Screen Save Format. This may be an uncompressed screen, a PIC
file, or a copy of the screen placed in the Scrap thing.

The PIC file format saved is as follows:

2 bytes, used as a file identifier, decimal 74,252 ($4AFC)
1 word - width of picture in pixels
1 word - height of picture in pixels
1 word - line increment, width of each line (in bytes)
1 byte - screen mode number
         0 or 4 = QL 4 colour mode
         8 = QL 8 colour mode
         16 or 31 = Aurora-style 256 colour mode
         32 = QPC or QXL 16-bit colour mode
         33 = Q40 or Q60 16-bit colour mode
         64 = 24-bit 16 million colour mode
1 byte - spare, currently unused, usually 0.

GO - Hit or Do (left or right mouse click respectively) on
this box, or press G, to start a screen snatching session. So
that it does not interfere with the screen display, Screen
Snatcher closes its own windows (it appears to disappear, but
really just lurks in the barkground) and waits for the
keypresses specified. You can safely CTRL C away to other
programs to set up the display as required, as Screen
Snatcher reads the keyboard independently (it uses the
sv_arbuf auto repeat system variable at offset decimal 138
(hex 8A) in the system variables area) so that it does not
interfere with the keyboard input for other programs - this
is why it is important that you choose a little used
CTRL+letter keypress to avoid interaction with other programs
which may use the same keypress combination. The program also
sets its own job priority to a very low '1' so as to use as
little processor time as possible.

When you are ready to grab a copy of the screen, press the
snatch activation key. If the snatch is successful, a message
appears briefly on the screen, a short beep is sounded (as
long as sound is configured on) and the Screen Snatcher
display reappears. If an error occurs, an error message is
displayed and you need to click on the [ OK ] button to
continue before you can try again.



