.\" 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 "Pstopnm User Manual" 0 "21 February 2024" "netpbm documentation"

.SH "نام (NAME)"
pstopnm \- تبدیل فایل PostScript به تصویر PNM

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

\fBpstopnm\fP

[\fB-stdout\fP]

[\fB-forceplain\fP]

[\fB-help\fP]

[\fB-dpi=\fP\fIdpi\fP]

[\fB-xsize=\fP\fIpixels\fP]
[\fB-ysize=\fP\fIpixels\fP]

[\fB-xborder=\fP\fIfrac\fP]
[\fB-yborder=\fP\fIfrac\fP]
[\fB-landscape\fP]

[\fB-portrait\fP]

[\fB-nocrop\fP]

[\fB-pbm\fP

|\fB-pgm\fP

|\fB-ppm\fP]

[\fB-llx=\fP\fIs\fP]
[\fB-lly=\fP\fIs\fP]
[\fB-urx=\fP\fIs\fP]
[\fB-ury=\fP\fIs\fP]

[\fB-verbose\fP]

[\fB-xmax=\fP\fIpixels\fP]
[\fB-ymax=\fP\fIpixels\fP]

[\fB-textalphabits=\fP{\fB1\fP,\fB2\fP,\fB4\fP}]


\fIpsfile\fP[\fB.ps\fP]

.SH "کاربرد گزینه‌ها (OPTION USAGE)"
.PP
کوتاه‌ترین مخفف یکتای گزینه‌ها قابل قبول است. می‌توانید به جای یک خط تیره منفرد،
از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید برای
جدا کردن نام گزینه از مقدار آن، به جای علامت مساوی از فاصله خالی استفاده کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
\fBpstopnm\fP یک فایل PostScript یا PDF را به عنوان ورودی می‌خواند و تصاویر PBM،
PGM یا PPM را به عنوان خروجی تولید می‌کند. این برنامه صرفاً از GhostScript برای
رندر کردن فایل PostScript با گرداننده‌های دستگاه PNM آن استفاده می‌کند. اگر
GhostScript نصب نباشد یا نسخه‌ای که نصب کرده‌اید با گرداننده‌های دستگاه مربوط به
PNM ساخته نشده باشد، \fBpstopnm\fP با خطا مواجه خواهد شد. با اجرای دستور
\f(CWgs --help \fP می‌توانید بررسی کنید که آیا محیط مناسب را در اختیار دارید یا خیر.
اگر خروجی داد و در بخش «Available Devices» مواردی همچون \fBpbm\fP، \fBpbmraw\fP،
\fBpgm\fP، \fBpgmraw\fP، \fBpnm\fP، \fBpnmraw\fP، \fBppm\fP، یا \fBppmraw\fP
فهرست شده بودند، همه‌چیز آماده است.
.PP
باید توجه داشت که \fBpstopnm\fP تنها در عام‌ترین معنای کلمه یک مبدل قالب فایل
تصویری Netpbm است، زیرا Postscript بسیار دور از یک قالب فایل تصویری است. آنچه
\fBpstopnm\fP واقعاً انجام می‌دهد، یک رندرکننده Postscript — یعنی یک تولیدکننده
تصویر — است. یک نمونه از تفاوت را زمانی خواهید دید که انتظار دارید
\f(CWpstopnm | pnmtops\fP یک تبدیل همانی (idempotent) باشد (که در عمل این‌گونه
نیست). جزئیات مربوط به این نوع تبدیل در ادامه آمده است.
.PP
\fBpstopnm\fP از مقدار متغیر محیطی \fBGHOSTSCRIPT\fP به عنوان نام فایل برنامه
Ghostscript استفاده می‌کند. اگر \fBGHOSTSCRIPT\fP تنظیم نشده باشد،
\fBpstopnm\fP متغیر \fBPATH\fP شما را به دنبال یک فایل معمولی با نام \fBgs\fP
جستجو می‌کند. اگر آن را پیدا نکند، فرض را بر این می‌گذارد که Ghostscript در فایل
\fB/usr/bin/gs\fP قرار دارد.
.PP
\fBpstopnm\fP برای تولید فایل‌های خروجی از کتابخانه‌های Netpbm استفاده نمی‌کند،
بنابراین ممکن است با اکثر برنامه‌های Netpbm کاملاً سازگار و یکدست نباشد.
.PP
\fIpsfile\fP[\fB.ps\fP] نام فایل ورودی است. اگر فایلی با نام دقیق مشخص‌شده وجود
نداشته باشد اما فایلی با افزودن \fB.ps\fP به انتهای آن موجود باشد، \fBpstopnm\fP
پسوند \fBps\fP را اضافه خواهد کرد. برای ورودی استاندارد، از \fB-\fP استفاده کنید
یا به سادگی هیچ آرگومانی مشخص نکنید.
.PP
اگر از گزینه \fB-stdout \fP استفاده کنید یا ورودی شما از ورودی استاندارد باشد،
\fBpstopnm\fP تصاویر تمام صفحات را در قالب یک فایل چندتصویری به خروجی استاندارد
ارسال می‌کند. در غیر این صورت، \fBpstopnm\fP برای هر صفحه در ورودی Postscript یک
فایل ایجاد می‌کند. نام‌گذاری فایل‌ها به این صورت است: اگر نام فایل ورودی
\fBpsfile.ps\fP باشد، نام فایل‌ها \fBpsfile001.ppm\fP، \fBpsfile002.ppm\fP و
غیره خواهد بود. پسوند نوع فایل بسته به نوع خروجی که با گزینه‌های فراخوانی انتخاب
می‌کنید، \fB.ppm\fP، \fB.pgm\fP یا \fB.pbm\fP است. اگر نام فایل ورودی به
\fB.ps\fP ختم نشود، کل نام فایل در نام فایل خروجی استفاده می‌شود. به عنوان مثال،
اگر نام فایل ورودی \fBpsfile.old\fP باشد، نام فایل خروجی \fBpsfile.old001.ppm\fP
و غیره خواهد بود.
.PP
توجه داشته باشید که انتخاب فایل خروجی با بیشتر برنامه‌های Netpbm ناهمخوان است،
زیرا خروجی پیش‌فرض آن خروجی استاندارد نیست. این امر به دلایل تاریخی و بر پایه این
واقعیت است که قالب‌های Netpbm در گذشته همیشه از دنباله‌ای از تصاویر درون یک فایل
منفرد پشتیبانی نمی‌کردند.
.PP
هنگامی که ورودی شما از ورودی استاندارد باشد، می‌توانید چندین سند Encapsulated
Postscript را یکی پس از دیگری ارسال کنید و \fBpstopnm\fP هر سند را تبدیل کرده
و آن را به عنوان یک تصویر در جریان خروجی استاندارد قرار می‌دهد. اما اگر ورودی
شما از یک فایل نام‌گذاری‌شده باشد، \fBpstopnm\fP انتظار دارد که فایل یک فایل
Encapsulated Postscript باشد، به این معنی که فقط یک سند Encapsulated
Postscript را شامل می‌شود. اگر فایل شامل چندین سند به هم پیوسته باشد،
\fBpstopnm\fP تمام اسناد به جز اولین مورد را نادیده می‌گیرد. این تمایز برای ورودی
Postscript غیر EPSF وجود ندارد — \fBpstopnm\fP بدون در نظر گرفتن اینکه ورودی از
ورودی استاندارد باشد یا از یک فایل نام‌گذاری‌شده، برای هر صفحه از ورودی یک تصویر
خروجی تولید می‌کند.
.PP
توجه داشته باشید که می‌توانید هر دو نوع فایل — یعنی EPSF پیوسته و غیر EPSF
چندصفحه‌ای — را با \fBpnmtops\fP و با تعیین گزینه \fB-setpage\fP ایجاد کنید.
.PP
هر تصویر خروجی شامل یک ناحیه مستطیلی از صفحه‌ای است که به آن مربوط می‌شود. برای
جزئیات بیشتر درباره اینکه چه بخشی از تصویر ورودی وارد تصویر خروجی می‌شود، اندازه
آن در خروجی چقدر است و چه کادرها و حاشیه‌هایی در تصویر خروجی قرار می‌گیرد، به
.UR #dimensions
بخش ابعاد (Dimensions)
.UE
\& مراجعه کنید.
.PP
گزارش شده است که برای برخی از ورودی‌های Postscript نسخه ۱، Ghostscript و در نتیجه
\fBpstopnm\fP هیچ خروجی تولید نمی‌کنند. برای رفع این مشکل می‌توانید فایل را با
برنامه \fBps2ps\fP به Postscript نسخه ۳ تبدیل کنید. گزارش شده است که برنامه
\fBpstops\fP در این حالت کارایی ندارد.

.UN dimensions.SS "ابعاد (Dimensions)"
.PP
این بخش توضیح می‌دهد که چه قسمتی از تصویر ورودی در خروجی استفاده می‌شود و ابعاد تصویر خروجی، شامل حاشیه‌ها و پس‌زمینه، چگونه تعیین می‌گردد.
.PP
توجه داشته باشید که یک تصویر خروجی به یک صفحه ورودی منفرد مرتبط است.

\fBpstopnm\fP کار خود را با برداشتن یک ناحیه مستطیلی از صفحه ورودی آغاز می‌کند. به این ناحیه «تصویر موضوع» (subject image) گفته می‌شود.
.PP
\fBpstopnm\fP ممکن است به تصویر موضوع حاشیه‌هایی اضافه کند تا آنچه را «تصویر موضوع حاشیه‌دار» (bordered subject image) نامیده می‌شود، تشکیل دهد.
.PP
\fBpstopnm\fP تصویر موضوع حاشیه‌دار را در مرکز تصویر خروجی قرار می‌دهد و لبه‌ها را بر حسب نیاز برش می‌دهد تا در اندازه محاسبه‌شده تصویر خروجی جا بگیرد.
.PP
مکان تصویر موضوع در صفحه ورودی Postscript با چهار عدد مشخص می‌شود: مختصات x و y گوشه پایین-چپ و گوشه بالا-راست. این مختصات معمولاً توسط عبارت BoundingBox DSC (یک کامنت در Postscript) در فایل PostScript مشخص می‌شوند، اما کاربر می‌تواند با تعیین یک یا چند مورد از گزینه‌های زیر آن‌ها را جایگزین کند: \fB-llx\fP، \fB-lly\fP، \fB-urx\fP و \fB-ury\fP.
.PP
وجود و ضخامت حاشیه‌ای که قرار است برای تشکیل تصویر موضوع حاشیه‌دار به تصویر موضوع اضافه شود، توسط گزینه‌های \fB-xborder\fP و \fB-yborder\fP کنترل می‌شود. اگر \fBpstopnm\fP عبارت BoundingBox را در ورودی نیابد و شما نیز مختصات ناحیه تصویر را در خط فرمان مشخص نکرده باشید، \fBpstopnm\fP از مقادیر پیش‌فرض استفاده می‌کند. اگر ورودی شما از ورودی استاندارد (Standard Input) باشد، \fBpstopnm\fP از مقادیر BoundingBox استفاده نخواهد کرد (به دلیل دشواری فنی استخراج آن اطلاعات هم‌زمان با ارسال جریان فایل به Ghostscript)؛ بنابراین یا باید مختصات ناحیه تصویر را مشخص کنید یا مقدار پیش‌فرض را بپذیرید.
.PP
اندازه تصویر خروجی موضوعی گیج‌کننده است. در یک فایل Postscript، اشیاء دارای ابعاد فضایی و فیزیکی هستند. برای نمونه، ممکن است طول یک خط مشخص ۳ سانتی‌متر باشد. یک چاپگر Postscript موظف است آن خط را فارغ از اینکه به چند پیکسل نیاز دارد و بدون در نظر گرفتن ابعاد برگه کاغذی که روی آن چاپ می‌کند، به طول ۳ سانتی‌متر چاپ کند. در مقابل، در یک تصویر PNM هیچ بعد فضایی وجود ندارد؛ تنها پیکسل‌ها هستند. ممکن است خطی به طول ۱۰۰ پیکسل داشته باشید، اما تصویر PNM هیچ چیزی درباره اینکه طول آن خط روی یک صفحه چاپ‌شده چقدر باید باشد، بیان نمی‌کند.
.PP
\fBpstopnm\fP نقش یک چاپگر Postscript را ایفا می‌کند. تصویر PNM یک صفحه چاپی مجازی است. \fBpstopnm\fP باید تعیین کند که در تصویر خروجی برای نشان دادن هر اینچ از تصویر ورودی، از چند پیکسل استفاده خواهد کرد؛ این مقدار همان «تفکیک‌پذیری دستگاه خروجی» (output device resolution) است. آن را مانند تعداد نقاط در هر اینچ (DPI) در نظر بگیرید که چاپگر مجازی روی صفحه مجازی چاپ می‌کند.
.PP
ساده‌ترین کار این است که با استفاده از گزینه \fB-dpi\fP، دقیقاً به \fBpstopnm\fP بگویید از چه تفکیک‌پذیری‌ای برای دستگاه خروجی استفاده کند. اگر برای مثال مقدار \fB-dpi=300\fP را تعیین کنید و تصویر موضوع حاشیه‌دار ۲ اینچ در ۳ اینچ باشد، خروجی PNM برابر با ۶۰۰ پیکسل در ۹۰۰ پیکسل خواهد بود. با استفاده از این روش، تفکیک‌پذیری دستگاه خروجی در هر دو جهت یکسان خواهد بود.
.PP
همچنین می‌توانید ابعاد تصویر خروجی را با گزینه‌های \fB-xsize\fP و \fB-ysize\fP تعیین کنید. برای نمونه، اگر مشخص کنید \fB-xsize=1200 -ysize=1800\fP و ابعاد تصویر موضوع حاشیه‌دار دارای پهنای ۲ اینچ و ارتفاع ۳ اینچ باشد، تصویر خروجی ۱۲۰۰ در ۱۸۰۰ پیکسل خواهد بود که در آن هر پیکسل نشان‌دهنده ۱/۶۰۰ اینچ از تصویر ورودی است.
.PP
در حالت نادری که بخواهید تفکیک‌پذیری دستگاه خروجی در دو جهت متفاوت باشد، می‌توانید از \fB-xsize\fP و \fB-ysize\fP برای این کار استفاده کنید. در مثال بالا، اگر \fB-ysize\fP را به ۹۰۰ تغییر دهید، یک پیکسل در راستای افقی همچنان ۱/۶۰۰ اینچ را نمایش می‌دهد، اما در راستای عمودی نشان‌دهنده ۱/۳۰۰ اینچ خواهد بود.
.PP
اگر یکی از گزینه‌های \fB-xsize\fP یا \fB-ysize\fP را مشخص کرده و دیگری را تعیین نکنید، \fBpstopnm\fP مقدار دیگری را به‌طور پیش‌فرض به‌گونه‌ای در نظر می‌گیرد که تفکیک‌پذیری دستگاه خروجی در هر دو جهت یکسان باشد.
.PP
بخش‌های «x» و «y» در \fB-xsize\fP و \fB-ysize\fP به تصویری اشاره دارند که روی صفحه چاپ می‌شود، نه خود صفحه. بنابراین اگر \fBpstopnm\fP آن را در جهت افقی (landscape) چاپ کند، «x» به جهت عمودی روی صفحه مربوط خواهد بود، یعنی جهت عمودی در تصویر PNM خروجی.
.PP
اگر نه اندازه خروجی و نه تفکیک‌پذیری دستگاه خروجی را مشخص نکنید، \fBpstopnm\fP محاسبات عجیبی انجام می‌دهد که وجود آن عمدتاً به دلایل تاریخی است:
.PP
اگر گزینه \fB-nocrop\fP را مشخص کنید، \fBpstopnm\fP از مقادیر \fB-xmax\fP و \fB-ymax\fP برای ابعاد تصویر خروجی استفاده می‌کند. مقادیر پیش‌فرض آن‌ها به ترتیب ۶۱۲ و ۷۹۲ پیکسل است.
.PP
حالت نهایی که حالت پیش‌فرض است، زمانی رخ می‌دهد که هیچ‌یک از گزینه‌های اندازه یا تفکیک‌پذیری و نیز \fB-nocrop\fP را مشخص نکنید. این پیچیده‌ترین حالت است. در این وضعیت، \fBpstopnm\fP ابتدا تفکیک‌پذیری‌ای برای دستگاه خروجی برمی‌گزیند که بتواند از تصویر موضوع حاشیه‌دار، تعداد پیکسل‌های مشخص‌شده با \fB-xmax\fP و \fB-ymax\fP را تولید کند. سپس بر اساس آن تفکیک‌پذیری، اندازه تصویری برای خروجی انتخاب می‌کند که فقط به اندازه‌ای بزرگ باشد که تصویر موضوع (بدون حاشیه‌ها) را در خود جای دهد. به یاد داشته باشید (همان‌طور که در بالا گفته شد) که \fBpstopnm\fP لبه‌های تصویر موضوع حاشیه‌دار را برش می‌دهد تا در اندازه تصویر خروجی محاسبه‌شده جا بگیرد.


.UN gslimitations
.SS "محدودیت‌های Ghostscript (Ghostscript Limitations)"
.PP
آزمایش‌های انجام‌شده در سال ۲۰۱۳ با Ghostscript نسخه 8.71 نشان می‌دهند که درایور خروجی \fBpgmraw\fP در Ghostscript دارای نوعی خطای گرد کردن است که باعث تغییر جزئی مقادیر پیکسل‌ها می‌شود؛ این یعنی وقتی ورودی Postscript تک‌رنگ داشته باشید، \fBpstopnm\fP خروجی نادرستی تولید می‌کند. اما با ورودی Postscript رنگی، \fBpstopnm\fP از درایور خروجی \fBppmraw\fP در Ghostscript استفاده کرده و خروجی PPM درستی تولید می‌نماید.


.UN usagenotes
.SS "نکات کاربردی (Usage Notes)"
.PP
توصیه‌های مفیدی درباره تبدیل به Postscript و از آن، در سند
.BR "Postcript File Conversions" " (1)\c"
\& به قلم Andrew T. Young آمده است.

.UN reversible
.B "تبدیل برگشت‌پذیر (Reversible Conversion)"
.PP
اگر قصد دارید معادل خط لوله ابتدایی
\f(CWpnmtops | pstopnm\fP
را انجام دهید، مراحل زیر این تبدیل را انجام خواهند داد.

.nf
\f(CW
    $ pnmtops -nocenter -equalpixels -dpi 72 -noturn testimg.ppm > testimg.ps
    $ pstopnm -xborder=0 -yborder=0 -xsize=\fIXSIZE\fP -ysize=\fIYSIZE\fP \e
        -portrait -stdout -quiet testimg.ps >testimg2.ppm
\fP
.fi

مقادیر \fIXSIZE\fP و \fIYSIZE\fP در بالا، ابعاد تصویر هستند که می‌توانید مانند مثال زیر آن‌ها را از testimg.ps استخراج کنید (دستورهای grep، awk و echo صرفاً برای نمایش نحوه کارکرد سایر دستورها هستند—شما در یک برنامه کاربردی از آن‌ها به این شکل استفاده نخواهید کرد).

.nf
\f(CW
    $ grep "BoundingBox" testimg.ps
    %%BoundingBox: 0 0 227 149

    $ awk  '/%%BoundingBox/ {print $4,$5}' testimg.ps
     227 149
 
    $ xysize=$(awk  '/%%BoundingBox/ {print "-xsize="$4,"-ysize="$5}' testimg.ps)
    $ echo $xysize

     -xsize=227 -ysize=149

    $ pstopnm -xborder=0 -yborder=0 $xysize -portrait ... testimg.ps
\fP
.fi
.PP
توجه داشته باشید که ایرادات و باگ‌های Ghostscript ممکن است مانع از انجام یک تبدیل برگشت‌پذیر کامل و بی‌نقص شوند.
.PP
قالب PDF زیرمجموعه‌ای از Postscript است، بنابراین \fBpstopnm\fP می‌تواند از PDF به قالب Netpbm تبدیل کند، اما اغلب به دلیل وابستگی \fBpstopnm\fP به عبارت BoundingBox DSC (که در ساختار PDF وجود ندارد)، تصویری با اندازه نادرست تولید می‌کند. در مورد PDFهای متنی محض، این تبدیل به‌خوبی کار می‌کند. در موارد دیگر، می‌توانید با تبدیل فایل به Postscript عمومی با استفاده از برنامه \fBpdf2ps\fP که همراه با Ghostscript ارائه می‌شود، نتایج بهتری کسب کنید. برای دریافت اطلاعات بیشتر درباره تبدیل به PDF و از آن، به
.UR index.html#document
Document/Graphics Software
.UE
مراجعه کنید.
  

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


.TP
\fB-forceplain\fP
فایل خروجی را مجبور می‌کند که در قالب ساده (متنی یا plain) باشد. در غیر این صورت،
در قالب خام (دودویی یا binary) خواهد بود. ببینید
.BR "pbm" (1)\c
\& و غیره. اگر به خروجی با قالب متنی نیاز دارید، به جای گزینهٔ مشترک
\fB-plain\fP از این گزینه استفاده کنید.

.TP
\fB-llx=\fP\fIbx\fP
مقدار \fIbx\fP را به عنوان مختصات x گوشهٔ پایین چپ (بر حسب اینچ) روی صفحهٔ
ورودی Postscript تصویر مورد نظر تعیین می‌کند.
بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.

.TP
\fB-lly=\fP\fIby\fP
مقدار \fIby\fP را به عنوان مختصات y گوشهٔ پایین چپ (بر حسب اینچ) روی صفحهٔ
ورودی Postscript تصویر مورد نظر تعیین می‌کند.
بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.

.TP
\fB-landscape\fP
تصویر را در جهت افقی (landscape) رندر می‌کند.
.sp
اگر هیچ‌یک از گزینه‌های \fB-portrait\fP و \fB-landscape\fP را مشخص نکنید،
\fBpstopnm\fP جهتی را انتخاب می‌کند که تصویر به بهترین شکل در صفحهٔ خروجی جا بگیرد.
.sp
افقی (Landscape) به معنای چاپ به صورت عرضی روی صفحه است، نه در امتداد لبهٔ طولی.
اگر لبهٔ طویل صفحه در بالا قرار داشته باشد، این دو مورد با هم متفاوت خواهند بود.

.TP
\fB-portrait\fP
تصویر را در جهت عمودی (portrait) رندر می‌کند.
.sp
گزینهٔ \fB-landscape\fP را ببینید.

.TP
\fB-nocrop\fP
این گزینه باعث می‌شود \fBpstopnm\fP ابعاد تصویر خروجی را دقیقاً برابر با ابعاد تصویر
اصلیِ حاشیه‌دار قرار دهد. به طور پیش‌فرض، \fBpstopnm\fP ابعاد تصویر خروجی را طبق مقادیر
تعیین‌شده توسط \fB-xmax\fP و \fB-ymax\fP تنظیم می‌کند. بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.

.TP
\fB-pbm\fP
.TP
\fB-pgm\fP
.TP
\fB-ppm\fP
قالب فایل خروجی را انتخاب می‌کند. به طور پیش‌فرض، تمام فایل‌ها به صورت
PPM رندر می‌شوند.

.TP
\fB-stdout\fP
باعث می‌شود خروجی به جای ارسال به فایل‌های معمولی (یک فایل به ازای هر صفحه؛
توضیحات فایل‌های خروجی در بالا را ببینید)، به خروجی استاندارد (Standard Output) فرستاده شود.
برای استخراج صفحات جداگانه از خروجی استاندارد، از \fBpnmsplit\fP استفاده کنید.

.TP
\fB-urx=\fP\fItx\fP
مقدار \fItx\fP را به عنوان مختصات x گوشهٔ بالا راست (بر حسب اینچ) روی صفحهٔ
ورودی Postscript تصویر مورد نظر تعیین می‌کند. بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.

.TP
\fB-ury=\fP\fIty\fP
مقدار \fIty\fP را به عنوان مختصات y گوشهٔ بالا راست (بر حسب اینچ) روی صفحهٔ
ورودی Postscript تصویر مورد نظر تعیین می‌کند. بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.


.TP
\fB-verbose\fP
اطلاعات پردازش را در stdout چاپ می‌کند.

.TP
\fB-xborder=\fP\fIfrac\fP 
مشخص می‌کند که حاشیه‌های چپ و راست اضافه شده به تصویر مورد نظر،
\fIfrac\fP برابر عرض تصویر باشند. مقدار پیش‌فرض 0.1 است. بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.


.TP
\fB-xmax=\fP\fIxmax\fP
مشخص می‌کند که عرض تصویر خروجی برابر \fIxmax\fP پیکسل باشد.
مقدار پیش‌فرض 612 است. بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.


.TP
\fB-xsize=\fP\fIxsize\fP
مشخص می‌کند که عرض تصویر خروجی برابر \fIxsize\fP پیکسل باشد.
بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.

.TP
\fB-yborder=\fP\fIfrac\fP
مشخص می‌کند که حاشیه‌های بالا و پایین اضافه شده به تصویر مورد نظر،
\fIfrac\fP برابر ارتفاع تصویر باشند. مقدار پیش‌فرض 0.1 است. بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.


.TP
\fB-ymax=\fP\fIymax\fP
مشخص می‌کند که ارتفاع تصویر خروجی برابر \fIymax\fP پیکسل باشد.
مقدار پیش‌فرض 792 است. بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.

.TP
\fB-ysize=\fP\fIysize\fP
مشخص می‌کند که ارتفاع تصویر خروجی برابر \fIysize\fP پیکسل باشد.
بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.

.TP
\fB-dpi=\fP\fIdpi\fP
وضوح دستگاه خروجی را بر حسب نقطه در اینچ (dpi) برای چاپگر Postscript که
\fBpstopnm\fP شبیه‌سازی می‌کند، مشخص می‌نماید. این مقدار برابر با تعداد پیکسل‌های
PNM است که \fBpstopnm\fP برای هر اینچ از تصویر تولید می‌کند. بخش
.UR #dimensions
ابعاد (Dimensions)
.UE
را ببینید.
.sp
این گزینه از Netpbm 10.21 (مارس ۲۰۰۴) اضافه شد.
     
.TP
\fB-textalphabits=\fP{\fB1\fP,\fB2\fP,\fB4\fP}
هموارسازی زیرنمونه‌ای (subsample antialiasing) متن را کنترل می‌کند. تکنیک ضدپلگی (Antialiasing)
روشی برای هموارسازی است که لبه‌های دندانه‌دار حروف را از بین می‌برد. هموارسازی زیرنمونه‌ای
نوعی از ضدپلگی است که از زیرپیکسل‌ها در یک جعبه استفاده می‌کند، و مقدار این گزینه اندازهٔ آن
جعبه است. مقدار 4 بهترین کیفیت خروجی را به همراه دارد، در حالی که 1 هیچ ضدپلگی اعمال نمی‌کند.
اعداد کوچک‌تر باعث می‌شوند \fBpnmtops\fP زمان پردازنده (CPU) کمتری مصرف کند.
.sp
ابزار \fBpstopnm\fP برای این کار از پارامتر \fBTextAlphaBits\fP برنامهٔ Ghostscript استفاده می‌کند.
.sp
پیش‌فرض 4 است.
.sp
این گزینه از Netpbm 10.53 (دسامبر ۲۰۱۰) اضافه شد. نسخه‌های قدیمی‌تر
\fBpstopnm\fP ضدپلگی انجام نمی‌دادند.




.UN limitations.SH "محدودیت‌ها (LIMITATIONS)"
.PP
این برنامه با فایل‌های PostScript که ماتریس تبدیل فعلی (current transformation matrix) را مقداردهی اولیه می‌کنند، نتایج نادرستی تولید خواهد کرد. در این موارد، انتقال و چرخش صفحه هیچ تاثیری نخواهند داشت. برای رندر کردن این فایل‌ها، احتمالاً بهترین راه استفاده از گزینه‌های زیر است:

.nf
    pstopnm -xborder 0 -yborder 0 -portrait -nocrop file.ps
.fi
.PP
اگر قرار باشد سند روی رسانه‌ای متفاوت از کاغذ اندازه letter رندر شود، ممکن است به گزینه‌های بیشتری نیاز باشد.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"

\fBgs\fP,
.BR "pnmtops" (1)\c
\&,
.BR "psidtopgm" (1)\c
\&,
.BR "pbmtolps" (1)\c
\&,
.BR "pbmtoepsi" (1)\c
\&,
.BR "pnmsplit" (1)\c
\&,
\fBpstofits\fP



.UN copyright
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.PP
کپی‌رایت (c) 1992 متعلق به Smithsonian Astrophysical Observatory
.PP
PostScript علامت تجاری Adobe Systems Incorporated است.


.UN author
.SH "نویسندگان (AUTHORS)"
.PP
Alberto Accomazzi, WIPL, Center for Astrophysics.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار \(lqmakeman\(rq در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pstopnm.html
.PP