Mag
                                     ===

   Mag - or Magnify - (very) simple utility to magnify part of the screen

This utility requires EasyPtr's ptrmen_cde and QLib_sms or QLib_run to run.
To use it in QL mode 0 it additionally needs the RPIXL keyword as found in
QJump's Qptr toolkit.

This is not a "proper" utiltiy program. It is just a quick hack that I
found so useful I thought I might as well share it!


Usage
-----

It is best put on a hotkey, for example, if you have fast storage:


        ERT HOT_LOAD1("M", '<path>Mag_obj'; '8')

or

        ERT HOT_RES1("M", '<path>Mag_obj'; '5')

if you have plenty of RAM.

However, you can also just EXECute it in the normal manner:

        EX '<path>_mag_obj'; '<magnification>'

where <magnification> is a size between 2 and ? If you specify a size too
large the program will simply error! (On my 1920x1080 screen 15 is the
maximum.) The default is 4X.


SO then, if you want to inspect part of the screen more closely, press
ALT+SHIFT+M (if you used my suggestion above). The cursor changes to a
64x64 pixel square outline (64x48 in QL mode), and a larger pane pops up at
the top right of the screen.

HIT     the location you wish to magnify
DO      somewhere on the screen to move the display to a different location.
Press   k or K to Keep a copy of the magnified image
Press   ESC to exit the program

As it stands, the program can save up to ten snapshots of magnified
screen, one for each time you press k or K - or until you run out of space
or memeory. The snapshots are saved as _pic files in ram1_ and can be
viewed with many QL image viewers.

The program is kept as simple as possible, but all the source code is
available for you to make your own thing of it.


Software status
---------------

V0.01, pjw, June 10th 2019
V0.02, pjw, 2019 Jul 01, Added Keep
V0.03, pjw, 2024 May 05, QL mode 0 compatibility (with Qptr)

               Conditions of use and DISCLAIMER as per Knoware.no

Generated by QuickHTM, 2024 May 05