نام (NAME)

pdfimages - استخراج‌کننده تصاویر از اسناد با قالب سند انتقال‌پذیر (PDF) (نسخه ۳.۰۳)

خلاصه دستور (SYNOPSIS)

pdfimages [گزینه‌ها] PDF-file image-root

توضیحات (DESCRIPTION)

دستور pdfimages تصاویر را از یک فایل «قالب سند انتقال‌پذیر» (PDF) به صورت فایل‌های Portable Pixmap (PPM)، Portable Bitmap (PBM)، Portable Network Graphics (PNG)، Tagged Image File Format (TIFF)، JPEG، JPEG2000 یا JBIG2 ذخیره می‌کند.

دستور pdfimages فایل PDF با نام PDF-file را می‌خواند، یک یا چند صفحه را پویش کرده و برای هر تصویر یک فایل با الگوی image-root-nnn.xxx می‌نویسد، که در آن nnn شماره تصویر و xxx نوع تصویر (.ppm، .pbm، .png، .tif، .jpg، jp2، jb2e یا jb2g) است. اگر PDF-file به صورت ´-' مشخص شود، فایل PDF از ورودی استاندارد (stdin) خوانده می‌شود.

قالب خروجی پیش‌فرض برای تصاویر سیاه و سفید (تک‌رنگ) PBM و برای تصاویر غیر تک‌رنگ PPM است. گزینه‌های -png یا -tiff قالب پیش‌فرض خروجی را به ترتیب به PNG یا TIFF تغییر می‌دهند. اگر هر دو گزینهٔ -png و -tiff مشخص شده باشند، تصاویر CMYK به صورت TIFF و تمام تصاویر دیگر به صورت PNG نوشته خواهند شد. علاوه بر این، گزینه‌های -j، -jp2 و -jbig2 به ترتیب باعث می‌شوند تصاویر JPEG، JPEG2000 و JBIG2 موجود در فایل PDF با قالب بومی و اصلی خود ذخیره شوند.

گزینه‌ها (OPTIONS)

-f number: مشخص کردن نخستین صفحه‌ای که باید پویش شود.
-l number: مشخص کردن آخرین صفحه‌ای که باید پویش شود.
-png: تغییر قالب خروجی پیش‌فرض به PNG.
-tiff: تغییر قالب خروجی پیش‌فرض به TIFF.
-j: ذخیره تصاویر در قالب JPEG به صورت فایل‌های JPEG به جای قالب پیش‌فرض. فایل JPEG دقیقاً مشابه داده‌های JPEG ذخیره‌شده در فایل PDF است.
-jp2: ذخیره تصاویر در قالب JPEG2000 به صورت فایل‌های JP2 به جای قالب پیش‌فرض. فایل JP2 دقیقاً مشابه داده‌های JPEG2000 ذخیره‌شده در فایل PDF است.
-jbig2: ذخیره تصاویر در قالب JBIG2 به صورت فایل‌های JBIG2 به جای قالب پیش‌فرض. داده‌های JBIG2 در PDF از نوع تعبیه‌شده (embedded) هستند. این نوع می‌تواند فایلی جداگانه و اختیاری شامل داده‌های سراسری (global data) داشته باشد. داده‌های تعبیه‌شده با پسوند .jb2e و داده‌های سراسری (در صورت وجود) با همان شماره تصویر و با پسوند .jb2g ذخیره می‌شوند. محتوای هر دوی این فایل‌ها دقیقاً مشابه داده‌های JBIG2 در PDF است.
-ccitt: ذخیره تصاویر در قالب CCITT به صورت فایل‌های CCITT به جای قالب پیش‌فرض. فایل CCITT دقیقاً مشابه داده‌های CCITT ذخیره‌شده در PDF است. فایل‌های PDF دارای پارامترهای اضافی هستند که نحوه رمزگشایی داده‌های CCITT را مشخص می‌کنند. این پارامترها به گزینه‌های ورودی fax2tiff ترجمه شده و در یک فایل با پسوند .params و با همان شماره تصویر نوشته می‌شوند. این پارامترها عبارتند از:

-1: کدگذاری 1D Group 3
-2: کدگذاری 2D Group 3
-4: کدگذاری Group 4
-A: آغاز سطر روی مرز بایت تراز شده است (byte boundary)
-P: آغاز سطر روی مرز بایت تراز نشده است
-X n: عرض تصویر بر حسب پیکسل
-W: کدگذاری از ۱ برای سیاه و از ۰ برای سفید استفاده می‌کند
-B: کدگذاری از ۰ برای سیاه و از ۱ برای سفید استفاده می‌کند
-M: داده‌های ورودی از باارزش‌ترین بیت (MSB) به کم‌ارزش‌ترین بیت (LSB) پر می‌شوند.

-min-height number: تصاویری که ارتفاع کمتری دارند نادیده گرفته می‌شوند.
-min-width number: تصاویری که عرض کمتری دارند نادیده گرفته می‌شوند.
-all: ذخیره تصاویر JPEG، JPEG2000، JBIG2 و CCITT در قالب بومی و اصلی خودشان. فایل‌های CMYK به صورت فایل‌های TIFF ذخیره می‌شوند و تمام تصاویر دیگر به صورت فایل‌های PNG نوشته خواهند شد. این حالت معادل مشخص کردن گزینه‌های -png -tiff -j -jp2 -jbig2 -ccitt است.
-list: به جای ذخیره تصاویر، اطلاعات مختلف مربوط به هر تصویر را فهرست می‌کند. هنگام استفاده از این گزینه نباید image-root را مشخص کنید.

: اطلاعات زیر برای هر تصویر فهرست می‌شود:

page: شماره صفحه‌ای که تصویر در آن قرار دارد
num: شماره تصویر
type: نوع تصویر:

image - یک تصویر کدر (opaque)

mask - یک تصویر ماسک تک‌رنگ (monochrome mask)

smask - یک تصویر سافت‌ماسک / ماسک نرم (soft-mask)

stencil - یک تصویر ماسک تک‌رنگ که برای رنگ‌آمیزی یا اعمال الگو استفاده می‌شود

نکته: شفافیت در تصاویر در ساختار PDF از طریق یک تصویر مجزا برای خود تصویر اصلی و ماسک/سافت‌ماسک نمایش داده می‌شود. ماسک/سافت‌ماسکی که به عنوان بخشی از یک تصویر شفاف به کار می‌رود، همواره در فهرست تصاویر بلافاصله پس از تصویر اصلی قرار می‌گیرد.

width: عرض تصویر (بر حسب پیکسل)
height: ارتفاع تصویر (بر حسب پیکسل)

نکته: عرض/ارتفاع تصویر بیانگر اندازه تصویر تعبیه‌شده است، نه اندازه‌ای که تصویر در صفحه نمایش داده (رندر) می‌شود.

color: فضای رنگی تصویر:

gray - خاکستری (Gray)

rgb - رنگی RGB

cmyk - رنگی CMYK

lab - فضای L*a*b

icc - مبتنی بر ICC

index - رنگ نمایه‌شده (Indexed Color)

sep - تفکیک (Separation)

devn - مدل DeviceN

comp: تعداد مؤلفه‌های رنگ
bpc: تعداد بیت در هر مؤلفه (bits per component)
enc: کدگذاری:

image - تصویر شطرنجی/رستری (ممکن است با Flate یا LZW فشرده شده باشد، اما از کدگذاری تصویر استفاده نمی‌کند)

jpeg - استاندارد JPEG

jp2 - استاندارد JPEG2000

jbig2 - استاندارد JBIG2

ccitt - فکس CCITT Group 3 یا Group 4

interp: در صورت انجام میان‌یابی (interpolation) هنگام بزرگ‌نمایی تصویر، مقدار "yes" خواهد بود
object ID: شناسه شیء دیکشنری تصویر (شماره و نسل)
x-ppi: وضوح افقی تصویر (بر حسب پیکسل در هر اینچ) هنگام رندر شدن در صفحه PDF.
y-ppi: وضوح عمودی تصویر (بر حسب پیکسل در هر اینچ) هنگام رندر شدن در صفحه PDF.
size: اندازه تصویر تعبیه‌شده در فایل PDF. از پسوندهای زیر استفاده می‌شود: 'B' برای بایت، 'K' برای کیلوبایت، 'M' برای مگابایت و 'G' برای گیگابایت.
ratio: نسبت فشرده‌سازی تصویر تعبیه‌شده.

-opw password: مشخص کردن گذرواژه مالک (owner password) برای فایل PDF. وارد کردن این گذرواژه تمام محدودیت‌های امنیتی را دور می‌زند.
-upw password: مشخص کردن گذرواژه کاربر (user password) برای فایل PDF.
-p: گنجاندن شماره صفحه در نام فایل‌های خروجی.
-print-filenames: چاپ نام فایل‌های تصویر در خروجی استاندارد (stdout).
-q: عدم چاپ هیچ‌گونه پیام یا خطا.
-v: چاپ اطلاعات کپی‌رایت و نسخه برنامه.
-h: چاپ اطلاعات نحوه استفاده از دستور. (-help و --help یکسان هستند.)

وضعیت خروج (EXIT STATUS)

ابزارهای Xpdf از کدهای خروج زیر استفاده می‌کنند:

0: بدون خطا.
1: خطا در باز کردن فایل PDF.
2: خطا در باز کردن یک فایل خروجی.
3: خطای مربوط به دسترسی‌ها و مجوزهای PDF.
99: خطاهای دیگر.

نویسندگان (AUTHORS)

حق نشر نرم‌افزار pdfimages و مستندات آن متعلق به Glyph & Cog, LLC (سال‌های ۱۹۹۸-۲۰۱۱) است.

همچنین ببینید (SEE ALSO)

pdfdetach(1), pdffonts(1), pdfinfo(1), pdftocairo(1), pdftohtml(1), pdftoppm(1), pdftops(1), pdftotext(1) pdfseparate(1), pdfsig(1), pdfunite(1)