GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey 1.34
------------------------------------------------------

GBM stands for Generalised Bitmap Module.

This is a plugin for the Webbrowsers Netscape, Mozilla, Firefox and
SeaMonkey available for OS/2 and eComStation that extends them for
the support of reading all bitmap formats supported by GBM.DLL.

For being able to use it, the following additional files are required:
- Netscape, Mozilla, Firefox or SeaMonkey
  The plugin has been tested with Firefox 1.5.0.x and 2.0.0.x, SeaMonkey 1.0.x
  and 1.1.x, Netscape 4.61 and even Netscape 2.02, but it should work with
  other versions as well.
  Printing is only supported on Mozilla/Firefox/SeaMonkey.
- GBM.DLL version 1.50 or higher (GBM Bitmap Format Handler)

More details to this package and about GBM in general can be found
at http://heikon.home.tlink.de or in the included documentation.


Supported features:
-------------------
There is the embedded mode with reduced functionality and the fullscreen mode
with full functionality. Both viewers automatically detect the file format,
so also wrongly named bitmaps often found in the world wide web can be shown.

FULL mode viewer with a load of features:
* menus, popup menu, scrollers
* variable scaled preview
* transformations mirror/transpose/rotate
* multipage navigation
* high quality scaling algorithm for improved appearance
* bitmap format info dialog
* save the shown page to any GBM supported bitmap file format
* uses GBM File Dialog if found, otherwise OS/2 File Dialog is used
  (dialog contextual help is available)
* English and German localized with autodetection via LANG variable
* Custom settings definable in npgbm.cfg file

EMBED mode viewer with reduced functionality of FULL mode viewer:
* popup menu
* transformations mirror
* multipage navigation
* high quality scaling algorithm for improved appearance
* bitmap format info dialog
* save the shown page to any GBM supported bitmap file format
* uses GBM File Dialog if found, otherwise OS/2 File Dialog is used
  (dialog contextual help is available)
* printing of embedded bitmaps is supported on Mozilla/Firefox/SeaMonkey only
* English and German localized with autodetection via LANG variable
* Custom settings definable in npgbm.cfg file


Installing GBM for Mozilla/Firefox/SeaMonkey
--------------------------------------------
Simply copy npgbm.dll into the plugin directory of your browser. Please check
the requirements listed for gbm.dll above. Copy gbm.dll to a directory somewhere
in your LIBPATH (defined in CONFIG.SYS).

The plugin will try to use the GBM File Dialog if it is found somewhere in the
LIBPATH. If it is not found, the standard OS/2 file dialog will be used.
Save options for bitmap export cannot be specified in the OS/2 file dialog and
thus the plugin will use the default export options of each bitmap format.

Note: This plugin requires so far that the browser cache is enabled.
      Further versions might be able to directly stream the images into
      the system memory.


License
-------

Copyright (C) 2006-2008 Heiko Nitzsche

  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the author be held liable for any damages
  arising from the use of this software.

  Permission is granted to anyone to use this software for any purpose,
  including commercial applications, and to alter it and redistribute it
  freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.



Contact
-------
Heiko.Nitzsche@gmx.de (http://heikon.home.tlink.de)



History
-------

16-Jul-2006  GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey (NPGBM.DLL version 1.00)
             * Initial release


30-Jul-2006: GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey (NPGBM.DLL version 1.10)

             Added fullscreen mode viewer with a load of features
             * menus, popup menu, scrollers
             * variable scaled preview
             * transformations: mirror/transpose/rotate
             * multipage navigation
             * save the shown page to any GBM supported bitmap file format
             * uses GBM File Dialog if found, otherwise OS/2 File Dialog is used
             * English and German localized with autodetection via LANG variable

             Added embedded mode viewer with reduced functionality of fullscreen mode viewer
             * popup menu
             * transformations: mirror
             * multipage navigation
             * save the shown page to any GBM supported bitmap file format
             * uses GBM File Dialog if found, otherwise OS/2 File Dialog is used
             * English and German localized with autodetection via LANG variable
             * printing of embedded bitmaps is supported on Mozilla/Firefox/SeaMonkey

             Now supports dynamic lookup of GBM.DLL either via LIBPATH
             or look into the directory where npgbm.dll is located.


16-Aug-2006: GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey (NPGBM.DLL version 1.20)
             * Renamed menu "Reflect horizontally" to "Flip horizontal" and
               menu "Reflect vertically" to "Flip vertical" in English NLS.
             * Added bitmap information dialog box
             * Fix for issue that GBM.DLL and GBMDLG.DLL are not found when
               LIBPATHSTRICT (or RUN!) is used. Thanks to Rich Walsh for the background
               info about the root cause.
             * Add bldlevel info
             * Makefiles now support activating debug compile without editing them.
               Just use nmake or wmake with parameter debug=on


08-Sep-2006  GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey (NPGBM.DLL version 1.21)
             * 1bpp bitmaps were shown inverted (colors swapped)


28-Nov-2006  GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey (NPGBM.DLL version 1.30)
             * Add help support for the GBM file dialog (requires gbmdlg.dll 1.31 or higher)
             * Allow all dialogs to be moved outside the plugin window
             * Improved detection of bitmap file formats which allows showing bitmap files
               that carry wrong file extensions (e.g. .tif but in reality it's a jpg)
             * Some fixes in GUI handling (menus were sometimes active if file was not loaded)
             * Enable support for XPM (X Windows PixMap) format
               (requires GBM.DLL 1.50 or higher)

09-Sep-2007  GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey (NPGBM.DLL version 1.31)
             * 8bpp grayscale and true color images are now scaled with a high quality
               algorithm to improve appearance.

04-Nov-2007  GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey (NPGBM.DLL version 1.32)
             * Resampling scaler with improved accuracy

27-Jan-2008  GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey (NPGBM.DLL version 1.33)
             * Resampling scaler now supports all grayscale bitmaps <=8bpp

08-Feb-2008  GBM plugin for Netscape/Mozilla/Firefox/SeaMonkey (NPGBM.DLL version 1.34)
             * Move HPS rendering code to common package GbmRenderer
               to save memory (now renders directly from cache buffer)
               without temporary subrectangle buffer
             * Allocate memory from high memory for bitmap data to
               stretch limit for out-of-memory errors
               (requires kernel with high memory support)
             * Custom settings definable in npgbm.cfg file
               (so far scaler={simple,nearestneighbor,bilinear,bell,bspline,mitchell,lanczos})
               The default scaler is simple to allow fast scaling on less powerful systems.
