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).