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