Debian Codegraph @

upstream/debian-unstable/man1/ppmshift.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ppmshift User Manual" 1 "20 November 2008" "netpbm documentation"
7
8 .SH NAME
9
10 ppmshift - shift lines of a PPM image left or right by a random amount
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBppmshift\fP
16 \fIshift\fP
17 [\fIppmfile\fP]
18
19 .UN description
20 .SH DESCRIPTION
21 .PP
22 This program is part of
23 .BR "Netpbm" (1)\c
24 \&.
25 .PP
26 \fBppmshift\fP reads a PPM image as input. It shifts every row of image
27 data to the left or right by a random amount, within a range of \fIshift\fP
28 pixels. The random distribution is uniform, centered at zero movement.
29 .PP
30 The randomness in the image is limited before Netpbm 10.37 (December
31 2006) -- if you run the program twice in the same second, you may get
32 identical output.
33 .PP
34 This is an effect the author intended to use for MPEG tests.
35 Unfortunately, this program is not useful for that - it creates too random
36 patterns to be used for animations. Still, it might give interesting results
37 on still images.
38
39 .UN options
40 .SH OPTIONS
41 .PP
42 There are no command line options defined specifically
43 for \fBppmshift\fP, but it recognizes the options common to all
44 programs based on libnetpbm (See
45 .UR index.html#commonoptions
46 Common Options
47 .UE
48 \&.)
49
50 .UN example
51 .SH EXAMPLE
52 .PP
53 Check this out: Save your favorite model's picture from something like
54 alt.binaries.pictures.supermodels (ok, or from any other picture source),
55 convert it to ppm, and process it e.g. like this, assuming the picture is
56 800x600 pixels:
57
58 .nf
59 #take the upper half, and leave it like it is
60 pamcut -top=0 -width=800 -height=300 cs.ppm >upper.ppm
61
62 #take the lower half, flip it upside down, dim it and distort it a little
63 pamcut -top=300 -width=800 -height=300 cs.ppm | \e
64 pamflip -topbottom | \e
65 ppmdim 0.7 | \e
66 ppmshift 10 >lower.ppm
67
68 #and concatenate the two pieces
69 pamcat -topbottom upper.ppm lower.ppm >newpic.ppm
70
71
72 .fi
73 .PP
74 The resulting picture looks like the image being reflected on a water
75 surface with slight ripples.
76
77 .UN seealso
78 .SH SEE ALSO
79 .BR "ppm" (1)\c
80 \&,
81 .BR "pamcut" (1)\c
82 \&,
83 .BR "pamflip" (1)\c
84 \&,
85 .BR "ppmdim" (1)\c
86 \&,
87 .BR "pamcat" (1)\c
88 \&
89
90
91 .UN author
92 .SH AUTHOR
93
94 Copyright (C) 1993 by Frank Neumann
95 .SH DOCUMENT SOURCE
96 This manual page was generated by the Netpbm tool 'makeman' from HTML
97 source. The master documentation is at
98 .IP
99 .B http://netpbm.sourceforge.net/doc/ppmshift.html
100 .PP