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