.TH GS 1 "18 Sept 2024" 10.04.0 Ghostscript \" -*- nroff -*- .SH "نام (NAME)" gs \- مفسر و پیش‌نمایش‌گر زبان‌های PostScript و PDF .SH "خلاصه دستور (SYNOPSIS)" \fBgs\fR [ \fIگزینه‌ها\fR ] [ \fIفایل‌ها\fR ] ... \fB(Unix, VMS)\fR .br \fBgswin32c\fR [ \fIگزینه‌ها\fR ] [ \fIفایل‌ها\fR ] ... \fB(MS Windows)\fR .br \fBgswin32\fR [ \fIگزینه‌ها\fR ] [ \fIفایل‌ها\fR ] ... \fB(MS Windows 3.1)\fR .br \fBgsos2\fR [ \fIگزینه‌ها\fR ] [ \fIفایل‌ها\fR ] ... \fB(OS/2)\fR .de TQ .br .ns .TP \\$1 .. .SH "توضیحات (DESCRIPTION)" دستور \fBgs\fR (\fBgswin32c\fR، \fBgswin32\fR، \fBgsos2\fR) برنامهٔ \fBGhostscript\fR را فراخوانی می‌کند؛ مفسری برای زبان‌های \fBPostScript\fR(tm) و \fBPortable Document Format\fR (PDF) متعلق به Adobe Systems. دستور \fBgs\fR «فایل‌ها» را به ترتیب خوانده و آن‌ها را به‌عنوان برنامه‌های Ghostscript اجرا می‌کند. پس از انجام این کار، ورودی‌های بعدی را از جریان ورودی استاندارد (معمولاً صفحه‌کلید) می‌خواند، هر خط را جداگانه تفسیر کرده و خروجی را به یک دستگاه خروجی (که می‌تواند یک فایل یا پنجرهٔ پیش‌نمایش X11 باشد؛ در ادامه را ببینید) می‌فرستد. مفسر هنگام برخورد با دستور «quit» (درون فایل یا از طریق صفحه‌کلید)، رسیدن به انتهای فایل، یا دریافت سیگنال وقفه (مانند Control-C از صفحه‌کلید) به‌طور عادی خارج می‌شود. .PP مفسر سوئیچ‌های گزینه‌ای متعددی را می‌شناسد که برخی از آن‌ها در ادامه شرح داده شده‌اند. لطفاً برای اطلاعات کامل مستندات کاربرد برنامه را ببینید. سوئیچ‌ها می‌توانند در هر کجای خط فرمان قرار گیرند و بر تمام فایل‌های بعد از خود اعمال می‌شوند. فراخوانی Ghostscript با سوئیچ \fB\-h\fR یا \fB\-?\fR پیامی تولید می‌کند که چندین سوئیچ کاربردی، تمام دستگاه‌های شناخته‌شده برای آن فایل اجرایی و مسیر جستجوی فونت‌ها را نشان می‌دهد؛ در Unix همچنین مکان مستندات دقیق را نمایش می‌دهد. .PP ممکن است Ghostscript برای استفاده از چندین دستگاه خروجی مختلف کامپایل شده باشد. برای دیدن اینکه فایل اجرایی شما شامل چه دستگاه‌هایی است، دستور «\fBgs -h\fR» را اجرا کنید. .PP مگر اینکه دستگاه خاصی را مشخص کنید، Ghostscript معمولاً نخستین دستگاه از میان آن‌ها را باز کرده و خروجی را به آن هدایت می‌کند. .PP اگر برنامه با پشتیبانی از X11 ساخته شده باشد، اغلب دستگاه پیش‌فرض یک پنجرهٔ X11 (پیش‌نمایش‌گر) است؛ در غیر این صورت، معمولاً Ghostscript از دستگاه bbox استفاده کرده و ابعاد فایل postscript را روی stdout چاپ می‌کند. .PP بنابراین اگر نخستین دستگاه در فهرست همان موردی است که می‌خواهید استفاده کنید، کافی است دستور زیر را اجرا کنید: .PP .nf gs myfile.ps .fi .PP همچنین می‌توانید مجموعهٔ دستگاه‌های موجود را از درون Ghostscript بررسی کنید: Ghostscript را اجرا کرده و عبارت زیر را تایپ کنید: .PP .nf devicenames == .fi .PP اما نخستین دستگاه در فهرست حاصل ممکن است همان دستگاه پیش‌فرضی نباشد که با «\fBgs -h\fR» مشاهده می‌کنید. برای تعیین «AbcXyz» به‌عنوان دستگاه خروجی اولیه، سوئیچ زیر را اضافه کنید: .PP .nf \-sDEVICE=AbcXyz .fi .PP برای نمونه، برای خروجی گرفتن روی یک چاپگر Epson می‌توانید از دستور زیر استفاده کنید: .PP .nf gs \-sDEVICE=epson myfile.ps .fi .PP سوئیچ «\-sDEVICE=» باید قبل از نخستین اشاره به نام فایل برای چاپ قرار گیرد، و تنها نخستین استفاده از این سوئیچ تأثیرگذار خواهد بود. .PP در نهایت، می‌توانید یک دستگاه پیش‌فرض را در متغیر محیطی \fBGS_DEVICE\fR مشخص کنید. ترتیب اولویت برای این گزینه‌ها از بالاترین به پایین‌ترین (Ghostscript دستگاهی را که در بالاترین رتبه در فهرست تعریف شده به کار می‌برد) به شرح زیر است: .PP .nf setpagedevice (command line) GS_DEVICE (first device in build list) .fi .PP برخی دستگاه‌ها می‌توانند از تفکیک‌پذیری‌های (تراکم‌های) متفاوتی پشتیبانی کنند. برای تعیین تفکیک‌پذیری روی چنین دستگاهی، از سوئیچ «\-r» استفاده کنید: .PP .nf gs \-sDEVICE= \-rx .fi .PP برای نمونه، روی یک چاپگر ۹-سوزنی سازگار با Epson، با دستور زیر کم‌تراکم‌ترین (سریع‌ترین) حالت را دریافت می‌کنید: .PP .nf gs \-sDEVICE=epson \-r60x72 .fi .PP و بیشترین تراکم (بهترین کیفیت خروجی) با دستور: .PP .nf gs \-sDEVICE=epson \-r240x72. .fi .PP اگر چاپگری را به‌عنوان دستگاه خروجی انتخاب کنید، Ghostscript همچنین به شما امکان می‌دهد محل ارسال خروجی را مشخص کنید \-\- در سیستم‌های Unix، معمولاً به یک فایل موقت. برای ارسال خروجی به فایلی به نام «foo.xyz»، از سوئیچ زیر استفاده کنید: .PP .nf \-sOutputFile=foo.xyz .fi .PP ممکن است بخواهید هر صفحه را جداگانه چاپ کنید. برای این کار، با استفاده از سوئیچ «\-sOutputFile=» همراه با «%d» در الگوی نام فایل، خروجی را به مجموعه‌ای از فایل‌های «foo1.xyz, foo2.xyz, ...» بفرستید: .PP .nf \-sOutputFile=foo%d.xyz .fi .PP هر فایل حاصل، یک صفحه از خروجی را دریافت می‌کند و فایل‌ها به ترتیب شماره‌گذاری می‌شوند. «%d» یک مشخصهٔ قالب‌بندی printf است؛ همچنین می‌توانید از متغیرهایی مانند «%02d» استفاده کنید. .PP در سیستم‌های Unix و MS Windows می‌توانید خروجی را به یک لوله (pipe) نیز بفرستید. برای نمونه، برای هدایت خروجی با pipe به دستور «\fBlpr\fR» (که در بسیاری از سیستم‌های Unix آن را به چاپگر هدایت می‌کند)، از گزینهٔ زیر استفاده کنید: .PP .nf \-sOutputFile=%pipe%lpr .fi .PP توجه داشته باشید که کاراکترهای «%» در MS Windows باید دو بار تکرار شوند (%%) تا از مخدوش شدن توسط مفسر خط فرمان جلوگیری شود. .PP همچنین می‌توانید خروجی را به خروجی استاندارد بفرستید: .PP .nf \-sOutputFile=\- .fi یا .nf \-sOutputFile=%stdout% .fi .PP در این حالت باید از سوئیچ \fB\-q\fR نیز استفاده کنید تا از نوشتن پیام‌های Ghostscript در خروجی استاندارد جلوگیری شود. .PP برای انتخاب یک اندازهٔ کاغذ خاص، از سوئیچ خط فرمان زیر استفاده کنید: .PP .nf -sPAPERSIZE= .fi .PP برای نمونه: .PP .nf -sPAPERSIZE=a4 .fi یا .nf -sPAPERSIZE=legal .fi .PP اکثر اندازه‌های استاندارد کاغذ ISO و US شناسایی می‌شوند. برای فهرست کامل، مستندات کاربرد یا تعاریف موجود در فایل مقداردهی اولیهٔ «gs_statd.ps» را ببینید. .PP Ghostscript افزون بر چاپ یا مشاهدهٔ فایل‌های PostScript و PDF، کارهای فراوان دیگری نیز انجام می‌دهد. برای نمونه، اگر می‌خواهید از کادر محدودکنندهٔ (bounding box) یک فایل PostScript (یا EPS) مطلع شوید، Ghostscript یک «دستگاه» ویژه ارائه می‌دهد که صرفاً این اطلاعات را چاپ می‌کند. .PP برای نمونه، با استفاده از یکی از فایل‌های نمونهٔ ارائه‌شده همراه با Ghostscript، .PP .nf gs \-sDEVICE=bbox golfer.ps .fi .PP خروجی زیر چاپ می‌شود: .PP .nf %%BoundingBox: 0 25 583 732 %%HiResBoundingBox: 0.808497 25.009496 582.994503 731.809445 .fi.SH "گزینه‌ها (OPTIONS)" .TP .BI \-\- " filename arg1 ..." آرگومان بعدی را طبق معمول به‌عنوان نام فایل در نظر می‌گیرد، اما تمامی آرگومان‌های باقی‌مانده را (حتی اگر ساختار نحوی سوییچ‌ها را داشته باشند) دریافت کرده و \fBپیش از\fR اجرای فایل، نام "ARGUMENTS" را در "userdict" (نه در "systemdict") به‌صورت آرایه‌ای از آن رشته‌ها تعریف می‌کند. هنگامی که Ghostscript اجرای فایل را به پایان رساند، به خط فرمان (shell) بازمی‌گردد. .TP .BI \-D name = token .TQ .BI \-d name = token نامی را در "systemdict" با تعریف داده‌شده مشخص می‌کند. توکن (token) باید دقیقاً یک توکن باشد (همان‌طور که توسط عملگر "token" تعریف شده) و نباید هیچ فاصله خالی (whitespace) داشته باشد. .TP .BI \-D name .TQ .BI \-d name نامی را در "systemdict" با مقدار value=null تعریف می‌کند. .TP .BI \-S name = string .TQ .BI \-s name = string نامی را در "systemdict" با یک رشته مشخص به‌عنوان مقدار تعریف می‌کند. این با \fB\-d\fR متفاوت است. برای نمونه، \fB\-dname=35\fR معادل قطعه‌کد .br /name 35 def .br است، در حالی که \fB\-sname=35\fR معادل .br /name (35) def خواهد بود. .TP .B \-P باعث می‌شود Ghostscript برای فایل‌های کتابخانه ابتدا دایرکتوری جاری را بررسی کند. به‌طور پیش‌فرض، Ghostscript دیگر دایرکتوری جاری را بررسی نمی‌کند، مگر اینکه البته اولین دایرکتوری ارائه‌شده به‌صورت صریح در \fB\-I\fR نقطه (".") باشد. همچنین بخش \fBفایل‌های راه‌اندازی (INITIALIZATION FILES)\fR در ادامه، و فایل همراه \fBUse.htm\fR را برای بررسی دقیق‌تر مسیرهای جستجو و نحوه یافتن فایل‌ها توسط Ghostscript ببینید. .TP .B \-q راه‌اندازی بی‌صدا: پیام‌های معمول راه‌اندازی را متوقف می‌کند و همچنین کاری معادل \fB\-dQUIET\fR انجام می‌دهد. .TP .BI \-g number1 x number2 معادل \fB\-dDEVICEWIDTH=\fR\fInumber1\fR و \fB\-dDEVICEHEIGHT=\fR\fInumber2\fR است. این گزینه برای دستگاه‌هایی (مانند پنجره‌های X11) کاربرد دارد که نیازمند (یا مجاز به) تعیین عرض و ارتفاع هستند. .TP .BI \-r number .TQ .BI \-r number1 x number2 معادل \fB\-dDEVICEXRESOLUTION=\fR\fInumber1\fR و \fB\-dDEVICEYRESOLUTION=\fR\fInumber2\fR است. این گزینه برای دستگاه‌هایی مانند چاپگرها که از چندین تفکیک‌پذیری X و Y پشتیبانی می‌کنند، کاربرد دارد. اگر تنها یک عدد مشخص شود، برای هر دو وضوح X و Y استفاده می‌شود. .TP .BI \-I directories فهرست مشخص‌شده از دایرکتوری‌ها را به ابتدای مسیر جستجوی فایل‌های کتابخانه‌ای اضافه می‌کند. .TP .B \- این در واقع یک سوییچ نیست، بلکه به Ghostscript نشان می‌دهد که ورودی استاندارد از یک فایل یا یک لوله (pipe) می‌آید، نه به‌صورت تعاملی از خط فرمان. Ghostscript ورودی استاندارد را تا رسیدن به پایان فایل (end-of-file) می‌خواند، آن را مانند هر فایل دیگری اجرا می‌کند و سپس به پردازش خط فرمان ادامه می‌دهد. هنگامی که خط فرمان به‌طور کامل پردازش شد، Ghostscript به‌جای رفتن به حالت تعاملی، خارج می‌شود. .PP توجه داشته باشید که فایل راه‌اندازی معمول "gs_init.ps"، دیکشنری "systemdict" را فقط‌خواندنی می‌کند؛ بنابراین مقادیر نام‌های تعریف‌شده با \fB\-D\fR، \fB\-d\fR، \fB\-S\fR یا \fB\-s\fR قابل تغییر نیستند (اگرچه البته می‌توان آن‌ها را با تعاریف موجود در "userdict" یا سایر دیکشنری‌ها جایگزین کرد). .SH "نام‌های ویژه (SPECIAL NAMES)" .TP .B \-dNOCACHE ذخیره‌سازی موقت نویسه‌ها (character caching) را غیرفعال می‌کند. فقط برای اشکال‌زدایی مفید است. .TP .B \-dNOBIND عملگر "bind" را غیرفعال می‌کند. فقط برای اشکال‌زدایی مفید است. .TP .B \-dNODISPLAY راه‌اندازی معمول دستگاه خروجی را متوقف می‌کند. این گزینه ممکن است هنگام اشکال‌زدایی مفید باشد. .TP .B \-dNOPAUSE اعلان و مکث در انتهای هر صفحه را غیرفعال می‌کند. این ویژگی برای مواردی که برنامه دیگری کنترل Ghostscript را بر عهده دارد مطلوب است. .TP .B \-dNOPLATFONTS استفاده از فونت‌های ارائه‌شده توسط پلتفرم زیرین (برای نمونه X11) را غیرفعال می‌کند. این گزینه زمانی که فونت‌های پلتفرم تفاوت نامطلوبی با فونت‌های مقیاس‌پذیر دارند، ممکن است لازم باشد. .TP .B \-dSAFER عملیات فایلی را که کار جاری می‌تواند انجام دهد محدود می‌کند. اکنون این حالت عملیاتی پیش‌فرض است. .TP .B \-dWRITESYSTEMDICT دیکشنری "systemdict" را قابل‌نوشتن باقی می‌گذارد. این کار هنگام اجرای برنامه‌های کاربردی خاص ضروری است، اما از آنجا که تدابیر امنیتی معمول PostScript را دور می‌زند، شدیداً نهی می‌شود. .TP .BI \-sDEVICE= device همان‌طور که در بالا توضیح داده شد، یک دستگاه خروجی اولیه جایگزین را انتخاب می‌کند. .TP .BI \-sOutputFile= filename همان‌طور که در بالا توضیح داده شد، یک فایل خروجی جایگزین (یا pipe) را برای دستگاه خروجی اولیه انتخاب می‌کند. .SH "حالت امن‌تر (SAFER MODE)" .PP گزینه .B \-dSAFER دسترسی‌های سامانه فایل را به فایل‌ها و دایرکتوری‌هایی محدود می‌کند که توسط متغیرهای محیطی مربوطه (مانند GS_LIB) یا پارامترهای خط فرمان مجاز شده‌اند (برای جزئیات به https://ghostscript.com/doc/current/Use.htm مراجعه کنید). .PP حالت SAFER اکنون حالت عملیاتی پیش‌فرض است. بنابراین، هنگام اجرای برنامه‌هایی که نیاز به باز کردن فایل‌ها یا تنظیم پارامترهای محدودشده دارند، باید گزینه خط فرمان .B \-dNOSAFER یا مترادف آن .BR \-dDELAYSAFER را پاس دهید. .PP اجرا با NOSAFER/DELAYSAFER (همان‌طور که از نامشان پیداست) سطح امنیت را کاهش می‌دهد و بنابراین \fBتنها\fR برای اشکال‌زدایی یا در جریان‌های کاری \fBبسیار\fR کنترل‌شده توصیه می‌شود، و در هر شرایط دیگری اکیداً \fBنهی می‌گردد\fR..SH "فایل‌ها (FILES)" .PP مکان بسیاری از فایل‌های زمان اجرای Ghostscript هنگام ساخت برنامه درون فایل اجرایی کامپایل می‌شود. در سیستم‌های Unix این مسیرها معمولاً بر پایه‌ی \fB/usr/local\fR هستند، اما ممکن است در سیستم شما متفاوت باشند. در DOS معمولاً بر پایه‌ی \fBC:\\GS\fR هستند، اما ممکن است جای دیگری باشند، به‌ویژه اگر Ghostscript را به همراه \fBGSview\fR نصب کنید. برای یافتن مکان مستندات Ghostscript روی سیستم خود، که جزئیات بیشتری را در اختیارتان می‌گذارد، دستور «\fBgs -h\fR» را اجرا کنید. .TP .B /usr/local/share/ghostscript/#.##/* فایل‌های راه‌اندازی، ابزارها و تعاریف قلم پایه‌ای .TP .B /usr/local/share/ghostscript/fonts/* تعاریف قلم‌های بیشتر .TP .B /usr/local/share/ghostscript/#.##/examples/* فایل‌های نمایشی Ghostscript .TP .B /usr/local/share/ghostscript/#.##/doc/* فایل‌های گوناگون مستندات .SH "فایل‌های راه‌اندازی (INITIALIZATION FILES)" هنگام جستجو برای فایل‌های راه‌اندازی «gs_*.ps»، فایل‌های مربوط به قلم‌ها، یا فایل عملگر «run»، نرم‌افزار Ghostscript ابتدا سعی می‌کند فایل را با همان نام داده‌شده باز کند؛ در صورتی که دایرکتوری مشخص نشده باشد، از دایرکتوری کاری جاری استفاده می‌کند. اگر این کار ناموفق باشد و نام فایل مسیر صریحی از یک دایرکتوری یا درایو را مشخص نکرده باشد (برای نمونه، در سیستم‌های Unix شامل «/» یا در سیستم‌های MS Windows شامل «\\» نباشد)، Ghostscript دایرکتوری‌ها را به این ترتیب بررسی می‌کند: .TP 4 1. دایرکتوری‌های مشخص‌شده توسط گزینه‌های \fB\-I\fR در خط فرمان (پایین را ببینید)، در صورت وجود؛ .TP 2. دایرکتوری‌های مشخص‌شده توسط متغیر محیطی \fBGS_LIB\fR، در صورت وجود؛ .TP 3. دایرکتوری‌های مشخص‌شده توسط ماکروی \fBGS_LIB_DEFAULT\fR در makefile نرم‌افزار Ghostscript هنگام ساخته شدن فایل اجرایی. هنگامی که \fBgs\fR روی Unix ساخته می‌شود، \fBGS_LIB_DEFAULT\fR معمولاً برابر است با: "/usr/local/share/ghostscript/#.##:/usr/local/share/ghostscript/fonts" که در آن «#.##» نشان‌دهنده شماره نسخه Ghostscript است. .PP هر یک از این موارد (\fBGS_LIB_DEFAULT\fR، \fBGS_LIB\fR و پارامتر \fB\-I\fR) می‌توانند یک دایرکتوری واحد یا فهرستی از دایرکتوری‌ها باشند که با «:» از یکدیگر جدا شده‌اند. .SH "محیط (ENVIRONMENT)" .TP .B GS_OPTIONS رشته‌ای از گزینه‌ها که پیش از گزینه‌های خط فرمان پردازش می‌شوند .TP .B GS_DEVICE برای تعیین یک دستگاه خروجی استفاده می‌شود .TP .B GS_FONTPATH نام مسیرهای مورد استفاده برای جستجوی قلم‌ها .TP .B GS_LIB نام مسیرها برای فایل‌های راه‌اندازی و قلم‌ها .TP .B TEMP مکانی که فایل‌های موقت در آن ساخته می‌شوند .SH "منابع اکس (X RESOURCES)" نرم‌افزار Ghostscript، یا دقیق‌تر دستگاه نمایش X11، به دنبال منابع زیر تحت نام برنامه «Ghostscript» می‌گردد: .TP .B borderWidth عرض حاشیه بر حسب پیکسل (پیش‌فرض = 1). .TP .B borderColor نام رنگ حاشیه (پیش‌فرض = black). .TP .B geometry اندازه و مکان پنجره، به صورت WxH+X+Y (پیش‌فرض NULL است). .TP .B xResolution تعداد پیکسل‌های افقی در هر اینچ (پیش‌فرض از \fBWidthOfScreen\fR و \fBWidthMMOfScreen\fR محاسبه می‌شود). .TP .B yResolution تعداد پیکسل‌های عمودی در هر اینچ (پیش‌فرض از \fBHeightOfScreen\fR و \fBHeightMMOfScreen\fR محاسبه می‌شود). .TP .B useBackingPixmap مشخص می‌کند که آیا برای ذخیره پنجره نمایش از backing store استفاده شود یا خیر (پیش‌فرض = true). .PP برای فهرست کامل‌تری از منابع، سند راهنمای استفاده را ببینید. برای تنظیم این منابع در Unix، آن‌ها را در فایلی مانند \fI~/.Xresources\fR به شکل زیر قرار دهید: .PP .nf Ghostscript*geometry: 612x792\-0+0 Ghostscript*xResolution: 72 Ghostscript*yResolution: 72 .fi .PP سپس این منابع را در پایگاه داده منابع کارساز X ادغام کنید: .PP .nf % xrdb \-merge ~/.Xresources .fi .SH "همچنین ببینید (SEE ALSO)" فایل‌های گوناگون مستندات Ghostscript (در بالا)، به‌ویژه \fBUse.htm\fR. .SH "گزارش باگ‌ها (BUGS)" به تارنمای http://bugs.ghostscript.com و گروه خبری Usenet به نشانی comp.lang.postscript مراجعه کنید. .SH "نسخه (VERSION)" این سند آخرین بار برای Ghostscript نسخه 10.04.0 بازبینی شده است. .SH "نویسندگان (AUTHORS)" شرکت Artifex Software, Inc. نگه‌دارنده اصلی Ghostscript است. Russell J. Lang با نشانی gsview در ghostgum.com.au، نویسنده بیشتر کدهای بخش MS Windows در Ghostscript است.