.\" Copyright 1998-2011 Glyph & Cog, LLC
.TH pdfimages 1 "15 August 2011"
.SH "نام (NAME)"
pdfimages \- استخراج‌کننده تصاویر از اسناد با قالب سند انتقال‌پذیر (PDF) (نسخه ۳.۰۳)
.SH "خلاصه دستور (SYNOPSIS)"
.B pdfimages
[گزینه‌ها]
.I PDF-file image-root
.SH "توضیحات (DESCRIPTION)"
دستور
.B pdfimages
تصاویر را از یک فایل «قالب سند انتقال‌پذیر» (PDF) به صورت فایل‌های Portable
Pixmap (PPM)، Portable Bitmap (PBM)، Portable Network Graphics (PNG)،
Tagged Image File Format (TIFF)، JPEG، JPEG2000 یا JBIG2 ذخیره می‌کند.
.PP
دستور pdfimages فایل PDF با نام
.IR PDF-file
را می‌خواند، یک یا چند صفحه را پویش کرده و برای هر تصویر یک فایل با الگوی
.IR image-root - nnn . xxx
می‌نویسد، که در آن
.I nnn
شماره تصویر و
.I xxx
نوع تصویر (.ppm، .pbm، .png، .tif، .jpg، jp2، jb2e یا jb2g) است. اگر
.I PDF-file
به صورت \'-' مشخص شود، فایل PDF از ورودی استاندارد (stdin) خوانده می‌شود.
.PP
قالب خروجی پیش‌فرض برای تصاویر سیاه و سفید (تک‌رنگ) PBM و برای تصاویر غیر تک‌رنگ PPM است. گزینه‌های \-png یا \-tiff قالب پیش‌فرض خروجی را به ترتیب به PNG یا TIFF تغییر می‌دهند. اگر هر دو گزینهٔ \-png و \-tiff مشخص شده باشند، تصاویر CMYK به صورت TIFF و تمام تصاویر دیگر به صورت PNG نوشته خواهند شد. علاوه بر این، گزینه‌های \-j، \-jp2 و \-jbig2 به ترتیب باعث می‌شوند تصاویر JPEG، JPEG2000 و JBIG2 موجود در فایل PDF با قالب بومی و اصلی خود ذخیره شوند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-f " number"
مشخص کردن نخستین صفحه‌ای که باید پویش شود.
.TP
.BI \-l " number"
مشخص کردن آخرین صفحه‌ای که باید پویش شود.
.TP
.B \-png
تغییر قالب خروجی پیش‌فرض به PNG.
.TP
.B \-tiff
تغییر قالب خروجی پیش‌فرض به TIFF.
.TP
.B \-j
ذخیره تصاویر در قالب JPEG به صورت فایل‌های JPEG به جای قالب پیش‌فرض. فایل JPEG دقیقاً مشابه داده‌های JPEG ذخیره‌شده در فایل PDF است.
.TP
.B \-jp2
ذخیره تصاویر در قالب JPEG2000 به صورت فایل‌های JP2 به جای قالب پیش‌فرض. فایل JP2 دقیقاً مشابه داده‌های JPEG2000 ذخیره‌شده در فایل PDF است.
.TP
.B \-jbig2
ذخیره تصاویر در قالب JBIG2 به صورت فایل‌های JBIG2 به جای قالب پیش‌فرض. داده‌های JBIG2 در PDF از نوع تعبیه‌شده (embedded) هستند. این نوع می‌تواند فایلی جداگانه و اختیاری شامل داده‌های سراسری (global data) داشته باشد. داده‌های تعبیه‌شده با پسوند .jb2e و داده‌های سراسری (در صورت وجود) با همان شماره تصویر و با پسوند .jb2g ذخیره می‌شوند. محتوای هر دوی این فایل‌ها دقیقاً مشابه داده‌های JBIG2 در PDF است.
.TP
.B \-ccitt
ذخیره تصاویر در قالب CCITT به صورت فایل‌های CCITT به جای قالب پیش‌فرض. فایل CCITT دقیقاً مشابه داده‌های CCITT ذخیره‌شده در PDF است. فایل‌های PDF دارای پارامترهای اضافی هستند که نحوه رمزگشایی داده‌های CCITT را مشخص می‌کنند. این پارامترها به گزینه‌های ورودی fax2tiff ترجمه شده و در یک فایل با پسوند .params و با همان شماره تصویر نوشته می‌شوند. این پارامترها عبارتند از:
.RS
.TP
.B \-1
کدگذاری 1D Group 3
.TP
.B \-2
کدگذاری 2D Group 3
.TP
.B \-4
کدگذاری Group 4
.TP
.B \-A
آغاز سطر روی مرز بایت تراز شده است (byte boundary)
.TP
.B \-P
آغاز سطر روی مرز بایت تراز نشده است
.TP
.B \-X n
عرض تصویر بر حسب پیکسل
.TP
.B \-W
کدگذاری از ۱ برای سیاه و از ۰ برای سفید استفاده می‌کند
.TP
.B \-B
کدگذاری از ۰ برای سیاه و از ۱ برای سفید استفاده می‌کند
.TP
.B \-M
داده‌های ورودی از باارزش‌ترین بیت (MSB) به کم‌ارزش‌ترین بیت (LSB) پر می‌شوند.
.RE
.TP
.BI \-min-height " number"
تصاویری که ارتفاع کمتری دارند نادیده گرفته می‌شوند.
.TP
.BI \-min-width " number"
تصاویری که عرض کمتری دارند نادیده گرفته می‌شوند.
.TP
.B \-all
ذخیره تصاویر JPEG، JPEG2000، JBIG2 و CCITT در قالب بومی و اصلی خودشان. فایل‌های CMYK به صورت فایل‌های TIFF ذخیره می‌شوند و تمام تصاویر دیگر به صورت فایل‌های PNG نوشته خواهند شد. این حالت معادل مشخص کردن گزینه‌های \-png \-tiff \-j \-jp2 \-jbig2 \-ccitt است.
.TP
.B \-list
به جای ذخیره تصاویر، اطلاعات مختلف مربوط به هر تصویر را فهرست می‌کند. هنگام استفاده از این گزینه نباید
.IR image-root
را مشخص کنید.
.IP
اطلاعات زیر برای هر تصویر فهرست می‌شود:
.RS
.TP
.B page
شماره صفحه‌ای که تصویر در آن قرار دارد
.TP
.B num
شماره تصویر
.TP
.B type
نوع تصویر:
.PP
.RS
image - یک تصویر کدر (opaque)
.RE
.RS
mask - یک تصویر ماسک تک‌رنگ (monochrome mask)
.RE
.RS
smask - یک تصویر سافت‌ماسک / ماسک نرم (soft-mask)
.RE
.RS
stencil - یک تصویر ماسک تک‌رنگ که برای رنگ‌آمیزی یا اعمال الگو استفاده می‌شود
.RE
.PP
نکته: شفافیت در تصاویر در ساختار PDF از طریق یک تصویر مجزا برای خود تصویر اصلی و ماسک/سافت‌ماسک نمایش داده می‌شود. ماسک/سافت‌ماسکی که به عنوان بخشی از یک تصویر شفاف به کار می‌رود، همواره در فهرست تصاویر بلافاصله پس از تصویر اصلی قرار می‌گیرد.
.TP
.B width
عرض تصویر (بر حسب پیکسل)
.TP
.B height
ارتفاع تصویر (بر حسب پیکسل)
.PP
نکته: عرض/ارتفاع تصویر بیانگر اندازه تصویر تعبیه‌شده است، نه اندازه‌ای که تصویر در صفحه نمایش داده (رندر) می‌شود.
.TP
.B color
فضای رنگی تصویر:
.PP
.RS
gray - خاکستری (Gray)
.RE
.RS
rgb - رنگی RGB
.RE
.RS
cmyk - رنگی CMYK
.RE
.RS
lab - فضای L*a*b
.RE
.RS
icc - مبتنی بر ICC
.RE
.RS
index - رنگ نمایه‌شده (Indexed Color)
.RE
.RS
sep - تفکیک (Separation)
.RE
.RS
devn - مدل DeviceN
.RE
.TP
.B comp
تعداد مؤلفه‌های رنگ
.TP
.B bpc
تعداد بیت در هر مؤلفه (bits per component)
.TP
.B enc
کدگذاری:
.PP
.RS
image - تصویر شطرنجی/رستری (ممکن است با Flate یا LZW فشرده شده باشد، اما از کدگذاری تصویر استفاده نمی‌کند)
.RE
.RS
jpeg - استاندارد JPEG
.RE
.RS
jp2 - استاندارد JPEG2000
.RE
.RS
jbig2 - استاندارد JBIG2
.RE
.RS
ccitt - فکس CCITT Group 3 یا Group 4
.RE
.TP
.B interp
در صورت انجام میان‌یابی (interpolation) هنگام بزرگ‌نمایی تصویر، مقدار "yes" خواهد بود
.TP
.B object ID
شناسه شیء دیکشنری تصویر (شماره و نسل)
.TP
.B x\-ppi
وضوح افقی تصویر (بر حسب پیکسل در هر اینچ) هنگام رندر شدن در صفحه PDF.
.TP
.B y\-ppi
وضوح عمودی تصویر (بر حسب پیکسل در هر اینچ) هنگام رندر شدن در صفحه PDF.
.TP
.B size
اندازه تصویر تعبیه‌شده در فایل PDF. از پسوندهای زیر استفاده می‌شود: 'B' برای بایت، 'K' برای کیلوبایت، 'M' برای مگابایت و 'G' برای گیگابایت.
.TP
.B ratio
نسبت فشرده‌سازی تصویر تعبیه‌شده.
.RE
.TP
.BI \-opw " password"
مشخص کردن گذرواژه مالک (owner password) برای فایل PDF. وارد کردن این گذرواژه تمام محدودیت‌های امنیتی را دور می‌زند.
.TP
.BI \-upw " password"
مشخص کردن گذرواژه کاربر (user password) برای فایل PDF.
.TP
.B \-p
گنجاندن شماره صفحه در نام فایل‌های خروجی.
.TP
.B \-print\-filenames
چاپ نام فایل‌های تصویر در خروجی استاندارد (stdout).
.TP
.B \-q
عدم چاپ هیچ‌گونه پیام یا خطا.
.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 "نویسندگان (AUTHORS)"
حق نشر نرم‌افزار pdfimages و مستندات آن متعلق به Glyph & Cog, LLC (سال‌های ۱۹۹۸-۲۰۱۱) است.
.SH "همچنین ببینید (SEE ALSO)"
.BR pdfdetach (1),
.BR pdffonts (1),
.BR pdfinfo (1),
.BR pdftocairo (1),
.BR pdftohtml (1),
.BR pdftoppm (1),
.BR pdftops (1),
.BR pdftotext (1)
.BR pdfseparate (1),
.BR pdfsig (1),
.BR pdfunite (1)