Ppmrough User Manual(0) Ppmrough User Manual(0)
ppmrough - create PPM image of two colors with a ragged border between them
All options can be abbreviated to their shortest unique prefix. You may use two hyphens
instead of one. You may separate an option name and its value with white space instead of
an equals sign.
This program is part of Netpbm(1)
ppmrough generates a PPM image of the specified width, height, and colors. ppmrough tiles
the image into semi-rectangular regions with a ragged borders between them. It calculates
the fluctuations with the rand() standard C library function.
ppmrough writes the PPM image to Standard Output.
The maxval of the output image is 255 (You can change this with pamdepth).
Use the options -left or -right, respectively, to make vertical borders, and -top or -bot-
tom, respectively, to generate horizontal borders inside the image. Each of these options
needs an integer value pixels that determines the average distance of the interior border
to the related edge of the image. You may combine the -left, -right, -top, and -bottom
options to generate an image with more than one border. The algorithm ensures that you
can concatenate two images produced with the same (i.e. -left) value without dislocations.
You specify the dimensions of the generated image with the -width and -height options.
Use the -bg and -fg options to set the background (margin) color and the foreground (inte-
rior) color, respectively. If you don't specify any of the -left, -right, -top, and -bot-
tom options, all pixels are set to foreground color. The defaults are white foreground
and black background.
Use the -var option to control the 'raggedness' of the border. The less its value is the
smoother the border is. You can initialize the pseudo-random generator with the -init
You could use ppmrough with ppmtopgm to create a PGM alpha mask and use it to roughen up
the edges of another image.
Specifies the mean distance of the border from the left margin (default: no bor-
Specifies the mean distance of the border from the right margin (default: no bor-
Specifies the mean distance of the border from the top margin (default: no border).
Specifies the mean distance of the border from the bottom margin (default: no bor-
Specifies the width of the image (default: 100).
Specifies the height of the image (default: 100).
Background color. Specify this the same way you specify a color with
ppmmake. Default is black.
Foreground color. Specify this the same way you specify a color with
ppmmake. Default is white.
Specifies the variance of the ragged border (default: 10). Must be a positive
integer. Set pixels to 1 to get a straight border.
Use this option to initialize the pseudo-random number generator (the Standard C
library srand() function) with seed.
Before Netpbm 10.61 (December 2012), this is called -init, and that still works.
Run ppmrough in verbose mode. It reports all parameters on Standard Error.
ppmmake(1) , pnmcat(1) , ppmtopgm(1) , ppm(1) ,
This program was added to Netpbm in Release 10.9 (September 2002).
Copyright (C) 2002 by Eckard Specht.
netpbm documentation 23 August 2002 Ppmrough User Manual(0)