.TH "راهنمای کاربری pamrecolor" 1 "31 ژوئیه 2010" "مستندات netpbm"

.SH "نام (NAME)"
pamrecolor \- تغییر رنگ و نگاشت مجدد فضای رنگی تصویر Netpbm

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBpamrecolor\fP
[\fB\-\-colorspace\fP=\fIنام\fP]
[\fB\-\-rmult\fP=\fIکسر\fP]
[\fB\-\-gmult\fP=\fIکسر\fP]
[\fB\-\-bmult\fP=\fIکسر\fP]
[\fB\-\-targetcolor\fP=\fIرنگ\fP]
[\fB\-\-colorfile\fP=\fIفایل\fP]
[\fB\-randomseed=\fP\fIعدد_صحیح\fP]

[\fIفایل_ورودی\fP]
.PP
کوتاه‌ترین مخفف یکتا برای هر گزینه قابل قبول است. می‌توانید به جای یک خط تیره از دو خط تیره برای گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از فاصله خالی برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
است.
.PP
دستور
.B pamrecolor
رنگ‌های یک تصویر را به نزدیک‌ترین حالت ممکن به رنگ‌های هدف تغییر می‌دهد، با این شرط که درخشندگی (روشنایی) تصویر دست‌نخورده باقی بماند. به این معنی که اگر هر دو تصویر اصلی و هدف به مقیاس خاکستری تبدیل شوند (مثلاً با دستور
.BR "ppmtopgm" (1)\c
)، کاملاً یکسان به نظر خواهند رسید. می‌توانید تعیین کنید که
.B pamrecolor
رنگ‌های هدف را به‌صورت تصادفی انتخاب کند، یک فام رنگی واحد را برای کل تصویر اعمال کند یا رنگ‌های هدف را از یک تصویر دیگر دریافت نماید.
.PP
علاوه بر تصاویر استاندارد Netpbm، دستور
.B pamrecolor
روی تصاویر شبه‌Netpbm مبتنی بر فضاهای رنگی دلخواه نیز کار می‌کند. می‌توانید فضای رنگی را به‌صورت صریح تعریف کنید یا یکی از فضاهای رنگی شناخته‌شده برای برنامه را با نام انتخاب نمایید.
.PP
خروجی یک تصویر PAM در خروجی استاندارد است. گزینه‌ها قالب دقیق PAM را کنترل می‌کنند. اگر تصویری از نوع PNM (شامل PBM، PGM یا PPM) می‌خواهید، دستور
.BR "pamtopnm" (1)\c
را روی خروجی اجرا کنید. در صورتی که بخواهید از تصویر به عنوان ورودی برنامه‌های کنونی Netpbm استفاده کنید نیازی به تبدیل نیست، اما بسیاری از برنامه‌های متفرقه قالب PAM را نمی‌شناسند.


.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های عمومی مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه گزینه
.BR \-quiet ،
به مستندات گزینه‌های عمومی Netpbm مراجعه کنید)، دستور
.B pamrecolor
از گزینه‌های خط فرمان زیر پشتیبانی می‌کند:

.TP
\fB\-\-colorspace\fP=\fIنام\fP
فضای رنگی مورد استفاده برای تعیین سهم هر یک از کانال‌های رنگی قرمز، سبز و آبی در درخشندگی (Luminance) را مشخص می‌کند. برای مثال، در فضای رنگی SMPTE-C یک رنگ RGB با ضرب کردن کانال قرمز در 0.2124132، کانال سبز در 0.7010437 و کانال آبی در 0.0865432 و سپس جمع کردن این سه حاصل‌ضرب، به مقیاس خاکستری تبدیل می‌شود.
.sp
هنگام استفاده از این گزینه، تصاویر ورودی و خروجی تصاویر واقعی Netpbm نیستند، زیرا قالب تصویر Netpbm یک فضای رنگی خاص را تعریف می‌کند. در عوض، شما از گونه‌ای از این قالب استفاده می‌کنید که در آن مقادیر نمونه در تصویر شطرنجی معنای متفاوتی دارند. بسیاری از برنامه‌هایی که ظاهراً از تصاویر Netpbm استفاده می‌کنند، در عمل از گونه‌ای با فضای رنگی متفاوت بهره می‌برند. برای نمونه،
.B GIMP
به‌طور داخلی از sRGB استفاده می‌کند و اگر با GIMP یک فایل تصویر Netpbm ایجاد کنید، در واقع گونه‌ای از این قالب را با فضای رنگی sRGB تولید می‌نماید.
.sp
دستور
.B pamrecolor
فضاهای رنگی زیر (مقادیر
\fIنام\fP)
را می‌شناسد:

.TP
.B adobe
فضای رنگی Adobe RGB (1998) با نقطه سفید مرجع D65

.TP
.B apple
فضای رنگی Apple RGB با نقطه سفید مرجع D65

.TP
.B cie
فضای رنگی CIE با نقطه سفید مرجع Illuminant E

.TP
.B ntsc
فضای رنگی NTSC RGB با نقطه سفید مرجع Illuminant C

.TP
.B pal
فضای رنگی PAL/SECAM با نقطه سفید مرجع D65

.TP
.B smpte-c
فضای رنگی SMPTE-C با نقطه سفید مرجع D65

.TP
.B srgb
فضای رنگی sRGB با نقطه سفید مرجع D65

.TP
.B wide
فضای رنگی Wide-gamut RGB با نقطه سفید مرجع D50

.sp
مقدار پیش‌فرض "ntsc" است زیرا این فضای رنگی است که قالب‌های Netpbm و بسیاری از ابزارهای گرافیکی استفاده می‌کنند. در مقابل،
.B GIMP
از sRGB به عنوان فضای رنگی بومی خود استفاده می‌کند.
.sp
مقادیر درخشندگی که
.B pamrecolor
برای هر یک از فضاهای رنگی بالا استفاده می‌کند، برگرفته از صفحه محاسبات ماتریس‌های RGB-to-XYZ و XYZ-to-RGB بروس لیندبلوم (Bruce Lindbloom) است.

.TP
\fB\-\-rmult\fP=\fIکسر\fP
.TP
\fB\-\-gmult\fP=\fIکسر\fP
.TP
\fB\-\-bmult\fP=\fIکسر\fP
به جای انتخاب یک فضای رنگی با نام، می‌توانید سهم هر کانال رنگی را در درخشندگی کلی به‌صورت صریح با ضرایب قرمز، سبز و آبی مشخص کنید. این سه گزینه باید همراه با هم استفاده شوند و مجموع این سه مقدار
\fIکسر\fP
باید برابر با 1.0 باشد. برای مثال، می‌توانید فضای رنگی ProPhoto (ROMM) RGB را با
"\fB\-\-rmult\fP=0.2880402 \fB\-\-gmult\fP=0.7118741 \fB\-\-bmult\fP=0.0000857"
مشخص نمایید.

.TP
\fB\-\-targetcolor\fP=\fIرنگ\fP
مقدار
\fIرنگ\fP
را به عنوان رنگ هدف برای تصویر تعیین می‌کند. دستور
.B pamrecolor
هر پیکسل را تا حد ممکن به
\fIرنگ\fP
هدف نزدیک می‌کند، با این شرط که درخشندگی باید دقیقاً مانند تصویر اصلی حفظ شود. مقدار
\fIرنگ\fP
را همانند آرگومان‌های تابع
\fBpnm_parsecolor()\fP
در کتابخانه libnetpbm (مانند "hotpink" یا "#ff69b4") مشخص کنید.
.sp
اگر هیچ‌یک از گزینه‌های
.B \-\-targetcolor
یا
.B \-\-colorfile
را مشخص نکنید،
.B pamrecolor
به‌صورت تصادفی یک رنگ هدف برای هر پیکسل از تصویر ورودی انتخاب می‌کند.
.sp
نمی‌توانید هر دو گزینه
.B \-targetcolor
و
.B \-colorfile
را همزمان مشخص کنید.

.TP
\fB\-\-colorfile\fP=\fIفایل\fP
رنگ‌های هدف را به‌ازای هر پیکسل از فایل Netpbm با نام
\fIفایل\fP
دریافت می‌کند، به جای اینکه از یک رنگ واحد برای کل تصویر استفاده شود.
\fIفایل\fP
باید یک تصویر PPM یا یک تصویر رنگی PAM باشد. اگر تصویر داخل فایل عریض‌تر یا بلندتر از تصویر ورودی باشد،
.B pamrecolor
تنها از بخش بالا و چپ آن استفاده می‌کند. اگر تصویر باریک‌تر یا کوتاه‌تر باشد،
.B pamrecolor
تصویر را مانند الگوهای کاشی‌کاری تکرار می‌نماید.
.sp
اگر هیچ‌یک از گزینه‌های
.B \-\-targetcolor
یا
.B \-\-colorfile
را مشخص نکنید،
.B pamrecolor
به‌صورت تصادفی یک رنگ هدف برای هر پیکسل از تصویر ورودی انتخاب می‌کند.
.sp
نمی‌توانید هر دو گزینه
.B \-targetcolor
و
.B \-colorfile
را همزمان مشخص کنید.

.TP
\fB\-randomseed=\fP\fIعدد_صحیح\fP
این مقدار بذر (Seed) برای مولد اعداد تصادفی است که پیکسل‌ها را تولید می‌کند.
.sp
از این گزینه برای اطمینان از دریافت خروجی یکسان در اجراهای جداگانه استفاده نمایید.
.sp
به‌طور پیش‌فرض،
.B pamrecolor
از بذری مشتق‌شده از زمان جاری سیستم و شناسه فرایند (PID) استفاده می‌کند که نتایجی نسبتاً نامرتبط در دفعات مختلف اجرا ارائه می‌دهد.
.sp
این گزینه در Netpbm 10.61 (دسامبر 2012) اضافه شده است.

.UN examples
.SH "مثال‌ها (EXAMPLES)"
.PP
این دستور به تصویر ته‌رنگ زرد می‌دهد:

.nf
    pamrecolor --targetcolor=yellow colorpic.pam > yellowpic.pam
.fi
.PP
این دستور رنگ‌ها را از
\fBcolorpicture.ppm\fP
گرفته و آن‌ها را روی
\fBgraypicture.pgm\fP
اعمال می‌کند:

.nf
    pamrecolor --colorfile=colorpic.ppm graypic.pgm > colorizedpic.pam
.fi
.PP
نسخه مقیاس خاکستری فایل
\fBcolorizedpic.pam\fP
دقیقاً شبیه
\fBgraypic.pgm\fP
خواهد بود. توجه داشته باشید که اگر برای تبدیل به مقیاس خاکستری از ابزاری غیر از Netpbm استفاده می‌کنید، ممکن است لازم باشد مقدار مناسب
.B \-\-colorspace
را برای ابزار تبدیل خود تعیین نمایید.

.UN notes
.SH "نکات (NOTES)"
.PP
چند جلوه ویژه جالب که می‌توانید با
.B pamrecolor
ایجاد کنید:

.IP \(bu
یک فایل رنگی مشخص کنید که دقیقاً مانند تصویر ورودی باشد اما متنی بزرگ و رنگی به آن اضافه شده باشد. هنگام تبدیل تصویر به مقیاس خاکستری، این متن به شکلی جادویی ناپدید خواهد شد.

.IP \(bu
یک تصویر خاکستری با کنتراست پایین (شاید پیامی محرمانه که با سایه‌های نزدیک به هم خاکستری نوشته شده) را به عنوان فایل ورودی و تصویری رنگارنگ اما کاملاً متفاوت را به عنوان فایل رنگی فراهم کنید. در صورت اجرای دقیق، تصویر خاکستری توسط تصویر رنگارنگ پنهان می‌شود و تنها افرادی که تصویر حاصل را به مقیاس خاکستری تبدیل کنند می‌توانند تصویر خاکستری اولیه را بازیابی نمایند.

.IP \(bu
استفاده از گزینه
\fB\-\-targetcolor\fP=tan
برای قدیمی نشان دادن ظاهر تصویر (یا دقیق‌تر، عکسی با تون قهوه‌ای مایل به زرد / سپیا شبیه به عکس‌های اواخر قرن نوزدهم).

.UN history
.SH "تاریخچه (HISTORY)"
.PP
اسکات پاکین (Scott Pakin) دستور
.B pamrecolor
را در ژوئیه 2010 نوشت.
.PP
دستور
.B pamrecolor
در Netpbm 10.52 (سپتامبر 2010) معرفی شد.

.UN author
.SH "نویسنده (AUTHOR)"
.PP
حق نشر (C) 2010 اسکات پاکین (Scott Pakin)،
\fIscott+pbm@pakin.org\fP

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"

.IP \(bu

.BR "\fBppmtopgm\fP" (1)\c
\&
.IP \(bu

.BR "\fBppmchange\fP" (1)\c
\&
.IP \(bu

.BR "\fBpnmremap\fP" (1)\c
\&

.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' از منابع HTML پروژه Netpbm تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamrecolor.html
.PP