ppmrough(1)

1Ppmrough User Manual(0)                                Ppmrough User Manual(0)
2
3
4

NAME

6       ppmrough  - create PPM image of two colors with a ragged border between
7       them
8
9

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

HISTORY

156       This program was added to Netpbm in Release 10.9 (September 2002).
157
158

AUTHOR

160       Copyright (C) 2002 by Eckard Specht.
161

DOCUMENT SOURCE

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)