Welcome to KIPP3D Version 1.02. 

(Turn off word wrap to properly view.) 

This file contains some important information, including:

 1.  What is KIPP3D? 
 2.  Tell Me about Registering KIPP3D
 3.  Where's the Manual?
 4.  System Configuration
 5.  Installing KIPP3D on Your Computer
 6.  Using KIPP3D (Sample Session)
 7.  Identifying Files
 8.  Supported Hardware
 9.  End User Licensing Agreement
10.  History


1.0  WHAT IS KIPP3D?
--------------------
KIPP3D is a suite of programs for turning plain ASCII data into contour 
(topographic) and/or surface (3D) graphs and plots.  From the beginning 
it was designed with two goals:  First, eliminate several incredibly 
annoying shortfalls of the big name, big cost programs.  Second, produce 
an inexpensive program that does almost everything those big name, big 
cost programs do.

It was written for DOS, but works great under Windows 95/NT.  As an added 
benefit, KIPP3D can use any graphical printer you have installed under 
Windows 95/NT.   



1.1  Some Features at a Glance
------------------------------

MAKGRID:
-No maximum number of input data points
-Up to 100 x 100 divisions on a grid
-Extrapolate beyond data limits
-Include data outside grid limits
-Smooth "noisy" data
-Customizable grid building (size, number of iterations, etc.)
-Online help

CONTOUR:
-Create contour/topographic plots
-Titles in multiple fonts with sub/superscripts (axes, main title)
-Customizable spacing on tic marks, contour lines, etc.
-Multiple fonts (Roman, Greek, Cyrillic, Old English, etc.)
-Multiple symbol sets (Centered, Arrows, etc.)
-Saved plot preferences (preferred fonts, scaling, etc.)
-Optional "stretching" of axes instead of scaling to maintain original 
data proportions
-"Posting" data onto plots
-User selected plot colors (many independently set)
-Scientific notation or fixed point representation of numbers
-Online help

SURFACE:
-Create 3D surface plots
-View hidden lines or hide the hidden lines
-Titles in multiple fonts with sub/superscripts (axes, main title)
-Customizable spacing on tic marks, contour lines, etc.
-Multiple fonts (Roman, Greek, Cyrillic, Old English, etc.)
-Multiple symbol sets (Centered, Arrows, etc.)
-Saved plot preferences (preferred fonts, scaling, etc.)
-Optional "stretching" of axes instead of scaling to maintain original 
data proportions
-"Posting" data onto plots
-Draw "base" on plot (base off, base on, base outlined)
-User choice of lines of constant X, Y, or both
-Variable viewing angles
-User selected plot colors (many independently set)
-Scientific notation or fixed point representation of numbers
-Axes can be rotated for easier reading
-Online help

VIEW:
-Display previously created plot files
-Online help

PLOT:
-Make hardcopies of previously created plot files
-Online help

ENHANCEMENTS:
-Add-on programs enhance KIPP3D
 --Font/Symbol cross-reference (figure out which key makes which 
character)
 --Combination Plot Generator (automatically place a contour under a 
surface plot)
 --Others as they become available
-Add in fonts/symbols as they become available



2.0  TELL ME ABOUT REGISTERING KIPP3D
-------------------------------------

KIPP3D is distributed under the Shareware concept -- Try it before you 
buy it.  Feel free to play with the copy you have for up to 30 days.  
If, at that point, you feel it is worth the price of registration, 
register it!  If not, delete it!


2.1  How Much is Registration?
------------------------------

For 1-5 copies, $39.95 each.  
For 6-10 copies, $29.95 each.
For 11-19 copies, $24.95 each.
For 20-25 copies, $19.95 each.  
A site license is $500.
A world license is $2000.
(Prices in US Dollars.)

As you can see, this is MUCH LESS THAN THE BIG NAME SOFTWARE!


2.2  How Do I Register
----------------------

The simplest way is to run the program REGISTER.EXE that came with the 
KIPP3D package and follow the directions.  REGISTER will help you create 
an email to register using a credit card over the Internet or will print 
the form for you to register by mail using a check, credit card, money 
order, or First Virtual payment.  

Notes:  
  --REGISTER will show more than one product.  Select the products you 
wish to order/register:  KIPP3D, a postal receipt, printed manuals, etc.  

  --Only printed manuals sold to residents of California are subject to 
sales tax.  If you order the printed manual and you live in California, 
you should also select the appropriate option when ordering the manual.

  --I use the software registration service offered by Kagi.  Kagi is 
only a registration service.  They will send your registration codes to 
you via mail (if you selected the "Postcard" option and paid the extra 
$1.00) or by email (if you provided your email address).  Kagi must have 
a way to send you the registration code.  You should hear from Kagi in 
less than a week (plus mail delivery time, if you chose that option).  
If you haven't heard from Kagi after that time, contact them at the email 
address:  support@kagi.com.

  --Visit Kagi on the Internet at www.kagi.com.  In the near future, 
KIPP3D registration will be accepted over their secure server for faster 
response.  

  --Questions about the software should be directed to the email address:  
ohware@kagi.com.  Registered users will receive priority. 

  --The REGISTER program will allow you to add a "Bonus" to if you feel 
the program is worth more than the registration fee. 




2.3  Why Should I Register?
---------------------------

With registration you get:

1.  The ability to print your plots.
2.  Notification of upgrades, add-ons, etc. via email.
3.  Discounts on upgrades, add-ons, additional fonts.

In addition, you should know I will be donating 10% of my royalties from 
KIPP3D to the Special Olympics.



3.0  WHERE'S THE MANUAL?
------------------------

To keep the cost of KIPP3D as low as possible, a complete "softcopy" of 
the manual is available in WORD 7.0 format for free.  You should already 
have it -- look for the file MANUAL.DOC.  (Some vendors may separate the 
manual from the rest of the program package to reduce the size of the 
individual downloads.)  If you use Windows 95/NT and don't have a copy of 
WORD 6.0 or higher, visit Microsoft's website and download their free 
viewer.  To properly display/print the manual with WORD, set your margins 
as follows:  Top 1.25", Bottom 1.25", Left 2.33", Right 0.83", Gutter 0", 
Header .67" from edge, and Footer .67" from edge.  

A bound "hardcopy" is also available for $15 (plus sales tax for 
California residents).  You must order it by running the program 
REGISTER.EXE.  (California residents should also add sales tax by 
selecting that option when ordering the manual.)  (Prices are in US 
Dollars.)



4.0  SYSTEM CONFIGURATION
-------------------------

Required:

386-based PC or better
DOS 6.2 or better, or Windows 95, or Windows NT (Windows 98 has not been 
tested but should work without any problems.)
640 KB RAM
14 MB of free hard disk space for program (plus space for creating plots)
(6.6 MB of the space is for the manual.)
CGA, EGA, or VGA display adapter and corresponding monitor

Optional:
One of the supported output devices
Mouse or trackball



5.0  INSTALLING KIPP3D ON YOUR COMPUTER
---------------------------------------

Installation is easy.  Just copy all of the files into the same directory, 
preferably one named KIPP3D.  To begin using the programs, run the program 
KIPP3D.EXE.

For DOS Users:  Change to the directory containing KIPP3D.  Type KIPP3D to 
start the main menu.  All parts of the suite are available from this menu.  
(Note:  COMMAND.COM must be in your path.  If it is not, you will 
eventually get the error "File Not Found" when KIPP3D tries to access 
features within it.  COMMAND.COM is almost always in the root directory of 
your hard drive and will almost always be in the path already.)

For Windows 3.1 Users:  Exit to DOS and follow the directions for DOS.

For Windows 95/NT Users:  Use the Microsoft Explorer to display the 
directory containing KIPP3D.  If you plan to use your printer, you will 
need to install the Windows printer support by double-clicking on 
WINSTUFF.  When prompted, install the program to the directory containing 
KIPP3D.  After installing the printer support, double click on KIPP3D (or 
KIPP3D.EXE depending on how your options are set).  This will start the 
main menu.  All parts of the suite are available from this menu.  (You 
will not need to reinstall the Windows printer support to run KIPP3D in 
the future.)  The manual has an appendix with more information for Windows 
users.




6.0  USING KIPP3D (SAMPLE SESSION)
----------------------------------

Step 0:  From KIPP3D's main menu, select "COnfig" to run the configuration 
program.  Select the appropriate display, printer, etc.

Step 1:  Identify your ASCII data file.  You can create it with BASIC from 
a function, store it from a data collection system, etc.  One format for 
the data can be three columns of data (x,y,z) with each line representing 
one three-dimensional point.  (The sample data file, SADDLE.DAT, is in 
this format.)

Step 2:  You'll need to take your ASCII data file and convert it into a 
"grid file."  Grid files are regularly spaced and contain a maximum of 
10,000 points.  Your ASCII data may be randomly spaced and contain as many 
points as you wish.  From the main menu in KIPP3D, select "Grid" to begin 
this process.  (This executes the program "MAKGRID.EXE.")  The manaual 
details the options for making grids.  (On-line help can be accessed from 
most screens by clicking on "Help" or pressing Alt-H.)  Once you've set 
the options you want to use, click on "Begin" to make the grid.  (This is 
the slowest step of the entire process, so be patient.  Start small -- 
10-15 subdivisions along each axis!)  "Quit" takes you back to the main 
menu when the process is finished.

Step 3:  Do you wish to create a two-dimensional contour (totographic) or 
a three-dimensional surface plot?  You can do either with the grid file 
you just created.  (If you used the sample file SADDLE.DAT, then you'll 
have a grid file named SADDLE.GRD.)  Let's assume you want to make both.  

   Step 3A -- Contour Plot.  Select "Contour" from the main menu.  (This 
starts the program "CONTOUR.EXE.")  Play with the options to customize the 
plot.  "Disp" will show you how your plot will look -- it's short for 
"Display."  Select "Plot" to make the plot file.  (Plot files are the 
output product of both CONTOUR.EXE and SURFACE.EXE.  You will use the plot 
files to make hard copy prints later.)  The default name of your plot file 
will be SADDLE.PLT if you've been using the example.  Change the name to 
something else you will remember for later, for example SADDLE-C.PLT.  
After creating the plot file, choose "Quit" to return to the main KIPP3D 
menu.

   Step 3B -- Surface Plot.  Select "Surface" from the main menu.  (This 
starts the program "SURFACE.EXE.)  After you've customized your plot with 
the various options, use "Disp" to preview the 3D surface.  Select "Plot" 
to make the plot file.  Again, change the plot file name to something like 
SADDLE-S.PLT.

Step 4:  Assuming you've registered your copy of KIPP3D, you can now make 
a hardcopy of your plot files.  Select "Plot" from the main menu and 
select the file you wish to print.  (This runs the PLOT.EXE program.)  
(In our example, you would have SADDLE-C.PLT and SADDLE-S.PLT available.)  
After printing, return to the main menu.  (Note:  If you have not registered 
your copy of KIPP3D, running plot will give you the option to register or print 
a demo plot.)

Step 5:  Okay, you like the plots, but your boss would like to see one of 
those "fancy" plots that puts the contour plot directly below the surface 
plot.  Luckily, you remember that your copy of KIPP3D has the "Combo Plot" 
add-on program.  Click "Enhance" (short for "enhancements") and select 
"Combination Plot Generator."  You'll be prompted to supply the surface 
plot file name, the contour plot file name, and a title.  (That's why you 
put the -S and -C on the names!)  Use a name like "COMBO.PLT" for the 
output file name.  Exit back to the main menu.

Step 6:  You could select "Plot" and make a hardcopy, but instead use 
the "View" option (which runs "VIEW.EXE").  You should see the combination 
plot you just made with the add-on program.  You can also use the "View" 
option to look at any of the *.PLT files you have created.

That's all there is to the process.  Of course, you may have more add-on 
programs, but they should have their own documentation.


7.0  IDENTIFYING FILES
----------------------

You should have the following files:

*.FNT -- Font files 
*.SYM -- Symbol files
*.EXE -- The executable files 
*.HLP -- Help files used by the executables
*.CFG -- Configuration files
*.DAT -- ASCII data files (samples supplied)
(One exception:  REGDATA.DAT is data for the REGISTRATION utility.)
*.PLT -- Output flot files created by KIPP3D (samples supplied)
*.DEM -- Plot used for demo before software is registered (you may 
delete AFTER registering)
*.GRD -- Grid file produced by MAKGRID for KIPP3D (samples supplied)
*.ICO -- Icons for use with KIPP3D and Windows 95/NT
*.SUP -- Supported equipment 
*.PRF -- Preference files 
*.DOC -- Document files in WORD 7.0 (such as the manual)
*.TXT -- Plain ASCII text files (such as README.TXT)
*.BAT -- DOS batch files used by KIPP3D
*.ICO -- Windows ICON files

The following files must never be deleted or moved from the directory 
from which you start KIPP3D:
ROMANS.FNT
GREEKS.FNT
CENTERED.SYM
RUNWIN.BAT
*.EXE
*.HLP
*.SUP

Files you may have:
*.REG -- Registration data (do not delete)
*.TMP -- Temporary files left over from improper shutdown (you may delete)
*.OPT -- Optimized files left over from DOS printer spooling that was 
improperly aborted (you may delete)
*.OUT -- Captured output printer files (created when you direct output to 
a file instead of a printer/plotter)
*.ADD -- Installation information for "add-on" expansion programs for 
KIPP3D (do not delete)




8.0  SUPPORTED HARDWARE
-----------------------


8.1  Printers Supported Under DOS:
----------------------------------

IBM/Epson Compatible 9 pin B&W (including Star NX-1000)
IBM/Epson Compatible 9 pin color (including Epson JX-80, Star 
NX-1000 Rainbow)
Hewlett-Packard HP-II Laserjet (including HP-II, Panasonic 4400)


8.2  Plotters Supported Under DOS:
----------------------------------

Comrex I/Sweetpea I 
Hewlett-Packard (1, 2, 6, 8 pen models)
Pixy 1
Pixy 3

8.3  Printers/Plotters Supported under Windows 95/NT:
-----------------------------------------------------

Any properly installed plotter and/or any properly installed printer 
capable of graphics printing.  KIPP3D will use the default Windows driver. 


8.4  Video Supported:
---------------------

CGA, EGA, VGA adapters with corresponding monitors.



9.0  END USER LICENSING AGREEMENT
---------------------------------

The following is a legal software license agreement between you, the 
software end user, and Oh!Ware Software. Carefully read this license 
agreement before using the product. Using the product indicates that you 
have read this license agreement and agree to its terms.

Grant of License: KIPP3D is distributed as Shareware.  An unregistered/ 
unlocked copy may be freely copied and distributed provided no files are 
altered, deleted, or added.  You may not sell any part of the package or 
bundle any part of the package with any other product without written 
approval from the author.  (A nominal fee -- less than $10 -- may be 
charged for the media by Shareware vendors.)  You may evaluate the 
unregistered/unlocked copy for up to 30 days to determine its usefulness 
to you.  Once registered/unlocked, KIPP3D and all of the associated 
components cease to be Shareware and are limited in distribution.  
This license permits you to use one copy of the registered/unlocked 
software package on any single computer.  For each software licensee, 
the program can be *in use* on only one computer at any given time. The 
software is *in use* when it is either loaded into RAM or installed into 
the hard disk or other permanent memory.  Site licenses are available 
if the software is going to be installed on network servers.

Copyright: The KIPP3D software contained in this package is owned by 
Oh!Ware Software, specifically Kerry Hicks, and is protected by United 
States copyright laws, international treaty provisions, and all other 
applicable national laws. The software must be treated like all other 
copyrighted materials (e.g. books and musical recordings). This license 
does not allow the software to be rented or leased, and the written 
materials accompanying the software (if any) may not be copied.

Limited Warranty. The software contained herein will perform substantially 
in accordance with the accompanying documentation.

No Other Warranties:  Oh!Ware Software and Kerry Hicks disclaim all other 
warranties, either express or implied, including but not limited to 
implied warranties of merchantability and fitness for a particular 
purpose, with respect to the Software and the accompanying written 
materials (if any).

No Liability for Consequential Damages:  In no event shall Oh!Ware 
Software or Kerry Hicks be liable for any damages whatsoever (including 
but not limited to damages for loss of business profits, business 
interruption, loss of business information, or any other pecuniary loss) 
which results from an inability to use this software, even if Oh!Ware 
and/or Kerry Hicks have been advised of the possibility of such damages. 

Simply put:  The software will perform as stated in the documentation.  
Once you have evaluated the software and are satisfied it does this, you 
register it.  I won't be liable for any damages caused by use, misuse, 
or inability to use the programs.  YOU are responsible for any losses 
and/or damages that occur while using KIPP3D and all of the programs 
it is bundled with.



10.0  HISTORY

KIPP3D grew out of my frustration with the commercial packages I had 
available in graduate school.  Primarily, I ran into the following 
problems with the commercial programs:

  --If I wanted to use axes with vastly different scales (0 < x < 0.001 
and 0 < y < 10,000), the commercial programs made the x-axis tiny because 
they wanted to maintain the original scaling.  KIPP3D solves this by 
letting you set the physical size of each axis (in inches).  

  --I often had more than 10,000 data points.  The program I had available 
would only accept 10,000 points, so I had to throw out perfectly good data.  
Using a reverse gridding algorithm, KIPP3D can accept as much data as you 
have the time and space to process.

  --They were all expensive.  Even a starving graduate student can afford 
KIPP3D! 


Version 1.0: 
      Feb 99 - Original shareware release

Version 1.01:
      Apr 99 - Fixed minor bug that affected DOS printing of demo
               plot in unregistered copy of KIPP3D.

Version 1.02
      Aug 99 - Fixed a bug in grid creation.  Bug caused fatal crash under fairly rare arrangements of data and grid combinationns.
 
