.\" 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 "Xpmtoppm User Manual" 1 "31 December 2011" "netpbm documentation"

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

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

\fBxpmtoppm\fP

[\fB--alphaout=\fP{\fIalpha-filename\fP,\fB-\fP}]
[\fB-verbose\fP]

[\fIxpmfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه
\fBxpmtoppm\fP
یک فایل نگاشت‌پیکسلی X11 (نسخه ۱ یا ۳ فرمت XPM) را به عنوان ورودی خوانده و یک تصویر PPM در خروجی تولید می‌کند.

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

.TP
\fB--alphaout=\fP\fIalpha-filename\fP
این گزینه باعث می‌شود که
\fBxpmtoppm\fP
یک فایل PBM حاوی ماسک شفافیت (transparency mask) تصویر ایجاد کند. اگر تصویر ورودی فاقد اطلاعات شفافیت باشد، فایل
\fIalpha-filename\fP
تنها حاوی مقادیر کاملاً سفید (کدر و مات) خواهد بود.
.sp
اگر گزینه
\fB--alphaout\fP
را مشخص نکنید،
\fBxpmtoppm\fP
هیچ فایل شفافیتی تولید نکرده و هرگونه اطلاعات شفافیت موجود در تصویر ورودی را نادیده می‌گیرد.
.sp
اگر به عنوان نام فایل کاراکتر
\fB-\fP
را مشخص کنید،
\fBxpmtoppm\fP
خروجی شفافیت را در خروجی استاندارد (Standard Output) نوشته و از تصویر اصلی صرف‌نظر می‌کند.
.sp
برای یک نمونه از نحوه استفاده از فایل خروجی شفافیت، ببینید:
.BR "pamcomp" (1)\c
\&.
.sp
برنامه
\fBxpmtoppm\fP
قادر به پردازش خطوط طولانی‌تر از ۸ کیلوبایت (8K) در ورودی XPM نیست. اگر طول خطی در فایل ورودی از این مقدار فراتر رود،
\fBxpmtoppm\fP
با یک پیام خطای متناسب به کار خود پایان می‌دهد. پیش از نسخه Netpbm 10.30 (اکتبر ۲۰۰۵)، این محدودیت برابر با ۲ کیلوبایت (2K) بود.

.TP
\fB--verbose\fP
برنامه
\fBxpmtoppm\fP
اطلاعات مربوط به فرآیند پردازش را در خطای استاندارد (Standard Error) چاپ می‌کند.

.UN limitations
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
برنامه
\fBxpmtoppm\fP
تنها مجموعه محدودی از ویژگی‌های نسخه ۳ فرمت XPM را شناسایی می‌کند؛ به این معنی که بسیاری از تصاویر معتبر XPM را به عنوان تصویر نامعتبر رد می‌کند.
.PP
تنها جایی که قرارگیری بلوک توضیحات (comment) معتبر است، شروع از ستون ۱ در سطر بلافاصله پس از "... static char" است.
.PP
علاوه بر این،
\fBppmtoxpm\fP
هر توضیح تک‌خطی را که از ستون ۱ در بخش جدول رنگ‌های فایل شروع شود، به درستی شناسایی می‌کند.
.PP
باید برای هر پیکسل یک نام‌رنگ پیش‌فرض جهت نمایش نوع رنگ وجود داشته باشد.
.PP
پیش از نسخه Netpbm 10.58 (مارس ۲۰۱۲)، وجود مقدار صفر بایت به ازای هر پیکسل باعث می‌شد برنامه با پیامی مبنی بر پایان زودهنگام فایل ورودی (premature EOF) با خطا متوقف شود.

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

.UN author
.SH "نویسندگان (AUTHORS)"
.PP
حق نشر (C) ۱۹۹۱ متعلق به Jef Poskanzer است.
.PP
ارتقا یافته برای کار با نگارش ۳ از XPM توسط Arnaud Le
Hors<\fIlehors@mirsa.inria.fr\fP>,
سه‌شنبه ۹ آوریل ۱۹۹۱.

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