\
.\" 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 "Rletopnm User Manual" 0 "13 April 2000" "netpbm documentation"

.SH "نام (NAME)"
rletopnm \- تبدیل یک فایل تصویر RLE از مجموعه ابزارهای رستر یوتا (Utah Raster Tools) به فایل تصویر PNM

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

\fBrletopnm\fP

[\fB--alphaout=\fP{\fIalpha-filename\fP,\fB-\fP}]
[\fB--headerdump\fP|\fB-h\fP]

[\fB--verbose\fP|\fB-v\fP]

[\fIrlefile\fP|\fB-\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها مخفف کرد، و گزینه‌ها و آرگومان‌ها می‌توانند با هر ترتیبی قرار گیرند.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه \fBrletopnm\fP فایل‌های تصویر RLE از Utah Raster Toolkit را به فایل‌های تصویر PNM تبدیل می‌کند. برنامه \fBrletopnm\fP از چهار نوع فایل RLE پشتیبانی می‌کند: Grayscale (داده‌های ۸ بیتی، بدون نگاشت رنگ)، Pseudocolor (داده‌های ۸ بیتی با نگاشت رنگ)، Truecolor (داده‌های ۲۴ بیتی با نگاشت رنگ) و Directcolor (داده‌های ۲۴ بیتی، بدون نگاشت رنگ). برنامه \fBrletopnm\fP برای تمامی این موارد به جز حالت Grayscale یک فایل PPM تولید می‌کند؛ برای حالت Grayscale یک فایل PGM ایجاد می‌نماید.
.PP
شناسه \fIrlefile\fP فایل ورودی RLE است. اگر این شناسه مشخص نشود یا \fB-\fP باشد، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود.

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


.TP
\fB--alphaout=\fP\fIalpha-filename\fP
برنامه \fBrletopnm\fP یک فایل PGM (نقشه خاکستری قابل حمل) شامل مقادیر کانال شفافیت تصویر ورودی ایجاد می‌کند. اگر تصویر ورودی فاقد کانال شفافیت باشد، فایل \fIalpha-filename\fP حاوی تماماً مقادیر صفر (شفاف) خواهد بود. اگر گزینه \fB--alphaout\fP را مشخص نکنید، \fBrletopnm\fP هیچ فایل شفافیتی تولید نمی‌کند و اگر تصویر ورودی دارای کانال شفافیت باشد، \fBrletopnm\fP به سادگی آن را نادیده می‌گیرد.
.sp
اگر نام فایل را \fB-\fP تعیین کنید، \fBrletopnm\fP خروجی شفافیت را در خروجی استاندارد می‌نویسد و از خود تصویر صرف‌نظر می‌کند.
.sp
برای مشاهده یک روش استفاده از فایل خروجی شفافیت، به
.BR "pamcomp" (1)\c
\& مراجعه کنید.

.TP
\fB--verbose\fP
این گزینه باعث می‌شود \fBrletopnm\fP در حالت پرگویی (verbose) اجرا شود. این ابزار پیام‌هایی درباره اقداماتی که انجام می‌دهد، شامل محتوای سرآیند تصویر RLE را در خطای استاندارد چاپ می‌کند.

.TP
\fB--headerdump\fP
این گزینه باعث می‌شود \fBrletopnm\fP در حالت تخلیه سرآیند (header dump) اجرا شود. این ابزار محتوای سرآیند تصویر RLE را در خطای استاندارد چاپ می‌کند، اما هیچ خروجی دیگری تولید نخواهد کرد.



.UN examples
.SH "مثال‌ها (EXAMPLES)"


.IP \(bu
در حین اجرا در حالت پرگویی، تبدیل lenna.rle به قالب PPM و ذخیره تصویر حاصل به عنوان lenna.ppm:

.nf
\f(CW
    rletopnm --verbose lenna.rle >lenna.ppm
\fP
.fi

.IP \(bu
تخلیه اطلاعات سرآیند فایل RLE با نام file.rle:

.nf
\f(CW
    rletopnm --headerdump file.rle
\fP
.fi

.IP \(bu
تبدیل فایل RLE به نام dart.rle به قالب PPM با نام dart.ppm. ذخیره کانال شفافیت dart.rle به عنوان dartalpha.pgm (اگر dart.rle فاقد کانال شفافیت باشد، یک ماسک کاملاً شفاف به عنوان dartalpha.pgm ذخیره می‌شود):

.nf
\f(CW
    rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm
\fP
.fi



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmtorle" (1)\c
\&،
.BR "pnmconvol" (1)\c
\&،
.BR "pnm" (1)\c
\&،
.BR "ppm" (1)\c
\&،
.BR "pgm" (1)\c
\&

.UN author
.SH "نویسنده (AUTHOR)"

Wes Barris
مرکز تحقیقات رایانش با کارایی بالا ارتش (AHPCRC)
Minnesota Supercomputer Center, Inc.
.PP
تغییرات توسط Eric Haines برای تولید قالب‌های خام (raw) و متنی ساده (plain).
.PP
تغییرات توسط Bryan Henderson برای ایجاد فایل‌های شفافیت و استفاده از گزینه‌های یادافزا (mnemonic).
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm تحت عنوان 'makeman' از منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/rletopnm.html
.PP