\
.\" 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 "Ppmtoicr User Manual" 0 "17 July 2022" "netpbm documentation"

.SH "نام (NAME)"

ppmtoicr \- تبدیل یک تصویر PPM به قالب NCSA ICR

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

\fBppmtoicr\fP

[\fB-windowname\fP \fIname\fP]

[\fB-expand\fP \fIexpand\fP]

[\fB-display\fP \fIdisplay\fP]

[\fIppmfile\fP]
.PP
حداقل مخفف یکتای هر گزینه پذیرفته می‌شود. می‌توانید به جای تک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید از فاصله خالی به جای علامت مساوی برای جداسازی نام گزینه از مقدار آن استفاده نمایید.


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBppmtoicr\fP یک فایل PPM را به عنوان ورودی می‌خواند و یک فایل گرافیکی NCSA Telnet Interactive Color Raster را در خروجی تولید می‌کند.

اگر \fIppmfile\fP تعیین نشود، \fBppmtoicr\fP از ورودی استاندارد می‌خواند.
.PP
‏Interactive Color Raster (ICR) پروتکلی برای نمایش گرافیک‌های شطرنجی بر روی صفحه نمایش ایستگاه‌های کاری است. این پروتکل در NCSA Telnet برای مکینتاش نسخه ۲.۳ پیاده‌سازی شده است. پروتکل ICR ویژگی‌های مشترکی با پروتکل شبیه‌سازی ترمینال گرافیکی Tektronix دارد؛ برای نمونه، از دنباله‌های گریز (escape sequences) برای کنترل نمایشگر استفاده می‌شود.
.PP
دستور \fBppmtoicr\fP دنباله‌های مناسب را برای ایجاد پنجره‌ای با ابعاد تصویر ورودی، ایجاد یک جدول رنگ (colormap) با حداکثر ۲۵۶ رنگ بر روی نمایشگر، و سپس بارگذاری داده‌های تصویر در پنجره خروجی می‌دهد.
.PP
توجه داشته باشید که هیچ ابزاری به نام icrtoppm وجود ندارد \- این تبدیل یک‌طرفه است.

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


.TP
\fB-windowname\fP \fIname\fP
خروجی در پنجره \fIname\fP نمایش داده خواهد شد.
.sp
\fIname\fP باید شامل نویسه‌های قابل چاپ باشد و نه '^'.
.sp
پیش‌فرض این است که در صورت تعیین در خط فرمان از نام فایل ورودی، یا در صورت دریافت ورودی از ورودی استاندارد از "untitled" استفاده شود. در حالت اول، هر نویسه غیرقابل چاپ یا '^' در نام فایل، در نام پنجره تبدیل به '.' می‌شود.
    
.TP
\fB-expand\fP \fIexpand\fP
خروجی با ضریب \fIexpand\fP در صفحه نمایش گسترش می‌یابد (به عنوان مثال، مقدار ۲ باعث می‌شود به ازای هر پیکسل ورودی، چهار پیکسل نمایش داده شود).

.TP
\fB-display\fP \fIdisplay\fP
خروجی روی صفحه شماره‌گذاری‌شده با \fIdisplay\fP نمایش داده خواهد شد.



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

برای نمایش یک فایل PPM با نام \fBppmfile\fP با استفاده از این پروتکل:

.nf
    ppmtoicr ppmfile
.fi

این دستور پنجره‌ای با نام \fIppmfile\fP بر روی صفحه نمایش با ابعاد مناسب برای \fIppmfile\fP ایجاد می‌کند، یک جدول رنگی با حداکثر ۲۵۶ رنگ ساخته و بارگذاری می‌نماید، و تصویر را درون پنجره منتقل می‌کند. با توالی زیر نیز می‌توانید به همان نتیجه دست یابید:

.nf
    ppmtoicr ppmfile > filename
    cat filename
.fi
.PP
برای نمایش یک فایل GIF با استفاده از این پروتکل در پنجره‌ای با عنوان برگرفته از نام فایل ورودی و بزرگ‌نمایی تصویر نمایش‌یافته با ضریب ۲:

.nf
    giftopnm giffile | ppmtoicr -windowname=giffile -expand=2
.fi

.UN limitations
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
این پروتکل برای افزایش سرعت نمایش، به طور مکرر از فراخوانی‌های ()fflush استفاده می‌کند. اگر خروجی را برای نمایش بعدی از طریق \fBcat\fP در یک فایل ذخیره کنید، \fBppmtoicr\fP بسیار کندتر ترسیم خواهد شد. در هر دو حالت، افزایش حد اندازه بلوک (blocksize limit) در نمایشگر، سرعت ارسال داده را به میزان چشمگیری افزایش می‌دهد.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "ppm" (1)\c
\&
.PP
NCSA Telnet for the Macintosh, University of Illinois at
Urbana-Champaign (1989)

.UN history
.SH "تاریخچه (HISTORY)"
.PP
تا پیش از Netpbm 10.71 (ژوئن ۲۰۱۵)، یک گزینه \fB-rle\fP در مستندات ثبت شده بود که ادعا می‌شد باعث فشرده‌سازی خروجی با کدگذاری طول اجرا (run length encoding) می‌شود. اما به دلیل یک باگ ساده در کد پردازش گزینه‌ها، این گزینه هیچ‌گاه اثری نداشت. همچنین به نظر نمی‌رسید کد فشرده‌سازی در عمل کار کند و برطرف کردن آن نیاز به کار زیادی داشت. از آنجا که بعید به نظر می‌رسید کسی دوباره از این برنامه استفاده کند، چه رسد به اینکه بخواهد از کدگذاری طول اجرا استفاده کند، به جای اصلاح کد، آن را از مستندات حذف کردیم.

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

حق نشر (C) ۱۹۹۰ متعلق به Kanthan Pillay (\fIsvpillay@Princeton.EDU\fP)،
رایانش و فناوری اطلاعات دانشگاه پرینستون (Princeton University Computing and Information Technology).
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از روی منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmtoicr.html
.PP