summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man1/ppmshift.1
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--upstream/opensuse-leap-15-6/man1/ppmshift.188
1 files changed, 88 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/ppmshift.1 b/upstream/opensuse-leap-15-6/man1/ppmshift.1
new file mode 100644
index 00000000..708b74d2
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man1/ppmshift.1
@@ -0,0 +1,88 @@
+\
+.\" 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" 0 "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 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
+ pnmcat -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" (5)\c
+\&,
+.BR "pamcut" (1)\c
+\&,
+.BR "pamflip" (1)\c
+\&,
+.BR "ppmdim" (1)\c
+\&,
+.BR "pnmcat" (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