
                                     TIVTC Common Usage Examples

                                  (Last Updated:  27 November 2004)


      This file lists some example scripts for dealing with common cases for which you would use
   TIVTC.  It assumes, however, that you have at least skimmed over the README's and know the
   different parameters.  It also assumes you know what "hybrid" and "vfr" mean, what an mkv
   timecodes file is and how to use it if you are looking into hybrid processing.  All examples
   assume we are using an mpeg2source()... and use TFM's d2v parameter to obtain the field order
   and scan for illegal transitions in the d2v file.  If you are not using a d2v source then adjust
   the examples as necessary to meet your requirments.


NTSC cases:


   1.) NTSC Film, normal source (not anime or cartoon).  One pass.

          mpeg2source("c:\oursource.d2v")
          tfm(d2v="c:\oursource.d2v")
          tdecimate()


   2.) NTSC Film, anime or cartoon source.  One pass.

          mpeg2source("c:\oursource.d2v")
          tfm(d2v="c:\oursource.d2v")
          tdecimate(mode=1)


   3.) NTSC Hybrid, using blend decimation on video sections (not anime or cartoon).  One pass.

          mpeg2source("c:\oursource.d2v")
          tfm(d2v="c:\oursource.d2v")
          tdecimate(hybrid=1)


   4.) NTSC Hybrid, using blend decimation on video sectons, anime or cartoon source.  One pass.

          mpeg2source("c:\oursource.d2v")
          tfm(d2v="c:\oursource.d2v")
          tdecimate(mode=1,hybrid=1)


   5.) NTSC Hybrid, using vfr via mkv (not anime or cartoon).  One pass.

          mpeg2source("c:\oursource.d2v")
          tfm(d2v="c:\oursource.d2v")
          tdecimate(mode=3,hybrid=2,vfrDec=0,mkvOut="mkv-timecodesfile.txt")


   6.) NTSC Hybrid, using vfr via mkv, anime or cartoon source.  One pass.

          mpeg2source("c:\oursource.d2v")
          tfm(d2v="c:\oursource.d2v")
          tdecimate(mode=3,hybrid=2,vfrDec=1,mkvOut="mkv-timecodesfile.txt")


   7.) NTSC, two pass (enables use of conCycleTP parameter) mkv vfr for hybrid source.

         First pass:

             mpeg2source("c:\oursource.d2v")
             tfm(d2v="c:\oursource.d2v",output="matches.txt")
             tdecimate(mode=4,output="metrics.txt")

         Second pass (not anime or cartoon):

             mpeg2source("c:\oursource.d2v")
             tfm(d2v="c:\oursource.d2v",input="matches.txt")
             tdecimate(mode=5,hybrid=2,vfrDec=0,input="metrics.txt",tfmIn="matches.txt",mkvOut="mkv-timecodesfile.txt")

         Second pass (anime or cartoon):

             mpeg2source("c:\oursource.d2v")
             tfm(d2v="c:\oursource.d2v",input="matches.txt")
             tdecimate(mode=5,hybrid=2,vfrDec=1,input="metrics.txt",tfmIn="matches.txt",mkvOut="mkv-timecodesfile.txt")



PAL Cases:


   1.) PAL, no decimation (just field matching)
          
          mpeg2source("c:\oursource.d2v")
          tfm(d2v="c:\oursource.d2v")


   2.) PAL, decimate 1 in 25 (most similar)

          mpeg2source("c:\oursource.d2v")
          tfm(d2v="c:\oursource.d2v")
          tdecimate(cycle=25)



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