TimeCalc 1.5a 15th October 1996 ---------------------------------------------- Description ~~~~~~~~~~~~ TimeCalc allows you to add together a list of times easily and quickly. eg. running lengths of films, or CD tracks Quick example: 3:28 -> 3:28 | 0:03:28 4:11 -> 7:39 | 0:07:39 3:05 -> 10:44 | 0:10:44 4:35 -> 15:19 | 0:15:19 4:31 -> 19:50 | 0:19:50 ---------------------------------------------- Usage ~~~~~ TimeCalc has three different methods of operation. Either manual entry of the times, reading the list from a file or reading the list from the clipboard. Reading the file is basiclly the same as typing in the numbers, but it's just done in advance, so the following conditions apply. Enter numbers like this: hh:mm:ss The display is in the format: -> mm:ss | h:mm:ss Any non-numeric character can be used as a seperator between the fields of the time. If you don't want to enter all fields, you don't have to. You could just have `mm:ss', or just `ss', but seeing as the program works right to left, if you want to leave out either the minutes or seconds, you must replace them with a `0'. eg. `3:00:00' for three hours. Also, you are not limited to two characters per feild. Say you wanted to add a group of film running lengths, you might have a list like this: 115:00 -> 115:00 | 1:55:00 123:30 -> 238:30 | 3:58:30 98:10 -> 336:40 | 5:36:40 88:59 -> 425:39 | 7:05:39 239:15 -> 664:54 | 11:04:54 `R' resets the count to 0:00:00, `Q' quits out. Invalid entries are ignored. You can subtract times by entering a minus (-) sign before the time: 40:15 -> 40:15 | 0:40:15 -20:11 -> 20:04 | 0:20:04 If the CLIP option is used instead of specifying a filename, then TimeCalc will use the current block in the clipboard. It will be treated as a file, so the options that affect a file will also work on this data. When reading the list of times from a file, there are three extra options available: Q=QUICK - This causes TimeCalc not to print entries as they are added, and just gives a total time at the end of the list. C=CONTINUE - If this option is present, then after the file has been scanned, you can continue entering times by hand. O=OFFSET - This is a decimal number representing where on the line to get the number to process. Eg. For the `!Mods.txt' files in Mods Anthology¹ you would use an offset of 44 ---------------------------------------------- History ~~~~~~~ 1.0 / 1.1 - Beta copies. Broken as hell 1.2 - First public release 1.3 - Internal beta - Whoops. 1.2 thought there was 70 minutes in a hour - Completly re-wrote maths routines. Previous versions had a maximum total of 18 hours - Now requires V37 or better 1.4 - Second public release - Added option to read a list from a file - Added Continue and Quick options 1.4a - Internal beta - Fixed minor bug where number would be re-used if non standard characters were found in entry 1.5 - Third public release - Added Offset option - Added Clip option (clipboard.device support) - Cleaned up memory handling - Rewrote string conversion routine. Can now cope with numbers being preceded by text, and can find the end of a number properly. 1.5a - Internal beta - Corrected Offest numbering. Was starting at Offset-1 ---------------------------------------------- Notes ~~~~~ #include I am very bad at writing documentation for my programs. I know how they work becuase I wrote them. Putting how they work into words is something I have always found difficult. If you have any problems, please feel free to contact me. ¹ - Mods Anthology is an excellent set of 4 CD's of modules collected together by Nicolas "Gryzor" Franck. Check it out. Special thanks to: Kerry - For putting up with me (Love ya) Renze - For not caring Gryzor - The idea about reading from a file ---------------------------------------------- Contact ~~~~~~~ Dave Dustin Ph/Fax: +64-6-357-9283 Eclipse Software Email: dave@eclipsnz.manawatu.gen.nz PO Box 4598 Palmerston North 5301 New Zealand