.\" 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 "Pamhue User Manual" 0 "07 January 2018" "netpbm documentation"

.SH "نام (NAME)"
pamhue \- تغییر فام (hue) رنگ‌های یک تصویر Netpbm

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

\fBpamhue\fP
[\fB-huechange=\fP[\fIdegrees\fP]]
\fIfilename\fP
.PP
کوتاه‌ترین اختصار یکتای هر گزینه پذیرفته می‌شود. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از فاصله خالی برای جدا کردن نام گزینه از مقدار آن استفاده کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamhue\fP فام رنگ (hue) هر پیکسل را در یک تصویر به مقدار یکسانی تغییر می‌دهد (شیفت می‌دهد).
.PP
اگر تصویر در قالب سیاه‌وسفید یا مقیاس خاکستری (grayscale) باشد، تصویر کاملاً غیراشباع (desaturated) است؛ بنابراین فام رنگ بی‌معنی بوده و \fBpamhue\fP تصویر را دست‌نخورده باقی می‌گذارد.
.PP
مدل «فام-اشباع-روشنایی» یا HSV، همانند مدل شناخته‌شده‌تر RGB، یکی از روش‌های نمایش رنگ است. فام نشان‌دهنده رنگ ثانویه‌ای با همان درخشندگی است که بیشترین تقریب را به آن رنگ دارد. یک رنگ ثانویه از ترکیب حداکثر دو رنگ اصلی تشکیل می‌شود.
.PP
در مدل HSV، فام یک موقعیت زاویه‌ای روی چرخه رنگ است.
.PP
با \fBpamhue\fP، شما زاویه‌ای را برای تغییر تمام فام‌های موجود در تصویر مشخص می‌کنید؛ برای مثال می‌توانید بگویید آن را ۶۰ درجه در جهت عقربه‌های ساعت بچرخاند. این کار تمام پیکسل‌های قرمز را به زرد و تمام پیکسل‌های زرد را به سبز و غیره تبدیل می‌کند.
  
.PP
برای تغییر دادن مؤلفه‌های اشباع (saturation) و روشنایی (value) رنگ‌ها، از \fBpambrighten\fP استفاده کنید.


.UN examples
.SH "مثال‌ها (EXAMPLES)"
.PP
برای چرخاندن رنگ هر پیکسل به میزان ۱۲۰ درجه در جهت عقربه‌های ساعت:
.nf
pamhue -huechange=120
.fi
.PP
برای چرخاندن رنگ هر پیکسل به میزان ۱۲۰ درجه در خلاف جهت عقربه‌های ساعت:
.nf
pamhue -huechange=-120
.fi


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


.TP
\fB-huechange=\fP\fIdegrees\fP
این گزینه مقدار تغییر (شیفت) هر رنگ را مشخص می‌کند. این مقدار بر حسب درجه است که مقادیر مثبت به معنای جهت عقربه‌های ساعت و مقادیر منفی به معنای خلاف جهت عقربه‌های ساعت هستند. مقدار می‌تواند اعشاری باشد و می‌تواند بیش از یک دور کامل باشد.
.sp
این گزینه الزامی است.

  

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamhue\fP در Netpbm 10.86 (مارس ۲۰۱۹) جدید بود.


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

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