y4mscaler(1) y4mtools manual y4mscaler(1) (NAME) y4mscaler - YUV4MPEG2 (SYNOPSIS) y4mscaler [] < Y4Mstream > Y4Mstream (DESCRIPTION) y4mscaler (scaler) YUV4MPEG2 MJPEGtools lav2yuv mpeg2enc(1) . y4mscaler (pipeline) . stdin stdout . y4mscaler <<>> ( source) ( target) . . (matte) . y4mscaler (chroma subsampling) . YUV4MPEG2 4:2:0 4:1:1 4:2:2 4:4:4 4:4:4 (luma-only) . ( <> .) y4mscaler (interlacing) : (top-field-first) (bottom-field-first) ( ) (progressive) ( ). y4mscaler (heuristics) . . . y4mscaler (presets) : DVD VideoCD (VCD) SuperVCD (SVCD) DV. (EXAMPLES) SVCD: y4mscaler -O preset=svcd VideoCD ( ) DV ( ) : y4mscaler -I ilace=bottom-only -I active=-4+0cc -O preset=vcd NTSC DV (widescreen) (letterboxed) : y4mscaler -O sar=ntsc -O bg=RGB:0,0,255 NTSC DV <<>> (fullscreen) ( ): y4mscaler -O sar=ntsc -O infer=clip NTSC (16:9) DVD : y4mscaler -O preset=dvd -O sar=ntsc_wide -O infer=clip x NTSC DV SuperVCD: y4mscaler -I active=140x140+0+0cc -I matte=100x100+0+0cc -I bg=RGB:0,0,255 -O preset=svcd -v -V -h . -v [0,1,2] (verbosity). 0 = . 1 = (). 2 = . -V . -h ( ). -I -O -S parameter=value . . . "parameter=[AAA|BBB|CCC]" AAA BBB CCC . . -I input_parameter /. '-I' . '-I' '-O' . active=WxH+X+Yaa . . ( "WxH" .) W H . X Y (anchor point) . "aa" (: TL) " (NOTES ON REGION GEOMETRY)" . : active=200x180+30+24cc matte=WxH+X+Y (matte) . . . ( "WxH" .) W H . X Y . "aa" (: TL) " (NOTES ON REGION GEOMETRY)" . : matte=200x180+30+24cc bg=RGB:r,g,b bg=YCBCR:y,cb,cr bg=RGBA:r,g,b,a bg=YCBCRA:y,cb,cr,a . . R'G'B' Y'CbCr . "bg=YCBCR:16,128,128" "bg=RGB:0,0,0" . 'A' () . RGBA [0,255] YCBCRA [16,235] . (255 RGBA 235 YCBCRA). norm=[NTSC|PAL|SECAM] (norm) . . ilace=[NONE|TOP_FIRST|BOTTOM_FIRST|TOP_ONLY|BOTTOM_ONLY] (interlacing) . NONE TOP_FIRST BOTTOM_FIRST . . TOP_ONLY BOTTOM_ONLY . (progressive) . ( VCD .) ( " " YUV4MPEG2). chromass=[420JPEG|420MPEG2|420PALDV|444|422|411|mono|444alpha] (chroma subsampling) . . 4:2:0 . . sar=N:D sar=[NTSC|PAL|NTSC_WIDE|PAL_WIDE] (sample-aspect-ratio) . ( "10:11") CCIR-601 4:3 16:9 . . -O output_parameter /. '-O' . '-O' '-I' . size=WxH size=SRC / W H . SRC . active=WxH+X+Yaa . . ( "WxH" .) W H . X Y . "aa" (: TL) " (NOTES ON REGION GEOMETRY)" . : active=200x180+30+24cc bg=RGB:r,g,b bg=YCBCR:y,cb,cr bg=RGBA:r,g,b,a bg=YCBCRA:y,cb,cr,a . . R'G'B' Y'CbCr . "bg=YCBCR:16,128,128" "bg=RGB:0,0,0" . 'A' () . RGBA [0,255] YCBCRA [16,235] . (255 RGBA 235 YCBCRA). ilace=[NONE|TOP_FIRST|BOTTOM_FIRST] . NONE TOP_FIRST BOTTOM_FIRST . . ( bottom-first top-first ) y4mscaler . chromass=[420JPEG|420MPEG2|420PALDV|444|422|411|mono|444alpha] . . " (NOTES ON CHROMA MODES AND SUBSAMPLING)" . sar=N:D sar=[SRC|NTSC|PAL|NTSC_WIDE|PAL_WIDE] (sample-aspect-ratio) . ( "10:11") CCIR-601 4:3 16:9 . SRC SAR . scale=N/D Xscale=N/D Yscale=N/D scale=1/2. "scale=" X Y . "Xscale=" "Yscale=" . infer=[PAD|CLIP|PRESERVE_X|PRESERVE_Y] SAR . . PAD . infer=[SIMPLIFY|EXACT] . . SIMPLIFY . align=[TL|TC|TR|CL|CC|CR|BL|BC|BR] . <<->> <<->> <<->> . (cropping) (padding) . CC <> . . CC . <> . preset=[VCD|CVD|SVCD|DVD|DVD_WIDE|DV|DV_WIDE| SVCD_STILL_HI|SVCD_STILL_LO|VCD_STILL_HI|VCD_STILL_LO| ATSC_720P|ATSC_1080I|ATSC_1080P] . <<-O>> (override) . . <> . VCD - VideoCD (progressive) CVD - ChinaVideoDisc () SVCD - SuperVCD DVD - DVD DVD_WIDE - DVD DV - DV ( ::) DV_WIDE - DV SVCD_STILL_HI - SVCD SVCD_STILL_LO - SVCD VCD_STILL_HI - VCD VCD_STILL_LO - SVCD ATSC_720P - ATSC 720p ( HDTV) ATSC_1080I - ATSC 1080i ( HDTV) ATSC_1080P - ATSC 1080p ( HDTV) -S scaling_parameter . <<-S>> (override) . mode=MONO . . . mode=LINESWITCH . . . (interlaced) . scaler=scaler-name . : 'default' - Matto () option=scaler-option . <> . scaler-option : box - (box filter) linear - (linear interpolation) quadratic - (quadratic interpolation) cubic - Mitchell-Netravali cubicCR - Catmull-Rom cubicB - B-spline cubicK4 - Keys sinc:N - sinc Lanczos N x y option=box,quadratic. sinc:N ( aliasing) . N . cubic (smoothing) (aliasing) . box ( aliasing) . cubicK4 cubic . ( sinc:4 [ringing artifacts] .) <> . NTSC {} PAL . (interlace) . Preset Frame Size Interlace SAR Subsampling ----------------------------------------------------------------------- VCD 352x240{288} none 10:11{59:54} 4:2:0-JPEG CVD 352x480{576} --- 20:11{59:27} 4:2:0-MPEG2 SVCD 480x480{576} --- 15:11{59:36} 4:2:0-MPEG2 DVD 720x480{576} --- 10:11{59:54} 4:2:0-MPEG2 DVD_WIDE 720x480{576} --- 40:33{118:81} 4:2:0-MPEG2 DV 720x480{576} bottom-first 10:11{59:54} 4:1:1 DV_WIDE 720x480{576} bottom-first 40:33{118:81} 4:1:1 SVCD_STILL_HI 704x480{576} none 10:11{59:54} 4:2:0-MPEG2 SVCD_STILL_LO 480x480{576} none 15:11{59:36} 4:2:0-MPEG2 VCD_STILL_HI 704x480{576} none 10:11{59:54} 4:2:0-JPEG VCD_STILL_LO 352x240{288} none 10:11{59:54} 4:2:0-JPEG ATSC_720p 1280x720 none 1:1 4:2:0-MPEG2 ATSC_1080i 1920x1080 (required) 1:1 4:2:0-MPEG2 ATSC_1080p 1920x1080 none 1:1 4:2:0-MPEG2 (NOTES ON REGION GEOMETRY) (active) (matte) <> . <> (Width) (Height) ( <> ). <<+X+Y>> <> . <> TL TC TR CL CC CR BL BC BR . <> (-) <> (-) ... <> (-) <> (-) . . <<+X+Y>> . <<+20+30TL>> - - () . . <<-4+0CC>> ( ) . TL - . (NOTES ON SOURCE AND TARGET ALIGNMENT) . . (clip) . (padding) <> . <> . <> - - . : ---------------- source |abcdefghijklmn| ---|opqrstuvwxyz01|--- target ---------------- | |234567890ABCDE| | |234567890ABCDE| | |FGHIJKLMNOPQRS| | |FGHIJKLMNOPQRS| | |TUVWXYZabcdefg| | |TUVWXYZabcdefg| ---------------------- ---------------- Before Mutually Clipped <> : ---------------------- ---------------- | |abcdefghijklmn| |abcdefghijklmn| | |opqrstuvwxyz01| |opqrstuvwxyz01| | |234567890ABCDE| |234567890ABCDE| ------|FGHIJKLMNOPQRS| ---------------- target |TUVWXYZabcdefg| source ---------------- Before Mutually Clipped <> ..SH " (NOTES ON SCALE FACTOR INFERENCE)" X Y y4mscaler (SAR) . ( SAR) . "infer=" PAD CLIP PRESERVE_X PRESERVE_Y . ( PAD .) PAD . CLIP . PRESERVE_X . PRESERVE_Y . : SIMPLIFY EXACT. ( SIMPLIFY .) EXACT . SIMPLIFY ( ) . ( 2/1 45/22.) (NOTES ON CHROMA MODES AND SUBSAMPLING) y4mscaler . 1/1 . y4mscaler . ("preset=XXX") . . / "chromass=" . y4mscaler 4:4:4 4:2:2 4:1:1 4:2:0 ( ) . YUV4MPEG2 MJPEGtools . smil2yuv raw2yuv 4:1:1 NTSC DV y4mscaler 4:2:0 . ( 444ALPHA) . ( "-O bg=" ) . . ( MONO ) . (NOTES ON ANOMALOUS INTERLACE MIXTURES) YUV4MPEG2 << >> . ( 4:2:0) . ( ) ( ) . . y4mscaler ( 4:4:4 4:2:2 ) . y4mscaler . y4mscaler . 0 . 1 . (AUTHORS) () Matthew Marjanovic . . : MJPEGtools : (SEE ALSO) mjpegtools(1), yuv2lav(1), mpeg2enc(1), ppmtoy4m(1), raw2yuv(1), smil2yuv(1), yuvplay(1), yuvscaler(1) y4mtools February 14, 2003 y4mscaler(1)