نام (NAME)

epstopdf, repstopdf - تبدیل فایل EPS به PDF

خلاصه دستور (SYNOPSIS)

epstopdf [گزینه‌ها] [epsfile [pdffile.pdf]]

توضیحات (DESCRIPTION)

epstopdf فایل PostScript ورودی را، به‌طور پیش‌فرض با استفاده از Ghostscript، به PDF تبدیل می‌کند.

با جزئیات بیشتر: epstopdf فایل Encapsulated PostScript ورودی epsfile (یا ورودی استاندارد) را به‌گونه‌ای تغییر می‌دهد که شروع آن از مختصات 0,0 تضمین گردد، و اندازهٔ صفحه را دقیقاً منطبق بر BoundingBox تنظیم می‌کند. بدین ترتیب، نتیجه نیازی به برش (crop) ندارد و مقدار MediaBox در PDF صحیح خواهد بود.

به‌طور پیش‌فرض، نام فایل خروجی همان نام فایل ورودی است که پسوند آن با .pdf جایگزین شده است. همچنین می‌توان یک نام خروجی منتهی به .pdf را به عنوان آرگومان دوم در خط فرمان تعیین کرد، یا از گزینهٔ --outfile (-o) با هر نام دلخواهی بهره برد.

خروجی به‌طور پیش‌فرض در قالب PDF 1.5 است. برای تغییر آن، برای نمونه از این قالب استفاده کنید:

--gsopt=-dCompatibilityLevel=1.7

(تا پیش از epstopdf 2.28 (منتشر شده در سپتامبر ۲۰۱۸)، نسخهٔ PDF تولیدی همان مقداری بود که Ghostscript زیرین یا سایر مفسرها به‌طور پیش‌فرض ارائه می‌کردند.)

دستورهای PJL در ابتدای فایل حذف می‌شوند. فایل‌های باینری DOS EPS (سند TN 5002) پشتیبانی می‌شوند. پرش (seeking) از یک لوله (pipe) پشتیبانی نمی‌شود.

اگر bounding box در ورودی نادرست باشد، بروز مشکل در نتیجه اجتناب‌ناپذیر خواهد بود.

گزینه‌ها (OPTIONS)

گزینه‌ها ممکن است با «-» یا «--» آغاز شوند و می‌توان آن‌ها را بدون ایجاد ابهام به صورت مخفف به کار برد. برای جلوگیری از تداخل احتمالی با گزینه‌های جدید در آینده، بهتر است در اسکریپت‌ها از نام کامل گزینه‌ها استفاده شود.

گزینه‌های عمومی اسکریپت:

--help: نمایش پیام راهنما و خروج
--version: نمایش اطلاعات نسخه و خروج
--outfile=file: نوشتن نتیجه در file. اگر این گزینه مشخص نشده باشد و --nogs یا --filter تعیین شده باشد، در خروجی استاندارد نوشته می‌شود؛ در غیر این صورت، حالت پیش‌فرض ساخت نام فایل خروجی با جایگزینی هر پسوندی در فایل ورودی با «.pdf» است.
--[no]debug: نوشتن اطلاعات اشکال‌زدایی (پیش‌فرض: false). برای دریافت حداکثر خروجی، از --debug به عنوان اولین گزینه استفاده کنید.
--[no]exact: پویش ExactBoundingBox (پیش‌فرض: false).
--[no]filter: خواندن از ورودی استاندارد و (مگر در حالتی که --outfile مشخص شده باشد) نوشتن در خروجی استاندارد (پیش‌فرض: false).
--[no]gs: اجرای Ghostscript (پیش‌فرض: true). با گزینهٔ --nogs، خروجی PostScript که در حالت عادی تبدیل می‌شد (به‌طور پیش‌فرض در خروجی استاندارد) ارائه می‌شود؛ یعنی همان PostScript ورودی که توسط epstopdf اصلاح شده است.
--[no]hires: پویش HiresBoundingBox (پیش‌فرض: false).
--restricted=val: فعال کردن حالت محدود (پیش‌فرض: [برای repstopdf مقدار true، در غیر این صورت false])؛ این حالت از جمله استفاده از --gscmd را ممنوع کرده و بر اساس مقادیر openin_any و openout_any محدودیت‌هایی بر نام فایل‌های ورودی و خروجی اعمال می‌کند (به راهنمای Web2c در https://tug.org/web2c مراجعه کنید). در ویندوز، دستور Ghostscript به gs داخلی TeX Live که در .../tlpkg/tlgs/bin/ نصب شده محدود می‌گردد.

گزینه‌های Ghostscript (اطلاعات بیشتر در ادامه):

--gscmd=val: هدایت خروجی به val از طریق لوله (پیش‌فرض: [gswin64c.exe در ویندوز ۶۴ بیتی، gswin32c.exe در ویندوز ۳۲ بیتی، در غیر این صورت gs])
--gsopt=val: افزودن val به عنوان یک آرگومان در دستور gs (قابل تکرار است).
--gsopts=val: تفکیک val با نویسه‌های فاصله و افزودن هر کلمهٔ حاصل به عنوان یک آرگومان مجزا در دستور gs (قابل تکرار است).
--autorotate=val: تنظیم AutoRotatePages (پیش‌فرض: None)؛ مقادیر مجاز برای val عبارتند از: None، All، PageByPage. برای فایل‌های EPS، مقدار PageByPage معادل All است.
--[no]compress: استفاده از فشرده‌سازی در خروجی (پیش‌فرض: true)؛ در صورت غیرفعال شدن، آرگومان زیر را ارسال می‌کند: -dUseFlateCompression=false.
--device=dev: استفاده از -sDEVICE=dev (پیش‌فرض: pdfwrite)؛ در حالت محدود مجاز نیست.
--[no]embed: جاسازی قلم‌ها (پیش‌فرض: true)؛ مقادیر زیر را ارسال می‌کند: -dMaxSubsetPct=100 -dSubsetFonts=true -dEmbedAllFonts=true.
--[no]gray: خروجی در مقیاس خاکستری (پیش‌فرض: false)؛ مقادیر زیر را ارسال می‌کند: -sColorConversionStrategy=Gray -dProcessColorModel=/DeviceGray.
--pdfsettings=val: استفاده از -dPDFSETTINGS=/val (اگر --embed فعال باشد پیش‌فرض «prepress» است، در غیر این صورت خالی)؛ مقادیر مجاز برای val عبارتند از: screen، ebook، printer، prepress، default.
--[no]quiet: استفاده از -q یا همان -dQUIET (پیش‌فرض: false).
--res=dpi, dpixdpi: تنظیم وضوح تصویر (پیش‌فرض: [استفاده از پیش‌فرض gs]).
--[no]safer: استفاده از -d(NO)SAFER (پیش‌فرض: true).

علاوه بر گزینه‌های خاص فوق، می‌توان گزینه‌های اضافی برای استفاده همراه با gs را با استفاده از یکی از دو گزینهٔ انباشتی --gsopts و --gsopt یا هر دوی آن‌ها تعیین کرد.

گزینهٔ --gsopts یک رشتهٔ واحد از گزینه‌ها را دریافت کرده و آن را بر اساس فاصله تفکیک می‌کند؛ سپس هر کلمهٔ حاصل به صورت مجزا به خط فرمان gs افزوده می‌شود.

گزینهٔ --gsopt آرگومان خود را به عنوان یک گزینهٔ واحد به خط فرمان gs اضافه می‌کند. می‌توان آن را چندین بار برای تعیین جداگانهٔ گزینه‌ها به کار برد. اگر یک گزینهٔ gs یا مقدار آن شامل فاصله باشد، باید حتماً از این قالب استفاده شود.

در حالت محدود، گزینه‌ها به مواردی محدود می‌شوند که نام و مقادیر آن‌ها ایمن شناخته شده باشد. برخی گزینه‌ها که مقادیر بولی، اعداد صحیح یا نام‌های ثابت دریافت می‌کنند مجازند، اما مواردی که رشته‌های عمومی می‌پذیرند مجاز نیستند.

برای ارائهٔ یک پیام خطای قابل فهم، epstopdf بررسی می‌کند که آیا kpsewhich و gs (مشخص‌شده) در PATH فعلی وجود دارند یا خیر، و در صورتی که به صورت مسیرهای مطلق مشخص شده باشند، آیا قابل اجرا هستند یا خیر.

مثال‌ها (EXAMPLES)

همهٔ این مثال‌ها به شکلی یکسان «test.eps» را به «test.pdf» تبدیل می‌کنند:

epstopdf test.eps
epstopdf test.eps test.pdf
cat test.eps | epstopdf --filter >test.pdf
cat test.eps | epstopdf -f -o=test.pdf

مثال برای استفاده از HiResBoundingBox به جای BoundingBox:

epstopdf --hires test.eps

مثال برای تلاش epstopdf جهت اصلاح PostScript:

epstopdf --nogs test.ps >testcorr.ps

در همهٔ این حالات، می‌توانید --debug را اضافه کنید تا اطلاعات بیشتری دربارهٔ فرایند کاری epstopdf به دست آورید. برای دریافت حداکثر خروجی، --debug را به عنوان نخستین گزینه وارد کنید.

گزارش باگ‌ها (BUGS)

حالت «%%BoundingBox: (atend)» در صورتی که ورودی قابل پرش (seekable) نباشد (مانند مواردی که از طریق لوله ارسال می‌شود) پشتیبانی نمی‌شود.

گزارش‌های مربوط به اشکالات برنامه یا این صفحهٔ راهنما را به tex-k@tug.org (https://lists.tug.org/tex-k) ارسال کنید. هنگام ارسال گزارش باگ، لطفاً یک فایل ورودی و گزینه‌های خط فرمان مشخص‌شده را نیز ضمیمه نمایید تا بازتولید مشکل امکان‌پذیر باشد.

همچنین ببینید (SEE ALSO)

gs(1), pdfcrop(1).

بستهٔ LaTeX به نام epstopdf، که اجرای درلحظهٔ این اسکریپت را درون LaTeX خودکار می‌سازد: https://ctan.org/pkg/epstopdf-pkg

نویسندگان (AUTHORS)

در ابتدا توسط Sebastian Rahtz برای Elsevier Science نوشته شد، با مشارکت‌های بعدی توسط Thomas Esser، Gerben Wierda، Heiko Oberdiek و افراد بسیار دیگر. در حال حاضر توسط Karl Berry نگهداری می‌شود.

صفحهٔ راهنما در ابتدا توسط Jim Van Zandt نگاشته شده است.

صفحهٔ بستهٔ epstopdf در CTAN: https://ctan.org/pkg/epstopdf

صفحهٔ اصلی epstopdf: https://tug.org/epstopdf

شما مجازید آزادانه از این صفحهٔ راهنما استفاده کنید، آن را تغییر دهید و/یا بازتوزیع نمایید. اسکریپت epstopdf تحت مجوز اصلاح‌شدهٔ BSD منتشر شده است.

$Id: epstopdf.1 71121 2024-04-29 17:27:25Z karl $