Minimum unique abbreviations of options are acceptable. You may use double hyphens instead of a single hyphen to denote options. You may use white space in place of the equals sign to separate an option name from its value.
This program is part of Netpbm.
pamthreshold thresholds a grayscale image. Thresholding means dividing the image into background and foreground by comparing every pixel to a thresholding value.
The input should be a PGM image or a PAM image of tuple type GRAYSCALE. However, pamthreshold doesn't check; it just thresholds the first channel as if it were grayscale samples. So if you feed it e.g. a PPM image, it will work but produce probably useless results.
The output is a PAM with tuple type BLACKANDWHITE. You can turn this into a PBM (if you need to use it with an older program that doesn't understand PAM, or you can't afford the 8X amount of space that PAM uses for the image) with pamtopnm.
The output is to Standard Output.
Another way to convert a grayscale image to black and white is to dither. Dithering is using clustered black and white pixels such that if you step back and look at the picture, you see varying levels of gray. pamditherbw does dithering.
Without any options, pamthreshold uses an iterative algorithm found in the wikipedia article Thresholding (image processing) to compute the thresholding value. (this version of the Wikipedia article was current at the time of this writing). It uses this threshold to globally threshold the image. This should work well for most images. The program issues a message telling you what threshold it used. (Netpbm messages go to Standard Error, and you can turn them off with the Netpbm common option -quiet).
If you don't specify this option, pamthreshold uses a threshold of 0.5. Without -simple or -local this option is meaningless.
The meaning of the threshold depends upon the kind of thresholding you do (as determined by other options). Roughly, pixels brighter than the threshold become white in the output while others become black.
If you don't specify this option, pamthreshold uses a contrast threshold of 0.05. Without -dual this option is meaningless.
pamthreshold was new in Netpbm 10.34 (June 2006).
pamthreshold is Copyright © 2006 by Erik Auerswald and released under the GPL.