yuvscaler  -  UPscales  or DOWNscales a YUV4MPEG2 stream to a specified


   yuvscaler [-I  input_keyword]  [-M  mode_keyword]  [-O  output_keyword]
   [-n p|s|n] [-v 0-2] [-h]


   yuvscaler is a general (UP or DOWN) scaling utility that is provided to
   allow conversion  between  different  video  formats.  It  reads  in  a
   YUV4MPEG2  format  stream from stdin (such as that produced by lav2yuv)
   and outputs such stream to stdout (e.g. to be  consumed  by  mpeg2enc).
   The most common use of yuvscaler is to generate input suitable for MPEG
   encoding to VCD or SVCD formats using mpeg2enc(1).

   yuvscaler will automatically  take  into  account  PAL/SECAM  and  NTSC
   format,  as  well  as  widescreen (16:9) format and interlacing. Use of
   yuvscaler was designed to be straightforward.


   VCD encoding:
   lav2yuv my-file.avi | yuvscaler -O VCD | mpeg2enc -f 1 -o vcd.%d.m1v

   SVCD encoding:
   lav2yuv my-file.qt | yuvscaler -O SVCD | mpeg2enc -f 4 -o svcd.%d.m2v

   Encoding anamorphic 16:9 as letterboxed VCD:
   lav2yuv my-ana16-9.eli | yuvscaler -M  WIDE2VCD  |  mpeg2enc  -f  1  -o

   Encoding anamorphic 16:9 as letterboxed SVCD:
   lav2yuv  my-ana16-9.eli | yuvscaler -M WIDE2STD -O SVCD | mpeg2enc -f 4
   -o letterbox_svcd.%d.m2v

   Encoding anamorphic 16:9 as letterboxed DVD:
   lav2yuv my-ana16-9.eli | yuvscaler -M WIDE2STD -O DVD | mpeg2enc  -f  8
   -o letterbox_dvd.%d.m2v


   -I input_keyword

          Specifies  input  processing  options.   Input  options  may  be
          combined by using multiple  -I  flags.  Possible  input_keywords

          USE_WidthxHeight+WidthOffset+HeightOffset  to  select  a  useful
          area  of  the  input  frame  (all  multiple  of  2,  Height  and
          HeightOffset multiple of 4 if interlaced), the rest of the image
          being discarded

          ACTIVE_WidthxHeight+WidthOffset+HeightOffset to select an active
          area  of  the  input  frame  (all  multiple  of  2,  Height  and
          HeightOffset multiple of 4 if interlaced), the rest of the image
          being made black

   -M mode_keyword

          Sets  the  scaling  mode  options.   Scaling mode options can be
          combined by giving several -M flags.  Possible  are:

          BICUBIC - to use the (Mitchell-Netravalli) high-quality  bicubic
          upsacling and/or downscaling algorithm

          RESAMPLE  -  to  use  a classical resampling algorithm -only for
          downscaling- that goes much faster than bicubic.  For  coherence
          reason,  yuvscaler  will  use  RESAMPLE  if  only downscaling is
          necessary, BICUBIC if not.

          WIDE2STD - convert widescreen anamorphic (16:9) input video into
          letterboxed  (4:3), generating necessary black lines.  Note that
          for  MPEG  applications  if  your  player  can  properly  decode
          anamorphic  video  you  may wish to leave the video unscaled and
          simply specify the approprate format during MPEG  encoding  (see

          RATIO_WidthIn_WidthOut_HeightIn_HeightOut  to  specified scaling
          ratios of WidthIn/WidthOut for width and HeightIN/HeightOut  for
          height  to be applied to the useful area. The output frames that
          result from scaling can have a different format than the  output
          format  specified  using -O options(s).  In this case, yuvscaler
          automatically generate necessary black lines and columns  and/or
          skips  necessary lines and columns to center the scaled image in
          the output frame.

          WIDE2VCD to  scale  anamorphic  widescreen  (16:9)  frames  into
          letterboxed VCD format (equivalent to -M WIDE2STD -O VCD).

          FASTVCD  to transcode full sized frames to VCD (equivalent to -M
          RATIO_2_1_2_1 -O VCD, see below).

          FAST_WIDE2VCD to transcode full-sized anamorphic  (16:9)  frames
          to  letter-boxed VCD (equivalent to -M WIDE2STD -M RATIO_2_1_2_1
          -O VCD, see below).

          NO_HEADER to suppress stream header generation on output

          MMX to use  MMX  functions  for  BICUBIC  scaling  (experimental

   -O output_keyword

          Sets the output frame format options.  Output format options can
          be combined by giving several  -O  flags.   By  default,  output
          frames  size  will  be the same as input frame sizes, as well as
          output  frames  interlacing  if  coherent  with  output  keyword
          specification which prevails, top_first if not.

          MONOCHROME to generate monochrome frames on output.  Chrominance
          information for the scaled pixels is set neutral (white).   MPEG
          encoding  of  black and white video will be both inefficient and
          show annonying chrominance artifacts unless this is done.

          VCD to generate VCD compliant frames on output (taking  care  of
          PAL and NTSC standards). Non-interlaced output.

          SVCD to generate SVCD compliant frames on output (taking care of
          PAL and NTSC standards). Top-field-first interlaced frames.

          DVD to generate DVD compliant frames on output (taking  care  of
          PAL and NTSC standards). Top-field-first interlaced frames.

          SIZE_WidthxHeight  to  generate  frames  of size WidthxHeight on
          output (multiple of 4)

          If VCD, SVCD or DVD keywords are not used, output interlacing is
          taken  of the same type as input. By default, output frames size
          will be the same as input frame size.

   -n p|s|n
          (usually not necessary) if norm could  not  be  determined  from
          data    flux,   specifies   the   OUTPUT   norm   for   VCD/SVCD

   -v 0|1|2
          Specifies  the   degree   of   verbosity:   0=quiet,   1=normal,

   -h     Prints a summary of command line syntax.

   Note:  The  most  useful downscaling ratios are handled using dedicated
   optimised scaling routines. They are:

          RATIO_WidthIn_WidthOut_2_1   =>   Full-sized   frame   to    VCD

          RATIO_3_2_1_1 => Full-sized frame to SVCD downscaling

          RATIO_1_1_4_3 => WIDE2STD downscaling mode

          RATIO_WidthIn_WidthOut_1_1  =>  downscaling only concerns width,
          not height

          RATIO_1_1_HeightIn_HeightOut  =>   downscaling   only   concerns
          height, not width

          RATIO_2_1_2_1  =>  FASTVCD, slightly width distorted (real ratio
          45 to 22) but faster full-sized frame  to  VCD  downscaling  (-M
          RATIO_2_1_2_1 -O VCD)

          RATIO_WidthIn_WidthOut_8_3  =>  specific to WIDE2VCD downscaling
          (-M WIDE2STD -O VCD)

          RATIO_2_1_8_3 => specific to (slighly  distorted)  FAST_WIDE2VCD
          downscaling (-M WIDE2STD -M RATIO_2_1_2_1 -O VCD)

          RATIO_1_1_1_1  =>  copy  useful  input  part of possible several
          files into output frames


   This man page was written by Xavier Biquard et al.
   If you have questions, remarks, problems or you just  want  to  contact
   the developers, the main mailing list for the MJPEG-tools is:

   For more info, see our website at


   mjpegtools(1), lavpipe(1), lav2yuv(1) mpeg2enc(1)


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.