.\" 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 "Pamaltsat User Manual" 0 "14 September 2018" "netpbm documentation"

.SH "نام (NAME)"
pamaltsat \- افزایش یا کاهش اشباع رنگ یک تصویر با استفاده از یکی از چندین روش جایگزین

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

\fBpamaltsat\fP
[\fB-method\fP \fIname\fP]
[\fB-strength\fP \fInumber\fP]
[\fB-linear\fP]
[\fIinfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamaltsat\fP اشباع رنگ (saturation) یک تصویر Netpbm را با استفاده از یکی از روش‌های گوناگون غیر استاندارد (\fIجایگزین\fP یا \fIalt\fPernative) کاهش یا افزایش می‌دهد.
.PP
ورودی یک تصویر Netpbm از ورودی استاندارد (Standard Input) یا فایلی است که نام آن در آرگومان‌ها مشخص شده است. خروجی نیز یک تصویر Netpbm با همان قالب است که در خروجی استاندارد (Standard Output) نوشته می‌شود.
.PP
مرسوم‌ترین روش برای تغییر اشباع رنگ یک تصویر، روشی است که \fBpambrighten\fP انجام می‌دهد.
  

.UN examples
.SH "مثال‌ها (EXAMPLES)"
.PP
برای افزایش اشباع رنگ با ضریب ۲٫۱ با استفاده از روش لگاریتمی:

.nf
\f(CW
     pamaltsat -method log -strength 2.1 test.ppm
\fP
.fi
.PP
برای تبدیل یک تصویر رنگی به مقیاس خاکستری (grayscale):

.nf
\f(CW
    pamaltsat -strength 0 test.ppm
\fP
.fi


.UN saturation_methods
.SH "روش‌های اشباع رنگ (SATURATION METHODS)"
.PP
روش‌های اشباع رنگ زیر در دسترس هستند.

.SS "روش لگاریتمی (Logarithmic Method)"
.PP
این مدل اشباع رنگ از مفهوم
.BR "تمامیت رنگ (color integrity)" (1)\c
\& الهام گرفته شده است، که با رنگ بر اساس نسبت‌های شدت کار می‌کند، جایی که شدت مقداری از
.UR https://en.wikipedia.org/wiki/Luminosity_function
تابع درخشندگی (luminosity function)
.UE
\& است، نه روشنایی یا مقدار عددی نمونه در فایل تصویر. از این دیدگاه، طبیعی است که اشباع رنگ به عنوان نسبت بیشینه و کمینه شدت مؤلفه‌های اصلی آن تعریف شود. با این حال، به منظور تبدیل اشباع رنگ به یک مقدار جمع‌پذیر و بخشیدن معنای ضریب به پارامتر \fB-strength\fP، مناسب است که روی لگاریتم این نسبت عمل شود. جمع چنین اشباع‌هایی معنای فیزیکی پیدا می‌کند و ضرب معادل با به توان رساندن شدت به توان ضریب خواهد بود.
.PP
با این روش، \fBpamaltsat\fP شدت هر مؤلفه را به توان مقدار \fBstrength\fP می‌رساند. از آنجا که شدت کل رنگ حاصل با رنگ اصلی متفاوت خواهد بود، لازم است با ضرب کردن شدت مؤلفه‌های رنگ اشباع‌شده در نسبت شدت رنگ اصلی به شدت رنگ اشباع‌شده، شدت بازیابی شود.
.PP
اگرچه همیشه کاهش اشباع رنگ با هر ضریب مشخصی ممکن است، اما در دو حالت نمی‌توان آن را افزایش داد. هنگامی که شدت کل (یا روشنایی) یک رنگ برای اشباع مطلوب بیش از حد بالا باشد، \fBpamaltsat\fP بیشینه اشباع ممکن را اعمال می‌کند که شدت اصلی را حفظ کند. به عنوان مثال، هر رنگی که حداقل یکی از مؤلفه‌های آن در بیشینه مقدار باشد، پیشاپیش کاملاً اشباع شده است. هنگامی که یکی از مؤلفه‌های اصلی صفر باشد، تعریف ارائه‌شده در بالا برای اشباع رنگ به دلیل وجود صفر در مخرج دیگر کار نمی‌کند. \fBpamaltsat\fP هیچ رفتار ویژه‌ای برای این وضعیت ارائه نمی‌دهد زیرا ناپیوستگی ایجاد نمی‌کند و بنابراین در سطوح قدرت معقول هیچ نقص قابل‌مشاهده‌ای به وجود نمی‌آورد. با این حال، هنگامی که قدرت به سمت بی‌نهایت میل می‌کند، هر رنگ به سمت مؤلفه اصلی خود با بالاترین شدت متمایل می‌شود.
.PP
این روش توسط Anton Shepelev ابداع شده است.
  

.SS "روش طیفی (Spectral Method)"
.PP
این روش پیش‌فرض است. این روش با رنگ به عنوان یک طیف با سه باند رفتار می‌کند: یکی برای شدت هر مؤلفه اصلی. از آنجا که خاکستری خنثی دارای طیف یکنواخت (ثابت) است، اشباع رنگ را می‌توان به عنوان تفاوت طیف رنگ مورد نظر با طیف یکنواخت با همان شدت کل اندازه‌گیری کرد. روش طیفی از یکی از ساده‌ترین معیارهای چنین تفاوتی استفاده می‌کند: تفاوت بین بیشترین و کمترین شدت مؤلفه‌ها، که مقداری جمع‌پذیر است و بنابراین با معنای فیزیکی مناسب، قابلیت ضرب شدن را دارد. اگرچه یک مدل کامل فام-اشباع (hue-saturation) را می‌توان از این رویکرد به دست آورد، اما نیازی نیست \fBpamaltsat\fP نگران آن باشد، زیرا همواره فام (hue) و شدت کل را حفظ می‌کند.
.PP
به منظور تغییر اشباع رنگ، \fBpamaltsat\fP ابتدا شدت هر مؤلفه را در قدرت مورد نظر ضرب می‌کند. اشباع نتیجه برابر است با حاصل‌ضرب قدرت در اشباع اولیه، و به همین ترتیب شدت کل نیز، اما سپس با تفریق خاکستری خنثی با شدت مناسب، بازیابی می‌شود.
.PP
اثر این روش بر شدت هر مؤلفه را می‌توان در معادله زیر بیان کرد:
.nf
<span style="font-family: monospace">
    sat = orig * strength - Iorig * (strength - 1)
</span>
.fi
که در آن <span style="font-family: monospace">sat</span> نمونه اشباع‌شده، <span style="font-family: monospace">orig</span> نمونه اصلی، و <span style="font-family: monospace">Iorig</span> شدت کل رنگ اصلی است.
.PP
این روش همچنین به مفهوم تمامیت رنگ (color integrity) مرتبط است زیرا هر دو عملیات آن بخشی از آن مفهوم هستند: ضرب شدت مؤلفه‌ها در یک ضریب یکسان عملیات مهمی است زیرا روشنایی را تغییر می‌دهد اما تعادل رنگ را حفظ می‌کند، و تفریق یک مقدار ثابت از تمام شدت‌های مؤلفه‌ها توسط ابداع‌کننده تمامیت رنگ به عنوان «تفریق سفید» توصیف شده است.
.PP
این روند ممکن است شدت‌های مؤلفه‌ای منفی یا بزرگ‌تر از یک تولید کند. برای چنین نمونه‌هایی، \fBpamaltsat\fP قدرت را به بیشترین مقداری کاهش می‌دهد که رنگ حاصل را در محدوده مجاز نگه دارد.
.PP
این روش توسط Anton Shepelev ابداع شده است.


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


.TP
\fB-method\fP \fImethod\fP
روش اشباع مورد استفاده را مشخص می‌کند:
.TS
method name	option value
Logarithmic	\f(CWlog \fP
Spectral   	\f(CWspectrum\fP
.TE
.sp
پیش‌فرض \fBspectrum\fP است.

.TP
\fB-strength\fP \fIstrength\fP
یک ضریب حقیقی غیرمنفی را مشخص می‌کند که اشباع با آن تغییر یابد. مقداری بزرگ‌تر از یک اشباع را افزایش می‌دهد، در حالی که مقداری کمتر از یک آن را کاهش خواهد داد. مقدار یک تصویر را بدون تغییر رها می‌کند، و مقدار صفر خروجی در مقیاس خاکستری طبق استاندارد Rec 709 تولید خواهد کرد.
  
دستور \fBpamaltsat\fP شدت کل هر پیکسل را حفظ می‌کند و هرگز روی پیکسل‌های خاکستری خنثی تأثیری نمی‌گذارد.
.sp
این گزینه الزامی است.

.TP
\fB-linear\fP
به \fBpamaltsat\fP اعلام می‌کند که ورودی نوع خطی-شدت (intensity-linear) از قالب تصویر Netpbm است، که در آن نمونه‌ها به جای روشنایی، متناسب با شدت نور هستند، همان‌طور که در قالب‌های تصویر Netpbm با گامای تنظیم‌شده یا واقعی وجود دارد.


.UN usage_notes
.SH "نکات استفاده (USAGE NOTES)"
.PP
از آنجا که \fBpamaltsat\fP روی رنگ‌های خنثی تأثیری نمی‌گذارد، باید پیش از اشباع، تعادل رنگ را تنظیم کنید. می‌توانید این کار را با \fBpamlevels\fP انجام دهید.

  
.UN extensibility
.SH "قابلیت گسترش (EXTENSIBILITY)"

دستور \fBpamaltsat\fP با دیدگاه گسترش آن با روش‌های اشباع جدید نوشته شده است، و از مشارکت برنامه‌نویسان استقبال می‌شود. تنها الزام این است که هر روش جدید به یک پارامتر قدرت (strength) منفرد با همان معانی توصیف‌شده تحت گزینه خط فرمان \fB-strength\fP وابسته باشد.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.PP
.BR "pambrighten" (1)\c
\&،
.BR "ppmflash" (1)\c
\&،


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

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamaltsat\fP در Netpbm 10.84 (سپتامبر ۲۰۱۸) معرفی شد.
  

.UN index
.SH "فهرست مطالب (Table Of Contents)"

.IP \(bu

.UR #synopsis
خلاصه دستور (SYNOPSIS)
.UE
\&
.IP \(bu

.UR #description
توضیحات (DESCRIPTION)
.UE
\&
.IP \(bu

.UR #examples
مثال‌ها (EXAMPLES)
.UE
\&
.IP \(bu

.UR #saturation_methods
روش‌های اشباع رنگ (SATURATION METHODS)
.UE
\&
.IP \(bu

.UR #options
گزینه‌ها (OPTIONS)
.UE
\&
.IP \(bu

.UR #usage_notes
نکات استفاده (USAGE NOTES)
.UE
\&
.IP \(bu

.UR #extensibility
قابلیت گسترش (EXTENSIBILITY)
.UE
\&
.IP \(bu

.UR #seealso
همچنین ببینید (SEE ALSO)
.UE
\&
.IP \(bu

.UR #author
نویسندگان (AUTHORS)
.UE
\&
.IP \(bu

.UR #history
تاریخچه (HISTORY)
.UE
\&
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamaltsat.html
.PP