yuvkineco - revert 2-3 pulldown movie

yuvkineco was written by Kawamata/Hitoshi.
       If you have questions, remarks, problems or you just want to contact the  developers,  the  main  mailing
       list for the MJPEG-tools is:
         mjpeg-users@lists.sourceforge.net

       For more info, see our website at
              http://mjpeg.sourceforge.net/

yuvkineco  reverts  to  original  non-interlaced  frames,  from NTSC video which was film sourced and 2-3
       pulled down.  Input fps code must be 4(29.97fps), output fps code can be  selected  from  1(23.97fps)  to
       4(29.97fps). If 2, 3 or 4 selected, duplicated frames remain but they are reverted to non-interlaced.  If
       input was non-interlaced only remove duplicate frames.  Interlaced frame detection may fail in conditions
       like:
           Pull down cycle changed (video editing).
           Low quality pull down.
           Motionless scene.
       If -CPATH was specified, yuvkineco outputs 2-3 pull down cycle list to the file.  You can edit this file
       by  hand  and  feed it to yuvkineco with -O or -N option to correct mistake of 1st yuvkineco.  Try -C and
       see cycle list.
         EXAMPLE #1: for 24p movie / automatically
           lav2yuv60i.eli|\yuvkineco-F1|yuv2lav-fa-I0-o24p.avi
         EXAMPLE #2: for 30p/24p mix / automatically
           lav2yuv60i.eli|\yuvkineco-F4|yuv2lav-fa-I0-o30p.avi
         EXAMPLE #3: for 24p movie / check and repair
           lav2yuv60i.eli|\yuvkineco-F1-C60i.23c|\yuv2lav-fa-I1-otake1.aviglav-F+ntake1.avi  # check and edit 60i.23c
           lav2yuvtake1.avi|\yuvkineco-F1-N60i.23c|\yuv2lav-fa-I0-otake2.avi
         EXAMPLE #4: for 24p movie / check and retry
           lav2yuv60i.eli|\yuvkineco-F1-C60i.23c|\yuv2lav-fa-I0-otake1.aviglav-F+ntake1.avi  # check and edit 60i.23c
           lav2yuv60i.eli|\yuvkineco-F1-O60i.23c|\yuv2lav-fa-I0-otake2.avi

       yuvkineco - revert 2-3 pulldown movie

yuvkineco accepts the following options:

       -FFPSCODE
               Set output fps code (default: same as input).

       -CPATH Specify 2-3 pull down cycle list file name to write.

       -OPATH Specify cycle list name to read with old yuv stream to retry.

       -NPATH Specify cycle list name to read with new yuv stream to repair.

       -SMIN  Use yuvycsnoise(1) as preprocessor and specify minimum threshold.

       -nLEVEL
               Specify noise level of input (default: 10).  This  affects  both  pulldown  cycle  detection  and
               deinterlacing.

       -cTHRESHOLD
               Specify  threshold  to  decide  pictures  in  2 frames are same (default: 4).  yuvkineco compares
               several frames, searches pair of frame they contain same pictures, to decide which  frame  should
               be  dropped.   If  THRESHOLD  is  0, pair which has smallest difference will be selected.  If 16,
               selected from pairs those have differences smaller than average.

       -iPERMILyuvkineco deinterlaces each frame after 2-3 pulldown reverting process, specify how  much  pixels
               deinterlaced to decide to use or not use deinterlacing result (default: 10).  If PERMIL is 10 and
               1% or more of pixels deinterlaced, deinterlacing result will be used.  If 0, always deinterlacing
               result  will  be used.  If 1000, deinterlacing result will not be used, but deinterlacing process
               will run on all of frames.  To disable deinterlacing process, specify negative value.

       -u      Set interlace information in header of output to unknown (default: non-interlaced).

mjpegtools(1), yuvycsnoise(1).

MJPEG Tools Team                                 5 February 2002                                    yuvkineco(1)

yuvkineco [options] [-CPATH]
       yuvkineco [options] -O|NPATH