home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / util / timecalc-1.0.lha / TimeCalc / TimeCalc.doc < prev    next >
Text File  |  1993-08-21  |  8KB  |  198 lines
  1. TimeCalc V1.0
  2. © 1993 Paul Huxham
  3.  
  4. paulh@wavefrm.DIALix.oz.au
  5.  
  6. PO Box 875
  7. Morley,
  8. Perth,
  9. Western Australia 6062
  10.  
  11. Well, I never found a decent timecode calculator, so here is one that works
  12. correctly  (For  me  at  any rate) with EBU and SMPTE timecodes (SMPTE Drop
  13. Frame  is not currently supported).  It has clever string gadgets that make
  14. timecode entry a breeze.
  15.  
  16. The timecode entry routines are part of the "Diamond Edit" package which is
  17. a  single  frame  recorder  for the PAL environment (soon for NTSC) that is
  18. a  very  powerful  and  cost  effective  means  of  recording  hires  24bit
  19. animations   to  video  tape  for  playback  at  a  full  frame  rate  (for
  20. professional VTRs only).
  21.  
  22. Please  direct  all  comments  and  criticisms (all welcome) to the authors
  23. interNET address above.
  24.  
  25. ===========================================================================
  26. OverView
  27.  
  28. Timecode  is entered into Timecode Entry Gadgets.  At first sight they look
  29. very  much  like standard string gadgets, except they have three colons ':'
  30. inside of them.
  31.  
  32. When  you  have  clicked  in  a  timecode entry gadget, there are shortcuts
  33. available that make for quick and easy timecode entry.
  34.  
  35. You  can enter an IN and OUT time and TimeCalc will show you the difference
  36. between  them, or you can enter an IN time and a DURATION and TimeCalc will
  37. generate the corresponding OUT time automatically.
  38.  
  39. TimeCalc  will  also  show  the total number of frames to the right of each
  40. gadget.
  41.  
  42. Pull  down menus enable you to select a timecode entry mode, as well as get
  43. infor about the author and quit the program.
  44.  
  45. ---------------------------------------------------------------------------
  46. CLI interface
  47. -------------
  48. There are 5 options available when executing TimeCalc from a CLI/Shell:
  49.  
  50. 1)  FILM     - 24 Frames per second
  51. 2)  EBU      - 25 Frames per second    (default)
  52. 3)  SMPTEDF  - 29.97 Frames per second (Not implemented yet)
  53. 4)  SMPTE    - 30 Frames per second
  54. 5)  PUBSCREEN=<Public screen name>
  55.  
  56. Entering  any  of  the first 4 options, will set the timecode entry mode in
  57. TimeCalc to that mode.
  58.  
  59. The  PUBSCREEN  can  be  used to force TimeCalc to open on a public screen.
  60. This  is best when called as a hotkey from Tool Manager, using "GetPubName"
  61. to retrieve the frontmost public screens' name.
  62.  
  63. Workbench interface
  64. -------------------
  65. Currently there is only one tooltype:
  66.  
  67. MODE=<FILM | EBU | SMPTEDF | SMPTE>
  68.  
  69. This is used to preset the timecode entry mode for TimeCalc.
  70.  
  71.  
  72. ---------------------------------------------------------------------------
  73. Clicking in an Entry Gadget
  74.  
  75. When  you  click  in an entry gadget do not bother worrying about where you
  76. click.  Timecode entry will always start at the right and move to the left,
  77. just  like  a  calculator.  The cursor will snap over to the right when you
  78. start  typing.   So,  to enter 1 second and 5 frames, you only need to type
  79. 105<return>.
  80.  
  81. The  separator  colons  ':'  are not entered by you, they are placed by the
  82. gadget  automatically.   The  only  part  of the timecode you need to worry
  83. about is the numbers themselves.
  84.  
  85. ---------------------------------------------------------------------------
  86. Movement between gadgets
  87.  
  88. Pressing  <return>  in the IN gadget moves you automatically to the OUT and
  89. then on to the DURATION gadget and then deselects all gadgets.
  90.  
  91. You  can also TAB between the gadgets or use the up and down cursor keys to
  92. move between gadgets.
  93.  
  94. ---------------------------------------------------------------------------
  95. Entering digits
  96.  
  97. You  do  not  have  to enter all of the hours, minutes, seconds and frames.
  98. Unentered  digits always assume the value of zero.  This means if you enter
  99. 312<return>,   you   have  entered  3  seconds  and  12  frames.   Entering
  100. 450622<return> means 45 minutes, 6 seconds and 22 frames.
  101.  
  102. If  you  do  not enter enough digits to reach hours, the gadget will assume
  103. you mean no hours.
  104.  
  105. You  will  be unable to enter any more than 8 digits into any entry gadget.
  106. This  is  because  there are only 2 digits available for each of the hours,
  107. minutes, seconds and frames.
  108.  
  109. Pressing the backspace key will erase the last entered digit.  You can move
  110. the  cursor  across  to  other  digits, but it will always snap back to the
  111. right  when  you  enter  more digits.  If you have entered 4 digits and you
  112. find  that the first digit is incorrect, you will have to delete all of the
  113. entered digits and retype them.
  114.  
  115. ---------------------------------------------------------------------------
  116. Incorrect timecode entry
  117.  
  118. Timecode  that is not correct i.e.  28 frames; will be corrected by summing
  119. the  total number of frames in the entered timecode and then splitting this
  120. value up into hours, minutes, seconds and frames.
  121.  
  122. With  EBU timecode selected, entering 250<return> would appear to be 2 secs
  123. and  50 frames.  However you can't have 50 frames so this will be summed to
  124. a  value  of  100  frames  and  then  split into a value of 4 seconds and 0
  125. frames.  (Because there are 25 frames in one second in EBU).
  126.  
  127. ---------------------------------------------------------------------------
  128. Wrap around
  129.  
  130. Timecode that runs over 23 hours, 59 minutes, 59 seconds and 24 frames will
  131. turn over to 0 hours, 0 minutes, 0 seconds and 0 frames.
  132.  
  133. ---------------------------------------------------------------------------
  134. Aborting timecode entry
  135.  
  136. Pressing escape will cancel the current timecode entry operation and return
  137. the timecode previously entered into the gadget before you started changing
  138. it.
  139.  
  140. ---------------------------------------------------------------------------
  141. Entering two zeros
  142.  
  143. Pressing  the  fullstop key on the numeric keypad or main keyboard enters a
  144. double zero '00'.
  145.  
  146. It  is  a  quick  way  of  entering  say 2 minutes, which would normally be
  147. entered as 20000<return>.  Type 2..<c r> instead.
  148.  
  149. To  delete  a double zero, you will need to press backspace twice as double
  150. zeros are just two normal zero digits.
  151.  
  152. ---------------------------------------------------------------------------
  153. Entering a number of frames
  154.  
  155. If  you  need to enter a number of frames less than 99, you just enter them
  156. and  press  <return>.  They will be converted to the correct timecode value
  157. for you.
  158.  
  159. If  however  you  need  to enter say 1000 frames, enter 1000 and instead of
  160. pressing <return>, press 'f'.  This will enter 100 frames and convert it to
  161. its correct timecode value.
  162.  
  163. ---------------------------------------------------------------------------
  164. Plus Mode
  165.  
  166. Pressing  + on the numeric keypad or = on the main keyboard enters the plus
  167. mode  where  the  timecode  you  enter  next  will be added to whatever was
  168. displayed in the gadget before you entered plus mode.  A + sign will appear
  169. in the left end of the entry gadget indicating plus mode is active.
  170.  
  171. This  is  an  easy  way  to add one or two frames or minutes to the current
  172. timecode value.
  173.  
  174. ---------------------------------------------------------------------------
  175. Minus Mode
  176.  
  177. Pressing  -  either on the numeric keypad or main keyboard enters the minus
  178. mode where the timecode you enter next will be taken away from whatever was
  179. displayed  in  the  gadget  before  you  entered minus mode.  A - sign will
  180. appear in the left end of the entry gadget indicating minus mode is active.
  181.  
  182. This  is  an  easy  way  to  subtract one or two frames or minutes from the
  183. current timecode value.
  184.  
  185. ---------------------------------------------------------------------------
  186. Sum Mode
  187.  
  188. Pressing  *  on the numeric keypad or \ on the main keyboard will resolve a
  189. plus  or  minus  operation  currently being entered and then continue entry
  190. until you press <return>.  You must press return to store your entry.
  191.  
  192. After  using  this  function  you can continue entry as though you had just
  193. clicked in the entry gadget with the mouse.
  194.  
  195. This  is  extremely  useful when you are adding to an existing timecode, to
  196. see a plus or minus result before accepting a final value.
  197.  
  198.