\
.\" 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 "Ppmtoxpm User Manual" 0 "22 February 2003" "netpbm documentation"

.SH "نام (NAME)"
ppmtoxpm \- تبدیل یک تصویر PPM به یک پیکس‌مپ (pixmap) در X11

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

\fBppmtoxpm \fP
[\fB-name=\fP\fIxpmname\fP]
[\fB-hexonly\fP]
[\fB-rgb=\fP\fIrgb-textfile\fP]
[\fB-alphamask=\fP\fIpgmfile\fP]
[\fIppmfile\fP]
.PP
حداقل مخفف یکتای گزینه پذیرفته می‌شود. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی از فاصله برای جدا کردن نام گزینه از مقدار آن استفاده کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه \fBppmtoxpm\fP یک تصویر PPM را به عنوان ورودی خوانده و یک پیکس‌مپ X11 (نسخه ۳) به عنوان خروجی تولید می‌کند. این قالب توسط کتابخانه XPM قابل بارگذاری است.
.PP
در خروجی XPM، رنگ‌ها ممکن است با نام‌هایی مانند «Red» یا در قالب شانزده‌شانزدهی (هگزادسیمال)، به عنوان مثال «#FF0000» مشخص شوند. در قالب هگزادسیمال، برای هر یک از مؤلفه‌های RGB می‌تواند بین ۱ تا ۴ رقم هگزادسیمال وجود داشته باشد.
.PP
به‌طور پیش‌فرض، برنامه \fBppmtoxpm\fP تلاش می‌کند تا نام هر رنگ موجود در تصویر را در
.UR libppm.html#dictionary
فرهنگ رنگ سیستم
.UE
\& پیدا کند و در صورت یافتن، از آن استفاده نماید. در غیر این صورت، از مقدار هگزادسیمال استفاده می‌کند. با استفاده از گزینه \fB-hexonly\fP می‌توانید \fBppmtoxpm\fP را ملزم کنید که فقط از مقادیر هگزادسیمال استفاده کند. همچنین با استفاده از گزینه \fB-rgb\fP می‌توانید فرهنگ رنگ متفاوتی را مشخص کنید.
.PP
هنگامی که \fBppmtoxpm\fP از قالب هگزادسیمال برای شناسایی یک رنگ استفاده می‌کند، از کمترین تعداد ارقام هگزادسیمال مورد نیاز برای نمایش مقدار maxval در تصویر PPM ورودی استفاده می‌نماید. برای نمونه، اگر maxval در PPM ورودی ۱۰۰ باشد، \fBppmtoxpm\fP برای هر مؤلفه از ۲ رقم استفاده می‌کند، مانند «#FF0000».
.PP
برخی از برنامه‌ها شناسه‌های رنگ هگزادسیمال با یک رقم برای هر مؤلفه را به درستی پردازش نمی‌کنند و رنگ‌ها را نادرست نشان می‌دهند. برای تولید یک فایل XPM که چنین برنامه‌هایی بتوانند آن را پردازش کنند، مطمئن شوید که maxval تصویر PPM ورودی بزرگ‌تر از ۱۵ است؛ برای نمونه از طریق عبور دادن آن از دستور \fBpamdepth 255\fP.

.SS "طول کدهای رنگ - حجم تصویر (Color Code Lengths - Image Size)"
.PP
در قالب XPM، یک پالت («نگاشت رنگ» یا color map) وجود دارد که هر رنگ تصویر را به توالی یکتایی از نویسه‌های قابل چاپ تحت عنوان کد رنگ اختصاص می‌دهد، و یک رستر (raster) که رنگ هر پیکسل تصویر را با یکی از آن کدهای رنگ مشخص می‌کند. طول کد رنگ بر اندازه جریان تصویر تأثیر می‌گذارد.
.PP
تمام کدهای رنگ در یک تصویر هم‌طول هستند و \fBppmtoxpm\fP تلاش می‌کند آن را تا حد امکان کوتاه نگه دارد. این طول مشخصاً بر اساس تعداد رنگ‌های موجود در تصویر تعیین می‌شود. برنامه \fBppmtoxpm\fP رنگ‌های تصویر را به جز رنگ‌هایی که به دلیل ماسک شفافیت در خروجی شفاف خواهند بود شمارش می‌کند و طول کد رنگ را بر این اساس انتخاب می‌نماید. ۹۲ نویسه قابل چاپ وجود دارد که می‌توان در یک کد رنگ استفاده کرد. بنابراین اگر ۹۲ رنگ یا کمتر داشته باشید، کدهای رنگ شما یک‌نویسه‌ای خواهند بود. اگر بیش از ۹۲ ولی حداکثر ۹۲ * ۹۲ رنگ داشته باشید، کدهای رنگ دو‌نویسه‌ای خواهند بود و به همین ترتیب.
.PP
یک استثنا برای موارد بالا وجود دارد: اگر یک ماسک شفافیت (گزینه \fB-alpha\fP) مشخص کنید، یک کد رنگ منحصر‌به‌فرد نمایانگر «شفاف» خواهد بود. این امر حتی در صورتی که ماسک شفافیت در عمل هیچ پیکسل شفافی تولید نکند نیز صادق است. بنابراین در صورت استفاده از \fB-alpha\fP، یک واحد از تعداد رنگ‌های ممکن کم کنید.


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


.TP
\fB-name=\fP\fIxpmname\fP
این گزینه رشته پیشوند مشخص‌شده در خروجی XPM را تعیین می‌کند. اگر از گزینه \fB-name\fP استفاده نکنید، \fBppmtoxpm\fP به‌طور پیش‌فرض از نام فایل (بدون پسوند) پارامتر \fIppmfile\fP استفاده می‌کند. اگر \fB-name\fP یا \fIppmfile\fP را مشخص نکنید (یعنی ورودی از ورودی استاندارد باشد)، رشته پیشوند به صورت پیش‌فرض \fBnoname\fP خواهد بود.

.TP
\fB-hexonly\fP
این گزینه مشخص می‌کند که هرگز نام رنگ‌ها در فایل XPM قرار نگیرد، بلکه رنگ‌ها با رشته‌های هگزادسیمال که صریحاً شدت مؤلفه‌های RGB را تعیین می‌کنند، مشخص شوند. این بدان معناست که خواننده فایل برای تفسیر آن نیازی به دسترسی به فرهنگ رنگ مناسب ندارد.
.sp
این گزینه در Netpbm 10.15 (آوریل ۲۰۰۳) معرفی شد. پیش از آن، این رفتار پیش‌فرض بود و با تعیین \fB-rgb\fP لغو می‌شد.

.TP
\fB-rgb=\fP\fIrgb-textfile\fP
این گزینه نام فایلی را مشخص می‌کند که فرهنگ رنگ مورد نظر شما در آن قرار دارد. به‌طور پیش‌فرض، \fBppmtoxpm\fP از 
.UR libppm.html#dictionary
فرهنگ رنگ سیستم
.UE
\& استفاده می‌کند، و اگر نتواند آن فایل را باز کند، از مشخص‌کننده‌های رنگ هگزادسیمال استفاده خواهد کرد.
.sp
هنگامی که \fB-hexonly\fP را تعیین کنید، این گزینه بی‌معنی است.
.sp
پیش از Netpbm 10.15 (آوریل ۲۰۰۳)، \fBppmtoxpm\fP به طور پیش‌فرض از فرهنگ رنگ سیستم استفاده نمی‌کرد. اگر \fB-rgb\fP را مشخص نمی‌کردید، \fBppmtoxpm\fP فقط از مشخص‌کننده‌های رنگ هگزادسیمال استفاده می‌کرد.

.TP
\fB-alphamask=\fP\fIpgmfile\fP
این گزینه یک فایل PGM را نام می‌برد تا به عنوان ماسک شفافیت (آلفا) استفاده شود. فایل باید حاوی تصویری با ابعاد یکسان با تصویر ورودی باشد. برنامه \fBppmtoxpm\fP هر پیکسلی را که موقعیت آن در تصویر ماسک شفافیت حداکثر نیمه‌سفید باشد به عنوان شفاف علامت‌گذاری می‌کند.
.sp
اگر \fB-alphamask\fP را تعیین نکنید، \fBppmtoxpm\fP تمام پیکسل‌ها را در خروجی کدر (مات) می‌سازد.
.sp
دستور \fBppmcolormask\fP یکی از روش‌های ایجاد فایل ماسک شفافیت است. همچنین می‌توانید آن را با استخراج اطلاعات شفافیت از یک فایل XPM با گزینه \fB-alphaout\fP در دستور \fBxpmtoppm\fP ایجاد کنید.
.sp
گزینه‌های مشابهی در دیگر مبدل‌های Netpbm که قالب‌های دارای اطلاعات شفافیت را تبدیل می‌کنند نیز وجود دارد.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "ppmcolormask" (1)\c
\&,
.BR "xpmtoppm" (1)\c
\&,
.BR "pamdepth" (1)\c
\&,
.BR "ppm" (1)\c
\&
راهنمای XPM توسط Arnaud Le Hors \fIlehors@mirsa.inria.fr\fP

.UN author
.SH "نویسنده (AUTHOR)"
.PP
حق نشر (C) ۱۹۹۰ توسط Mark W. Snitily.
.PP
مجوز استفاده، کپی، تغییر و توزیع این نرم‌افزار و مستندات آن برای هر هدفی و بدون هزینه بدین وسیله اعطا می‌شود، مشروط بر اینکه اطلاعیه حق نشر بالا در تمامی نسخه‌ها ظاهر شود و هر دو اطلاعیه حق نشر و این مجوزنامه در مستندات پشتیبان آورده شوند. این نرم‌افزار «همان‌گونه که هست» و بدون هیچ‌گونه ضمانت صریح یا ضمنی ارائه شده است.
.PP
این ابزار برای شرکت Schlumberger Technologies، بخش ATE توسعه یافته بود و با اجازه آن‌ها همراه با اطلاعیه حق نشر و مجوز بالا در دسترس عموم قرار گرفته است.
.PP
ارتقا به XPM2 توسط Paul Breslaw از Mecasoft SA، زوریخ، سوئیس (\fIpaul@mecazh.uu.ch\fP)، در ۸ نوامبر ۱۹۹۰.
.PP
ارتقا به XPM نسخه ۳ توسط Arnaud Le Hors (\fIlehors@mirsa.inria.fr\fP)، در ۹ آوریل ۱۹۹۱.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmtoxpm.html
.PP