.\" 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 "Pnmtorle User Manual" 0 "07 March 2022" "netpbm documentation"

.SH "نام (NAME)"

pnmtorle \- تبدیل یک فایل تصویر Netpbm به یک فایل تصویر RLE.

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

\fBpnmtorle\fP

[\fB-header\fP]
[\fB-verbose\fP]
[\fB-alpha\fP]
[\fB-outfile=\fP\fIoutfile\fP]
[\fIpnmfile\fP]
.PP
کوتاه‌ترین اختصار یکتا برای گزینه‌ها قابل قبول است. می‌توانید به جای یک خط پیوند، از دو خط پیوند برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از فاصله خالی برای جدا کردن نام گزینه از مقدار آن استفاده کنید.


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
این برنامه فایل‌های تصویر Netpbm را به فایل‌های تصویر Utah RLE تبدیل می‌کند. می‌توانید یک ماسک شفافیت را نیز اضافه کنید. اگر ورودی فایلی شامل چند تصویر باشد، خروجی شامل چندین تصویر پیوسته‌شده‌ی RLE خواهد بود.
.PP
\fIpnmfile\fP نام فایل ورودی تصویر Netpbm است. اگر این آرگومان را مشخص نکنید، ورودی از ورودی استاندارد (Standard Input) دریافت می‌شود.
.PP
فایل RLE بسته به نوع ورودی Netpbm، شامل یک تصویر رنگی سه کاناله (۲۴ بیتی) یا یک تصویر تک‌کاناله طیف خاکستری (۸ بیتی) خواهد بود. اگر ورودی Netpbm رنگی باشد، خروجی RLE رنگی ۳ کاناله و ۲۴ بیتی است. اگر ورودی Netpbm طیف خاکستری یا سیاه و سفید باشد، خروجی RLE تک‌کاناله طیف خاکستری خواهد بود.


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


.TP
\fB-verbose\fP
این گزینه باعث می‌شود \fBpnmtorle\fP در حالت پرگو (verbose) کار کند. برنامه اطلاعات هدر (سرآیند) را در خطای استاندارد (Standard Error) می‌نویسد. در عمل، اطلاعات سرآیند چندانی در فایل‌های Netpbm ذخیره نمی‌شود، بنابراین این اطلاعات حداقل است.
.sp
پیش از Netpbm 10.98 (مارس ۲۰۲۲)، این گزینه تنها به صورت \fB-v\fP بود.

.TP
\fB-header\fP
این گزینه باعث می‌شود که برنامه هدر تصویر Netpbm را بدون تبدیل فایل، در خطای استاندارد تخلیه (dump) کند. این کار معادل استفاده از گزینه \fB-verbose\fP است، با این تفاوت که هیچ تبدیلی روی فایل انجام نمی‌شود.
.sp
پیش از Netpbm 10.98 (مارس ۲۰۲۲)، این گزینه تنها به صورت \fB-h\fP بود.

.TP
\fB-alpha\fP
این گزینه باعث می‌شود \fBpnmtorle\fP یک کانال شفافیت در تصویر خروجی بگنجاند. کانال شفافیت بر اساس تصویر تعیین می‌شود: هر جا که یک پیکسل سیاه باشد، مقدار شفافیت متناظر آن شفاف است. در بقیه نقاط، مقدار شفافیت کاملاً کدر (مات) است.

.TP
\fB-outfile\fP \fIoutfile\fP
اگر این گزینه را مشخص کنید، \fBpnmtorle\fP خروجی را در این فایل می‌نویسد. اگر \fIoutfile\fP برابر با \fB-\fP باشد یا \fB-outfile\fP را مشخص نکنید، \fBpnmtorle\fP خروجی را در خروجی استاندارد (Standard Output) می‌نویسد.
.sp
پیش از Netpbm 10.98 (مارس ۲۰۲۲)، این گزینه تنها به صورت \fB-o\fP بود و باید با یک فاصله (و نه علامت مساوی) از مقدار خود جدا می‌شد.



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

.nf
   pnmtorle -verbose file.ppm -outfile=file.rle
.fi
.PP
در حین اجرا در حالت پرگو، file.ppm را به فرمت RLE تبدیل کرده و داده‌های حاصل را در file.rle ذخیره می‌کند.

.nf
   pnmtorle -header file.pgm
.fi
.PP
تخلیه اطلاعات هدر فایل Netpbm با نام file.pgm.

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

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

.nf
Wes Barris,
Army High Performance Computing Research Center (AHPCRC)
Minnesota Supercomputer Center, Inc.
.fi
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pnmtorle.html
.PP