1 files changed, 100 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/ppmshift.1 b/upstream/debian-unstable/man1/ppmshift.1
new file mode 100644
index 00000000..7c4274e9
--- /dev/null
+++ b/upstream/debian-unstable/man1/ppmshift.1
@@ -0,0 +1,100 @@
+\
+.\" 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 "Ppmshift User Manual" 1 "20 November 2008" "netpbm documentation"
+
+.SH NAME
+
+ppmshift - shift lines of a PPM image left or right by a random amount
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBppmshift\fP
+\fIshift\fP
+[\fIppmfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBppmshift\fP reads a PPM image as input.  It shifts every row of image
+data to the left or right by a random amount, within a range of \fIshift\fP
+pixels.  The random distribution is uniform, centered at zero movement.
+.PP
+The randomness in the image is limited before Netpbm 10.37 (December
+2006) -- if you run the program twice in the same second, you may get
+identical output.
+.PP
+This is an effect the author intended to use for MPEG tests.
+Unfortunately, this program is not useful for that - it creates too random
+patterns to be used for animations.  Still, it might give interesting results
+on still images.
+
+.UN options
+.SH OPTIONS
+.PP
+There are no command line options defined specifically
+for \fBppmshift\fP, but it recognizes the options common to all
+programs based on libnetpbm (See 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&.)
+
+.UN example
+.SH EXAMPLE
+.PP
+Check this out: Save your favorite model's picture from something like
+alt.binaries.pictures.supermodels (ok, or from any other picture source),
+convert it to ppm, and process it e.g. like this, assuming the picture is 
+800x600 pixels:
+
+.nf
+     #take the upper half, and leave it like it is
+     pamcut -top=0 -width=800 -height=300 cs.ppm >upper.ppm
+     
+     #take the lower half, flip it upside down, dim it and distort it a little
+     pamcut -top=300 -width=800 -height=300 cs.ppm | \e
+         pamflip -topbottom | \e
+         ppmdim 0.7 | \e
+         ppmshift 10 >lower.ppm
+     
+     #and concatenate the two pieces
+     pamcat -topbottom upper.ppm lower.ppm >newpic.ppm
+
+
+.fi
+.PP
+The resulting picture looks like the image being reflected on a water 
+surface with slight ripples.
+
+.UN seealso
+.SH SEE ALSO
+.BR "ppm" (1)\c
+\&,
+.BR "pamcut" (1)\c
+\&,
+.BR "pamflip" (1)\c
+\&,
+.BR "ppmdim" (1)\c
+\&,
+.BR "pamcat" (1)\c
+\&
+
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1993 by Frank Neumann
+.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/ppmshift.html
+.PP
+\ No newline at end of file