PPMROUGH(1)

💖 ppmrough(1) — Ppmrough User Manual 💖

okay bestie, gather round, because we're about to talk about ppmrough, and it is lowkey iconic. it makes a PPM image of a single-color rectangle with ragged edges sitting on a different color background. that's the whole vibe. periodt.

---

✨ NAME ✨

ppmrough — create PPM image of a single color rectangle with ragged edges on a different color background

---

🎀 SYNOPSIS 🎀

ppmrough

[-left pixels]

[-right pixels]

[-top pixels]

[-bottom pixels]

[-width pixels]

[-height pixels]

[-bg colorspec]

[-fg colorspec]

[-var pixels]

[-randomseed seed]

[-verbose]

ngl, the CLI is so flexible about how you write it. all options can be abbreviated to their shortest unique prefix. you may use two hyphens instead of one. and you may separate an option name and its value with white space instead of an equals sign. slay, honestly. 💅

---

🦋 DESCRIPTION 🦋

This program is part of Netpbm(1).

ppmrough generates a PPM image of the specified width and height.

the image consists of a rectangle of the specified foreground color surrounded by borders of the specified size and background color, except that the boundary between the foreground rectangle and the borders is ragged. and the ragged effect? random. fr fr. 🎲

ppmrough writes the PPM image to Standard Output. no cap.

the maxval of the output image is 255 (you can change this with pamdepth — not me giving you options or anything 💅).

use the options -left or -right, respectively, to make vertical borders, and -top or -bottom, respectively, to generate horizontal borders inside the image. the value of each of these options is the minimum width of the border on that edge. beyond that minimum, the width at any given location on that edge is random, varying along the edge in a fractal kind of way. it's giving math, it's giving art, it's giving both. ✨

use the -var option to control the "raggedness" of the border. the lower its value, 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 transparency mask and use it to roughen up the edges of another image. 🫶

---

✨ OPTIONS ✨

in addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), ppmrough recognizes the following command line options:

• -width=pixels — this specifies the width of the image in pixels (default: 100).
• -height=pixels — this specifies the height of the image in pixels (default: 100).
• -left=pixels
• -right=pixels
• -top=pixels
• -bottom=pixels — this option causes the program to create a left, right, top, or bottom border, respectively, at least pixels pixels wide, varying randomly beyond that. you may specify any combination of these. mix and match, bestie. 🎨
• -bg=colorspec — this is the background color, i.e. the color of the borders. colorspec is as described for the argument of the pnm_parsecolor() library routine. default is black.
• -fg=color — this specifies the foreground color, i.e. the color of the center of the mage — everything but the borders. colorspec is as described for the argument of the pnm_parsecolor() library routine. default is white.
• -var=pixels — this specifies how ragged the borders are — how much and how quickly its width varies along the image edge. its specific meaning is complex, but the larger it is, the more the border varies. zero means it does not vary at all — the edge of the foreground is straight. this must be a nonnegative integer. the default is 10.
• -randomseed=seed — use this option to initialize the pseudo-random number generator with seed. you can use this to cause the program to produce repeatable output. obsessed. 🔁 before Netpbm 10.61 (December 2012), this is called -init, and that still works. vintage, but still working.
• -verbose — run ppmrough in verbose mode. it reports all parameters on Standard Error. it's giving yapper energy, respectfully. 💜

---

🌈 SEE ALSO 🌈

ppmmake(1), pamcat(1), ppmtopgm(1), ppm(1),

---

📜 HISTORY 📜

this program was added to Netpbm in Release 10.9 (September 2002). a legend was born. 👑

---

👑 AUTHOR 👑

Copyright (C) 2002 by Eckard Specht.

---

🧚 DOCUMENT SOURCE 🧚

this manual page was generated by the Netpbm tool makeman from HTML source. the master documentation is at

http://netpbm.sourceforge.net/doc/ppmrough.html

---

that's a wrap, bestie 🎀 this came from the netpbm documentation, dated 20 August 2023, and it lives under the name Ppmrough User Manual. go make some jagged little rectangles, you absolute icon. 💖✨