       tc2cfr v1.5 by tritical - Help File  --  August 02, 2006
--------------------------------------------------------------------------


INFO:

      This program turns an avi file (with each frame present once)
   into a new avi file with null frames with the specified framerate
   and a v1 or v2 timecode file specifying the display length for
   each individual frame.


SYNTAX/EXAMPLES:


   tc2cfr out_fps input_avi_file timecode_file_or_fps output_avi_file


   tc2cfr 119.880120 c:\video.avi c:\timecodes.txt c:\video-120.avi

   tc2cfr 120000/1001 c:\video.avi c:\timecodes.txt c:\video-120.avi

   tc2cfr 120000/1001 c:\video.avi 24000/1001 c:\video-120.avi

   tc2cfr 119.880120 c:\video.avi 23.976024 c:\video-120.avi


PARAMETERS:


   out_fps -

      The framerate of the destination (output) avi file.  The
      fps is specified as a double precision floating point number or
      as a fraction in numerator/denominator format.  When using a
      fraction input the exact numbers specified for numerator and
      denominator will be used for the dwRate and dwScale fields of
      the output avi file.


   input_avi_file -

      The name and path of the input avi file. This file should
      have each frame present exactly one time.  The input avi
      file can only have a single stream and that stream must be
      a video stream.  It must use an "idx1" index.


   timecode_file_or_fps -

      The name and path of the input v1 or v2 timecode file.  The
      timecode file formats are those defined by mkvtoolnix for use
      with mkvmerge.

      The timecode file can have any framerate corresponding to the
      following equation:

        framerate = out_fps/n  for  n=1 to infinity

      The infinity doesn't apply in real use.  While there is no hard
      maximum value for n, tc2cfr can only allow it to be so big
      before it can no longer tell the difference between neighboring
      values.  For an out_fps of 119.880120 this corresponds to a
      value of n=340.  When tc2cfr starts it will tell you the maximum
      value that n can have for the specified out_fps value (the
      number of descernable framerates).

      It is also possible to specify an input fps value instead of
      using a timecode file.  The fps value can be a floating point
      value or a fraction (num/den), same as out_fps.


   output_avi_file -

      The name and path of the destination (output) avi file that
      will be created.


CHANGE LIST:


   02/08/2006  v1.5

      + Ability to specify an input fps value instead of using a
           timecode file


   26/07/2006  v1.4

      + update copyright


   29/12/2005  v1.3

      + Allow fractional input for out_fps
      + Use a larger io buffer for avi file reading/writing
      - Fixed some typos in output messages


   26/12/2005  v1.2

      + Print elapsed process time
      + Minor optimizations


   25/12/2005  v1.1

      + unlink output file on early exit
      - change everything to double instead of float
      - various code changes and cleanup


   18/12/2005  v1.0

      - initial release



contact:   forum.doom9.org  nick = tritical  or  email:  kes25c@mizzou.edu
