======================================================================
                  mkimage - Generate an Image for a UBET file
                           November 18, 1999
             Copyright (c) 1999 by Lucent Technologies
======================================================================

Description
=============================

Mkimage reads a UCG file and generates an image for the format specified. 
Currently, OutputEngine can only generate GIF images. These notes are for 
the command line version of mkimage. During installation, mkimage is 
placed in the bin directory under the UBET installation. On UNIX, the 
command is named "mkimage" and on Windows, it is named "mkimage.exe". 
These notes assume you have placed the UBET bin in your path so you can 
easily call mkimage directly from the command line.

Synopsis
=============================

mkimage [options] ucgfile 

where

ucgfile - the top level UCG input file 

and the options are: 

-a        - use antialiasing (only with monochrome), default is false 
-f font   - use this font for labels, Windows default is Arial, 
            Solaris default is Helvetica
-fs size  - use this size for the font, default size is 10 
-gif      - output a gif image for the ucgfile 
-l        - output a landscape image, default is portrait 
-m        - output a monochrome image, default is color 
-o file   - output image in this file, default has basename of 
            ucgfile & image type for suffix 
-r        - show reference tag and create csv report 
-s name   - hightlight scenario with this name, default is false 
-w width  - use this width for the image, default is calculated 
-h height - use this height for the image, default is calculated 

Running from the command line
=============================

On Solaris, to run mkimage, you must have set and exported the MP_HOME 
shell variable. Also, you must also set and export the shell variable 
UBET_JAVAHOME to point the installation of Sun's 1.2.2 JRE (see the 
notes below about how to obtain the JRE).  You also might want to add 
$MP_HOME/bin to your PATH environment variable. 

Obtaining the JRE
=============================

OutputEngine is implemented in Java 1.2.2.  It will not run with an older 
version of the JRE.  We recommend you also obtain the same version JRE 
(or higher when it is released).  

Here are the URLs to get the correct JRE:

If you are running on Windows:
       http://java.sun.com/products/jdk/1.2/jre/download-windows.html

If you are running on Solaris 5.5.1 (2.5.1), you must use the reference 
release:
       http://java.sun.com/products/jdk/1.2/jre/download-solaris.html

If you are running on Solaris 5.6 (2.6) or higher:
       http://java.sun.com/products/jdk/1.2/jre/download-solaris.html











