diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
commit | fc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch) | |
tree | ce1e3bce06471410239a6f41282e328770aa404a /upstream/opensuse-tumbleweed/man1/pamfind.1 | |
parent | Initial commit. (diff) | |
download | manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip |
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/pamfind.1')
-rw-r--r-- | upstream/opensuse-tumbleweed/man1/pamfind.1 | 127 |
1 files changed, 127 insertions, 0 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/pamfind.1 b/upstream/opensuse-tumbleweed/man1/pamfind.1 new file mode 100644 index 00000000..057d2208 --- /dev/null +++ b/upstream/opensuse-tumbleweed/man1/pamfind.1 @@ -0,0 +1,127 @@ +\ +.\" 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 "Pamfind User Manual" 0 "13 March 2019" "netpbm documentation" + +.SH NAME +pamfind - Print the locations of all tuples of a certain value in an image + +.UN synopsis +.SH SYNOPSIS +\fBpamfind\fP +{ +\fB-target=\fP\fIsample0\fP\fB,\fP\fIsample1\fP\fB,\fP ... | +\fB-color=\fP\fIcolor\fP +} +[\fB-machine\fP] +[\fIimagefile\fP] +.PP +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. + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpamfind\fP 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. +.PP +You can specify the value in actual decimal sample values with +a \fB-target\fP option or as a color with \fB-color\fP. If you +specify \fB-color\fP, 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. +.PP +To do the opposite, see what tuple is at a given location, use +\fBpamcut\fP and \fBpamtable\fP: + +.nf + + $ pamcut -left=5 -top=7 -width=1 -height=1 | pamtable + + +.fi +.PP +\fBppmcolormask\fP 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. + + +.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 +\&), \fBpamfind\fP recognizes the following +command line options: + + + +.TP +\fB-target=\fP\fIsample0\fP\fB,\fP\fIsample1\fP\fB,\fP ... | +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). +.sp +You must specify exactly one of \fB-target\fP and \fB-color\fP. + +.TP +\fB-color=\fP\fIcolor\fP +This is the color to find, assuming the image is a color visual image. +.sp +\fIcolor\fP is as described for the +.UR libnetpbm_image.html#colorname +argument of the \fBpnm_parsecolor()\fP library routine +.UE +\&. +.sp +You must specify exactly one of \fB-target\fP and \fB-color\fP. + +.TP +\fB-machine\fP +This makes the output more convenient for a machine to use, while + less convenient for a human. \fBpamfind\fP reports the same information + as with no options. +.sp +This option was new in Netpbm 10.87 (March 2020). + + + +.UN seealso +.SH SEE ALSO +.BR "pamdepth" (1)\c +\&, +.BR "pamgetcolor" (1)\c +\&, +.BR "ppmhist" (1)\c +\&, +.BR "ppmcolormask" (1)\c +\&, +.BR "pamcut" (1)\c +\&, +.BR "pamtable" (1)\c +\&, +.BR "pam" (5)\c +\& + +.UN history +.SH HISTORY +.PP +\fBpamfind\fP was added to Netpbm in Release 10.86 (March 2019). +.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/pamfind.html +.PP
\ No newline at end of file |