                             JNSE DESIGNER TOOLKIT
                                  Version 2.2

                             (c) 1994 JOHN KUNYIK

   FILES CONTAINED IN THIS PACKAGE
   -------------------------------
   JNSEDT22.EXE  - Main program file.
   HOLE.PRE      - Program default file for PCX-to-Hole file function.
   JNSEPAL.PRE   - Program default file for Export Palette function
   LANDPLOT.PRE  - Program default file for PCX-to-Landplot file function.
   MWGRFX22.BL   - Program graphics.
   RGB.USR       - Default file for user-defined palette shifts.
   COLDESC.CDT   - Optional starter file for palette color descriptions.
   JNSEOBJS.PCX  - Optional PCX File for Palette Editor use.
   LPBRUSH.BBM   - Optional DP2E brush containing the landplot palette.
   LPBRUSH.PCC   - Optional PCX file containing the landplot palette.
   PCX2HOLE.PCX  - 320 x 200 PCX-to-Hole template.
   PCX2LPLT.PCX  - 320 x 200 PCX-to-Landplot template.
   MAKEQSP.EXE   - Stand-alone util. for creating quick-display from PCX files.
   MAKEQSP.TXT   - Instructions for MAKEQSP.
   QSP.EXE       - Stand-alone utility for presenting quick-display files.
   QSP.TXT       - Instructions for using QSP files.
   RUNQSP.BAT    - Sample batch file for QSP.
   QSP.1         - QSP graphic file.
   REGISTER.FRM  - Registration form for the software.
   JNSEDT22.TXT  - This text file.
   --------------------------------------------------------------------------
   
   NEW TO VERSION 2.2
   ------------------
   o     Export palette from an existing JNSE course to a new PCX file, 
         operates as one of the Palette Editor functions.
   o     Convert PCX files to landplot/overheads.
   o     QSP stand-alone utilities for creating and presenting quick-load
         PCX files. Read the QSP.TXT file for additional information.
   --------------------------------------------------------------------------

   INTRODUCTION
   ------------
   The toolbox consists of the following. A palette editor, the means to 
   import and export JNSE background files to-and-from PCX format, to import 
   PCX files into hole files, and to import PCX files into landplot/overhead 
   files.

   o     Copy the files into your JNSE directory, or other directory of your
         choice.

   o     To start the program, at the DOS prompt type: JNSEDT22 [ENTER].

   o     PALETTE EDITOR allows you to change the palette colors, including 
         spreads, exchanges, copies of colors, and other functions.

   o     EXPORT BACKGROUND creates a PCX file from your course background. It
         reads the course PRC file for the palette, and the course DZV file 
         for the backgound, then creates a PCX file to use in compatible 
         paint programs. The created file is named after the PRC and DZV 
         files and, after conversion, is stored in the same directory that 
         those two files are stored in.

   o     IMPORT BACKGROUND creates a JNSE background file from a PCX file. It
         reads a PCX file and writes the background into the course DZV file.
         The pcx file MUST be 1200 x 47 pixels. The utility does NOT write 
         the PCX palette into the course PRC file.  To move a PCX palette 
         into the course, use the 'L' option of the palette editor (see 
         below).

   o     PCX TO HOLE FILE allows for PCX files, painted within certain
         restrictions detailed below, to be converted into JNSE course hole
         files.

   o     PCX TO LANDPLOT allows for PCX files, painted with JNSE default
         terrain colors and with size restrictions detailed below, to be 
         converted into JNSE course landplot/overhead files.
-----------------------------------------------------------------------------

   PALETTE EDITOR
   --------------
   While using the palette editor, the following options are available:

   F1    Help.
   F2    Cursor off.
   F3    Display a background PCX file at the lower part of the screen. This
         allows you to see how any palette alterations affect the background.
   F4    Display a PCX file at the right corner of the screen. This was 
         designed primarily to let you see how palette adjustments affect a 
         PCX object before transfer into JNSE. See notes below on an optional
         PCX file, JNSEOBJS.PCX, included with this package.
   F5    Clears the graphics area.
   F6    Prints the palette settings.
   F7    Restores the palette to its original settings.
   F8    Show pixels (flashes pixels of the currently selected color). This is
         useful for identifying colors already in use in a background or 
         object file.
   F9    Shifts a displayed background left.
   F10   Shifts a displayed backgound right.
   ESC   Quit.
   PgUp  Increases the brightness of the current color.
   PgDn  Decreases the brightness of the current color.
   ARROW keys are used to move the cursor.
   R     Increases the red value of the current color.
   G     Increases the green value of the current color.
   B     Increases the blue value of the current color.
   Y     Increases the yellow vlaue of the current color.
   r     Decreases the red value of the current color.
   g     Decreases the green value of the current color.
   b     Decreases the blue value of the current color.
   y     Decreases the yellow value of the current color.

   Color values are set in a range of 0-to-63. Exceeding the 63 setting on any
   value causes it to rollover to 0 where it begins to increment again.  The
   reverse happens if the setting is taken below 0, the value moves to 63
   where it continues to be decreased.

   C,c   Copy color. Move the cursor to the color you want to copy, press C,
         then move cursor to where you want it copied, then press [ENTER].
   X,x   Exchanges two colors, use like the C command.
   S,s   Spread colors. Use like the C command. It will evenly spread the two
         selected colors as a range.
   INS   Edit the color description line. May be used to indicate what JNSE
         features a specific color is assigned to (grass, sand, control panel,
         etc.) and my be altered to taste. See below.
   K,k   Exports the current palette into a newly created PCX file named
         JNSEPAL.PCX.
   L,l   Load a PCX or PRC palette. For importing a palette from any other 
         PCX file, or for importing a palette (via PRC file) from another 
         JNSE course.
   U,u   User-defined shift of colors. (See the next entry, 'D.')
   D     Set your own user defined units in positive or negative numbers for
         RGB (Red-Green-Blue.Creates a file called RGB>USER with three 
         numbers in it on lines 1,2 &3. The program will load these 
         user-defined units. The RBG.USR file may also be altered in any 
         ASCII text editor.) 
         
         The user-defined shift allows you to set-up your favorite 
         combination and leave it on-hand from session to session. One 
         possible combination is "warmer-cooler": Using either +2 red, 
         +1 green or +2 red, +1 green, -1 blue.  Note that the values 
         that you set apply to the [U] key, and that [u] does the reverse of 
         those values automatically. The default RBG.USR file is +2 red,
         +1 green.

   JNSEOBJS.PCX
   Included is a PCX file called JNSEOBJS.PCX. It contains many of the
   standard objects, swatches of terrain colors, and the control panel used in
   the game. When loaded, the terrain swatches are labeled as follows:

               os-out of bounds colors
               ts-tee colors
               rs-rough colors
               fs-fairway colors
               gs-green colors
               ws-water colors
               ss-sand colors
               cs-cart path colors

   Load this file or any PCX file while you edit the palette, then you can
   see the effects of your changes.

   COLDESC.CDT
   When a palette is first loaded for editing, a CDT file must specified.
   Included is a starter file named COLDESC.CDT. It contains 256 lines of 
   color descriptions which appear at the bottom of the screen when editing 
   the palette.  You may edit the line by pressing the INSERT key. The 
   following keys are used in the editor:

                LEFT ARROW-RIGHT ARROW
                INS-DEL
                HOME-END
                TAB
                BACKSPACE
                ESC-ENTER

   You may wish to pay particular note to color #'s 16-31. JNSE uses these
   colors, particularly to paint the golfers, and because of this the program
   redefines them regularly during gameplay.  As a result, they should be 
   avoided when creating backgrounds in a user-owned paint program since the 
   colors will shift as different golfers-morphs are called up by the 
   program.

   To avoid this result, a number of JNSE-designers redefine these colors as 
   hot-pink or bright lavender...colors not in use in their background and 
   unlikely to be used then by their paint program when doing spreads and 
   blends. 

-----------------------------------------------------------------------------
   PCX-TO-HOLE FILE UTILITY
   ------------------------

   The program will convert 240x80 PCX files to hole files. It's purpose is to
   allow you to layout a hole in your paint program and then transfer it to 
   the JNSE course of your choice.  If your paint program will accept scans 
   then another application might be to transfer a scanned hole overhead 
   into a JNSE hole file.

   While working in your paint program:  Palette colors are used to identify
   terrain types and, as noted below, to establish a basic set of elevations.
   Therefore, one must draw/paint the hole within a few specific parameters if
   the PCX-to-hole file conversion is to be successful.

   The eight JNSE terrain types are assigned to blocks of 32 colors each in 
   the PCX palette.  Depending on the parameters you specify when converting 
   the PCX file, the various colors may be used to specify elevation changes. 
   A table below details how the palette is divided.


   To convert the PCX file to a JNSE hole file:

   o     You will need to do a course routing before you use this utility to
         import PCX files into JNSE hole files. This routing is used by JNSE 
         to establish the tee, pin, and centerline vertices in the course PRC 
         file.

   o     The PCX files must be in the same directory as JNSEDT2.

   o     The PCX files must be named H1.PCX, H2.PCX, etc.

   o     The program will ask for an elevation factor.  This factor is used by
         the conversion utility to convert the palette colors to JNSE
         elevations for the various terrain features. The elevation factor 
         range MUST be a number from 0 through 8.

   If you put enter a 0, then an elevation of 0 will be set by the utility for
   ALL terrain colors. The elevation factor is a straight multiplier. An 8
   setting would multiply the elevation units by eight.

   There are 32 elevation units (assigned to blocks of palette colors) per
   terrain: -15 through 16. Therefore, an 8 elevation factor would yield a 
   range of -120 through 127 in 8 unit steps (each unit is represents approx. 
   1/2 JNSE foot of elevation. So, in feet, the numbers represent -60 through 
   63 JNSE feet).

   The elevation factor you select is applied to all terrain types.

   Following is table which shows both how the colors are sorted by terrain
   type, and the colors that are used to establish negative, flat, and 
   positive terrain elevations when an elevation factor other than 0 is 
   entered during the conversion.

                     Elevation
   Terrain types   Color numbers
                  -15    0   +16
   ==============================
   Out of bounds    0   15    31
   Tee             32   47    63
   Sand            64   79    95
   Water           96  111   127
   Rough          128  143   159
   Fairway        160  175   191
   Green          192  207   223
   Cart path      224  239   255

   After the conversion:

   o     The utility creates hole files named " H1.H1," "H2.H2,"  etc.

   o     So that JNSE may read these files, rename them, as the other files for
         your course are named, using the format [coursename].H1, etc.

   o     It is highly unlikely that the tee, centerline vertices, and pin
         positions will match your hole files exactly.  You will need to 
         reset your tee positions, vertices and, at minimum, the position for 
         pin #1 so that JNSE may match the hole file to the correct routing.  
         You may also need to employ the MOVE HOLE function in JNSE's ROUTING 
         screen to properly lay out your course.

   o     PCX2HOLE.PCX is a 320 x 200 graphic template which contains the 
         hole frame, a palette key, and some simple reminders for use in
         creating a hole for JNSE conversion.  While this standard MCGA size
         provides screen workspace for cut-and-paste and other techniques, it
         must be reduced to 240 x 80 before conversion.
-----------------------------------------------------------------------------
PCX-TO-LANDPLOT
_______________

   Converts a 240 pixel wide x 120 pixel high PCX file into a JNSE-
   compatible .LDM file named LANDPLOT.LDM.

   o     PCX2LPLOT.PCX is a 320 x 200 graphic template which contains the 
         landplot frame, a palette key, and some simple reminders for use in
         creating a landplot/overhead graphic.  While this standard MCGA size
         provides screen workspace for cut-and-paste and other techniques, it
         must be reduced to 240 x 120 before conversion.

   o     The file must be named LANDPLOT.PCX and must reside in the same
         DOS directory as the toolkit JNSEDT22.EXE file.  Then simply select
         the PCX-TO-LANDPLOT button from the toolkit interface, and the 
         conversion is completed automatically.

   o     Note that the landplot file which is generated is without elevation,
         and may require a resetting of individual tees, hole vertices, and
         pins to work properly after the file is copied into your course.
   
   o     Remember to rename the output file (LANDPLOT.LDM) to match the 
         current DOS naming conventions of your current course.
----------------------------------------------------------------------------

   This software is copyrighted, but may be distributed free-of-charge 
   providing that all files accompany it and that they are unaltered.

   This software is not shareware, and you are not required to pay a fee to 
   use it.  However, I have nothing against receiving donations to help
   to continue software development for this or any future computer
   golf course designer.

-----------------------------------------------------------------------------

   Thanks to Mark Willett for providing the initial color description file,
   the v2.2 opening graphic, proofing and adding to this document, and other 
   useful suggestions prior to release.

-----------------------------------------------------------------------------

   I hope you find the JNSE Designer Toolbox v2.2 useful!  And I welcome any
   questions, comments, or suggestions.


   John Kunyik
   422 Prairieview Dr.
   Oswego, IL 60543

   May, 1995



