Probe House Software presents

        Probe House  U N I T   C O N V E R T O R   v 1 . 0

                    William Wong, Jan 1995
                    Probe House Software

    * Introduction.
    * Installation.
    * Using PH Unit.
    * The Dialogs of the program.
    * The Conversion Report window.
    * The GUI of PH Unit.
    * Changing dialog Background Fill.
    * Application or accessory.
    * Development, History, acknowledgement, address

  PH Unit is freeware - you can freely use and distribute it. If you
  like it, please let me know as it is a booster for software developer.
  Donations and gifts are welcome.

Introducting PH Unit
=====================
The Probe House Unit Conversion or PH Unit is an small application
for, no prizes for guessing, converison between different units.

Why this program?
Well, I am not used to Miles and Fahrenheit, it's Kilometers and Celsius
where I come from, and have a hard time having a feel for distances and
temperature. Thus, this program was developed.

Of course it does a few other conversion as well. 
Here is a list of units it can handle:

Length  : feet, inches, yards, centimeters, meters, kilometers, 
          statute miles, nautical miles, par-secs, light-years,
          mils, microns, millimicrons, angstroms, x-units, rods,
          fathoms, furlongs.
         
Mass    : pounds, grams, kilograms, tons, amus, ounces, stones.

Speed   : m/sec, ft/sec, km/hr, cm/sec, knots, miles/hr.

Volume  : cubic meters, cubic cms, liters, gallons, cubic feet,
          cubic inches, barrels, hogsheads, boardfeet, cords.

Area    : square meters, square cms, square feet, square inches,
          circular mills, acres.

Density : kg/m3, slug/ft3, gm/cm3, lb/ft3, lb/in3.

Time    : days, years, hours, minutes, seconds, decades, score,
          centuries, millenia, fortnights.

Force   : newtons, dynes, pounds, gram-force, kilogram-force.

Energy  : btus, ergs, ft-lbs, hp-hr, joules, calories, kilowatt-hours,
          electron volts, MeV.

Pressure: atmospheres, dynes/cm2, inches of water, cms Hg, torr,
          mms Hg, inches Hg, lbs/in2, lbs/ft2, newtons/m2, bars,
          pascals.

Plane Angle :
         degrees, minutes, seconds, radians, revolutions.

Power   : btus/hour, ft-lbs/min, ft-lbs/sec, horsepower, kilowatts,
          watts, calories/sec.

Electric Charge :
          coulombs, abcoulombs, amp-hrs, faradays, statcoulombs,
          electron charges.

Magnetic Induction:
          gauss, kilolines/in2, webers/m2, tesla, gamma.

Light   :  Footlamberts, Nit, Millilamberts, Candelas/in2,
           Candelas/ft2, Candelas/m2, Stilb.

Temperature :
           Fahrenheit, Celsius, Rankine, Kelvin.

There are others, but hey, I'm no rocket scientist!!


Using PH Unit
=============
1/ Select the type of unit conversion you are interested in, eg length.
2/ Next select the specific unit, eg "inches".
3/ Next enter the amount, eg 10.
4/ The result will be a table converting the amount of inches to every other
   unit of length the program is familiar with.


Installation
============
Easy really, just unlzh the archive into any directory.
Double click on the PH Unit icon to run it.


Dialogs of the PH Unit
======================

The Main Dialog
---------------
This is where you start off. It presents all the possible type of 
conversion available in this program. Just click on the type you 
are interested in.


The Units Dialog
----------------
This dialog requires you to select the specific units you want to
convert. Click on the unit that you are interested in.


The Entry Dialog
----------------
This dailog prompts you for the value of the unit selected in the
Unit Dialog. This value will be converted to every other unit 
displayed in the Unit Dialog.


The Converion Report Window
===========================
This window display the result of the conversion.
Conversion results will always be display in this window. So old
results are overwritten and lost.

To save the result in a file, press 'P' whenever this window is 
opened. You will be prompted for the filename to save the results
into via a file selector. Overwrite warning will not be issued.


The PH Unit GUI
===============
PH Unit uses an advance GUI for the ST/STE/TT and Falcon. The following
tries to give an overview of the interface.

Iconification
-------------
All windows can be iconified in all TOS version.
For those TOS which support iconification use the button for it.
For other TOS, to iconify a window, click the RIGHT mouse button on
the window title bar.

Window management
-----------------
Windows can be manipulated by hot keys.
ESC        : Maximise / restore size  a window.
Shift-ESC  : Close a window.
Shift-Tab  : Iconify a window.
Control-Tab: Cycle windows.


Changing dialog background fills
================================
To change the background fill, double click on any part of the Main
Dialog except the buttons. The selected background fill is remembered
for future usage of PH Unit.

The default background fill is 50% grey.


Application or Accessory
========================
PH Unit is both an application and am accessory rolled into one.
To use it as an application, rename it to PHUNIT.PRG
To use it as an accessory, rename it to PHUNIT.ACC and pop it into
the bootup drive.


Development, History, acknowledgement, address
==============================================
This program was developed on a 4Mb Tos 2.05 Mega STE with 170Mb HDD.
Currently I am using a TV, my monitor is back home. I am not shipping
my monitor for this. So if the screen looks funny, please feedback to
me.

Software tools and package use:
-------------------------------
  Program  : Pure C, Pure Debugger and GUI provided by BIG 1.88.
  Hypertext: Pure C (editor), ST-Guide and HCP

History
-------
Ver 1.0:  Released to the public as freeware.

What's next ?
-------------
For PHSW, I am thinking of a QWK OLR, well, actually, it will be an
update of my unrelased QWK OLR.

Feedback
--------
  Please send feedback of any types to:
    Internet : wongck@lobby.ti.com

    Mail : William Wong
           Blk 148, Potong Pasir Ave 1,
           #04-63, S(1335),
           Republic of Singapore.

           William Wong                The USA address valid till
           2600 Preston Road,          April 1995
           Apt 1009,
           Plano, Texas 75093
           USA

Acknowledgement
---------------
Borland Germany for the excellent Pure C and Pure debugger.
Claude Attard   for the cool BIG libraries.
Holger Weets    for the great ST-Guide and HCP software.
Gregory Simpson for the conversion table.
My students     for the interpretation.

