Debian Codegraph @

upstream/debian-unstable/man1/ppmwheel.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ppmwheel User Manual" 1 "03 February 2019" "netpbm documentation"
7
8 .SH NAME
9 ppmwheel - make a PPM image of a color wheel
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBppmwheel\fP
15 \fIdiameter\fP
16 [{\fB-huevalue\fP | \fB-huesaturation\fP}]
17 [\fB-maxval=\fP\fIN\fP]
18
19
20 .UN description
21 .SH DESCRIPTION
22 .PP
23 This program is part of
24 .BR "Netpbm" (1)\c
25 \&.
26 .PP
27 \fBppmwheel\fP produces a PPM image of a color wheel of the
28 specified diameter inside a white square just large enough to hold it.
29 .PP
30 The color wheel is based on the HSV color model. Hues are distributed
31 angularly around the circle and the values and saturations are distributed
32 radially.
33 .PP
34 You can generate three kinds of color wheel:
35
36 .IP \(bu
37 Hue-value: Select this with a \fB-huevalue\fP option.
38 .sp
39 The saturation is 100% everywhere. The value goes from zero to 100%
40 linearly, from the center of the wheel to the edge. So the center is black.
41 .sp
42 Hence, the image consists of all of the secondary colors based on the
43 red, green, and blue primary colors. A secondary color is one that is
44 composed of light of at most two of the three primary colors.
45
46 .IP \(bu
47 Hue-saturation: Select this with a \fB-huesaturation\fP option.
48 .sp
49 The value is 100% everywhere. The saturation goes from zero to 100%
50 linearly, from the center of the wheel to the edge. So the center is white.
51
52 .IP \(bu
53 Ppmcirc: Select this by not specifying any other wheel type option.
54 .sp
55 The saturation is 100% everywhere. The value is a strange function of
56 the distance from the center, increasing as the square root of the distance
57 until halfway out, then decreasing as the 8th root of the distance the rest
58 of the way. We don't know what the point of this is, but it is what the
59 program Ppmcirc by Peter Kirchgessner in 1995 does, and was the only option
60 in \fBppmwheel\fP from its inception in 2003 to 2019.
61
62
63
64
65 .UN arguments
66 .SH ARGUMENTS
67 .PP
68 You must specify one non-option argument: the radius of the color wheel
69 in pixels.
70 .PP
71 This is also the height and width of the output image.
72
73
74 .UN options
75 .SH OPTIONS
76 .PP
77 In addition to the options common to all programs based on libnetpbm
78 (most notably \fB-quiet\fP, see
79 .UR index.html#commonoptions
80 Common Options
81 .UE
82 \&), \fBppmwheel\fP recognizes the following
83 command line options:
84
85
86 .TP
87 \fB-huevalue\fP
88
89 This selects a hue-value color wheel.
90 .sp
91 This option was new in Netpbm 10.86 (March 2019).
92
93 .TP
94 \fB-huesaturation\fP
95
96 This selects a hue-saturation color wheel.
97 .sp
98 This option was new in Netpbm 10.86 (March 2019).
99
100 .TP
101 \fB-maxval=\fP\fIN\fP
102
103 This selects the maxval for the image. The default is 255.
104 .sp
105 This option was new in Netpbm 10.86 (March 2019).
106
107
108
109
110 .UN seealso
111 .SH SEE ALSO
112 .BR "ppmcie" (1)\c
113 \&,
114 .BR "ppmrainbow" (1)\c
115 \&,
116 .BR "ppm" (1)\c
117 \&
118
119 .UN history
120 .SH HISTORY
121 .PP
122 \fBppmwheel\fP was added to Netpbm in Release 10.14 (March 2003).
123
124
125 .UN author
126 .SH AUTHOR
127
128 Copyright (C) 1995 by Peter Kirchgessner
129 .SH DOCUMENT SOURCE
130 This manual page was generated by the Netpbm tool 'makeman' from HTML
131 source. The master documentation is at
132 .IP
133 .B http://netpbm.sourceforge.net/doc/ppmwheel.html
134 .PP