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

.SH "نام (NAME)"
pambrighten \- تغییر میزان Saturation و Value در تصاویر PPM

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

\fBpambrighten\fP
[\fB-saturation=\fP[\fB+\fP|\fB-\fP]\fIsaturation_percent\fP]
[\fB-value=\fP[\fB+\fP|\fB-\fP]\fIvalue_percent\fP]
[\fInetpbmfile\fP]
.PP
کوتاه‌ترین مخفف یکتای گزینه‌ها پذیرفته می‌شود. می‌توانید به جای یک خط فاصله، از دو خط فاصله برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسه فاصله برای جدا کردن نام یک گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpambrighten\fP مقدار Saturation (اشباع رنگ) و Value (روشنایی رنگ) هر پیکسل از یک تصویر Netpbm را (بر اساس فضای رنگی HSV) افزایش یا کاهش می‌دهد. شما درصد تغییر را برای هر یک از این پارامترها مشخص می‌کنید.
.PP
همچنین می‌توانید رنگ‌های پیکسل‌ها را به گونه‌ای بازنگاشت کنید که مقادیر Value آن‌ها کل دامنه مقادیر ممکن Value را پوشش دهد.
.PP
تصویر ورودی از فایلی به نام \fInetpbmfile\fP یا در صورت تعیین نشدن \fInetpbmfile\fP، از ورودی استاندارد (Standard Input) خوانده می‌شود.
  
.PP
قالب خروجی همانند قالب ورودی است و هرگونه کانال اضافی، مانند شفافیت (transparency)، بدون تغییر عبور داده می‌شوند.
  
.PP
مدل Hue-Saturation-Value یا HSV، یکی از روش‌های نمایش رنگ است، درست مانند مدل شناخته‌شده‌تر RGB. متغیرهای Hue (فام)، Saturation (اشباع)، و Value (روشنایی) اعدادی در بازه 0 تا 1 هستند. در این نوشتار هرگاه منظور مقداری از فضای رنگی HSV باشد، همواره آن‌ها را با حرف بزرگ آغاز می‌کنیم؛ به‌ویژه از آنجا که واژه «value» در کاربرد معمول انگلیسی مفهومی بسیار انتزاعی‌تر دارد.
.PP
مقدار Value معیاری برای سنجش روشنایی رنگ نسبت به یک مقدار بیشینه مشخص است (قالب‌های Netpbm نیز بر اساس یک بیشینه روشنایی مشخص تعریف شده‌اند -- برای اهداف این برنامه، هر دوی آن‌ها یکسان هستند). به‌طور خاص، این مقدار برابر است با روشناییِ روشن‌ترین مؤلفه از رنگ‌های اصلی تقسیم بر بیشینه روشنایی ممکن برای یک مؤلفه. مقدار صفر برای Value به معنای رنگ سیاه است. رنگ سفید دارای Value کامل (1) است.
.PP
مقدار Hue نشان‌دهنده رنگ ثانویه‌ای با همان روشنایی است که بیشترین تقریب را به رنگ مورد نظر ارائه می‌دهد. یک رنگ ثانویه از ترکیب حداکثر دو مورد از رنگ‌های اصلی ساخته می‌شود.
.PP
مقدار Saturation معیاری است از نزدیکی رنگ به رنگِ مشخص‌شده توسط Hue و Value. مقدار کمتر به این معنی است که برای دستیابی به رنگ دقیق، باید نور بیشتری از رنگ اصلی سوم اضافه شود. اشباع (Saturation) کامل به این معناست که رنگ یک رنگ ثانویه خالص است. مقدار اشباع صفر به معنای رنگ خاکستری (یا سیاه و سفید) است. کاهش اشباع یک رنگ تمایل دارد که آن را رنگ‌ورفته و کدر کند.
.PP
اگر افزایش مقدار Value یک پیکسل به میزانی که تعیین کرده‌اید ناممکن باشد (برای مثال، مقدار Value برابر ۰٫۵ باشد و شما +200% را مشخص کنید)، \fBpambrighten\fP در عوض آن را به حداکثر Value افزایش می‌دهد.
.PP
اگر افزایش مقدار Saturation یک پیکسل به میزانی که تعیین کرده‌اید ناممکن باشد (برای مثال، از قبل نیمه‌اشباع باشد و شما +200% را مشخص کنید)، \fBpambrighten\fP در عوض آن را به حداکثر Saturation افزایش می‌دهد.
.PP
برای روش ساده‌تری از افزایش روشنایی، می‌توانید از \fBpamfunc -multiplier\fP صرفاً برای افزایش روشنایی هر پیکسل به میزان یک درصد مشخص استفاده کنید، که در آن هر مؤلفه RGB که روشنایی محاسبه‌شده آن از بیشینه روشنایی فراتر رود برش می‌خورد (clip می‌شود). بنابراین، علاوه بر عدم دستیابی به روشنایی مشخص‌شده، رنگمایگی (chromaticity) روشن‌ترین رنگ‌ها در تصویر تغییر خواهد کرد. برای \fIکاهش\fP روشنایی، دستور \fBpamfunc\fP باید عملکرد یکسانی با \fBpambrighten\fP داشته باشد.
.PP
دستور \fBppmflash\fP نوع دیگری از روشن‌سازی را انجام می‌دهد. این دستور رنگ هر پیکسل را تغییر می‌دهد تا آن را به میزانی درصدی مشخص به رنگ سفید نزدیک‌تر کند. این کار باعث افزایش value و saturation می‌شود.
.PP
برنامه \fBpambrighten\fP به عنوان جایگزینی برای \fBppmbrighten\fP طراحی شده است. این برنامه همانند \fBppmbrighten\fP عمل می‌کند، با این تفاوت که قالب‌های تصویری گوناگون Netpbm را به رسمیت می‌شناسد به جای اینکه با همه آن‌ها مانند PPM رفتار کند. قالب خروجی مشابه قالب ورودی است و کانال‌های اضافی در یک تصویر PAM (مانند کانال شفافیت) دست‌نخورده عبور داده می‌شوند.
.PP
اگر قصد تغییر دادن فام‌ها (hues) را در تصویر دارید، از \fBpamhue\fP استفاده کنید.

  
.UN examples
.SH "مثال‌ها (EXAMPLES)"
.PP
برای دو برابر کردن Value هر پیکسل:
.nf
pambrighten -value=100
.fi
.PP
برای دو برابر کردن Saturation و نصف کردن Value هر پیکسل:
.nf
pambrighten -saturation=+100 -value=-50
.fi

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


.TP
\fB-value=\fP\fIvalue_percent\fP
این گزینه مقداری را به‌صورت درصد مشخص می‌کند که می‌خواهید Value هر پیکسل به آن میزان افزایش یابد. این مقدار می‌تواند منفی باشد.
.sp
پیش‌فرض صفر است.
  
.TP
\fB-saturation=\fP\fIvalue_percent\fP
این گزینه مقداری را به‌صورت درصد مشخص می‌کند که می‌خواهید Saturation هر پیکسل به آن میزان افزایش یابد. این مقدار می‌تواند منفی باشد.
.sp
پیش‌فرض صفر است.

  

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmnorm" (1)\c
\&, 
.BR "ppmdim" (1)\c
\&, 
.BR "pamfunc" (1)\c
\&, 
.BR "ppmflash" (1)\c
\&, 
.BR "pamaltsat" (1)\c
\&, 
.BR "pamdepth" (1)\c
\&, 
.BR "pnmgamma" (1)\c
\&, 
.BR "pamhue" (1)\c
\&, 
.BR "ppmhist" (1)\c
\&, 
.BR "ppm" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpambrighten\fP در Netpbm 10.86 (مارس ۲۰۱۹) جدید بود. این برنامه نسخه تبدیل‌شده به PAM از دستور بسیار قدیمی‌تر \fBppmbrighten\fP بود.
  

.UN author
.SH "نویسندگان (AUTHORS)"
.PP
حق نشر \(co ۱۹۹۰ متعلق به Brian Moffet.
حق نشر \(co ۱۹۸۹ متعلق به Jef Poskanzer.
.PP
مجوز استفاده، رونوشت‌برداری، تغییر و توزیع این نرم‌افزار و مستندات آن به هر منظور و بدون دریافت هزینه، بدین وسیله اعطا می‌شود، به این شرط که اعلامیه حق نشر فوق در تمامی نسخه‌ها درج شود و هر دو اعلامیه حق نشر و این اعلامیه مجوز در مستندات پشتیبان ذکر گردند. این نرم‌افزار «همان‌گونه که هست» و بدون هرگونه ضمانت صریح یا ضمنی ارائه می‌شود.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm به نام 'makeman' از روی مبدأ HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pambrighten.html
.PP