Scroll to navigation

Pgmnoise User Manual(0) Pgmnoise User Manual(0)

NAME

pgmnoise - create a PGM image made up of white noise

SYNOPSIS

pgmnoise width height

[-maxval=n] [-randomseed=integer]

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.

DESCRIPTION

This program is part of Netpbm(1).

pgmnoise creates a PGM image that is made up of pixels of random brightness.

This program exists for backward compatibility and is implemented as a thin wrapper around pamnoise, which is what you should use in any new applications.

pamnoise is a drop-in replacement for pgmnoise except that it produces PAM output instead of PGM. If you must have PGM output, put the output through pgmtopgm (but you probably don't have to, because most Netpbm programs that accept PGM input also accept equivalent PAM input; in some cases, you may need to add a -tupletype=GRAYSCALE option).

Use the pamnoise manual with pgmnoise, with the following
exceptions:

  • pgmnoise produces PGM output only.

  • pgmnoise doesn't have any options except
    -maxval (new in Netpbm 10.63 (June 2013)) and -randomseed
    (new in Netpbm 10.45 (December 2008)).

  • Use pamnoise's backward compatibility syntax to specify
    the width and height as arguments.

  • The randomness in the image generated by pgmnoise is limited
    before Netpbm 10.37 (December 2006) -- if you run the program twice in the
    same second, you may get identical output.

SEE ALSO

AUTHOR

Bryan Henderson (contributed to the public domain by its author).

HISTORY

The original pgmnoise was written by Frank Neumann in 1993 and
added to Netpbm at that time.

It was significantly enhanced and rewritten in the years following, including to use Netpbm's new random number architecture developed by Akira Urushibata, until pamnoise replaced it in Netpbm 11.16 (September 2026) and pgmnoise was replaced with a thin wrapper around pamnoise.

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/pgmnoise.html
13 September 2026 netpbm documentation