1Ppmrough User Manual(0) Ppmrough User Manual(0)
2
6 ppmrough - create PPM image of two colors with a ragged border between
7 them
8
10 ppmrough
11 [-left pixels]
13 [-right pixels]
15 [-top pixels]
17 [-bottom pixels]
19 [-width pixels]
21 [-height pixels]
23 [-bg rgb:##/##/##]
25 [-fg rgb:##/##/##]
27 [-var pixels]
29 [-init seed]
31 [-verbose]
33 All options can be abbreviated to their shortest unique prefix. You
35 may use two hyphens instead of one. You may separate an option name
36 and its value with white space instead of an equals sign.
37
39 This program is part of Netpbm(1).
40 ppmrough generates a PPM image of the specified width, height, and col‐
42 ors. ppmrough tiles the image into semi-rectangular regions with a
43 ragged borders between them. It calculates the fluctuations with the
44 rand() standard C library function.
45 ppmrough writes the PPM image to Standard Output.
47 The maxval of the output image is 255 (You can change this with
49 pamdepth).
50 Use the options -left or -right, respectively, to make vertical bor‐
52 ders, and -top or -bottom, respectively, to generate horizontal borders
53 inside the image. Each of these options needs an integer value pixels
54 that determines the average distance of the interior border to the
55 related edge of the image. You may combine the -left, -right, -top,
56 and -bottom options to generate an image with more than one border.
57 The algorithm ensures that you can concatenate two images produced with
58 the same (i.e. -left) value without dislocations.
59 You specify the dimensions of the generated image with the -width and
61 -height options.
62 Use the -bg and -fg options to set the background (margin) color and
64 the foreground (interior) color, respectively. If you don't specify
65 any of the -left, -right, -top, and -bottom options, all pixels are set
66 to foreground color. The defaults are white foreground and black back‐
67 ground.
68 Use the -var option to control the 'raggedness' of the border. The
70 less its value is the smoother the border is. You can initialize the
71 pseudo-random generator with the -init option.
72 You could use ppmrough with ppmtopgm to create a PGM alpha mask and use
74 it to roughen up the edges of another image.
75
78 -left pixels
79 Specifies the mean distance of the border from the left margin
80 (default: no border).
81 -right pixels
84 Specifies the mean distance of the border from the right margin
85 (default: no border).
86 -top pixels
89 Specifies the mean distance of the border from the top margin
90 (default: no border).
91 -bottom pixels
94 Specifies the mean distance of the border from the bottom margin
95 (default: no border).
96 -width pixels
99 Specifies the width of the image (default: 100).
100 -height pixels
103 Specifies the height of the image (default: 100).
104 -bg color
107 Background color. Specify this the same way you specify a color
108 with
109 ppmmake. Default is black.
110 -fg color
113 Foreground color. Specify this the same way you specify a color
114 with
115 ppmmake. Default is white.
116 -var pixels
119 Specifies the variance of the ragged border (default: 10). Must
120 be a positive integer. Set pixels to 1 to get a straight bor‐
121 der.
122 -init seed
125 Use this option to initialize the pseudo-random number generator
126 (the Standard C library rand() function) with seed.
127 -verbose
130 Run ppmrough in verbose mode. It reports all parameters on
131 Standard Error.
132
137 ppmmake(1), pnmcat(1), ppmtopgm(1), ppm(1),
138
141 This program was added to Netpbm in Release 10.9 (September 2002).
142
145 Copyright (C) 2002 by Eckard Specht.
146netpbm documentation 23 August 2002 Ppmrough User Manual(0)