From fc22b3d6507c6745911b9dfcc68f1e665ae13dbc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:43:11 +0200 Subject: Adding upstream version 4.22.0. Signed-off-by: Daniel Baumann --- upstream/debian-bookworm/man1/ppmshift.1 | 100 +++++++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 upstream/debian-bookworm/man1/ppmshift.1 (limited to 'upstream/debian-bookworm/man1/ppmshift.1') diff --git a/upstream/debian-bookworm/man1/ppmshift.1 b/upstream/debian-bookworm/man1/ppmshift.1 new file mode 100644 index 00000000..d6172735 --- /dev/null +++ b/upstream/debian-bookworm/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 + 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" (1)\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 -- cgit v1.2.3