.\" 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 "Pamdepth User Manual" 0 "26 August 2020" "netpbm documentation"

.SH "نام (NAME)"

pamdepth \- تغییر عمق (تفکیک‌پذیری رنگ) در یک تصویر Netpbm

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

\fBpamdepth\fP \fInewmaxval\fP [\fInetpbmfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamdepth\fP یک تصویر Netpbm را به‌عنوان ورودی می‌خواند، عمق (تفکیک‌پذیری رنگ) آن را تغییر می‌دهد، و تصویر Netpbm حاصل را در خروجی می‌نویسد. به این معنا که مقدار maxval خروجی نسبت به ورودی متفاوت است، اما تمام رنگ‌ها یکسان باقی می‌مانند (به‌جز خطاهای ناشی از گرد کردن).
.PP
کاهش عمق منجر به از دست رفتن مقداری از اطلاعات می‌شود.
.PP
در اینجا مثالی از این اثر در سطح قالب تصویر آورده شده است: فرض کنید با تصویری با maxval برابر با 100 و مقادیر نمونه‌ی 50 و 100 شروع می‌کنید. به \fBpamdepth\fP مشخص می‌کنید که آن را به عمق 150 تغییر دهد. خروجی دارای maxval برابر با 200 و مقادیر نمونه‌ی 75 و 150 خواهد بود.
.PP
این برنامه روی جریان‌های چندتصویری (multi-image streams) نیز کار می‌کند.
.PP
هنگام انتخاب maxval جدید، مراقب خطاهای یکی‌کم‌و‌بیش (off-by-one errors) باشید. برای مثال، اگر می‌خواهید مقادیر رنگ پهنای ۵ بیت داشته باشند، از maxval برابر با 31 استفاده کنید، نه 32.
.PP
یکی از کاربردهای مهم \fBpamdepth\fP تبدیل یک فایل PNM با قالب جدیدِ ۲ بایت بر نمونه به قالب قدیمی‌ترِ ۱ بایت بر نمونه است. قبل از آوریل ۲۰۰۰، اساساً تمام فایل‌های قالب PNM خام (دودویی) دارای maxval کمتر از 256 و یک بایت به ازای هر نمونه بودند، و برنامه‌های متعددی ممکن است به آن وابسته باشند. اگر یک \fInewmaxval\fP کمتر از 256 مشخص کنید، فایل حاصل باید توسط هر برنامه‌ای که قبل از آوریل ۲۰۰۰ با فایل‌های PNM کار می‌کرده، قابل خواندن باشد.

.UN output_format
.SS "قالب خروجی (Output Format)"
.PP
قالب خروجی (PBM و غیره) و در مورد PAM، نوع تاپل (tuple type) خروجی معمولاً با ورودی یکسان است.
.PP
با این حال، تغییر عمق یک تصویر سیاه‌وسفید بی‌معنی است، مگر آنکه به یک تصویر در مقیاس خاکستری (grayscale) تبدیل شود؛ بنابراین اگر ورودی یک تصویر سیاه‌وسفید باشد، \fBpamdepth\fP خروجی را به‌صورت خاکستری درمی‌آورد. به‌طور دقیق‌تر، اگر ورودی یک تصویر PBM باشد، خروجی PGM خواهد بود، و اگر ورودی یک PAM با نوع تاپل BLACKANDWHITE یا BLACKANDWHITE_ALPHA باشد، خروجی به‌ترتیب یک PAM با نوع تاپل GRAYSCALE یا GRAYSCALE_ALPHA خواهد بود.
.PP
این تبدیل حتی اگر maxval جدید برابر با 1 باشد نیز انجام می‌شود.
.PP
قبل از Netpbm نسخه 10.92 (سپتامبر ۲۰۲۰)، اگر ورودی PAM با نوع تاپل سیاه‌وسفید بود و maxval جدید مقداری به‌جز 1 داشت، \fBpamdepth\fP با خطا مواجه می‌شد. اما همواره PBM را به PGM ارتقا می‌داد.

  
.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
هیچ گزینه خط فرمانی به‌طور اختصاصی برای \fBpamdepth\fP تعریف نشده است، اما گزینه‌های عمومی مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm را می‌شناسد (نگاه کنید به
.UR index.html#commonoptions
گزینه‌های عمومی
.UE
\&.)

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnm" (1)\c
\&،
.BR "pam" (1)\c
\&،
.BR "pnmquant" (1)\c
\&،
.BR "ppmdither" (1)\c
\&،
.BR "pambrighten" (1)\c
\&،
.BR "pamfunc" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamdepth\fP در Netpbm نسخه 10.32 (فوریه ۲۰۰۶) اضافه شد. این دستور جایگزین \fBpnmdepth\fP اثر Jef Poskanzer گردید. \fBpamdepth\fP با \fBpnmdepth\fP سازگاری پس‌رو دارد و قابلیت پردازش تصاویر دلخواه PAM و امکان پردازش جریان‌های ورودی چندتصویری را فراهم می‌کند. \fBpnmdepth\fP تنها تصاویر PNM را مدیریت می‌کرد و در هر جریان، تمام تصاویر به‌جز اولین تصویر را نادیده می‌گرفت.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' از Netpbm از منبع HTML تولید شده است. مستندات مرجع در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamdepth.html
.PP