.\" 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 "راهنمای کاربری Pnmtops" 1 "۲۱ فوریه ۲۰۲۴" "مستندات netpbm"

.SH "نام (NAME)"
pnmtops \- تبدیل تصاویر Netpbm (PNM/PAM) به زبان توصیف صفحه PostScript

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

\fBpnmtops\fP
[\fB-scale=\fP\fIs\fP]
[\fB-dpi=\fP\fIN\fP[\fBx\fP\fIN\fP]]
[\fB-imagewidth=\fP\fIn\fP]
[\fB-imageheight=\fP\fIn\fP]
[\fB-width=\fP\fIN\fP]
[\fB-height=\fP\fIN\fP]
[\fB-equalpixels\fP]
[\fB-bitspersample=\fP\fIN\fP]
[\fB-turn\fP|\fB-noturn\fP]
[\fB-rle\fP|\fB-runlength\fP]
[\fB-flate\fP]
[\fB-ascii85\fP]
[\fB-nocenter\fP|\fB-center\fP]
[\fB-nosetpage\fP|\fB-setpage\fP]
[\fB-level=\fP\fIN\fP]
[\fB-dict\fP]
[\fB-vmreclaim\fP]
[\fB-psfilter\fP]
[\fB-noshowpage\fP]
[\fB-verbose\fP]
[\fIpnmfile\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد.
می‌توانید به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید نام
گزینه و مقدار آن را به جای علامت مساوی با فاصله از هم جدا کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
است.
.PP
دستور
\fBpnmtops\fP
جریان تصویر Netpbm را به عنوان ورودی خوانده و خروجی پست‌اسکریپت کپسوله‌شده (EPSF) تولید می‌کند.
.PP
(توجه: افراد معمولاً این نام را به صورت «PostScript» می‌نویسند، اما ما در مستندات Netpbm از قواعد نگارش استاندارد استفاده می‌کنیم، بنابراین فقط حرف اول را بزرگ می‌نویسیم).
.PP
اگر فایل ورودی رنگی (PPM) باشد،
\fBpnmtops\fP
یک فایل پست‌اسکریپت رنگی تولید می‌کند. برخی مفسرهای پست‌اسکریپت توانایی پردازش پست‌اسکریپت رنگی را ندارند. اگر با چنین مفسری کار می‌کنید، ابتدا باید تصویر خود را با دستور
\fBppmtopgm\fP
پردازش و تبدیل کنید.
.PP
اگر هیچ گزینه‌ای برای ابعاد خروجی مشخص نکنید، ابعاد تصویر خروجی به گونه‌ای تعیین می‌شود که گویی گزینه
\fB-scale=1.0\fP
را مشخص کرده‌اید؛ این بدان معناست که تقریباً ۷۲ پیکسل از تصویر ورودی یک اینچ در خروجی تولید می‌کند (در صورتی که در صفحه جا شود).
.PP
از گزینه‌های
\fB-imagewidth\fP\fR،\fP
\fB-imageheight\fP\fR،\fP
\fB-equalpixels\fP\fR،\fP
\fB-width\fP\fR،\fP
\fB-height\fP
و
\fB-scale\fP
برای تنظیم این مقادیر استفاده کنید.
.PP
هر تصویر در جریان ورودی به یک برنامه پست‌اسکریپت تک‌صفحه‌ای کامل در خروجی تبدیل می‌شود. (ممکن است این بهترین روش برای ایجاد یک جریان پست‌اسکریپت چندصفحه‌ای نباشد؛ فردی مسلط به پست‌اسکریپت باید روی این موضوع کار کند).
.PP
خط بالای فایل تولیدشده توسط
\fBpnmtops\fP
یا «%!PS-Adobe-3.0 EPSF-3.0» است یا فقط «%!PS-Adobe-3.0». این اعداد نشان‌دهنده سطح زبان پست‌اسکریپت نیستند، بلکه نسخه مشخصات توضیحات DSC و مشخصات EPS پیاده‌سازی‌شده را نشان می‌دهند. سطح زبان پست‌اسکریپت در توضیح «%%LanguageLevel:» قرار دارد. در صورتی که گزینه
\fB-setpage\fP
را مشخص کنید،
\fBpnmtops\fP
عبارت «EPSF-3.0» را حذف می‌کند، زیرا اگر فایل از
\fBsetpagedevice\fP
استفاده کند، ادعای سازگاری با EPS نادرست خواهد بود.


.SS "پست‌اسکریپت کپسوله‌شده چیست؟ (What is Encapsulated Postscript?)"
.PP
پست‌اسکریپت کپسوله‌شده (EPSF) زیرمجموعه‌ای از پست‌اسکریپت است (یعنی مجموعه جریان‌هایی که با EPSF مطابقت دارند، زیرمجموعه‌ای از آن‌هایی هستند که با پست‌اسکریپت مطابقت دارند). این قالب به گونه‌ای طراحی شده است که یک جریان EPSF بتواند درون یک جریان پست‌اسکریپت دیگر گنجانده شود. یک دلیل متداول برای این کار، داشتن جریان EPSF حاوی تصویری است که می‌خواهید درون یک سند بزرگ‌تر قرار دهید.
.PP
اما EPSF یک فرمت تصویر نیست -- تبدیل از فرمت Netpbm به EPSF در واقع به معنای تولید برنامه‌ای برای چاپ آن تصویر Netpbm روی کاغذ است. توجه داشته باشید که روش‌های بی‌شماری برای چاپ تصویر روی کاغذ وجود دارد؛ گزینه‌های خط فرمان
\fBpnmtops\fP
به شما امکان می‌دهند برخی از آن‌ها را کنترل کنید.
.PP
یک سند پست‌اسکریپت کپسوله‌شده با DSC (قرارداد ساختاردهی سند) مطابقت دارد. این استاندارد (DSC) برخی توضیحات پست‌اسکریپت را تعریف می‌کند (این موارد از دیدگاه پست‌اسکریپت فقط کامنت هستند، اما از دیدگاه DSC ارزش معنایی دارند).
.PP
اطلاعات بیشتر درباره پست‌اسکریپت کپسوله‌شده در پیوند زیر موجود است:
.BR "http://www.tailrecursive.org/postscript/eps.html" (1)\c
\&.
.PP
بسیاری از ایده‌های موجود در
\fBpnmtops\fP
از ابزار
\fBbmeps\fP
اثر Dirk Krause گرفته شده است. بخش
.UR #seealso
همچنین ببینید
.UE
را مشاهده کنید.

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


.TP
\fB-imagewidth\fP\fR،\fP \fB-imageheight\fP
عرض و ارتفاع مورد نظر تصویر روی صفحه را بر حسب اینچ مشخص می‌کند.
نسبت تصویر حفظ می‌شود؛ بنابراین اگر هر دوی این گزینه‌ها را مشخص کنید،
تصویر روی صفحه بزرگ‌ترین تصویری خواهد بود که درون کادری با این ابعاد جا می‌گیرد.
.sp
اگر این ابعاد بزرگ‌تر از اندازه صفحه باشند، خروجی پست‌اسکریپت از صفحه بیرون می‌زند.
.sp
نمی‌توانید از
\fBimagewidth\fP
یا
\fBimageheight\fP
همراه با
\fB-scale\fP
یا
\fB-equalpixels\fP
استفاده کنید.

.TP
\fB-equalpixels\fP
این گزینه باعث می‌شود تصویر خروجی تعداد پیکسل‌های برابری با تصویر ورودی داشته باشد. بنابراین اگر دستگاه خروجی دارای دقت ۶۰۰ dpi باشد و عرض تصویر شما ۳۰۰۰ پیکسل باشد، عرض تصویر خروجی ۵ اینچ خواهد بود.
.sp
نمی‌توانید از
\fB-equalpixels\fP
همراه با
\fB-imagewidth\fP\fR،\fP
\fB-imageheight\fP
یا
\fB-scale\fP
استفاده کنید.

.TP
\fB-bitspersample=\fP\fIN\fP
این گزینه تعداد بیت‌های هر مؤلفه از هر پیکسل را در خروجی پست‌اسکریپت تعیین می‌کند. به طور پیش‌فرض،
\fBpnmtops\fP
مقداری را متناسب با بیشینه مقدار روشنایی (maxval) در ورودی PNM و با رعایت محدودیت‌های زبان پست‌اسکریپت انتخاب می‌کند. به ویژه، اگر سطح ۲ پست‌اسکریپت
(\fB-level\fP)
را به همراه فیلترهای توکار پست‌اسکریپت
(\fB-psfilter\fP)
انتخاب نکنید، حداکثر بیت در هر پیکسل ۸ خواهد بود.
.sp
مقدار باید ۱، ۲، ۴، ۸ یا ۱۲ باشد، که مقدار ۱۲ محدود به حالتی است که در بالا توضیح داده شد.
.sp
این گزینه در Netpbm 10.51 (ژوئن ۲۰۱۰) اضافه شده است.

.TP
\fB-scale\fP
اندازه تصویر را روی صفحه مشخص می‌کند. مقدار آن بیانگر تعداد اینچ‌هایی از تصویر خروجی است که می‌خواهید ۷۲ پیکسل از ورودی تولید کند.
.sp
اما
\fBpnmtops\fP
این عدد را به مقداری گرد می‌کند که مضرب صحیحی از پیکسل‌های دستگاه خروجی باشد. برای مثال، اگر دستگاه خروجی ۳۰۰ dpi باشد و شما
\fB-scale=1.0\fP
را مشخص کنید، ۷۵ پیکسل (و نه ۷۲ پیکسل) از ورودی به یک اینچ خروجی تبدیل می‌شود (۴ پیکسل خروجی به ازای هر پیکسل ورودی). توجه داشته باشید که گزینه
\fB-dpi\fP
به
\fBpnmtops\fP
می‌گوید دستگاه خروجی چند پیکسل در هر اینچ تولید می‌کند.
.sp
اگر اندازه مشخص‌شده در صفحه جا نشود (که توسط گزینه‌های
\fB-width\fP
و
\fB-height\fP
یا اندازه پیش‌فرض صفحه یعنی ۸.۵ در ۱۱ اینچ سنجیده می‌شود)،
\fBpnmtops\fP
گزینه
\fB-scale\fP
را نادیده می‌گیرد، یک هشدار صادر می‌کند و تصویر را برای قرارگیری در صفحه مقیاس‌بندی می‌کند.

.TP
\fB-dpi=\fP\fIN\fP[\fBx\fP\fIN\fP]
.sp
این گزینه وضوح تصویر دستگاه خروجی را بر حسب نقطه در اینچ (DPI) مشخص می‌کند. مقدار پیش‌فرض ۳۰۰ dpi است. در تئوری، پست‌اسکریپت مستقل از دستگاه است و نیازی به نگرانی در این مورد نیست، اما در عمل اگر پیکسل‌های دستگاه و پیکسل‌های تصویر هماهنگ نباشند، رندر شطرنجی (رستر) آن ممکن است دارای خطوط و نوارهای نازیبا شود.
.sp
همچنین این گزینه برای عملکرد گزینه
\fBequalpixels\fP
بسیار حیاتی است.
.sp
اگر مقدار را به صورت
\fIN\fP\fBx\fP\fIN\fP
مشخص کنید، عدد اول وضوح افقی و عدد دوم وضوح عمودی است. اگر فقط یک عدد
\fIN\fP
را مشخص کنید، همان وضوح در هر دو جهت اعمال می‌شود.

.TP
\fB-width\fP\fR،\fP \fB-height\fP
این گزینه‌ها ابعاد صفحه‌ای را که خروجی قرار است روی آن چاپ شود، بر حسب اینچ مشخص می‌کنند. این کار می‌تواند بر اندازه تصویر خروجی تأثیر بگذارد.
.sp
البته هنگامی که گزینه‌های
\fB-imagewidth\fP\fR،\fP
\fB-imageheight\fP
یا
\fB-equalpixels\fP
را مشخص کنید، اندازه صفحه هیچ تأثیری نخواهد داشت.
.sp
این گزینه‌ها همچنین ممکن است بر موقعیت تصویر روی صفحه و حتی کاغذی که توسط چاپگر/پلاتر هنگام چاپ خروجی انتخاب (یا برش) داده می‌شود تأثیر بگذارند. گزینه
\fB-nosetpage\fP
را ببینید.
.sp
مقدار پیش‌فرض ۸.۵ در ۱۱ اینچ است.

.TP
\fB-turn\fP

.TP
\fB-noturn\fP
این گزینه‌ها چرخش ۹۰ درجه‌ای تصویر را کنترل می‌کنند. به طور معمول، اگر چرخاندن تصویر باعث جاگیری بهتر آن در صفحه شود (برای مثال عرض تصویر بیشتر از ارتفاع آن باشد، اما ارتفاع صفحه بیشتر از عرض آن باشد)، تصویر به طور خودکار می‌چرخد تا بهتر در صفحه جا شود. اگر گزینه
\fB-turn\fP
را مشخص کنید،
\fBpnmtops\fP
تصویر را صرف‌نظر از شکل آن می‌چرخاند؛ اگر
\fB-noturn\fP
را مشخص کنید،
\fBpnmtops\fP
تصویر را تحت هیچ شرایطی
\fIنمی‌چرخاند\fP.

.TP
\fB-rle\fP

.TP
\fB-runlength\fP
این گزینه‌های یکسان به
\fBpnmtops\fP
دستور می‌دهند که از فشرده‌سازی طول اجرا (RLE) در کدگذاری تصویر در برنامه پست‌اسکریپت استفاده کند. این کار ممکن است در صورت کند بودن اتصال رایانه به چاپگر در زمان صرفه‌جویی کند؛ اما به طور معمول زمان پردازش چاپگر غالب است، بنابراین
\fB-rle\fP
تأثیری ندارد (و در نبود بافرسازی، حتی ممکن است کار را کندتر کند).
.sp
با این حال، این کار می‌تواند حجم برنامه پست‌اسکریپت را به طور چشمگیری کاهش دهد.
.sp
این گزینه معمولاً در تصاویر رنگی همراه با
\fB-psfilter\fP
هیچ کمکی نمی‌کند، زیرا در آن حالت، برنامه پست‌اسکریپت تولیدشده توسط
\fBpnmtops\fP
مقادیر قرمز، سبز و آبی هر پیکسل را کنار هم قرار می‌دهد، به این معنی که توالی‌های طولانی از بایت‌های یکسان تنها در حالت نامحتمل یکسان بودن مقادیر قرمز، سبز و آبی برای مجموعه‌ای از پیکسل‌های مجاور رخ می‌دهد. اما بدون
\fB-psfilter\fP\fR،\fP
برنامه پست‌اسکریپت ابتدا تمام مقادیر قرمز، سپس تمام مقادیر سبز و بعد تمام مقادیر آبی را قرار می‌دهد، بنابراین توالی‌های طولانی در هر جایی که بخش‌های طولانی از یک رنگ وجود داشته باشد ظاهر می‌شوند.
.sp
در ادامه توضیحی از Jef Poskanzer آمده است درباره اینکه چرا گزینه
\fB-rle\fP
را ابداع کرد:

.RS
چند ساعت وقت صرف اصلاح فیلتر pbmtops خود کردم تا خروجی پست‌اسکریپت با کدگذاری طول اجرا تولید کند. نتایج برای من چشمگیر نیست - بله، فایل‌ها کوچک‌تر شده‌اند، اما زمان چاپ تقریباً یکسان است. البته من از طریق شبکه چاپ می‌کنم. اگر با خط سریال کار می‌کردید، این یک موفقیت بزرگ بود. من یک برنامه نمونه تولیدشده توسط فیلترم را ضمیمه کرده‌ام. اگر کسی روشی برای بهبود کد می‌بیند، لطفاً به من اطلاع دهد، من چندان هکر حرفه‌ای پست‌اسکریپت نیستم. این نسخه از pbmtops در ماه اکتبر در comp.sources.misc و expo.lcs.mit.edu توزیع خواهد شد. - جف (Jef)
.RE
.sp
این متن از تالار گفتگویی درباره پست‌اسکریپت
(http://www.lngpstscrpt.tk/re-postscript-run-length-encoding-again)
استخراج‌شده در اکتبر ۲۰۱۰ است. جف گزینه ‎-rle را در اوت ۱۹۸۸ اضافه کرد. در آن روزها، خطوط RS-232 (که در نقل قول به عنوان «سریال» به آن‌ها اشاره شده) معمولاً دارای سرعت ۹۶۰۰ بیت بر ثانیه بودند. خطوط ۲۴۰۰ بیت بر ثانیه نیز هنوز وجود داشتند. آنچه در این نقل قول «شبکه» نامیده شده احتمالاً یک اتصال اترنت ۱۰ مگابیت بر ثانیه است.

.TP
\fB-flate\fP
این گزینه به
\fBpnmtops\fP
دستور می‌دهد از فشرده‌سازی «flate» استفاده کند (یعنی فشرده‌سازی از طریق کتابخانه «Z» -- مشابه فرمت PNG).
.sp
برای اطلاعات درباره فشرده‌سازی به طور کلی، گزینه
\fB-rle\fP
را ببینید.
.sp
در صورت تعیین
\fB-flate\fP\fR،\fP
باید گزینه
\fB-psfilter\fP
را نیز مشخص کنید.
.sp
نسخه‌های جدیدی از
\fBpnmtops\fP
وجود دارند که قادر به انجام فشرده‌سازی flate نیستند؛ این نسخه‌ها بدون کتابخانه Z ساخته شده‌اند و طوری کامپایل شده‌اند که نیازی به آن نداشته باشند. اگر از چنین نسخه‌ای استفاده می‌کنید، در صورت تعیین
\fB-flate\fP
برنامه با یک پیام خطای توضیحی متوقف می‌شود.
.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شده است.
.sp
پیش از Netpbm 10.32 (فوریه ۲۰۰۶)، امکان تعیین همزمان
\fB-rle\fP
و
\fB-flate\fP
وجود نداشت.


.TP
\fB-ascii85\fP
به طور پیش‌فرض،
\fBpnmtops\fP
از کدگذاری «asciihex» برای تصویر شطرنجی (رستر) استفاده می‌کند. تصویر شطرنجی جریانی از بیت‌ها است، در حالی که برنامه پست‌اسکریپت یک متن است، بنابراین باید یک روش کدگذاری از بیت‌ها به متن وجود داشته باشد. کدگذاری asciihex همان نمایش رایج هگزادسیمال بیت‌ها است؛ برای مثال ۸ بیت با مقدار ۱ به صورت دو نویسه «FF» کدگذاری می‌شوند.
.sp
با استفاده از گزینه
\fB-ascii85\fP\fR،\fP
برنامه
\fBpnmtops\fP
در عوض از کدگذاری «ascii85» استفاده می‌کند. این کدگذاری ۳۲ بیت را در پنج نویسه متنی فشرده می‌کند. بنابراین، برای یک تصویر شطرنجی یکسان، متن کمتری نسبت به asciihex تولید می‌کند. اما ascii85 در سطح ۱ پست‌اسکریپت پشتیبانی نمی‌شود، در حالی که asciihex پشتیبانی می‌شود.
.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شده است.

.TP
\fB-psfilter\fP
برنامه
\fBpnmtops\fP
می‌تواند دو نوع مختلف از برنامه‌های پست‌اسکریپت کپسوله‌شده را برای نمایش تصویر تولید کند. به طور پیش‌فرض، برنامه‌ای تولید می‌کند که دستور
\fBreadstring\fP
را به صورت سفارشی بازتعریف کرده و به فیلترهای توکار پست‌اسکریپت متکی نیست. اما با گزینه
\fB-psfilter\fP\fR،\fP
دستور
\fBpnmtops\fP
کاری به
\fBreadstring\fP
ندارد و از فیلترهای توکار پست‌اسکریپت
\fB/ASCII85Decode\fP\fR،\fP
\fB/ASCIIHexDecode\fP\fR،\fP
\fB/RunLengthDecode\fP
و
\fB/FlateDecode\fP
استفاده می‌کند.
.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شده است. پیش از آن،
\fBpnmtops\fP
همیشه از
\fBreadstring\fP
سفارشی استفاده می‌کرد.
.sp
کد سفارشی توانایی انجام کدگذاری flate یا ascii85 را ندارد، بنابراین در صورت نیاز به آن‌ها باید از
\fB-psfilter\fP
استفاده کنید (گزینه‌های
\fB-flate\fP
و
\fB-ascii85\fP
را ببینید).

.TP
\fB-level\fP
این گزینه سطح (شماره نسخه) زبان پست‌اسکریپت مورد استفاده توسط
\fBpnmtops\fP
را تعیین می‌کند. به طور پیش‌فرض،
\fBpnmtops\fP
از سطح ۲ استفاده می‌کند. برخی قابلیت‌های
\fBpnmtops\fP
تنها در سطوح بالاتر پست‌اسکریپت در دسترس هستند؛ بنابراین اگر سطحی بیش از حد پایین را برای تصویر و گزینه‌های خود تعیین کنید،
\fBpnmtops\fP
با خطا متوقف می‌شود. برای مثال،
\fBpnmtops\fP
نمی‌تواند تصویر رنگی را در سطح ۱ پردازش کند.
.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شده است. پیش از آن،
\fBpnmtops\fP
همیشه از سطح ۲ استفاده می‌کرد.

.TP
\fB-dict\fP
این گزینه باعث می‌شود برنامه پست‌اسکریپت یک دیکشنری مجزا برای متغیرهای محلی خود ایجاد کرده و هنگام خروج آن را از پشته حذف کند.
.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شده است.

.TP
\fB-vmreclaim\fP
این گزینه باعث می‌شود برنامه پست‌اسکریپت هنگام خروج، فرآیند آزادسازی حافظه (Garbage Collection) را اجبار کند.
.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شده است.

.TP
\fB-nocenter\fP
به طور پیش‌فرض،
\fBpnmtops\fP
تصویر را در مرکز صفحه خروجی قرار می‌دهد. با استفاده از گزینه
\fB-nocenter\fP
می‌توانید کاری کنید که تصویر به جای مرکز، در گوشه پایین سمت چپ صفحه قرار گیرد. این ویژگی برای برنامه‌هایی مناسب است که می‌توانند فایل‌های پست‌اسکریپت را در بر گیرند اما با تصاویری که در گوشه پایین سمت چپ قرار نگرفته‌اند سازگاری ندارند.
.sp
اگر می‌خواهید تصویر را در موقعیت دلخواهی روی صفحه قرار دهید، از
\fBpamcomp\fP
برای ایجاد تصویری از کل صفحه استفاده کنید به طوری که تصویر مورد نظر در جای مناسب قرار گیرد و بقیه صفحه سفید باشد، سپس از
\fBpnmtops\fP
برای تبدیل نتیجه به پست‌اسکریپت کپسوله‌شده استفاده کنید.
.sp
برای سازگاری با گذشته،
\fBpnmtops\fP
گزینه
\fB-center\fP
را می‌پذیرد اما این گزینه هیچ تأثیری ندارد.

.TP
\fB-setpage\fP
این گزینه باعث می‌شود
\fBpnmtops\fP
یک دستورالعمل «setpagedevice» را در خروجی بگنجاند. این کار باعث نقض مشخصات پست‌اسکریپت کپسوله‌شده EPSF می‌شود، اما اگر قصد ندارید فایل را به صورت کپسوله‌شده استفاده کنید، ممکن است دقیقاً همان چیزی باشد که نیاز دارید. این دستورالعمل به چاپگر/پلاتر می‌گوید از چه اندازه کاغذی استفاده کند (یا آن را برش دهد). ابعادی که در این دستورالعمل مشخص می‌شود همان ابعادی است که توسط گزینه‌های
\fB-width\fP
و
\fB-height\fP
انتخاب شده یا به طور پیش‌فرض در نظر گرفته شده است.
.sp
از ژانویه تا مه ۲۰۰۲، رفتار پیش‌فرض گنجاندن «setpagedevice» بود و این گزینه وجود نداشت. پیش از ژانویه ۲۰۰۲، راهی برای گنجاندن «setpagedevice» وجود نداشت و هیچ‌یک از گزینه‌های
\fB-setpage\fP
یا
\fB-nosetpage\fP
وجود نداشتند.

.TP
\fB-nosetpage\fP
به
\fBpnmtops\fP
دستور می‌دهد دستورالعمل «setpagedevice» را در خروجی نگنجاند. این رفتار پیش‌فرض است، بنابراین این گزینه تأثیری ندارد.
.sp
برای پیشینه این گزینه، به گزینه
\fB-setpage\fP
مراجعه کنید.

.TP
\fB-noshowpage\fP
به
\fBpnmtops\fP
دستور می‌دهد دستورالعمل «showpage» را در خروجی نگنجاند. به طور پیش‌فرض،
\fBpnmtops\fP
یک دستور «showpage» در انتهای برنامه EPSF می‌گنجاند. طبق مشخصات EPSF، این کار مجاز است و برنامه‌ای که EPSF را درون خود می‌گنجاند باید showpage را بازتعریف کند تا رفتار ناخواسته‌ای رخ ندهد. اما اغلب ساده‌تر است که showpage وجود نداشته باشد.
.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شده است. نسخه‌های قبلی
\fBpnmtops\fP
همیشه showpage را اضافه می‌کردند.

.TP
\fB-showpage\fP
به
\fBpnmtops\fP
دستور می‌دهد دستورالعمل «showpage» را در انتهای خروجی EPSF بگنجاند. این رفتار پیش‌فرض است، بنابراین این گزینه تأثیری ندارد.
.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شده است.

.TP
\fB-verbose\fP
پیام‌های اطلاعاتی درباره فرآیند تبدیل و نتیجه آن را نمایش می‌دهد.



.UN limitations
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
اگر بیشینه مقدار روشنایی/رنگ (maxval) در تصویر PNM بزرگ‌تر از ۲۵۵ باشد،
\fBpnmtops\fP
خروجی با وضوح ۸ بیت در هر نمونه تولید می‌کند مگر اینکه گزینه
\fB-psfilter\fP
را مشخص کنید، حتی با وجود اینکه سطح ۲ پست‌اسکریپت از قالب ۱۲ بیت در هر نمونه پشتیبانی می‌کند. کد سفارشی تولید رستر در
\fBpnmtops\fP
قالب ۱۲ بیتی را نمی‌شناسد.

.UN applications
.SH "کاربردها (APPLICATIONS)"
.PP
می‌توانید از خروجی پست‌اسکریپت به روش‌های گوناگونی استفاده کنید. بسیاری از چاپگرها ورودی پست‌اسکریپت را می‌پذیرند (اما همچنان به نوعی درایور چاپگر برای انتقال پست‌اسکریپت به چاپگر نیاز دارید).
.PP
همچنین برنامه Ghostscript وجود دارد (که بخشی از Netpbm نیست)، که پست‌اسکریپت را به عنوان ورودی دریافت کرده و یک جریان خروجی برای کنترل هر یک از مدل‌های بی‌شمار چاپگرها تولید می‌کند (اما همچنان برای انتقال آن جریان به چاپگر به نوعی درایور چاپگر نیاز دارید).
.PP
برنامه Ghostscript همچنین می‌تواند فایل پست‌اسکریپت را به PDF تبدیل کند که فرمت بسیار محبوبی برای اسناد و تصاویر است. برای این کار از نوع دستگاه خروجی
\fBpdfwrite\fP
در Ghostscript استفاده کنید. برنامه
\fBps2pdf\fP
(توزیع‌شده همراه Ghostscript) روشی آسان برای اجرای Ghostscript با
\fBpdfwrite\fP
است. برای اطلاعات بیشتر درباره تبدیل به و از PDF، بخش
.UR index.html#document
نرم‌افزارهای اسناد/گرافیک
.UE
را ببینید.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.PP
.BR "\fBbmpp\fP" (1)\c
تصاویر را از فرمت Netpbm و سایر فرمت‌ها به پست‌اسکریپت کپسوله‌شده تبدیل می‌کند.
.PP
برنامه
\fBbmpp\fP
دارای چند قابلیت است که
\fBpnmtops\fP
ندارد، مانند توانایی استفاده از فشرده‌سازی LZW.
.PP
.BR "pnm" (1)\c
\fR،\fP
\fBgs\fP\fR،\fP
.BR "psidtopgm" (1)\c
\fR،\fP
.BR "pstopnm" (1)\c
\fR،\fP
.BR "pbmtolps" (1)\c
\fR،\fP
.BR "pbmtoepsi" (1)\c
\fR،\fP
.BR "pbmtopsg3" (1)\c
\fR،\fP
.BR "ppmtopgm" (1)


.UN history
.SH "تاریخچه (HISTORY)"
.PP
حق نشر \(co ۱۹۸۹، ۱۹۹۱ متعلق به Jef Poskanzer.
.PP
ویرایش‌شده در نوامبر ۱۹۹۳ توسط Wolfgang Stuerzlinger،
\fIwrzl@gup.uni-linz.ac.at\fP
.PP
این برنامه در ابتدا
\fBpbmtops\fP
بود. در اکتبر ۱۹۸۸ به
\fBpgmtops\fP
تغییر نام داد و در ژانویه ۱۹۹۱ با
\fBppmtops\fP
ادغام شد تا
\fBpnmtops\fP
را تشکیل دهد. برنامه
\fBppmtops\fP
مدتی پیش از سپتامبر ۱۹۸۹ به وجود آمده بود.

.UN index
.SH "فهرست مطالب (Table Of Contents)"

.IP \(bu

.UR #synopsis
خلاصه دستور (SYNOPSIS)
.UE
\&
.IP \(bu

.UR #description
توضیحات (DESCRIPTION)
.UE
\&
.IP \(bu

.UR #options
گزینه‌ها (OPTIONS)
.UE
\&
.IP \(bu

.UR #limitations
محدودیت‌ها (LIMITATIONS)
.UE
\&
.IP \(bu

.UR #applications
کاربردها (APPLICATIONS)
.UE
\&
.IP \(bu

.UR #seealso
همچنین ببینید (SEE ALSO)
.UE
\&
.IP \(bu

.UR #history
تاریخچه (HISTORY)
.UE
\&
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pnmtops.html
.PP