diff options
Diffstat (limited to 'upstream/fedora-40/man1/ppmpat.1')
| -rw-r--r-- | upstream/fedora-40/man1/ppmpat.1 | 235 |
1 files changed, 235 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/ppmpat.1 b/upstream/fedora-40/man1/ppmpat.1 new file mode 100644 index 00000000..ed7f0d99 --- /dev/null +++ b/upstream/fedora-40/man1/ppmpat.1 @@ -0,0 +1,235 @@ +\ +.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. +.\" Do not hand-hack it! If you have bug fixes or improvements, please find +.\" the corresponding HTML page on the Netpbm website, generate a patch +.\" against that, and send it to the Netpbm maintainer. +.TH "Ppmpat User Manual" 0 "02 March 2016" "netpbm documentation" + +.SH NAME + +ppmpat - make a pretty PPM image + +.UN synopsis +.SH SYNOPSIS + +\fBppmpat\fP +[{\fB-gingham2\fP|\fB-g2\fP} | +{\fB-gingham3\fP|\fB-g3\fP} | +\fB-madras\fP | +\fB-tartan\fP | +\fB-poles\fP | +\fB-squig\fP | +\fB-camo\fP | +\fB-anticamo\fP | +\fB-argyle1\fP | +\fB-argyle2\fP] +[\fB-color\fP \fIcolorlist\fP] +[\fB-mesh\fP] +[\fB-randomseed\fP \fIinteger\fP] + +\fIwidth\fP \fIheight\fP +.PP +You can abbreviate any option to its shortest unique prefix. + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBppmpat\fP produces a PPM of the specified width and height, +with a pattern in it. +.PP +You could, for example, use it to create wallpaper for a computer screen. +.PP +One use of this program is as an example of the Netpbm library +.BR "drawing" (1)\c +\& functions, which it uses. +.PP +Some of the patterns have large numbers of colors, so if you want +a simpler pattern, use \fBpnmquant\fP on the output. + +.UN options +.SH OPTIONS +.PP +In addition to the options common to all programs based on libnetpbm +(most notably \fB-quiet\fP, see +.UR index.html#commonoptions + Common Options +.UE +\&), \fBppmpat\fP recognizes the following +command line options: + +.UN patspec +.SS Pattern Specification +.PP +Specify the pattern type with these options. One pattern type must +be specified. + + +.TP +\fB-gingham2\fP \fB-g2\fP +A gingham check pattern. Can be tiled. +.sp +If you specify -color, give two colors: background and foreground, in that +order. + +.TP +\fB-gingham3\fP \fB-g3\fP +A slightly more complicated gingham. Can be tiled. +.sp +If you specify -color, give three colors: background and two foregrounds, +in that order. + +.TP +\fB-madras\fP +A madras plaid. Can be tiled. +.sp +If you specify -color, give three colors: background and two foregrounds, +in that order. + +.TP +\fB-tartan\fP +A tartan plaid. Can be tiled. +.sp +If you specify -color, give three colors: background and two foregrounds, +in that order. + +.TP +\fB-poles\fP +Color gradients centered on randomly-placed poles. +.sp +If you specify -color, give two or more colors. + +.TP +\fB-squig\fP +Squiggley tubular pattern. Can be tiled. +.sp +If you specify -color, give three or more colors. The first is the +background color. + +.TP +\fB-camo\fP +Camouflage pattern. +.sp +If you specify \fB-color\fP, give three or more colors. The first is the +background color; the others are colors for the leafy foreground shapes. +The foreground shapes will probably occupy nearly the entire image, so that the +background color is barely visible. + +.TP +\fB-anticamo\fP +Anti-camouflage pattern - like -camo, but ultra-bright colors. +.sp +If you specify \fB-color\fP, this is the same as \fB-camo\fP. + +.TP +\fB-argyle1\fP +A diamond argyle pattern, without a cross through the diamond, with one +diamond. Can be tiled. +.sp +If you specify -color, give two colors: background and foreground, in that +order. +.sp +This option was new in Netpbm 10.78 (March 2017). + +.TP +\fB-argyle2\fP +A diamond argyle pattern, with a cross through the diamond, with one +diamond. Can be tiled. +.sp +If you specify -color, give three colors: background, foreground, and +stripe, in that order. +.sp +This option was new in Netpbm 10.78 (March 2017). + + + +.UN otheropts +.SS Other Options + + + +.TP +\fB-color\fP \fIcolorlist\fP +This specifies the colors to appear in the pattern. +.sp +If you do not specify this option, \fBppmpat\fP chooses colors at random. +.sp +Different patterns take different numbers of colors. Some can involve +variable numbers of colors. If you specify a number of colors incompatible +with the pattern you specify, \fBppmpat\fP fails, telling you how many colors +to specify. +.sp +\fIcolorlist\fP is a comma-separated list of colors. +.sp +Specify each color as described for the +.UR libnetpbm_image.html#colorname +argument of the \fBpnm_parsecolor()\fP library routine +.UE +\&. +.sp +Example: \fB-color red, green, rgbi:1.0/0.5/.25\fP . +.sp +This option was new in Netpbm 10.78 (March 2017). + +.TP +\fB-mesh\fP +This option affects the patterns generated by the +\fB-gingham2\fP, \fB-gingham3\fP, \fB-madras\fP, and \fB-tartan\fP. When +this option is \fInot\fP specified, when two colors intersect, the program +mixes them and puts the average in the rectangular intersection region. +with \fB-mesh\fP, the program fills that region with a checkerboard pattern +consisting of the two colors. The resulting image looks like a true woven +fabric, with separate threads for the separate colors. +.sp +This option was new in Netpbm 10.97 (December 2021). + + +.TP +\fB-randomseed\fP \fIinteger\fP +This is the seed for the random number generator that generates the +pixels. +.sp +Use this to ensure you get the same image on separate invocations. +.sp +By default, \fBppmpat\fP uses a seed derived from the time of day +and process ID, which gives you fairly uncorrelated results in multiple +invocations. +.sp +This option was new in Netpbm 10.61 (December 2012). + + + +.UN references +.SH REFERENCES + +Some of the patterns are from "Designer's Guide to Color 3" +by Jeanne Allen. + +.UN seealso +.SH SEE ALSO +.BR "pnmtile" (1)\c +\&, +.BR "pnmquant" (1)\c +\&, +.BR "ppmmake" (1)\c +\&, +.BR "ppmrainbow" (1)\c +\&, +.BR "pamgradient" (1)\c +\&, +.BR "ppm" (1)\c +\& + +.UN author +.SH AUTHOR + +Copyright (C) 1989 by Jef Poskanzer. +.SH DOCUMENT SOURCE +This manual page was generated by the Netpbm tool 'makeman' from HTML +source. The master documentation is at +.IP +.B http://netpbm.sourceforge.net/doc/ppmpat.html +.PP
\ No newline at end of file |