.TH pdftocairo 1
.SH "نام (NAME)"
pdftocairo \- تبدیل قالب سند قابل‌حمل (PDF) به PNG/JPEG/TIFF/PDF/PS/EPS/SVG با استفاده از cairo
.SH "خلاصه دستور (SYNOPSIS)"
.B pdftocairo
[گزینه‌ها]
.IR PDF-file
.RI [ output-file ]
.SH "توضیحات (DESCRIPTION)"
.B pdftocairo
فایل‌های «قالب سند قابل‌حمل» (PDF) را با استفاده از دستگاه خروجی cairo مربوط به کتابخانهٔ PDF پاپلر (poppler)، به هر یک از قالب‌های خروجی زیر تبدیل می‌کند:
.IP \(bu
گرافیک شبکه‌ای قابل‌حمل (PNG)
.IP \(bu
قالب تبادل JPEG (JPEG)
.IP \(bu
قالب فایل تصویری برچسب‌دار (TIFF)
.IP \(bu
قالب سند قابل‌حمل (PDF)
.IP \(bu
پست‌اسکریپت (PS)
.IP \(bu
پست‌اسکریپت کپسوله‌شده (EPS)
.IP \(bu
گرافیک برداری مقیاس‌پذیر (SVG)
.IP \(bu
چاپگر ویندوز (Windows Printer)
.PP
.B pdftocairo
فایل PDF ورودی،
.IR PDF-file ،
را خوانده و در
.IR output-file
می‌نویسد. قالب‌های تصویری (PNG، JPEG و TIFF) به ازای هر صفحه یک فایل تولید می‌کنند که شمارهٔ صفحه و پسوند نوع فایل به انتهای
.IR output-file
افزوده می‌شود. هنگامی که از \-singlefile همراه با قالب‌های تصویری استفاده شود، تنها پسوند نوع فایل به
.IR output-file
اضافه خواهد شد. زمانی که قالب خروجی یک قالب برداری باشد (PDF، PS، EPS و SVG)،
.IR output-file
نام کامل فایل خروجی خواهد بود.

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