| pdftopng(1) | General Commands Manual | pdftopng(1) |
نام (NAME)
pdftopng - تبدیل اسناد با قالب سند قابل حمل (PDF) به تصاویر گرافیک شبکه‌ای قابل حمل (PNG)
خلاصه دستور (SYNOPSIS)
pdftopng [گزینه‌ها] PDF-file PNG-root
توضیحات (DESCRIPTION)
Pdftopng فایل‌های با قالب سند قابل حمل (PDF) را به فایل‌های تصویری رنگی، مقیاس خاکستری یا تک‌رنگ در قالب گرافیک شبکه‌ای قابل حمل (PNG) تبدیل می‌کند.
دستور Pdftopng فایل PDF، PDF-file، را می‌خواند و برای هر صفحه یک فایل PNG، PNG-root-nnnnnn.png، می‌نویسد که در آن nnnnnn شماره صفحه است. اگر PNG-root برابر ´-' باشد، تصویر به خروجی استاندارد (stdout) ارسال می‌شود (این حالت معمولاً فقط هنگام تبدیل یک صفحه منفرد مفید است).
فایل پیکربندی (CONFIGURATION FILE)
دستور Pdftopng هنگام راه‌اندازی، یک فایل پیکربندی را می‌خواند. ابتدا تلاش می‌کند فایل پیکربندی اختصاصی کاربر، ~/.xpdfrc را بیابد. اگر آن فایل وجود نداشته باشد، به دنبال فایل پیکربندی سراسری سیستم، معمولاً /etc/xpdfrc می‌گردد (البته این مسیر ممکن است در زمان ساخت pdftopng تغییر کرده باشد). برای جزئیات به صفحه راهنمای xpdfrc(5) مراجعه کنید.
گزینه‌ها (OPTIONS)
بسیاری از گزینه‌های زیر را می‌توان با دستورات فایل پیکربندی تنظیم کرد. این موارد درون کروشه در کنار توضیحات گزینه متناظر خط فرمان فهرست شده‌اند.
- -f number
- اولین صفحه را برای تبدیل مشخص می‌کند.
- -l number
- آخرین صفحه را برای تبدیل مشخص می‌کند.
- -r number
- وضوح تصویر (رزولوشن) را بر حسب DPI مشخص می‌کند. مقدار پیش‌فرض 150 DPI است.
- -mono
- تولید تصویر تک‌رنگ (به‌جای تصویر رنگی).
- -gray
- تولید تصویر در مقیاس خاکستری (به‌جای تصویر رنگی).
- -alpha
- یک کانال آلفا در فایل PNG تولید می‌کند. این گزینه فقط برای فایل‌های PDF که با پس‌زمینه شفاف ساخته شده‌اند کاربرد دارد. گزینه -alpha همراه با -mono قابل استفاده نیست.
- -rot angle
- صفحات را به اندازه 0 (پیش‌فرض)، 90، 180 یا 270 درجه می‌چرخاند.
- -freetype yes | no
- ابزار FreeType (مبدل شطرنجی فونت‌های TrueType / Type 1) را فعال یا غیرفعال می‌کند. مقدار پیش‌فرض "yes" است. [دستور فایل پیکربندی: enableFreeType]
- -aa yes | no
- هموارسازی قلم (anti-aliasing) را فعال یا غیرفعال می‌کند. مقدار پیش‌فرض "yes" است. [دستور فایل پیکربندی: antialias]
- -aaVector yes | no
- هموارسازی برداری (vector anti-aliasing) را فعال یا غیرفعال می‌کند. مقدار پیش‌فرض "yes" است. [دستور فایل پیکربندی: vectorAntialias]
- -opw password
- تعیین گذرواژه مالک برای فایل PDF. ارائه این گذرواژه تمامی محدودیت‌های امنیتی را دور می‌زند.
- -upw password
- تعیین گذرواژه کاربر برای فایل PDF.
- -verbose
- چاپ پیام وضعیت (در خروجی استاندارد stdout) پیش از پردازش هر صفحه. [دستور فایل پیکربندی: printStatusInfo]
- -q
- هیچ پیام یا خطایی چاپ نشود. [دستور فایل پیکربندی: errQuiet]
- -cfg config-file
- خواندن config-file به‌جای ~/.xpdfrc یا فایل پیکربندی سراسری سیستم.
- -v
- چاپ اطلاعات حق نشر و نگارش.
- -h
- چاپ اطلاعات نحوه استفاده. (-help و --help معادل یکدیگر هستند.)
کدهای خروج (EXIT CODES)
ابزارهای Xpdf از کدهای خروج زیر استفاده می‌کنند:
- 0
- بدون خطا.
- 1
- خطا در باز کردن فایل PDF.
- 2
- خطا در باز کردن فایل خروجی.
- 3
- خطای مربوط به دسترسی‌ها و مجوزهای PDF.
- 98
- اتمام حافظه (Out of memory).
- 99
- سایر خطاها.
نویسنده (AUTHOR)
حق نشر نرم‌افزار pdftopng و مستندات آن متعلق به Glyph & Cog, LLC (سال‌های 1996-2025) است.
همچنین ببینید (SEE ALSO)
xpdf(1), pdftops(1), pdftotext(1),
pdftohtml(1), pdfinfo(1), pdffonts(1),
pdfdetach(1), pdftoppm(1), pdfimages(1),
xpdfrc(5)
http://www.xpdfreader.com
| 14 Nov 2025 |