\
.\" 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 "Pamunlookup User Manual" 0 "09 August 2015" "netpbm documentation"

.SH "نام (NAME)"
pamunlookup \- معکوس دستور pamlookup

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBpamunlookup\fP
\fB-lookupfile=\fP\fIlookupfile\fP
\fIinputfile\fP
.PP
تمامی گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد.
می‌توانید به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید
نام یک گزینه و مقدار آن را به جای علامت مساوی با یک فاصله خالی جدا کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
بهترین تعریف برای
\fBpamunlookup\fP
عملکرد معکوس
\fBpamlookup\fP
(بدون گزینه
\fB-byplane\fP\fR)
است. برای مثال، دستور زیر معمولاً خروجی کاملاً یکسانی با ورودی تولید می‌کند:

.nf
\f(CW
    $ cat input.ppm | \e
        pamunlookup -lookupfile=map.pam | \e
        pamlookup -lookupfile=map.pam \e
        > output.ppm
\fP
.fi
.PP
به طور مشخص،
\fBpamunlookup\fP
یک تصویر ورودی را دریافت کرده و تصویر خروجی با همان عرض و ارتفاع تولید می‌کند که در آن هر چندتایی (tuple) یک عدد منفرد است. آن عدد، نمایه (index) مقدار چندتاییِ موجود در همان موقعیتِ تصویر ورودی، در جدول جستجوی (lookup table) داده‌شده است.
.PP
شما جدول جستجو را به همان روشی که برای
.UR pamlookup.html#lookupimage
\fBpamlookup\fP
.UE
تعیین می‌شود، مشخص می‌کنید.
.PP
در صورتی که یک چندتایی در تصویر ورودی در جدول جستجو وجود نداشته باشد، عددی که
\fBpamunlookup\fP
در تصویر نمایه خروجی قرار می‌دهد، یک واحد بزرگ‌تر از بالاترین نمایه در جدول جستجو خواهد بود. بر همین اساس، مقدار بیشینه (maxval) تصویر نمایه خروجی، برابر با اندازه جدول جستجو است.


.UN example
.SS "مثال (Example)"
.PP
در اینجا یک مثال از عملکرد
\fBpamunlookup\fP
آورده شده است.
.PP
یک تصویر ورودی متشکل از یک تصویر PPM به ابعاد ۳x۲ را به صورت زیر در نظر بگیرید:

.TS
l l l.
red	yellow	red
beige	beige	beige
.TE

و یک جدول جستجو متشکل از یک تصویر PPM به ابعاد ۳x۱ به صورت زیر:

.TS
l l l.
red	yellow	beige
.TE

جدول جستجوی بالا نشان می‌دهد که نمایه 0 مربوط به رنگ قرمز (red)، نمایه 1 مربوط به زرد (yellow) و نمایه 2 مربوط به بژ (beige) است. خروجی
\fBpamunlookup\fP
تصویر نمایه زیر خواهد بود:

.TS
l l l.
0	1	0
2	2	2
.TE

.UN misc
.SS "متفرقه (Miscellaneous)"
.PP
آرگومان
\fIinputfile\fP
فایل حاوی تصویر PAM یا PNM را مشخص می‌کند. علامت
\fB-\fP
به معنی ورودی استاندارد (Standard Input) است. اگر هر دو فایل تصویر ورودی و جدول جستجو ورودی استاندارد باشند، کار نخواهد کرد.
.PP
تصویر نمایه خروجی به خروجی استاندارد (Standard Output) فرستاده می‌شود.


.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک میان تمامی برنامه‌های مبتنی بر libnetpbm
(به‌ویژه
\fB-quiet\fP\fR،
به 
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
مراجعه کنید)،
\fBpamunlookup\fP
گزینه خط فرمان زیر را می‌شناسد:


.TP
\fB-lookupfile=\fP\fIlookupfile\fP
\fIlookupfile\fP
نام فایلی است که حاوی تصویر PAM یا PNM به عنوان جدول جستجو می‌باشد. این گزینه الزامی است.

     
.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamlookup" (1)\c
\&,
.BR "ppmchange" (1)\c
\&,
.BR "pnmcolormap" (1)\c
\&,
.BR "pnm" (1)\c
\&,
.BR "pam" (1)\c
\&


.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور
\fBpamunlookup\fP
در Netpbm 10.72 (سپتامبر 2015) جدید بود.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' از Netpbm و از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارند:
.IP
.B http://netpbm.sourceforge.net/doc/pamunlookup.html
.PP