# GBM plugin for Lucide

## Introduction

Lucide is a general purpose document viewer for eComStation. It provides a plugin interface which allows developers to integrate support for all kinds of document files. For details about Lucide please visit the Lucide project homepage.

The GBM plugin for Lucide is such an extension that provides access to all GBM supported bitmap formats. The following Lucide features are currently supported by the plugin:

- Read all bitmap formats supported by GBM.DLL
- Save loaded bitmap in any GBM supported format if it has only one page
- Multipage bitmap files which can be navigated in Lucide
- Scaled bitmap preview
- Rotated bitmap preview
- Document information
- file thumbnail creation
- high quality scaling algorithm for improved appearance

For being able to use it, the following additional stuff is required:

- Lucide 1.20 or higher
- GBM.DLL (GBM Bitmap Format Handler) version 1.50 or higher

Note:
GBM.DLL version 1.41 must not be used as it contains a compiler optimization issue that reduces stability. When used together with the GBM plugin for Lucide, Lucide will crash when opening JPEG bitmaps. Please upgrade to GBM.DLL version 1.50 or higher.

## Installing GBM for Lucide

Simply copy `lugbm.dll` into the Lucide installation directory. Please check the requirements listed for `gbm.dll` above. Copy `gbm.dll` either into the Lucide installation directory beside `lugbm.dll` or put it somewhere in your LIBPATH (defined in CONFIG.SYS). The last option is recommended if `gbm.dll` is also required by other programs.

The zoom quality the plugin uses to show images can be customized by settings in the configuration file `lugbm.cfg`. Simply create the configuration file right beside the plugin DLL `lugbm.dll` using your favourite ASCII text editor and add the options. There is also an example file included in the package. You can use the `#` sign to start a comment. Everything behind this sign is ignored on this line. If the configuration file does not exist, the plugin will use the default options.

Example of `lugbm.cfg` :

    # The scaling algorithm can be one of the following:
    # scaler={simple,nearestneighbor,bilinear,bell,bspline,mitchell,lanczos}
    #
    # By default the simple scaler is used. This is the fastest scaler which uses
    # less resources compared to all other scalers. Though it provides acceptable
    # quality for normal viewing.
    scaler=simple

## License of GBM for Lucide

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.

## Screenshot

Lucide window showing a multipage GIF by using the GBM plugin: