AddTime Readme

AddTime for Palm OS Handhelds

AddTime is a simple program for Palm OS devices that adds, subtracts,
multiplies and divides time values in hours, minutes, and seconds.

H:M:S Mode

H:M Mode

60+Min Mode

Frame Mode

Total Field - Top field, above Active Field.
Active Field - Field directly above keypad.

Tap a yellow "Mode" button to select the desired calculation mode.

H:M:S & H:M - In these two modes, the numbers are entered sequentially into the Active Field, either hours, minutes, and seconds or just hours and minutes.

60+Min - In this mode, a value greater than 60 minutes can be entered into the Active Field and is automatically converted to hours and minutes when any operator is tapped.

25 / 30 - In these modes, time values can be calculated, including frames. The "Frame" value runs from 0-24 or 0-29 and calculates the result in "Non-Drop" format only.

A running total, in decimal form, appears in the upper right-hand corner when in either the H:M or 60+Min mode.

Division Operation:
Since dividing time cannot always result in even values I've chosen to display the remainder (when appropriate) instead of rounding the result to the nearest minute or second, whichever the case may be. This means that when dividing in H:M:S mode the remaining seconds (or remaining minutes in H:M mode) that are not divided evenly are displayed next to the result.

For example, dividing 12:45:56 by 9 displays a result of 1:23:52 with a remainder of 8 seconds. The easiest way of understanding the remainder is by reversing the calculation. Multiplying the result, 1:23:52 by 9 will be 12:34:48. The remainder, obviously, is the difference between 12:34:56 and 12:34:48 or 8 seconds.

The remainder becomes more pronounced when the values are divided by larger numbers. For example, in H:M mode, 1234:56 divided by 25 equals 49:23 with 21 minutes remaining. Reversing the calculation, 49:23 multiplied by 25 equals 1234:35, the difference being 21 minutes.

This may or may not be useful for most people but at least I am able to provide you with the most accurate calculation, if it is necessary.

The following table shows how the minute values are rounded to tenth values.

Minute = tenth
00 - 03 = 0.0
04 - 09 = 0.1
10 - 15 = 0.2
16 - 21 = 0.3
22 - 27 = 0.4
28 - 33 = 0.5
34 - 39 = 0.6
40 - 45 = 0.7
46 - 51 = 0.8
52 - 57 = 0.9
58 - 60 = 1.0

The memory functions are all standard and also include a 'MS' key which "swaps" the stored memory value with the current value displayed in the Total Field. A "Storage" feature is also included to allow the result, and a short text description, to be saved within the program.

The value displayed in the Total Field can be copied to the Clipboard, using the menu command or Graffiti shortcut, and pasted into other applications.

Buttons:
M+ - Adds the value displayed in the Total Field to Memory.
M- - Subtracts the value displayed in the Total Field from Memory.
MR - Recalls the value saved in Memory and displays it in the Active Field.
MS - "Swaps" current value displayed in the Total Field with the value stored in Memory.
MC - Clears the value stored in Memory.
AC - Clears the values displayed in the Total Field and Active Field. (Not Memory)
C - Clears the Active Field.
DIFF - Opens the "Time Difference" page. (See below)
Store - Opens a new form where a time value and corresponding text description can be stored. When this button is pressed, the current value displayed in the Total Field is automatically copied to the Clipboard for immediate pasting into the desired storage field.

Time Difference Page
This page calculates the difference between any two clock times

Tapping the "DIFF" button on the main page will bring up this page.

When the page opens the current time is displayed in both the "Start" and "Stop" fields.

Tapping the hour or minute numbers brings up another box that allows you to change those values.

Tapping on AM or PM changes it to the opposite value.

The "Now" button inserts the current time into the corresponding field.

The "Hold" checkboxes allow you to hold the current time that's displayed in its corresponding field and allows you to use it as a simple count-up or count-down timer depending on whether you hold the Start time or Stop time, respectively.

The "24 Hour" checkbox converts the times to 24-hour format.

The "Start Here" checkbox allows you to go directly to this page when AddTime is started.

RELEASES:

Version 1.6 -- (March 1, 2004)

* Added a "Time Difference" function to calculate differences in "clock" times.

* Added a "00" button to help speed up number input.

* Addtime now supports only Palm OS 3.5 or greater. Both color and monochrome versions have been combined.

Version 1.5b & 1.5c -- (November 24, 2003)

* Finally included the division operator with remainder feature.

* Included the "25 FPS" mode.

* The program now saves the value in the "Total" field when the program is exited.

* Fixed more minor bugs.

Version 1.4b & 1.4c -- (May 21, 2002)

* Added a multiplication feature. Values can be multiplied in any mode except "Frame" mode.

* Changed the program so that the numbers are enter sequentially into the Active Field in ALL modes. No need to tap on an individual field to input the values.

* Fixed other minor bugs.

Version 1.3b & 1.3c -- (March 27, 2002)

* Added the ability to add and subtract "Frame" values in Non-Drop format.

* Minor cosmetic changes.

Version 1.2b & 1.2c -- (January 22, 2002)

* Added a "Storage" feature which allows the result, along with a short text description, to be saved within the program itself.

Version 1.1b & 1.1c -- (January 2, 2002)

* Added the ability to copy the result to the Clipboard.

* Went back to 2 separate files to support the older Palm devices (pre-Palm OS 3.5) and to keep the file size smaller for users not needing color support.

Version 1.1 -- (December 26, 2001)

* Added a feature which allows the input of "Total" minutes (values greater than 60) which is converted to Hours and Minutes (H:MM) automatically when an operator is tapped.

* Now displays the result in decimal form in the 'Scratch Pad' when in "QuickEntry" or "Over 60" mode.

* Combined the Color and Monochrome versions into one .PRC file.

* Fixed a few minor bugs.

Version 1.01 & 1.01c -- (September 9, 2001)

* Added support for the HandEra 330.

* Added support for color devices.

Version 1.0 -- (August 27, 2001)

* Initial Release

INSTALLATION:

This program requires Palm OS version 3.5 or greater to run.

Follow the documentation that came with your handheld to install the file AddTime.prc onto your device.

DISTRIBUTION FILES:
license.txt - The End-User License Agreement.
readme.html - This file in HTML.
AddTime.prc - Version 1.6 for devices running Palm OS 3.5 or greater.
AddTime16_1.gif - Picture of AddTime (H:M:S Mode) for the HTML file.
AddTime16_2.gif - Picture of AddTime (H:M Mode) for the HTML file.
AddTime16_3.gif - Picture of AddTime (60+Min Mode) for the HTML file.
AddTime16_4.gif - Picture of AddTime (25 FPS Mode) for the HTML file.
AddTime16_5.gif - Picture of AddTime (Time Difference Mode) for the HTML file.

REGISTRATION:

Cost: $12.00 USD

The evaluation version is fully functional except that the '5' key has been disabled until the program is registered.

Please go to https://secure.palmgear.com/sc/buy.cfm?prodID=27817 to purchase AddTime.

Before registering, please read the information on the following webpage:

http://climbspeed.com/reghelp.html

This page helps explain the registration process and contains additional information to insure that you receive your registration code with minimal delay.

Feel free to forward any comments or suggestions to me at: