| pdftoppm(1) | General Commands Manual | pdftoppm(1) |
نام (NAME)
pdftoppm - مبدل پرونده‌های سند قابل‌حمل (PDF) به نگاشت‌پیکسل قابل‌حمل (PPM) (نسخه 3.03)
خلاصه دستور (SYNOPSIS)
pdftoppm [options] PDF-file PPM-root
توضیحات (DESCRIPTION)
دستور pdftoppm فایل‌های «فرمت سند قابل‌حمل» (PDF) را به فایل‌های تصویری رنگی در قالب «نگاشت‌پیکسل قابل‌حمل» (PPM)، فایل‌های تصویری مقیاس‌خاکستری در قالب «نگاشت‌خاکستری قابل‌حمل» (PGM)، یا فایل‌های تصویری تک‌رنگ در قالب «بیت‌نگاشت قابل‌حمل» (PBM) تبدیل می‌کند.
دستور Pdftoppm فایل PDF را با نام PDF-file خوانده و برای هر صفحه، یک فایل PPM با الگوی PPM-root-number.ppm می‌نویسد، که در آن number شماره صفحه است. اگر PDF-file برابر با '-' باشد، فایل PDF را از ورودی استاندارد (stdin) می‌خواند.
گزینه‌ها (OPTIONS)
- -f number
- نخستین صفحه‌ای را که باید تبدیل شود مشخص می‌کند.
- -l number
- آخرین صفحه‌ای را که باید تبدیل شود مشخص می‌کند.
- -o
- تنها صفحه‌های فرد را تولید می‌کند.
- -e
- تنها صفحه‌های زوج را تولید می‌کند.
- -singlefile
- تنها نخستین صفحه را می‌نویسد و ارقام شماره صفحه را اضافه نمی‌کند.
- -r number
- وضوح تصویر را بر حسب DPI برای هر دو محور X و Y مشخص می‌کند. مقدار پیش‌فرض 150 DPI است.
- -rx number
- وضوح تصویر بر حسب DPI برای محور X را مشخص می‌کند. مقدار پیش‌فرض 150 DPI است.
- -ry number
- وضوح تصویر بر حسب DPI برای محور Y را مشخص می‌کند. مقدار پیش‌فرض 150 DPI است.
- -scale-to number
- ضلع بزرگتر هر صفحه (عرض برای صفحه‌های افقی، ارتفاع برای صفحه‌های عمودی) را طوری مقیاس‌بندی می‌کند که در تعداد پیکسل‌های scale-to جای گیرد. اندازه ضلع کوچکتر بر اساس نسبت ابعاد صفحه تعیین خواهد شد.
- -scale-to-x number
- هر صفحه را به‌صورت افقی مقیاس‌بندی می‌کند تا در تعداد پیکسل‌های scale-to-x جای گیرد. اگر scale-to-y برابر با -1 تنظیم شده باشد، اندازه عمودی بر اساس نسبت ابعاد صفحه تعیین خواهد شد.
- -scale-to-y number
- هر صفحه را به‌صورت عمودی مقیاس‌بندی می‌کند تا در تعداد پیکسل‌های scale-to-y جای گیرد. اگر scale-to-x برابر با -1 تنظیم شده باشد، اندازه افقی بر اساس نسبت ابعاد صفحه تعیین خواهد شد.
- -scale-dimension-before-rotation
- ابعاد افقی و عمودی را برای یک PDF چرخیده‌شده (افقی) پیش از مقیاس‌بندی جابه‌جا می‌کند، نه پس از آن.
- -x number
- مختصات x گوشه بالا-چپ ناحیه برش را مشخص می‌کند.
- -y number
- مختصات y گوشه بالا-چپ ناحیه برش را مشخص می‌کند.
- -W number
- عرض ناحیه برش را بر حسب پیکسل مشخص می‌کند (پیش‌فرض 0 است).
- -H number
- ارتفاع ناحیه برش را بر حسب پیکسل مشخص می‌کند (پیش‌فرض 0 است).
- -sz number
- اندازه مربع برش را بر حسب پیکسل مشخص می‌کند (هم W و هم H را تنظیم می‌کند).
- -cropbox
- هنگام تولید فایل‌ها، به‌جای media box از crop box استفاده می‌کند.
- -hide-annotations
- حاشیه‌نویسی‌ها و یادداشت‌ها نمایش داده نشوند.
- -mono
- یک فایل تک‌رنگ PBM (به‌جای فایل رنگی PPM) تولید می‌کند.
- -gray
- یک فایل مقیاس‌خاکستری PGM (به‌جای فایل رنگی PPM) تولید می‌کند.
- -displayprofile displayprofilefile
- اگر poppler با پشتیبانی از مدیریت رنگ کامپایل شده باشد، این گزینه پروفایل نمایشگر را روی پروفایل ICC ذخیره‌شده در displayprofilefile تنظیم می‌کند.
- -defaultgrayprofile defaultgrayprofilefile
- اگر poppler با پشتیبانی از مدیریت رنگ کامپایل شده باشد، این گزینه فضای رنگی DefaultGray را روی پروفایل ICC ذخیره‌شده در defaultgrayprofilefile تنظیم می‌کند.
- -defaultrgbprofile defaultrgbprofilefile
- اگر poppler با پشتیبانی از مدیریت رنگ کامپایل شده باشد، این گزینه فضای رنگی DefaultRGB را روی پروفایل ICC ذخیره‌شده در defaultrgbprofilefile تنظیم می‌کند.
- -defaultcmykprofile defaultcmykprofilefile
- اگر poppler با پشتیبانی از مدیریت رنگ کامپایل شده باشد، این گزینه فضای رنگی DefaultCMYK را روی پروفایل ICC ذخیره‌شده در defaultcmykprofilefile تنظیم می‌کند.
- -png
- به‌جای یک فایل PPM، یک فایل PNG تولید می‌کند.
- -jpeg
- به‌جای یک فایل PPM، یک فایل JPEG تولید می‌کند.
- -jpegopt jpeg-options
- هنگام استفاده با -jpeg، فهرستی از گزینه‌ها را برای کنترل فشرده‌سازی jpeg دریافت می‌کند. برای گزینه‌های در دسترس بخش گزینه‌های JPEG (JPEG OPTIONS) را ببینید.
- -tiff
- به‌جای یک فایل PPM، یک فایل TIFF تولید می‌کند.
- -tiffcompression none | packbits | jpeg | lzw | deflate
- نوع فشرده‌سازی TIFF را مشخص می‌کند. مقدار پیش‌فرض "none" است.
- -freetype yes | no
- سامانه FreeType (رسترایزر قلم‌های TrueType / Type 1) را فعال یا غیرفعال می‌کند. مقدار پیش‌فرض "yes" است.
- -thinlinemode none | solid | shape
- حالت خطوط باریک را مشخص می‌کند. مقدار پیش‌فرض "none" است.
- "solid":
- خطوط با پهنای کمتر از یک پیکسل را با مرز پیکسل تطبیق داده و آن را با پهنای یک پیکسل رسم می‌کند.
- "shape":
- خطوط با پهنای کمتر از یک پیکسل را با مرز پیکسل تطبیق داده و آن را با پهنای یک پیکسل اما با شکلی متناسب با پهنای آن رسم می‌کند.
- -aa yes | no
- صاف‌سازی لبه‌های قلم (anti-aliasing) را فعال یا غیرفعال می‌کند. مقدار پیش‌فرض "yes" است.
- -aaVector yes | no
- صاف‌سازی لبه‌های برداری (vector anti-aliasing) را فعال یا غیرفعال می‌کند. مقدار پیش‌فرض "yes" است.
- -opw password
- رمز عبور مالک (owner password) را برای فایل PDF مشخص می‌کند. ارائه این رمز تمامی محدودیت‌های امنیتی را دور می‌زند.
- -upw password
- رمز عبور کاربر (user password) را برای فایل PDF مشخص می‌کند.
- -q
- هیچ پیام یا خطایی چاپ نشود.
- -progress
- هنگام تولید هر صفحه، اطلاعات پیشرفت را چاپ می‌کند. سه فیلدِ جداشده با فاصله در خروجی خطای استاندارد (STDERR) چاپ می‌شوند: شماره صفحه فعلی، شماره آخرین صفحه‌ای که تولید خواهد شد، و مسیر فایلی که در آن نوشته شده است.
- -sep char
- یک تک‌نویسه را به‌عنوان جداکننده میان نام و شماره صفحه مشخص می‌کند؛ پیش‌فرض - است.
- -forcenum
- درج شماره صفحه را حتی اگر تنها یک صفحه وجود داشته باشد، اجباری می‌کند.
- -v
- اطلاعات حق تکثیر و نسخه را چاپ می‌کند.
- -h
- اطلاعات نحوه استفاده را چاپ می‌کند. (-help و --help معادل هستند.)
وضعیت خروج (EXIT STATUS)
ابزارهای Xpdf از کدهای خروج زیر استفاده می‌کنند:
- 0
- بدون خطا.
- 1
- خطا در باز کردن فایل PDF.
- 2
- خطا در باز کردن فایل خروجی.
- 3
- خطای مرتبط با مجوزهای فایل PDF.
- 99
- سایر خطاها.
گزینه‌های JPEG (JPEG OPTIONS)
هنگامی که خروجی JPEG تعیین شده باشد، می‌توان از گزینه -jpegopt برای کنترل پارامترهای فشرده‌سازی JPEG استفاده کرد. این گزینه رشته‌ای به شکل "<opt>=<val>[,<opt>=<val>]" دریافت می‌کند. گزینه‌های دردسترس فعلی عبارتند از:
- quality
- مقدار کیفیت JPEG را مشخص می‌کند. این مقدار باید یک عدد صحیح بین 0 تا 100 باشد.
- progressive
- خروجی تدریجی (progressive) JPEG را انتخاب می‌کند. مقادیر ممکن "y" و "n" هستند که به‌ترتیب بیانگر تدریجی (بله) یا غیرتدریجی (خیر) می‌باشند.
- optimize
- تعیین می‌کند که آیا جدول‌های کدگذاری هافمن بهینه برای خروجی JPEG محاسبه شوند یا خیر، که این کار فایل‌های کوچکتری ایجاد می‌کند اما نیازمند یک مرحله پیمایش اضافی روی داده‌ها است. مقدار باید "y" یا "n" باشد؛ "y" بهینه‌سازی را انجام می‌دهد، در غیر این صورت از جدول‌های پیش‌فرض هافمن استفاده خواهد شد.
نویسندگان (AUTHORS)
حق امتیاز نرم‌افزار و مستندات pdftoppm متعلق به Glyph & Cog, LLC (سال‌های 1996-2011) است.
همچنین ببینید (SEE ALSO)
pdfdetach(1), pdffonts(1), pdfimages(1), pdfinfo(1), pdftocairo(1), pdftohtml(1), pdftops(1), pdftotext(1) pdfseparate(1), pdfsig(1), pdfunite(1)
| 15 August 2011 |