Pamfind User Manual(0)                                  Pamfind User Manual(0)



NAME
       pamfind - Print the locations of all tuples of a certain value in an
       image


SYNOPSIS
       pamfind { -target=sample0,sample1, ... | -color=color } [-machine]
       [imagefile]

       All options can be abbreviated to their shortest unique prefix.  You
       may use two hyphens instead of one.  You may separate an option name
       and its value with white space instead of an equals sign.


DESCRIPTION
       This program is part of Netpbm(1).

       pamfind reads a Netpbm image (PNM or PAM) and prints a list of all the
       locations (row and column) of the tuples that have a value you specify.
       For example, you can list all the places that a visual image is red.

       You can specify the value in actual decimal sample values with a
       -target option or as a color with -color.  If you specify -color, the
       program fails if the input image does not have depth 3.  If it has
       depth 3 but the tuples aren't actually colors, you get results as if
       they are.

       To do the opposite, see what tuple is at a given location, use pamcut
       and pamtable:

           <span style="font-family: monospace;">
             $ pamcut -left=5 -top=7 -width=1 -height=1 | pamtable
           </span>

       ppmcolormask also finds all the tuples of a certain value, at least in
       visual images, but instead of printing their coordinates, it generates
       a mask image, which you can use to visualize where those tuples are or
       as input to another program.



OPTIONS
       In addition to the options common to all programs based on libnetpbm
       (most notably -quiet, see
        Common Options <index.html#commonoptions> ), pamfind recognizes the
       following command line options:




       -target=sample0,sample1, ... |
              This specifies the tuple value to find.  You specify the sample
              values in order, and must specify the proper number of sample
              values for the depth of the image (e.g. 3 if it is a color
              image).

              You must specify exactly one of -target and -color.


       -color=color
              This is the color to find, assuming the image is a color visual
              image.

              color is as described for the argument of the pnm_parsecolor()
              library routine <libnetpbm_image.html#colorname> .

              You must specify exactly one of -target and -color.


       -machine
              This makes the output more convenient for a machine to use,
              while
                less convenient for a human.  pamfind reports the same
              information
                as with no options.

              This option was new in Netpbm 10.87 (March 2020).




SEE ALSO
       pamdepth(1), pamgetcolor(1), ppmhist(1), ppmcolormask(1), pamcut(1),
       pamtable(1), pam(1)


HISTORY
       pamfind was added to Netpbm in Release 10.86 (March 2019).

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/pamfind.html

netpbm documentation             13 March 2019          Pamfind User Manual(0)