1Ppmrough User Manual(0) Ppmrough User Manual(0)
2
3
4
6 ppmrough - create PPM image of two colors with a ragged border between
7 them
8
9
11 ppmrough
12
13 [-left pixels]
14
15 [-right pixels]
16
17 [-top pixels]
18
19 [-bottom pixels]
20
21 [-width pixels]
22
23 [-height pixels]
24
25 [-bg colorspec]
26
27 [-fg colorspec]
28
29 [-var pixels]
30
31 [-randomseed seed]
32
33 [-verbose]
34
35 All options can be abbreviated to their shortest unique prefix. You
36 may use two hyphens instead of one. You may separate an option name
37 and its value with white space instead of an equals sign.
38
39
41 This program is part of Netpbm(1).
42
43 ppmrough generates a PPM image of the specified width, height, and col‐
44 ors. ppmrough tiles the image into semi-rectangular regions with a
45 ragged borders between them. It calculates the fluctuations with the
46 rand() standard C library function.
47
48 ppmrough writes the PPM image to Standard Output.
49
50 The maxval of the output image is 255 (You can change this with
51 pamdepth).
52
53 Use the options -left or -right, respectively, to make vertical bor‐
54 ders, and -top or -bottom, respectively, to generate horizontal borders
55 inside the image. Each of these options needs an integer value pixels
56 that determines the average distance of the interior border to the re‐
57 lated edge of the image. You may combine the -left, -right, -top, and
58 -bottom options to generate an image with more than one border. The
59 algorithm ensures that you can concatenate two images produced with the
60 same (i.e. -left) value without dislocations.
61
62 You specify the dimensions of the generated image with the -width and
63 -height options.
64
65 Use the -bg and -fg options to set the background (margin) color and
66 the foreground (interior) color, respectively. If you don't specify
67 any of the -left, -right, -top, and -bottom options, all pixels are set
68 to foreground color. The defaults are white foreground and black back‐
69 ground.
70
71 Use the -var option to control the "raggedness" of the border. The
72 less its value is the smoother the border is. You can initialize the
73 pseudo-random generator with the -init option.
74
75 You could use ppmrough with ppmtopgm to create a PGM transparency mask
76 and use it to roughen up the edges of another image.
77
78
80 In addition to the options common to all programs based on libnetpbm
81 (most notably -quiet, see
82 Common Options ⟨index.html#commonoptions⟩ ), ppmrough recognizes the
83 following command line options:
84
85
86
87 -left=pixels
88 Specifies the mean distance of the border from the left margin
89 (default: no border).
90
91
92 -right=pixels
93 Specifies the mean distance of the border from the right margin
94 (default: no border).
95
96
97 -top=pixels
98 Specifies the mean distance of the border from the top margin
99 (default: no border).
100
101
102 -bottom=pixels
103 Specifies the mean distance of the border from the bottom margin
104 (default: no border).
105
106
107 -width=pixels
108 Specifies the width of the image (default: 100).
109
110
111 -height=pixels
112 Specifies the height of the image (default: 100).
113
114
115 -bg=colorspec
116 Background color. colorspec is as described for the argument of
117 the pnm_parsecolor() library routine
118 ⟨libnetpbm_image.html#colorname⟩ . Default is black.
119
120
121 -fg=color
122 Foreground color. colorspec is as described for the argument of
123 the pnm_parsecolor() library routine
124 ⟨libnetpbm_image.html#colorname⟩ . Default is white.
125
126
127 -var=pixels
128 Specifies the variance of the ragged border (default: 10). Must
129 be a positive integer. Set pixels to 1 to get a straight bor‐
130 der.
131
132
133 -randomseed=seed
134 Use this option to initialize the pseudo-random number generator
135 with seed.
136
137 You can use this to cause the program to produce repeatable out‐
138 put.
139
140 Before Netpbm 10.61 (December 2012), this is called -init, and
141 that still works.
142
143
144 -verbose
145 Run ppmrough in verbose mode. It reports all parameters on
146 Standard Error.
147
148
149
150
152 ppmmake(1), pnmcat(1), ppmtopgm(1), ppm(1),
153
154
156 This program was added to Netpbm in Release 10.9 (September 2002).
157
158
160 Copyright (C) 2002 by Eckard Specht.
161
163 This manual page was generated by the Netpbm tool 'makeman' from HTML
164 source. The master documentation is at
165
166 http://netpbm.sourceforge.net/doc/ppmrough.html
167
168netpbm documentation 13 March 2021 Ppmrough User Manual(0)