| pdftocairo(1) | General Commands Manual | pdftocairo(1) |
نام (NAME)
pdftocairo - تبدیل قالب سند قابل‌حمل (PDF) به PNG/JPEG/TIFF/PDF/PS/EPS/SVG با استفاده از cairo
خلاصه دستور (SYNOPSIS)
pdftocairo [گزینه‌ها] PDF-file [output-file]
توضیحات (DESCRIPTION)
pdftocairo فایل‌های «قالب سند قابل‌حمل» (PDF) را با استفاده از دستگاه خروجی cairo مربوط به کتابخانهٔ PDF پاپلر (poppler)، به هر یک از قالب‌های خروجی زیر تبدیل می‌کند:
- گرافیک شبکه‌ای قابل‌حمل (PNG)
- قالب تبادل JPEG (JPEG)
- قالب فایل تصویری برچسب‌دار (TIFF)
- قالب سند قابل‌حمل (PDF)
- پست‌اسکریپت (PS)
- پست‌اسکریپت کپسوله‌شده (EPS)
- گرافیک برداری مقیاس‌پذیر (SVG)
- چاپگر ویندوز (Windows Printer)
pdftocairo فایل PDF ورودی، PDF-file، را خوانده و در output-file می‌نویسد. قالب‌های تصویری (PNG، JPEG و TIFF) به ازای هر صفحه یک فایل تولید می‌کنند که شمارهٔ صفحه و پسوند نوع فایل به انتهای output-file افزوده می‌شود. هنگامی که از -singlefile همراه با قالب‌های تصویری استفاده شود، تنها پسوند نوع فایل به output-file اضافه خواهد شد. زمانی که قالب خروجی یک قالب برداری باشد (PDF، PS، EPS و SVG)، output-file نام کامل فایل خروجی خواهد بود.
اگر PDF-file برابر با “-” باشد، فایل PDF از ورودی استاندارد (stdin) خوانده می‌شود. اگر output-file برابر با “-” باشد، خروجی در خروجی استاندارد (stdout) نوشته خواهد شد. استفاده از stdout با قالب‌های تصویری مجاز نیست مگر آنکه از -singlefile استفاده شود. اگر output-file مشخص نشود، نام فایل خروجی از روی نام فایل PDF-file مشتق خواهد شد.
همهٔ گزینه‌ها با تمام قالب‌های خروجی سازگار نیستند. باید یکی (و فقط یکی) از گزینه‌های تعیین قالب خروجی (-png، -jpeg، -tiff، -pdf، -print، -ps، -eps یا -svg) استفاده شود.
گزینه‌های تفکیک‌پذیری (-r، -rx، -ry) تفکیک‌پذیری خروجی‌های تصویری را تعیین می‌کنند. ابعاد تصویر به اندازهٔ صفحهٔ PDF و میزان تفکیک‌پذیری بستگی دارد. برای خروجی‌های برداری، بخش‌هایی از صفحه که به صورت محلی در قالب خروجی قابل نمایش نیستند (مانند نیمه‌شفافی در PS)، با تفکیک‌پذیری تعیین‌شده توسط گزینه‌های مربوطه شطرنجی (رستریزه) خواهند شد.
گزینه‌های -scale-to می‌توانند برای تعیین یک اندازهٔ ثابت برای تصویر به کار روند. در این حالت، تفکیک‌پذیری تصویر متناسب با اندازهٔ صفحه متغیر خواهد بود.
گزینه‌های برش (-x، -y، -W و -H) در قالب‌های تصویری از واحد پیکسل و در قالب‌های برداری از واحد پوینت پست‌اسکریپت (۱/۷۲ اینچ) استفاده می‌کنند. هنگامی که برش در خروجی‌های برداری به کار رود، ناحیهٔ برش‌خورده در مرکز قرار می‌گیرد مگر آنکه از -nocenter استفاده شود که در این حالت ناحیهٔ برش در بالا سمت چپ (در SVG) یا در پایین سمت چپ (در PDF، PS، EPS) قرار خواهد گرفت.
گزینه‌ها (OPTIONS)
- -png
- تولید فایل یا فایل‌های PNG.
- -jpeg
- تولید فایل یا فایل‌های JPEG. همچنین -jpegopt را ببینید.
- -tiff
- تولید فایل یا فایل‌های TIFF.
- تولید یک فایل PDF.
- -ps
- تولید یک فایل PS.
- -eps
- تولید یک فایل EPS. فایل EPS تنها شامل یک تصویر منفرد است؛ بنابراین اگر از این گزینه برای یک فایل PDF چندصفحه‌ای استفاده می‌کنید، باید از گزینه‌های -f و -l برای تعیین یک صفحهٔ مشخص استفاده نمایید. گزینه‌های اندازهٔ صفحه (-origpagesizes، -paper، -paperw، -paperh) را نمی‌توان همراه با این گزینه به کار برد.
- -svg
- تولید یک فایل SVG (گرافیک برداری مقیاس‌پذیر).
- (تنها در ویندوز) چاپ در چاپگر سیستم. همچنین گزینه‌های -printer و -printeropt را ببینید. اگر فایل خروجی تعیین نشده باشد، خروجی به چاپگر فرستاده می‌شود. فایل خروجی '-' نمی‌تواند با این گزینه استفاده شود.
- -printdlg
- (تنها در ویندوز) چاپ در چاپگر سیستم. کادر گفتگوی چاپ را نمایش می‌دهد تا امکان ویرایش گزینه‌های چاپ پیش از فرآیند چاپ فراهم شود.
- -f number
- شمارهٔ اولین صفحه‌ای که باید تبدیل شود را تعیین می‌کند.
- -l number
- شمارهٔ آخرین صفحه‌ای که باید تبدیل شود را تعیین می‌کند.
- -o
- تنها صفحه‌های فرد را تولید می‌کند.
- -e
- تنها صفحه‌های زوج را تولید می‌کند.
- -singlefile
- تنها اولین صفحه را می‌نویسد و ارقام شمارهٔ صفحه را به نام فایل اضافه نمی‌کند.
- -r number
- تفکیک‌پذیری محورهای X و Y فایل‌های تصویری (یا بخش‌های رستریزه در خروجی برداری) را بر حسب پیکسل بر اینچ مشخص می‌کند. مقدار پیش‌فرض 150 PPI است.
- -rx number
- تفکیک‌پذیری محور X فایل‌های تصویری (یا بخش‌های رستریزه در خروجی برداری) را بر حسب پیکسل بر اینچ مشخص می‌کند. مقدار پیش‌فرض 150 PPI است.
- -ry number
- تفکیک‌پذیری محور Y فایل‌های تصویری (یا بخش‌های رستریزه در خروجی برداری) را بر حسب پیکسل بر اینچ مشخص می‌کند. مقدار پیش‌فرض 150 PPI است.
- -scale-to number
- ضلع بزرگ‌تر هر صفحه (پهنا در صفحه‌های افقی، ارتفاع در صفحه‌های عمودی) را به گونه‌ای مقیاس‌بندی می‌کند که در تعداد پیکسل مشخص‌شده جا شود. اندازهٔ ضلع کوچک‌تر بر اساس نسبت ابعاد صفحه تعیین خواهد شد (تنها PNG/JPEG/TIFF).
- -scale-to-x number
- هر صفحه را به صورت افقی مقیاس‌بندی می‌کند تا در تعداد پیکسل scale-to-x جا شود. اگر scale-to-y برابر با -1 باشد، اندازهٔ عمودی بر اساس نسبت ابعاد صفحه تعیین خواهد شد (تنها PNG/JPEG/TIFF).
- -scale-to-y number
- هر صفحه را به صورت عمودی مقیاس‌بندی می‌کند تا در تعداد پیکسل scale-to-y جا شود. اگر scale-to-x برابر با -1 باشد، اندازهٔ افقی بر اساس نسبت ابعاد صفحه تعیین خواهد شد (تنها PNG/JPEG/TIFF).
- -x number
- مختصات x گوشهٔ بالا-چپ ناحیهٔ برش را بر حسب پیکسل (خروجی تصویر) یا پوینت (خروجی برداری) مشخص می‌کند.
- -y number
- مختصات y گوشهٔ بالا-چپ ناحیهٔ برش را بر حسب پیکسل (خروجی تصویر) یا پوینت (خروجی برداری) مشخص می‌کند.
- -W number
- پهنای ناحیهٔ برش را بر حسب پیکسل (خروجی تصویر) یا پوینت (خروجی برداری) مشخص می‌کند (پیش‌فرض 0 است).
- -H number
- ارتفاع ناحیهٔ برش را بر حسب پیکسل (خروجی تصویر) یا پوینت (خروجی برداری) مشخص می‌کند (پیش‌فرض 0 است).
- -sz number
- اندازهٔ مربع برش را بر حسب پیکسل (خروجی تصویر) یا پوینت (خروجی برداری) مشخص می‌کند (مقادیر -W و -H را تنظیم می‌کند).
- -cropbox
- هنگام تولید فایل‌ها، به جای media box از crop box استفاده می‌کند (تنها PNG/JPEG/TIFF).
- -mono
- تولید فایل تک‌رنگ (تنها PNG و TIFF).
- -gray
- تولید فایل در طیف خاکستری (تنها PNG، JPEG و TIFF).
- -antialias
- گزینهٔ هموارسازی لبه‌ها (antialias) در cairo را برای متن و رسم خطوط در فایل‌های تصویری (یا بخش‌های رستریزه در خروجی برداری) تنظیم می‌کند. گزینه‌ها عبارتند از:
- default
- استفاده از هموارسازی پیش‌فرض برای دستگاه هدف. در صورت عدم استفاده از -antialias این مقدار پیش‌فرض است.
- none
- هموارسازی لبه‌ها غیرفعال می‌شود.
- gray
- انجام هموارسازی تک‌رنگ با استفاده از سایه‌های خاکستری..TP subpixel انجام صاف‌سازی (antialiasing) با بهره‌گیری از چیدمان عناصر زیرپیکسل در دستگاه‌هایی مانند LCD.
- fast
- اشاره به موتور خروجی (backend) برای انجام مقداری صاف‌سازی، با اولویت دادن سرعت بر کیفیت.
- good
- موتور خروجی باید میان کیفیت و کارایی تعادل برقرار کند.
- best
- اشاره به موتور خروجی برای رندر با بالاترین کیفیت، با فدا کردن سرعت در صورت نیاز.
- -transp
- استفاده از رنگ صفحه شفاف به‌جای سفید (فقط PNG و TIFF).
- -icc icc-file
- استفاده از فایل ICC مشخص‌شده به‌عنوان نمایه خروجی (فقط PNG). این نمایه در فایل PNG جاسازی خواهد شد.
- -jpegopt jpeg-options
- هنگام استفاده همراه با -jpeg، فهرستی از گزینه‌ها را برای کنترل فشرده‌سازی jpeg دریافت می‌کند. برای گزینه‌های در دسترس، JPEG OPTIONS را ببینید.
- -level2
- تولید PostScript سطح ۲ (فقط PS).
- -level3
- تولید PostScript سطح ۳ (فقط PS). این گزینه تمام قابلیت‌های سطح ۲ به‌همراه الگوهای سایه‌زنی (shading patterns) و تصاویر ماسک‌شده را فعال می‌کند. این تنظیم پیش‌فرض است.
- -struct
- اگر فایل ورودی حاوی اطلاعات ساختاری درباره محتوای سند باشد، این اطلاعات را در فایل خروجی می‌نویسد (فقط PDF).
- -origpagesizes
- این گزینه معادل "-paper match"; است.
- -paper size
- تنظیم اندازه کاغذ روی یکی از موارد "letter"، "legal"، "A4" یا "A3" (فقط PS، PDF، SVG). همچنین می‌تواند روی "match" تنظیم شود که اندازه کاغذ هر صفحه را مطابق با اندازه مشخص‌شده در فایل PDF قرار می‌دهد. اگر هیچ‌یک از گزینه‌های -paper، -paperw یا -paperh مشخص نشده باشند، حالت پیش‌فرض تطبیق اندازه کاغذ (match) است.
- -paperw size
- تنظیم عرض کاغذ بر حسب پوینت (فقط PS، PDF، SVG).
- -paperh size
- تنظیم ارتفاع کاغذ بر حسب پوینت (فقط PS، PDF، SVG).
- -nocrop
- به‌طور پیش‌فرض، خروجی چاپ مطابق با CropBox مشخص‌شده در فایل PDF برش می‌خورد. این گزینه برش را غیرفعال می‌کند (فقط PS، PDF، SVG).
- -expand
- بزرگ کردن صفحات PDF کوچک‌تر از کاغذ برای پر کردن اندازه کاغذ (فقط PS، PDF، SVG). به‌طور پیش‌فرض، مقیاس این صفحات تغییر داده نمی‌شود.
- -noshrink
- عدم تغییر مقیاس صفحات PDF که بزرگ‌تر از کاغذ هستند (فقط PS، PDF، SVG). به‌طور پیش‌فرض، صفحات بزرگ‌تر از کاغذ کوچک می‌شوند تا جا بگیرند.
- -nocenter
- به‌طور پیش‌فرض، صفحات PDF کوچک‌تر از کاغذ (پس از هرگونه تغییر مقیاس) در وسط کاغذ قرار می‌گیرند. این گزینه باعث می‌شود که در عوض به گوشه پایین-چپ کاغذ تراز شوند (فقط PS، PDF، SVG).
- -duplex
- توضیح DSC با عنوان %%IncludeFeature: *Duplex DuplexNoTumble را به فایل PostScript اضافه می‌کند (فقط PS). این کار به مدیر چاپ اعلان می‌کند که چاپ دورو را فعال کند.
- -printer printer-name
- (فقط ویندوز). هنگام استفاده با -print، نام چاپگر مورد استفاده را به‌جای پیش‌فرض سیستم مشخص می‌کند.
- -printopt printer-options
- (فقط ویندوز). هنگام استفاده با -print، فهرستی از گزینه‌ها را برای پیکربندی چاپگر دریافت می‌کند. برای گزینه‌های در دسترس، WINDOWS PRINTER OPTIONS را ببینید.
- -setupdlg
- (فقط ویندوز). هنگام استفاده با -print، کادر محاوره‌ای ویژگی‌های چاپگر نمایش داده می‌شود تا امکان تغییر تنظیمات چاپ پیش از شروع کار فراهم گردد. اندازه کاغذ انتخاب‌شده در کادر ویژگی‌های چاپ استفاده خواهد شد، مگر اینکه -origpagesizes مشخص شده باشد.
- -opw password
- مشخص کردن گذرواژه مالک (owner password) برای فایل PDF. ارائه این گذرواژه تمام محدودیت‌های امنیتی را دور می‌زند.
- -upw password
- مشخص کردن گذرواژه کاربر (user password) برای فایل PDF.
- -q
- عدم چاپ هیچ‌گونه پیام یا خطا.
- -v
- چاپ اطلاعات نسخه و حق نشر (copyright).
- -h
- چاپ اطلاعات راهنمای استفاده. (-help و --help معادل هستند.).SH "کدهای خروج (EXIT CODES)" ابزارهای poppler از کدهای خروج زیر استفاده می‌کنند:
- 0
- بدون خطا.
- 1
- خطا در باز کردن فایل PDF.
- 2
- خطا در باز کردن فایل خروجی.
- 3
- خطای مربوط به مجوزهای دسترسی PDF.
- 4
- خطای مربوط به نمایهٔ ICC.
- 99
- خطای دیگر.
گزینه‌های JPEG (JPEG OPTIONS)
هنگامی که خروجی JPEG مشخص شده باشد، می‌توان از گزینهٔ -jpegopt برای کنترل پارامترهای فشرده‌سازی JPEG استفاده کرد. این گزینه رشته‌ای به قالب "<opt>=<val>[,<opt>=<val>]" دریافت می‌کند. در حال حاضر گزینه‌های دردسترس عبارتند از:
- quality
- مقدار کیفیت JPEG را مشخص می‌کند. مقدار باید یک عدد صحیح بین 0 و 100 باشد.
- progressive
- خروجی JPEG پیش‌رونده (progressive) را انتخاب می‌کند. مقادیر ممکن "y" و "n" هستند که به ترتیب نشان‌دهندهٔ پیش‌رونده (بله) یا غیرپیش‌رونده (خیر) می‌باشند.
- optimize
- تعیین می‌کند که آیا جدول‌های بهینهٔ کدگذاری هافمن برای خروجی JPEG محاسبه شوند یا خیر، که موجب ایجاد فایل‌های کوچک‌تر می‌شود اما یک دور پردازش اضافی روی داده‌ها اعمال می‌کند. مقدار باید "y" یا "n" باشد؛ که "y" بهینه‌سازی را انجام می‌دهد، در غیر این صورت از جدول‌های پیش‌فرض هافمن استفاده خواهد شد.
گزینه‌های چاپگر ویندوز (WINDOWS PRINTER OPTIONS)
در Windows، می‌توانید از گزینهٔ -print برای چاپ مستقیم روی یک چاپگر سیستمی استفاده کنید. علاوه بر این، می‌توانید از گزینهٔ -printopt برای پیکربندی چاپگر استفاده نمایید. این گزینه رشته‌ای به قالب "<opt>=<val>[,<opt>=<val>]" دریافت می‌کند. در حال حاضر گزینه‌های دردسترس عبارتند از:
- source
- سینی کاغذ مبدا (bin) مورد استفاده را انتخاب می‌کند. مقادیر ممکن عبارتند از "upper"، "onlyone"، "lower"، "middle"، "manual"، "envelope"، "envmanual"، "auto"، "tractor"، "smallfmt"، "largefmt"، "largecapacity"، "formsource"، یا یک مقدار عددی برای انتخاب یک منبع خاص در درایور.
- duplex
- حالت دوطرفهٔ (duplex) چاپگر را تنظیم می‌کند. مقادیر ممکن "off"، "short" یا "long" هستند که به ترتیب نشان‌دهندهٔ عدم چاپ دوطرفه، صحافی از لبهٔ کوتاه، یا صحافی از لبهٔ بلند می‌باشند. گزینهٔ عمومی -duplex مترادف با "duplex=long" است. در صورتی که هر دو گزینه مشخص شوند، -printopt اولویت دارد.
نویسنده (AUTHOR)
حق تکثیر نرم‌افزار و مستندات pdftocairo متعلق به Glyph & Cog, LLC در سال‌های 1996-2004 و توسعه‌دهندگان Poppler در سال‌های 2005-2011 است.
همچنین ببینید (SEE ALSO)
pdfdetach(1), pdffonts(1), pdfimages(1), pdfinfo(1), pdftohtml(1), pdftoppm(1), pdftops(1), pdftotext(1) pdfseparate(1), pdfsig(1), pdfunite(1)