summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man1/pgmnoise.1
blob: 4aaefb82011fdaf686da8eeb1c7360479be7d78d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
\
.\" 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 "Pgmnoise User Manual" 0 "27 June 2013" "netpbm documentation"

.SH NAME
pgmnoise - create a PGM image made up of white noise

.UN synopsis
.SH SYNOPSIS

\fBpgmnoise\fP \fIwidth\fP \fIheight\fP

[\fB-maxval=\fP\fIn\fP]
[\fB-randomseed=\fP\fIinteger\fP]
.PP
Minimum unique abbreviations of option are acceptable.  You may use
double hyphens instead of single hyphen to denote options.  You may use
white space in place of the equals sign to separate an option name
from its value.


.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpgmnoise\fP creates a PGM image that is made up of pixels
of random brightness.
.PP
You specify the dimensions of the image with the \fIwidth\fP
and \fIheight\fP arguments.
.PP
The randomness in the image is limited before Netpbm 10.37 (December
2006) -- if you run the program twice in the same second, you may get
identical 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
\&), \fBpgmnoise\fP recognizes the following
command line options:


.TP
\fB-maxval=\fP\fIn\fP
The maxval of the generated image.
.sp
Default is 255.
.sp
This option was new in Netpbm 10.63 (June 2013).

.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, \fBpgmnoise\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.45 (December 2008).



.UN seealso
.SH SEE ALSO


.IP \(bu

.BR "pbmnoise" (1)\c
\&
.IP \(bu

.BR "pgm" (5)\c
\&


.UN author
.SH AUTHOR

Copyright (C) 1993 by Frank Neumann
.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/pgmnoise.html
.PP