.\" 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 "Pamlevels User Manual" 0 "13 June 2018" "netpbm documentation"

.SH "نام (NAME)"
pamlevels \- اعمال تبدیل سطوح (levels) بر تصویر

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

\fBpamlevels\fP
\fB-from1\fP \fIfrom1\fP
\fB-to1\fP \fIto1\fP
\fB-from2\fP \fIfrom2\fP
\fB-to2\fP \fIto2\fP
[\fB-from3\fP \fIfrom3\fP
\fB-to3\fP \fIto3\fP]
[\fB-linear\fP]
[\fB-fitbrightness\fP]
[\fIpamfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamlevels\fP یک تصویر Netpbm را از \fIpamfile\fP یا ورودی استاندارد می‌خواند، یک تبدیل «سطوح» (levels) اعمال می‌کند و نتیجه را به خروجی استاندارد می‌فرستد. این برنامه تبدیلی یکتا پیدا می‌کند که رنگ \fIfrom1\fP را به \fIto1\fP، رنگ \fIfrom2\fP را به \fIto2\fP، و در صورت مشخص شدن \fB-from3\fP و \fB-to3\fP، رنگ \fIfrom3\fP را به \fIto3\fP نگاشت می‌کند. تبدیل‌های مبتنی بر دو نگاشت بر حسب شدت نور خطی هستند و تبدیل‌های مبتنی بر سه نگاشت درجه‌دوم (quadratic) می‌باشند. گزینه‌های نگاشت رنگ را می‌توان به‌صورت کوتاه شدهٔ \fB-f1\fP...\fB-f3\fP و \fB-t1\fP...\fB-t3\fP نیز به کار برد.
.PP
مقادیر رنگ قالب زیر را دارند:
\fIcolor\fP[:\fIscale\fP]، که در آن \fIcolor\fP یک
.UR libppm.html#colorname
مشخصهٔ رنگ Netpbm
.UE
\& و \fIscale\fP ضریبی اختیاری است که بر شدت (یعنی \fIنه\fP تصحیح‌شده با گاما) هر یک از مؤلفه‌های RGB رنگ اعمال می‌شود.
.PP
هنگامی که تبدیل خطی است (یعنی از دو نگاشت استفاده می‌کند) و صفر را حفظ می‌کند (یعنی سیاه را به سیاه نگاشت می‌کند)، معادل ضرب شدت نور در یک مقدار ثابت است و
.BR "color integrity" (1)\c
\& (یکپارچگی رنگ) را حفظ می‌کند.


.UN examples
.SH "مثال‌ها (EXAMPLES)"
در مثال‌های زیر، \f(CW\e\fP نشان‌دهندهٔ ادامهٔ خط است:
.PP
برای روشن‌تر کردن تصویر با تنظیم یک نقطهٔ سفید تیره‌تر:
.nf
    pamlevels -f1 black -t1 black \e
      -f2 white:0.9 -t2 white in.ppm > out.ppm
.fi
.PP
برای تنظیم نقطهٔ سفید:
.nf
    pamlevels -f1 black -t1 black \e
      -f2 rgbi:0.9/0.83/0.80 -t2 white in.ppm > out.ppm
.fi
.PP
برای تنظیم یک نقطهٔ سیاه روشن‌تر:
.nf
    pamlevels -f1 white:0.06 -t1 black \e
      -f2 white -t2 white in.ppm > out.ppm
.fi
.PP
برای افزایش روشنایی از طریق فشرده‌سازی:
.nf
    pamlevels \e
      -f1 black -t1 black -f2 white -t2 white \e
      -f3 white:0.5 -t3 white:0.6 in.ppm > out.ppm
.fi
تبدیل اخیر مشابه با تصحیح گاما (gamma-correction) است.


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


.TP
\fB-from1\fP
.TP
\fB-to1\fP
.TP
\fB-from2\fP
.TP
\fB-to2\fP
.TP
\fB-from3\fP
.TP
\fB-to3\fP
این گزینه‌ها نگاشت‌های رنگ‌های ورودی به رنگ‌های خروجی را که پایه و اساس تابع تبدیل هستند تعریف می‌کنند. به بخش
.UR #description
توضیحات (DESCRIPTION)
.UE
\& مراجعه کنید.
.sp
باید حداقل دو جفت از این گزینه‌ها را مشخص کنید.

.TP
\fB-linear\fP
این گزینه به \fBpamlevels\fP می‌گوید با نسخهٔ با شدتِ خطی در PPM کار کند که در آن نمونه‌ها برخلاف PPM واقعی که بر اساس روشنایی (تصحیح‌شده با گاما) هستند، متناسب با شدت نور می‌باشند. ورودی باید به این شکل باشد و \fBpamlevels\fP خروجی را نیز با همین قالب تولید می‌کند.
.sp
توجه داشته باشید که اعداد در مشخصهٔ رنگی مانند \fBrgbi:0.9/0.83/0.80\fP بدون در نظر گرفتن قالب ورودی و خروجی، همواره سطوح روشنایی (تصحیح‌شده با گاما) هستند.
.sp
نمی‌توان از این گزینه همراه با \fB-fitbrightness\fP استفاده کرد، زیرا این قابلیت پیاده‌سازی نشده است.
  
.TP
\fB-fitbrightness\fP
این گزینه تبدیلی را انتخاب می‌کند که چندان کاربردی نیست؛ این تبدیل به جای شدت نور پیکسل‌ها، بر حسب روشنایی خطی یا درجه‌دوم است. هیچ پایه و مبنای فیزیکی برای انجام تبدیل به این روش وجود ندارد و نتیجه معمولاً نامطلوب است.
.sp
توجه داشته باشید که بسیاری از ابزارهای غیر از Netpbm تبدیل را به همین شیوه انجام می‌دهند. یکی از کاربردهای این گزینه صرفاً نمایش نتیجهٔ ضعیف این روش است.
.sp
یک مزیت این تبدیل، سرعت بیشتر آن است؛ چرا که قالب‌های تصویر ورودی و خروجی از مقادیر روشنایی استفاده می‌کنند. نتیجه تقریباً صحیح خواهد بود.
.sp
نمی‌توان از این گزینه همراه با \fB-linear\fP استفاده کرد، زیرا این قابلیت پیاده‌سازی نشده است.
  


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmnorm" (1)\c
\&,
.BR "pamrecolor" (1)\c
\&,
.BR "pnmgamma" (1)\c
\&,
.BR "pnm" (1)\c
\&

.UN author
.SH "نویسندگان (AUTHORS)"
.PP
این برنامه ابتدا توسط Anton Shepelev
(\fIanton.txt@gmail.com\fP) ارائه شد.

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamlevels\fP در Netpbm نسخهٔ 10.83 (ژوئن ۲۰۱۸) معرفی شد.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار «makeman» در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamlevels.html
.PP