.TH EPSTOPDF 1 "29 April 2024"
.\" $Id: epstopdf.1 71121 2024-04-29 17:27:25Z karl $
.SH "نام (NAME)"
epstopdf, repstopdf \- تبدیل فایل EPS به PDF
.SH "خلاصه دستور (SYNOPSIS)"
\fBepstopdf\fP [\fIگزینه‌ها\fP] [\fIepsfile\fP [\fIpdffile\fP.pdf]]
.SH "توضیحات (DESCRIPTION)"
\fBepstopdf\fP فایل PostScript ورودی را، به‌طور پیش‌فرض با استفاده از Ghostscript، به PDF تبدیل می‌کند.
.PP
با جزئیات بیشتر: \fBepstopdf\fP فایل Encapsulated PostScript ورودی \fIepsfile\fP (یا ورودی استاندارد) را به‌گونه‌ای تغییر می‌دهد که شروع آن از مختصات 0,0 تضمین گردد، و اندازهٔ صفحه را دقیقاً منطبق بر BoundingBox تنظیم می‌کند. بدین ترتیب، نتیجه نیازی به برش (crop) ندارد و مقدار MediaBox در PDF صحیح خواهد بود.
.PP
به‌طور پیش‌فرض، نام فایل خروجی همان نام فایل ورودی است که پسوند آن با \fB.pdf\fP جایگزین شده است. همچنین می‌توان یک نام خروجی منتهی به .pdf را به عنوان آرگومان دوم در خط فرمان تعیین کرد، یا از گزینهٔ \fB--outfile\fP (\fB-o\fP) با هر نام دلخواهی بهره برد.
.PP
خروجی به‌طور پیش‌فرض در قالب PDF 1.5 است. برای تغییر آن، برای نمونه از این قالب استفاده کنید:
.nf
--gsopt=-dCompatibilityLevel=1.7
.fi
(تا پیش از epstopdf 2.28 (منتشر شده در سپتامبر ۲۰۱۸)، نسخهٔ PDF تولیدی همان مقداری بود که Ghostscript زیرین یا سایر مفسرها به‌طور پیش‌فرض ارائه می‌کردند.)
.PP
دستورهای PJL در ابتدای فایل حذف می‌شوند. فایل‌های باینری DOS EPS (سند TN 5002) پشتیبانی می‌شوند. پرش (seeking) از یک لوله (pipe) پشتیبانی نمی‌شود.
.PP
اگر bounding box در ورودی نادرست باشد، بروز مشکل در نتیجه اجتناب‌ناپذیر خواهد بود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌ها ممکن است با «\fB-\fP» یا «\fB--\fP» آغاز شوند و می‌توان آن‌ها را بدون ایجاد ابهام به صورت مخفف به کار برد. برای جلوگیری از تداخل احتمالی با گزینه‌های جدید در آینده، بهتر است در اسکریپت‌ها از نام کامل گزینه‌ها استفاده شود.
.PP
گزینه‌های عمومی اسکریپت:
.IP "\fB--help\fP"
نمایش پیام راهنما و خروج
.IP "\fB--version\fP"
نمایش اطلاعات نسخه و خروج
.IP "\fB--outfile\fP=\fIfile\fP"
نوشتن نتیجه در \fIfile\fP. اگر این گزینه مشخص نشده باشد و \fB--nogs\fP یا \fB--filter\fP تعیین شده باشد، در خروجی استاندارد نوشته می‌شود؛ در غیر این صورت، حالت پیش‌فرض ساخت نام فایل خروجی با جایگزینی هر پسوندی در فایل ورودی با «.pdf» است.
.IP "\fB--\fP[\fBno\fP]\fBdebug\fP"
نوشتن اطلاعات اشکال‌زدایی (پیش‌فرض: false). برای دریافت حداکثر خروجی، از \fB--debug\fP به عنوان اولین گزینه استفاده کنید.
.IP "\fB--\fP[\fBno\fP]\fBexact\fP"
پویش ExactBoundingBox (پیش‌فرض: false).
.IP "\fB--\fP[\fBno\fP]\fBfilter\fP"
خواندن از ورودی استاندارد و (مگر در حالتی که \fB--outfile\fP مشخص شده باشد) نوشتن در خروجی استاندارد (پیش‌فرض: false).
.IP "\fB--\fP[\fBno\fP]\fBgs\fP"
اجرای Ghostscript (پیش‌فرض: true). با گزینهٔ \fB--nogs\fP، خروجی PostScript که در حالت عادی تبدیل می‌شد (به‌طور پیش‌فرض در خروجی استاندارد) ارائه می‌شود؛ یعنی همان PostScript ورودی که توسط \fBepstopdf\fP اصلاح شده است.
.IP "\fB--\fP[\fBno\fP]\fBhires\fP"
پویش HiresBoundingBox (پیش‌فرض: false).
.IP "\fB--restricted\fP=\fIval\fP"
فعال کردن حالت محدود (پیش‌فرض: [برای repstopdf مقدار true، در غیر این صورت false])؛ این حالت از جمله استفاده از \fB--gscmd\fP را ممنوع کرده و بر اساس مقادیر openin_any و openout_any محدودیت‌هایی بر نام فایل‌های ورودی و خروجی اعمال می‌کند (به راهنمای Web2c در https://tug.org/web2c مراجعه کنید). در ویندوز، دستور Ghostscript به gs داخلی TeX Live که در \fB.../tlpkg/tlgs/bin/\fP نصب شده محدود می‌گردد.
.PP
گزینه‌های Ghostscript (اطلاعات بیشتر در ادامه):
.IP "\fB--gscmd\fP=\fIval\fP"
هدایت خروجی به \fIval\fP از طریق لوله (پیش‌فرض: [\fBgswin64c.exe\fP در ویندوز ۶۴ بیتی، \fBgswin32c.exe\fP در ویندوز ۳۲ بیتی، در غیر این صورت \fBgs\fP])
.IP "\fB--gsopt\fP=\fIval\fP"
افزودن \fIval\fP به عنوان یک آرگومان در دستور gs (قابل تکرار است).
.IP "\fB--gsopts\fP=\fIval\fP"
تفکیک \fIval\fP با نویسه‌های فاصله و افزودن هر کلمهٔ حاصل به عنوان یک آرگومان مجزا در دستور gs (قابل تکرار است).
.IP "\fB--autorotate\fP=\fIval\fP"
تنظیم AutoRotatePages (پیش‌فرض: None)؛ مقادیر مجاز برای \fIval\fP عبارتند از: None، All، PageByPage. برای فایل‌های EPS، مقدار PageByPage معادل All است.
.IP "\fB--\fP[\fBno\fP]\fBcompress\fP"
استفاده از فشرده‌سازی در خروجی (پیش‌فرض: true)؛ در صورت غیرفعال شدن، آرگومان زیر را ارسال می‌کند:
.BR -dUseFlateCompression=false .
.IP "\fB--device\fP=\fIdev\fP"
استفاده از \fB-sDEVICE=\fIdev\fR (پیش‌فرض: pdfwrite)؛ در حالت محدود مجاز نیست.
.IP "\fB--\fP[\fBno\fP]\fBembed\fP"
جاسازی قلم‌ها (پیش‌فرض: true)؛ مقادیر زیر را ارسال می‌کند:
.B -dMaxSubsetPct=100 -dSubsetFonts=true -dEmbedAllFonts=true.
.IP "\fB--\fP[\fBno\fP]\fBgray\fP"
خروجی در مقیاس خاکستری (پیش‌فرض: false)؛ مقادیر زیر را ارسال می‌کند:
.B -sColorConversionStrategy=Gray -dProcessColorModel=/DeviceGray.
.IP "\fB--pdfsettings\fP=\fIval\fP"
استفاده از -dPDFSETTINGS=/\fIval\fP (اگر \fB--embed\fP فعال باشد پیش‌فرض «prepress» است، در غیر این صورت خالی)؛ مقادیر مجاز برای \fIval\fP عبارتند از: screen، ebook، printer، prepress، default.
.IP "\fB--\fP[\fBno\fP]\fBquiet\fP"
استفاده از -q یا همان -dQUIET (پیش‌فرض: false).
.IP "\fB--res\fP=\fIdpi, dpi\fPx\fIdpi\fP"
تنظیم وضوح تصویر (پیش‌فرض: [استفاده از پیش‌فرض gs]).
.IP "\fB--\fP[\fBno\fP]\fBsafer\fP"
استفاده از -d(NO)SAFER (پیش‌فرض: true).
.PP
علاوه بر گزینه‌های خاص فوق، می‌توان گزینه‌های اضافی برای استفاده همراه با gs را با استفاده از یکی از دو گزینهٔ انباشتی \fB--gsopts\fP و \fB--gsopt\fP یا هر دوی آن‌ها تعیین کرد.
.PP
گزینهٔ \fB--gsopts\fP یک رشتهٔ واحد از گزینه‌ها را دریافت کرده و آن را بر اساس فاصله تفکیک می‌کند؛ سپس هر کلمهٔ حاصل به صورت مجزا به خط فرمان gs افزوده می‌شود.
.PP
گزینهٔ \fB--gsopt\fP آرگومان خود را به عنوان یک گزینهٔ واحد به خط فرمان gs اضافه می‌کند. می‌توان آن را چندین بار برای تعیین جداگانهٔ گزینه‌ها به کار برد. اگر یک گزینهٔ gs یا مقدار آن شامل فاصله باشد، باید حتماً از این قالب استفاده شود.
.PP
در حالت محدود، گزینه‌ها به مواردی محدود می‌شوند که نام و مقادیر آن‌ها ایمن شناخته شده باشد. برخی گزینه‌ها که مقادیر بولی، اعداد صحیح یا نام‌های ثابت دریافت می‌کنند مجازند، اما مواردی که رشته‌های عمومی می‌پذیرند مجاز نیستند.
.PP
برای ارائهٔ یک پیام خطای قابل فهم، epstopdf بررسی می‌کند که آیا kpsewhich و gs (مشخص‌شده) در PATH فعلی وجود دارند یا خیر، و در صورتی که به صورت مسیرهای مطلق مشخص شده باشند، آیا قابل اجرا هستند یا خیر.

.SH "مثال‌ها (EXAMPLES)"
همهٔ این مثال‌ها به شکلی یکسان «test.eps» را به «test.pdf» تبدیل می‌کنند:
.nf
epstopdf test.eps
epstopdf test.eps test.pdf
cat test.eps | epstopdf --filter >test.pdf
cat test.eps | epstopdf -f -o=test.pdf
.fi
.PP
مثال برای استفاده از HiResBoundingBox به جای BoundingBox:
.nf
epstopdf --hires test.eps
.fi
.PP
مثال برای تلاش \fBepstopdf\fP جهت اصلاح PostScript:
.nf
epstopdf --nogs test.ps >testcorr.ps
.fi
.PP
در همهٔ این حالات، می‌توانید \fB--debug\fP را اضافه کنید تا اطلاعات بیشتری دربارهٔ فرایند کاری \fBepstopdf\fP به دست آورید. برای دریافت حداکثر خروجی، \fB--debug\fP را به عنوان نخستین گزینه وارد کنید.
.SH "گزارش باگ‌ها (BUGS)"
حالت «%%BoundingBox: (atend)» در صورتی که ورودی قابل پرش (seekable) نباشد (مانند مواردی که از طریق لوله ارسال می‌شود) پشتیبانی نمی‌شود.
.PP
گزارش‌های مربوط به اشکالات برنامه یا این صفحهٔ راهنما را به tex-k@tug.org (https://lists.tug.org/tex-k) ارسال کنید. هنگام ارسال گزارش باگ، لطفاً یک فایل ورودی و گزینه‌های خط فرمان مشخص‌شده را نیز ضمیمه نمایید تا بازتولید مشکل امکان‌پذیر باشد.
.SH "همچنین ببینید (SEE ALSO)"
\fBgs\fP(1),
\fBpdfcrop\fP(1).
.PP
بستهٔ LaTeX به نام epstopdf، که اجرای درلحظهٔ این اسکریپت را درون LaTeX خودکار می‌سازد: https://ctan.org/pkg/epstopdf-pkg
.SH "نویسندگان (AUTHORS)"
در ابتدا توسط Sebastian Rahtz برای Elsevier Science نوشته شد، با مشارکت‌های بعدی توسط Thomas Esser، Gerben Wierda، Heiko Oberdiek و افراد بسیار دیگر. در حال حاضر توسط Karl Berry نگهداری می‌شود.
.PP
صفحهٔ راهنما در ابتدا توسط Jim Van Zandt نگاشته شده است.
.PP
صفحهٔ بستهٔ epstopdf در CTAN: https://ctan.org/pkg/epstopdf
.PP
صفحهٔ اصلی epstopdf: https://tug.org/epstopdf
.PP
شما مجازید آزادانه از این صفحهٔ راهنما استفاده کنید، آن را تغییر دهید و/یا بازتوزیع نمایید. اسکریپت epstopdf تحت مجوز اصلاح‌شدهٔ BSD منتشر شده است.
.PP
$Id: epstopdf.1 71121 2024-04-29 17:27:25Z karl $