ppmrough



Ppmrough User Manual(0)                                Ppmrough User Manual(0)




NAME

       ppmrough  - create PPM image of two colors with a ragged border between
       them


SYNOPSIS

       ppmrough

       [-left pixels]

       [-right pixels]

       [-top pixels]

       [-bottom pixels]

       [-width pixels]

       [-height pixels]

       [-bg rgb:##/##/##]

       [-fg rgb:##/##/##]

       [-var pixels]

       [-init seed]

       [-verbose]

       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.



DESCRIPTION

       This program is part of Netpbm(1).

       ppmrough generates a PPM image of the specified width, height, and col-
       ors.   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
       pnmdepth).

       Use the options -left or -right, respectively, to  make  vertical  bor-
       ders, and -top or -bottom, 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  (interior)  color, respectively.  If you don’t specify
       any of the -left, -right, -top, and -bottom options, all pixels are set
       to foreground color.  The defaults are white foreground and black back-
       ground.

       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 option.

       You could use ppmrough with ppmtopgm to create a PGM alpha mask and use
       it to roughen up the edges of another image.



OPTIONS

       -left pixels
               Specifies  the mean distance of the border from the left margin
              (default: no border).


       -right pixels
              Specifies the mean distance of the border from the right  margin
              (default: no border).


       -top pixels
              Specifies  the  mean  distance of the border from the top margin
              (default: no border).


       -bottom pixels
              Specifies the mean distance of the border from the bottom margin
              (default: no border).


       -width pixels
              Specifies the width of the image (default: 100).


       -height pixels
              Specifies the height of the image (default: 100).


       -bg color
              Background color.  Specify this the same way you specify a color
              with
                   ppmmake.  Default is black.


       -fg color
              Foreground color.  Specify this the same way you specify a color
              with
                   ppmmake.  Default is white.


       -var pixels
               Specifies the variance of the ragged border (default: 10). Must
              be a positive integer.  Set pixels to 1 to get a  straight  bor-
              der.


       -init seed
              Use this option to initialize the pseudo-random number generator
              (the Standard C library rand() function) with seed.


       -verbose
              Run ppmrough in verbose mode.   It  reports  all  parameters  on
              Standard Error.





SEE ALSO

       ppmmake(1), pnmcat(1), ppmtopgm(1), ppm(1),



HISTORY

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



AUTHOR

       Copyright (C) 2002 by Eckard Specht.



netpbm documentation            23 August 2002         Ppmrough User Manual(0)

Man(1) output converted with man2html