Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 104 insertions, 0 deletions

diff --git a/upstream/fedora-rawhide/man1/ppmtoyuv.1 b/upstream/fedora-rawhide/man1/ppmtoyuv.1
new file mode 100644
index 00000000..fa6297de
--- /dev/null
+++ b/upstream/fedora-rawhide/man1/ppmtoyuv.1
@@ -0,0 +1,104 @@
+\
+.\" 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
\ No newline at end of file