NAME

       yuvkineco - revert 2-3 pulldown movie

SYNOPSIS

       yuvkineco [options] [-C PATH]
       yuvkineco [options] -O|N PATH

DESCRIPTION

       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 -C PATH 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
           lav2yuv 60i.eli | \
               yuvkineco -F 1 | yuv2lav -f a -I 0 -o 24p.avi
         EXAMPLE #2: for 30p/24p mix / automatically
           lav2yuv 60i.eli | \
               yuvkineco -F 4 | yuv2lav -f a -I 0 -o 30p.avi
         EXAMPLE #3: for 24p movie / check and repair
           lav2yuv 60i.eli | \
               yuvkineco -F 1 -C 60i.23c | \
               yuv2lav -f a -I 1 -o take1.avi
           glav -F +n take1.avi  # check and edit 60i.23c
           lav2yuv take1.avi | \
               yuvkineco -F 1 -N 60i.23c | \
               yuv2lav -f a -I 0 -o take2.avi
         EXAMPLE #4: for 24p movie / check and retry
           lav2yuv 60i.eli | \
               yuvkineco -F 1 -C 60i.23c | \
               yuv2lav -f a -I 0 -o take1.avi
           glav -F +n take1.avi  # check and edit 60i.23c
           lav2yuv 60i.eli | \
               yuvkineco -F 1 -O 60i.23c | \
               yuv2lav -f a -I 0 -o take2.avi

OPTIONS

       yuvkineco accepts the following options:

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

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

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

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

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

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

       -c THRESHOLD
               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.

       -i PERMIL
               yuvkineco 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).

AUTHOR

       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/

SEE ALSO

       mjpegtools(1), yuvycsnoise(1).