yuvkineco(1)

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 their are also
reverted to non-interlaced. If input was non-interlaced,
only do remove duplicated frames. Interlaced frame detec
tion 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 deinter
lacing.

-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 differ ence will be selected. If 16, selected from pairs
those have differences smaller than average.

-i PERMIL

yuvkineco deinterlaces each frame after 2-3 pull down reverting process, specify how much pixels
deinterlaced to decide to use or not use deinter
lacing 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 deinterlac
ing 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).

MJPEG Linux Square 5 February 2002 yuvkineco(1)