This is version 2.1 of Lupe. The magnifying glass program.

= PREFACE =
Lupe has been developed from 1995 to 1997 up to version 1.9 by Frank Toepper.
The source code to version 1.9 was released to Aminet by Stephan Rupprecht in
February 2000.

Porting of the original source code from C to AmigaE, support for MorphOS and
AmigaOS4 and the resulting update to V2.0 and V2.1 with new features and a
couple of bug fixes was done by Matthias "UltraGelb" Böcker.

The original Archive of Lupe V1.10ß including the source code to V1.9 is
contained in this Archive.

The AmigaE source code to Lupe 2.1 is also part of this archive.

Thanks to the beta testers for their help and also the many useful
suggestions and ideas!


= DESCRIPTION =
Lupe magnifies an area surrounding the mouse pointer and displays it in a
separate window.

  Features:
  - The magnification factor is adjustable
  - Can jump to any screen
  - Crosshair
  - Optionally shows mouse coordinated
  - A pixel grid is available
  - Special Fast-mode for fast continous updates
  - Possibility to set the area to fixed coordinates
  - Can show the RGB values of the current pixel
  - Saving of the current window contents as IFF or PNG file
  - Auto-jump to the currently active screen
  - Supports CyberGfx bitmaps >8 bit depth
  - Comes with a MorphOS version
  - Comes with an AmigaOS4 version


= REQUIREMENTS =
Minimum Requirements are AmigaOS 3.0 for the AmigaOS/68K version.
The MorphOS version needs at least MorphOS 3.0.
The AmigaOS4 version needs at least AmigaOS 4.1 FE.

PNG saving in the 68K version needs z.library available at
http://aminet.net/util/libs/zlib.lha.  The z.library that comes with MUI5
also works apparently.

= HISTORY =
Changes for V2.1 - 15.10.2022
=============================
- Added italian AmigaGuide documentation translated by Samir Hawamdeh.

- Added an TEXTFRAMETYPE option to change the type of frame that is to be
  drawn around the coordinates and RGB displays.
  (Thanks to Mikhail Malyshev for the suggestion)

- The window can now also be moved around by using the cursor keys or the
  numeric key pad.  The 'immovable' option has no effect on this.  For
  details/qualifiers please see the documentation.
  (Thanks to Mikhail Malyshev for the suggestion)

- 68k version now uses z.library (http://aminet.net/util/libs/zlib.lha) for
  PNG saving.  The z.library that comes with MUI5 also works.

- Added support for application.library/ringhio on OS4 to notify the user
  when an image was saved.

- Added native support for OS4 intuition screen notifications when WB wants
  to close/reopen.

- Added native support for iconify and jump-screen gadget if OS4 is detected.

- There is now an OS4 native compile of Lupe.

- Added a 'Pause' mode that can be activated either by Project menu and its
  menu key, just pressing space when the Lupe window is active or by a
  definable hotkey (see PAUSEKEY argument/ToolType).

- The 68K version of Lupe now checks for zlib.library at program start and if
  there isn't it will disable the 'Save PNG' menu item.

- There is now a bonus drawer which at the moment only contains an
  alternative glow icon by Luca (thanks for the icon :-))

- Double-clicking the Lupe window while holding the SHIFT key will move the
  Lupe window to the back now if it's not set as a frontdrop window.  Useful
  when set to borderless.
  (Thanks to Mikhail Malyshev for the suggestion)

- Double-clicking the Lupe window will bring it to font now if it is not set
  as a backdrop window.
  (Thanks to Mikhail Malyshev for the suggestion)

- Added glow icons done by Mikhail Malyshev which will be used from now on
  for the 68K version of Lupe.  Thank you Mikhail :-)

- Added HORIZSLIDER option to have the zoom-slider in the bottom border of
  the window instead of the right border.
  (Thanks to Mikhail Malyshev for bugging me)

- FRONTDROP option is now simulated on classic AmigaOS and does a timed
  WindowToFront() every now and then.  (Thanks Mikhail for the hint :-))

- Added BACKDROP and FRONTDROP options to have the window either always stay
  in the background or in the foreground respectively.
  (Thanks to Luca Longone for the suggestion)

- Added WINDOWBORDER option.  The argument following must be a number in the
  range 0 to 3 to select what kind of window border to use.
  (Thanks to Luca Longone for the suggestion)

- Added padding for RGB and and coordinates texts between frame and text.
  Use XTEXTPADDING and YTEXTPADDING to change the padding horizontally and
  vertically respectively.
  Valid range is 0 to 4 pixel.  Default is 1 Pixel.
  (Thanks to Mikhail Malyshev for the suggestion)

- Added 'Open Icon-Info' menu item to the 'Settings' menu to open the icon
  info window on the workbench of Lupe's icon.  This mostly makes sense with
  the ICONNOTIFY option to have another way to edit all options without the
  need to restart Lupe.

- Reworked the menu structure.  Instead of having just the 'Project' menu,
  screen related items are now in the new 'Screen' menu.  Settings related
  items were moved to a 'Settings' menu.

- Improved scaling/blitting so that there are no small black borders anymore
  on the right and bottom sides.
  (Thanks to Luca Longone for bugging me)

- Lupe will now try to use the systems default font (gfxbase.defaultfont)
  before using topaz.font as a final fallback.
  (Thanks to Mikhail Malyshev for the suggestion)

- You can now specify your own font Lupe will use to display Coordinates and
  RGB using the UserFont argument.  The font specified needs to be an
  non-proportional (mono) font.  Format to use here is fontname[.font][/size].
  Example: USERFONT=xen/9
  (Thanks to Mikhail Malyshev for the suggestion)

- Fixed broken error handling for the PNG saver in the Amiga68k version.  It
  never reported any errors like missing libraries due to a wrong #ifdef.
  (Thanks to Samir Hawamdeh for reporting this).

- Coordinates and the RGB pixel value are no longer drawn in the window
  border but instead are drawn in the window itself now.  This was done in
  order to avoid collisions with programs like Birdie and since drawing in
  window borders is bad anyhow.

- Added russian catalogs by Mikhail Malyshev.

- Added italian catalogs by Samir Hawamdeh and Luca Longone.

- Added visual prefs Iconify gadget support, so Lupe now also sports an
  iconify gadget on OS3.x if visual prefs is running or the standalone
  'tbiclass' (aminet/dev/gui/titlebar_ic.lha) is installed.
  (Thanks to Mikhail Malyshev for the suggestion)

- Mouse wheel zoom can now be inverted by tooltype or CLI argument
  INVERTWHEEL.
  (Thanks to Luca Longone for the suggestion)

- Lupe will now open its AppIcon at 0,0 when iconified.
  (Thanks to Luca Longone for the suggestion)

- Added some missing localisations in the about requester.
  (Thanks to Samir Hawamdeh for pointing this out).

- Lupe now displays its name and version in the screen title when the window
  is active.
  (Thanks to Samir Hawamdeh for the suggestion)

- Fixed an enforcer hit when parsing CLI arguments that are defined as /K/S.

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                 1945    3024  64.3% -lh5- f41b Oct 15 19:07 Lupe.info
[generic]                 1132    1629  69.5% -lh5- d642 Oct 15 19:07 Lupe/Bonus/def_Lupe_orig.info
[generic]                 2301    3024  76.1% -lh5- ef9f Oct 15 19:07 Lupe/Bonus/Lupe_HEXAAE.info
[generic]                 1293    1614  80.1% -lh5- 4305 Oct 15 19:07 Lupe/Bonus/Lupe_orig.info
[generic]                 1314    2894  45.4% -lh5- c016 Oct 15 19:07 Lupe/catalogs/deutsch/Lupe.catalog
[generic]                 1426    3234  44.1% -lh5- ece1 Oct 15 19:07 Lupe/catalogs/italiano/Lupe.catalog
[generic]                 1525    3086  49.4% -lh5- 0f7b Oct 15 19:07 Lupe/catalogs/russian/Lupe.catalog
[generic]                 2245    5678  39.5% -lh5- 8cce Oct 15 19:07 Lupe/catdev/deutsch/Lupe.ct
[generic]                 2380    5998  39.7% -lh5- fa6a Oct 15 19:07 Lupe/catdev/italiano/Lupe.ct
[generic]                 1455    3844  37.9% -lh5- eae0 Oct 15 19:07 Lupe/catdev/Lupe.cd
[generic]                 4179   10038  41.6% -lh5- e7d8 Oct 15 19:07 Lupe/catdev/Lupe.cs
[generic]                 2722    6202  43.9% -lh5- 6919 Oct 15 19:07 Lupe/catdev/russian/Lupe.ct
[generic]                 3414    8099  42.2% -lh5- ec20 Oct 15 19:07 Lupe/Changes.txt
[generic]                  227     438  51.8% -lh5- 1c58 Oct 15 19:07 Lupe/Changes.txt.info
[generic]                 1888    6247  30.2% -lh5- 5f7f Oct 15 19:07 Lupe/Install
[generic]                  311     597  52.1% -lh5- cbec Oct 15 19:07 Lupe/Install.info
[generic]                27213   57876  47.0% -lh5- 7952 Oct 15 19:07 Lupe/Lupe.68k
[generic]                 1321    1969  67.1% -lh5- 7b0f Oct 15 19:07 Lupe/Lupe.68k.info
[generic]                30968   73540  42.1% -lh5- b73d Oct 15 19:07 Lupe/Lupe.mos
[generic]                 7232    7475  96.7% -lh5- 12d1 Oct 15 19:07 Lupe/Lupe.mos.info
[generic]                28623   62660  45.7% -lh5- a934 Oct 15 19:07 Lupe/Lupe.OS4
[generic]                 7272    7505  96.9% -lh5- 2bb8 Oct 15 19:07 Lupe/Lupe.OS4.info
[generic]                 3106    7437  41.8% -lh5- 7090 Oct 15 19:07 Lupe/Lupe.readme
[generic]                  227     438  51.8% -lh5- 3fbb Oct 15 19:07 Lupe/Lupe.readme.info
[generic]                 9083   28243  32.2% -lh5- 1626 Oct 15 19:07 Lupe/Lupe_DE.guide
[generic]                  227     438  51.8% -lh5- 3fbb Oct 15 19:07 Lupe/Lupe_DE.guide.info
[generic]                 8058   25490  31.6% -lh5- efb9 Oct 15 19:07 Lupe/Lupe_EN.guide
[generic]                  227     438  51.8% -lh5- 1c58 Oct 15 19:07 Lupe/Lupe_EN.guide.info
[generic]                 9165   29540  31.0% -lh5- b68a Oct 15 19:07 Lupe/Lupe_IT.guide
[generic]                  224     438  51.1% -lh5- acbc Oct 15 19:07 Lupe/Lupe_IT.guide.info
[generic]                70339   70339 100.0% -lh0- ca6e Oct 15 19:07 Lupe/Lupe_Old_V1.10beta/lupe.lha
[generic]                 1514    3157  48.0% -lh5- 219a Oct 15 19:07 Lupe/Lupe_Old_V1.10beta/lupe.readme
[generic]                 1216    1536  79.2% -lh5- 8eda Oct 15 19:07 Lupe/Prefs/Env-Archive/sys/def_Lupe.68k.info
[generic]                 8035    8035 100.0% -lh0- 3649 Oct 15 19:07 Lupe/Prefs/Env-Archive/sys/def_Lupe.mos.info
[generic]                 7759    7788  99.6% -lh5- 1cb1 Oct 15 19:07 Lupe/Prefs/Env-Archive/sys/def_Lupe.OS4.info
[generic]                 2644    4456  59.3% -lh5- 9a7b Oct 15 19:07 Lupe/Source/ecxmodules/amigaos/makepng_z.m
[generic]                  157     283  55.5% -lh5- 97bd Oct 15 19:07 Lupe/Source/ecxmodules/amigaos/z.m
[generic]                10985   34358  32.0% -lh5- 82e2 Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/intuition/gadgetclass.e
[generic]                 2268    6656  34.1% -lh5- e892 Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/intuition/gadgetclass.m
[generic]                 6091   19028  32.0% -lh5- 5792 Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/intuition/imageclass.e
[generic]                 2067    5948  34.8% -lh5- 7c78 Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/intuition/imageclass.m
[generic]                24354   79484  30.6% -lh5- 3c5e Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/intuition/intuition.e
[generic]                 6537   19416  33.7% -lh5- fc89 Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/intuition/intuition.m
[generic]                 1083    3183  34.0% -lh5- cc3c Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/intuition/notify.e
[generic]                  481    1604  30.0% -lh5- 2b6c Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/intuition/notify.m
[generic]                 4860   22785  21.3% -lh5- 164f Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/libraries/application.e
[generic]                 3604   11752  30.7% -lh5- 45a1 Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/libraries/application.m
[generic]                 1519    3156  48.1% -lh5- c554 Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/makepng_z.m
[generic]                  962    2848  33.8% -lh5- e4d2 Oct 15 19:07 Lupe/Source/ecxmodules/amigaos4/z.m
[generic]                  758    2064  36.7% -lh5- 8ff2 Oct 15 19:07 Lupe/Source/ecxmodules/morphos/graphics/layers.m
[generic]                  253     956  26.5% -lh5- 3048 Oct 15 19:07 Lupe/Source/ecxmodules/morphos/graphics/rpattr.m
[generic]                  299     594  50.3% -lh5- 9caa Oct 15 19:07 Lupe/Source/ecxmodules/morphos/intuition/diattr.m
[generic]                 1435    3380  42.5% -lh5- a356 Oct 15 19:07 Lupe/Source/ecxmodules/morphos/intuition/extensions.m
[generic]                  241     452  53.3% -lh5- 5a31 Oct 15 19:07 Lupe/Source/ecxmodules/morphos/intuition/iobsolete.m
[generic]                 1808    4198  43.1% -lh5- 89f8 Oct 15 19:07 Lupe/Source/ecxmodules/morphos/intuition/screens.m
[generic]                  888    2924  30.4% -lh5- 207b Oct 15 19:07 Lupe/Source/ecxmodules/morphos/layers.m
[generic]                 1228    3170  38.7% -lh5- 48e7 Oct 15 19:07 Lupe/Source/ecxmodules/morphos/libraries/magicbeacon.m
[generic]                  250     712  35.1% -lh5- d6d1 Oct 15 19:07 Lupe/Source/ecxmodules/morphos/magicbeacon.m
[generic]                 1472    3072  47.9% -lh5- 8b5f Oct 15 19:07 Lupe/Source/ecxmodules/morphos/makepng_z.m
[generic]                 1198    3716  32.2% -lh5- 87d3 Oct 15 19:07 Lupe/Source/ecxmodules/morphos/z.m
[generic]                  886    2099  42.2% -lh5- a955 Oct 15 19:07 Lupe/Source/emodules/images/titlebar.e
[generic]                  209     310  67.4% -lh5- edda Oct 15 19:07 Lupe/Source/emodules/images/titlebar.m
[generic]                 3875    9792  39.6% -lh5- 5c98 Oct 15 19:07 Lupe/Source/emodules/makepng_z.e
[generic]                 3875    9792  39.6% -lh5- 5c98 Oct 15 19:07 Lupe/Source/emodules/makepng_z.e.bak
[generic]                  431     734  58.7% -lh5- feb8 Oct 15 19:07 Lupe/Source/emodules/png.e
[generic]                  180     292  61.6% -lh5- 419f Oct 15 19:07 Lupe/Source/emodules/png.m
[generic]                37764  141563  26.7% -lh5- f433 Oct 15 19:07 Lupe/Source/Lupe.e
[generic]                 1914    5545  34.5% -lh5- 797b Oct 15 19:07 Lupe/Source/Lupe_cat.e
[generic]                 2899    6800  42.6% -lh5- 23f3 Oct 15 19:07 Lupe/Source/lupe_cat_68k.m
[generic]                 3022    6968  43.4% -lh5- f8c5 Oct 15 19:07 Lupe/Source/lupe_cat_mos.m
[generic]                 3005    6936  43.3% -lh5- 5679 Oct 15 19:07 Lupe/Source/lupe_cat_OS4.m
[generic]                 5511   12497  44.1% -lh5- 6449 Oct 15 19:07 Lupe/TheStoryOfLupeV2.x.txt
[generic]                  227     438  51.8% -lh5- 3fbb Oct 15 19:07 Lupe/TheStoryOfLupeV2.x.txt.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        73 files  392806  903949  43.5%            Oct 16 02:53