y4mtopnm(1)                   MJPEG tools manual                   y4mtopnm(1)

<?><?><?> (NAME)
       y4mtopnm - <?><?><?><?><?> <?><?> <?><?><?><?><?> YUV4MPEG2 <?><?>
       <?><?><?><?><?><?> PNM


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       y4mtopnm [options]


<?><?><?><?><?><?><?> (DESCRIPTION)
       y4mtopnm <?><?> <?><?><?><?><?> YUV4MPEG2 <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> PPM<?> PGM
       <?><?> PAM <?><?><?><?><?> <?><?><?><?><?><?>. (<?><?> <?><?><?>
       <?><?><?><?> <<pnm>> <?><?><?><?> <?><?><?><?><?><?><?><?> PPM<?> PGM
       <?> PBM <?><?><?>. PAM <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?>.)

       <?><?><?><?><?> <?><?> stdout <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       (<?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>).

       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?> <?><?><?><?><?><?><?><?> <?><?><?><?> YUV4MPEG2 <?><?> stdin
       <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?>
       YUV4MPEG2 <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> Y'CbCr
       (<?><?><?><?><?><?><?><?><?> ITU-R BT.601) <?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> 4:4:4 (<?><?><?><?>)<?>
       y4mtopnm <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> R'G'B' <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?> PPM <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?> <<MONO>> (<?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> luma) <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> [0,255]
       <?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       PGM <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> YUV4MPEG2 <?><?><?><?> <?><?><?>
       (<?><?><?><?>!) <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       (subsampled) <?><?><?><?><?><?> <?><?><?> y4mtopnm <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> (<?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <<flatten>><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>). <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       y4mscaler <?><?> 4:4:4 <?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?> y4mtopnm <?><?> <?><?><?><?><?> <<444ALPHA>>
       (<?><?><?><?><?><?> 4:4:4 <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?>) <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <<-P>> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?>. <?><?> <<-P>><?> <?><?><?><?><?><?> PAM <?><?> TUPLTYPE
       <?><?> <?><?><?> RGB_ALPHA <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?> <?><?><?><?> <?><?><?><?><?>. <?><?><?><?> <<-P>><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> PPM <?> PGM <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?>: <?><?> PPM <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?> <?><?> <?><?>
       <?><?> PGM <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>. (<?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       PPM <?> PGM <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> pnmtoy4m <?><?><?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?>.)

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>/<?><?><?><?> <<<?><?><?>
       <?><?><?><?><?><?>>> <?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> pnmsplit
       <?><?><?><?><?><?><?> <?><?><?><?>. (<?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> PNM <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>/<?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.)

       y4mtopnm <?> pnmtoy4m <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> (pipe)
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?>
       (<?><?> <?><?> <?><?><?><?> <<444ALPHA>> <?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?> <?> <?><?><?><?> <<mixed-mode>> <?><?> <?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?>).
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> (lossy) <?><?><?><?> (<?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>/<?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?>). <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> PNM<?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> (interlacing) <?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (sample aspect ratio)
       <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> (<?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> pnmtoy4m <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?>).


<?><?><?><?><?><?><?><?> (OPTIONS)
       y4mtopnm <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?>:


       -P   <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> PAM <?><?>
            <?><?><?> PPM <?>/<?><?> PGM. <?><?><?><?> PAM
            <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
            <?><?> PNM <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
            <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>. (<?><?>
            <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
            NetPBM <?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?>
            <?><?><?> <?><?><?><?><?><?><?>.)

       -D   <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> (field) <?><?>
            <?><?> <?><?><?><?>. (<?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
            <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?>.)

            <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?> (interlaced) <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?> <?><?> <?><?><?><?><?> bottom-field-first<?>
            <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
            <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
            (progressive) <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
            <<<?><?><?><?> <?><?><?><?><?><?>>> (mixed-mode) <?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?>.

            <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <<mixed-mode>> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
            PNM/PAM <?><?> <?><?><?><?><?><?><?> <?><?> pnmtoy4m
            <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.

       -f   <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
            <<<?><?><?><?><?><?><?><?>>> (flattened)<?> <?><?>
            <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>/<?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> PGM
            (<?><?> PAM <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>) <?><?>
            <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?>:
                           +-----+                    +-----+
                   4:4:4   |  Y  |    4:4:4 w/alpha   |  Y  |
                           +-----+                    +-----+
                           |  Cb |                    |  Cb |
                           +-----+                    +-----+
                           |  Cr |                    |  Cr |
                           +-----+                    +-----+
                                                      |  A  |
                           +-----+                    +-----+
                   4:2:2,  |  Y  |
                   4:2:0   +--+--+                    +-----+--+--+
                           |Cb|Cr|            4:1:1   |  Y  |Cb|Cr|
                           +--+--+                    +-----+--+--+
                                        +-----+
                                 MONO   |  Y  |
                                        +-----+
            <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?><?> YUV4MPEG2 <?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?> <?><?><?> <?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> (upsampling)
            <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?>.  <?><?><?> <?><?><?><?> <?><?> <?><?><?>
            <?><?><?><?><?> <?><?><?><?><?><?><?><?>/<?><?><?><?><?><?><?>
            <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> PGM
            <?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
            <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?>.

       -v [0,1,2]
            <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> (verbosity).
             0 = <?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?>.
             1 = <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?>.
             2 = <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> AVI (<?><?> <?><?><?> MJPEG <?><?> DV) <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> PPM:

            lav2yuv -f 15 your-video.avi | y4mscaler -O chromass=444 |
            y4mtopnm | pnmsplit - "your-video-%d.ppm"


<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> Matt Marjanovic
       <?><?><?><?><?> <?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       MJPEG-tools <?><?><?><?><?> <?><?><?> <?><?>:
         mjpeg-users@lists.sourceforge.net


       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>:
              http://mjpeg.sourceforge.net


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       pam(5), pgm(5), pnm(5), ppm(5), pnmtoy4m(1), mjpegtools(1),
       mpeg2enc(1), lav2yuv(1), pnmsplit(1), y4mscaler(1)

MJPEG Tools Team                 28 April 2004                     y4mtopnm(1)