\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Ppmtoyuv User Manual" 0 "06 June 2005" "netpbm documentation"

.SH NAME
ppmtoyuv - convert a PPM image to an Abekas YUV file

.UN synopsis
.SH SYNOPSIS

\fBppmtoyuv\fP
[\fIppmfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBppmtoyuv\fP reads a PPM image as input and produces an Abekas
YUV file as output.
.PP
The output file contains a raster of four byte YUV codes, each
uniquely associated with two side-by-side pixels in the image.  The raster
contains rows in order from top to bottom, and within each row columns
from left to right.  So the output file size in bytes is twice the number of
pixels in the image.
.PP
Each YUV code is associated with two pixels from the input image that we
will call the left pixel and the right pixel.  The 2nd byte of the code is
the Y value of the left pixel.  The 4th byte of the code is the Y value of
the right pixel.  The 1st byte of the code is an average of the U value of
the pixel \fIto the left of the left pixel\fP, the left pixel, and the
right pixel.  The 3rd byte of the code is analogous for V values.  These
averages are weighted arithmetic means where the left pixel is weighted
double what the other two pixels are weighted.
.PP
This format is reminiscent of but rather different from the common
YUV 4:2:0 format (aka YUV 420) and the similar YUV 4:4:4, YUV 4:2:2,
YUV 4:1:1, YUV 4:1:1s, and YUV 4:1:0.  In YUV 4:2:0, the raster is
different for even numbered lines and odd numbered lines.  On even
numbered lines, there are twice as many bits for Y of each pixel as
for U or V.  On odd numbered lines, there are the same number of bits
for Y as on even numbered lines, but no bits at all for U and V.
.PP
Another YUV-based format is YUV4MPEG2, which is a movie format
normally used with 
.UR http://mjpeg.sourceforge.net
\fBMJPEGTools\fP
.UE
\&.  Netpbm
does not have converters for this format, but \fBMJPEGTools\fP does.

.UN options
.SH OPTIONS
.PP
There are no command line options defined specifically
for \fBppmtoyuv\fP, but it recognizes the options common to all
programs based on libnetpbm (See 
.UR index.html#commonoptions
 Common Options
.UE
\&.)

.UN seealso
.SH SEE ALSO
.BR "yuvtoppm" (1)\c
\&,
.BR "ppmtoeyuv" (1)\c
\&,
.BR "ppmtoyuvsplit" (1)\c
\&,
.BR "ppm" (1)\c
\&,
.UR http://mjpeg.sourceforge.net
pnmtoy4m
.UE
\&,
.UR http://mjpeg.sourceforge.net
y4mtopnm
.UE
\&


.UN author
.SH AUTHOR
.PP
Marc Boucher \fImarc@PostImage.COM\fP, based on
Example Conversion Program, A60/A64 Digital Video Interface Manual,
page 69.
.PP
Copyright (C) 1991 by DHD PostImage Inc.
.PP
Copyright (C) 1987 by Abekas Video Systems Inc.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/ppmtoyuv.html
.PP