:   =====================================================================
:   Black Belt Systems DMI Resolver public interface load & save document
:   =====================================================================
:                   Last Update: January 24th, 1992
:                Revision Level: 1.01
:                       Authors: Barry Chalmers and Ben Williams
:
: 1.01 - Now uses new SAGE libraries and configuration set by TWEEK
: 1.00 - Initial Release
:         * Requires 6.13 of the image processor
:
:This is a Public Interface module to display images on the DMI
:Resolver 256 color display, for the following image processing
:packages from Black Belt Systems:
:
:    Image Professional
:    Imagemaster F/c
:    Imagemaster
:
:If you have one of these packages, but have an earlier revision than the
:changes list indicates, then you need to obtain a new version of the
:software. Contact Black Belt Systems for details.
:
:In this document, all of these programs will be referred to as
:the "image processor" to remain general.
:

Contents:
=========

The RESOLVE package consists of two files; first, an ARexx script
called "resolver.rexx", and a CLI command called "resolve".

Installation:
=============

You will need the following library which came with your Resolver, or is
obtainable from DMI.
  
      sage.library
  
Also, this module requires that you have a file called resolver.stp
which was created by the TWEEK program from DMI, in 

      SAGE:config/resolver.stp

TWEEK is used to setup the various display modes for the DMI resolver and
its display monitor. This MUST have been done for this module to work.

This module is automatically installed by the install-pi script.

Use:
====

Now, pressing F1 will provide you with a choice of Display in Luma,
Render to 256 Colors, and Use Preset Colors.  All of these display
modes also give you the option of choosing one of the display
resolutions supported by your Resolver/monitor setup.

Done
----
If you choose Done, the PI module will return immediately to the image
processor.

Display in Luma
---------------
This will display the current image on the Resolver in 256 gray levels.

Render to 256 Colors
--------------------
This option will choose the best 256 colors to represent the current
image. You will also be asked to choose between:

   'Quiet Render' - which will not list progress messages,
   'Show Progress on Console' - which will list the progress of the
                                render, and
   'Show Progress on the Resolver' - which will display the colors
                                as they are chosen.

Use Preset Colors
-----------------
This is a faster method of displaying the image using a palette that
can reach all possible colors.


Possible Problems:
==================

Messages:
---------
If there are problems encountered by the Resolver module, messages will
indicate what the problem is. These messages usually appear in the image
processor control panel.

ARexx:
------
If you do not have ARexx installed, this loader cannot function at all.
The obvious solution is to get ARexx. Here is where you can get it:

    William Hawes
    P.O. Box 308
    Maynard, Massachusetts
    01754
    
    (508) 568-8695

ARexx comes standard with the 2.0 operating system; if you purchase an
"Enhancer" package for your Amiga, you'll be getting ARexx in that
package.

You also need the ARexx support libraries installed - these are located
on the ARexx release disk(s).


