نام (NAME)

mutool - ابزار همه‌منظوره برای کار با فایل‌های PDF

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

mutool sub-command [options]

توضیحات (DESCRIPTION)

دستور mutool ابزاری مبتنی بر MuPDF برای کار با فایل‌های سندی به روش‌های گوناگون است. چندین زیردستور مختلف در دسترس است که در ادامه شرح داده شده‌اند.

نسخه (VERSION)

mutool -v

نسخه MuPDF استفاده‌شده برای ساخت mutool را نمایش می‌دهد.

AUDIT

mutool audit [options] file1.pdf [file2.pdf ...]

گزارشی از عملگرها و فضای استفاده‌شده برای هر فایل PDF داده‌شده تولید می‌کند.

-o filename: نام فایل خروجی برای گزارش.

BAKE

mutool bake [options] input.pdf [output.pdf]

به‌طور معمول یادداشت‌ها (annotations) و ویجت‌های فیلدهای فرم، جریان‌های محتوایی جداگانه‌ای هستند که روی محتوای صفحه رسم می‌شوند. این دستور یادداشت‌ها و/یا ویجت‌ها را در محتوای صفحه ادغام و تثبیت (bake) می‌کند و آن‌ها را جدایی‌ناپذیر می‌سازد. پس از تثبیت یادداشت‌ها و ویجت‌ها، آن‌ها تنها بازنمایی‌هایی بصری از شکل قبلی یادداشت/ویجت اصلی خواهند بود؛ ویژگی‌های آن‌ها دیگر قابل ویرایش نیست زیرا دیگر به‌صورت یادداشت/ویجت واقعی وجود ندارند.

-A: یادداشت‌ها تثبیت نشوند.
-F: ویجت‌های فیلد فرم تثبیت نشوند.
-O options: فهرستی از گزینه‌های PDF جداشده با کاما. بخش PDF OUTPUT OPTIONS در ادامه را ببینید.

BARCODE

mutool barcode -d [options] file1.pdf [pages1] [file2.pdf] [pages2]

یک بارکد را از یک تصویر یا یک سند رمزگشایی می‌کند.

-p password: در صورت رمزگذاری شدن فایل، از گذرواژه مشخص‌شده استفاده می‌کند.
-o output: نام فایل خروجی. اگر خروجی مشخص نشود، هر متنی از بارکدهای رمزگشایی‌شده به stdout ارسال خواهد شد.
-r angle: میزان چرخش صفحات ورودی بر حسب درجه (0-360)، پیش از تلاش برای رمزگشایی بارکدها.
pages: فهرستی از شماره‌ها و بازه‌های صفحات جداشده با کاما (برای مثال: 1,5,10-15,20-N)، که در آن نویسه N بیانگر آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات پردازش خواهند شد.

mutool barcode -c [options] text

یک بارکد جدید شامل آرگومان text و قالب‌بندی‌شده بر اساس گزینه‌های مشخص‌شده ایجاد می‌کند.

-o output: قالب خروجی بر اساس نام فایل خروجی (PNG یا PDF) تعیین می‌شود. اگر خروجی مشخص نشود، پیش‌فرض out.png است.
-F format: قالب بارکد خروجی مورد نظر:
aztec
codabar
code39
code93
code128
databar
databarexpanded
datamatrix
ean8
ean13
itf
maxicode
pdf417
qrcode
upca
upce
microqrcode
rmqrcode
dxfilmedge
databarlimited
-s size: تنظیم اندازه بارکد خروجی بر حسب پیکسل. اگر مشخص نشود، کوچک‌ترین اندازه‌ای که قابل رمزگشایی باشد انتخاب خواهد شد.
-q: افزودن حاشیه امن (quiet zones) در اطراف بارکد. این گزینه یک حاشیه خالی در اطراف بارکدهای ایجادشده قرار می‌دهد.
-t: افزودن متن خوانا برای انسان، در صورت در دسترس بودن. برخی از بارکدها، مانند EAN-13، می‌توانند محتوای بارکد را به‌صورت متنی خوانا در کنار بارکد چاپ کنند که این قابلیت با این پرچم فعال می‌شود.
-t level: تنظیم سطح تصحیح خطا (0-8). برخی از بارکدها، مانند QR-codeها، از چندین سطح تصحیح خطا پشتیبانی می‌کنند که از طریق این گزینه قابل سفارشی‌سازی است.
text: متنی که باید در یک بارکد کدگذاری شود.

mutool clean [options] input.pdf [output.pdf] [pages ...]

دستور clean ساختار نحوی (syntax) یک فایل PDF را بازنویسی کرده و آن را به‌صورت مرتب قالب‌بندی (pretty print) می‌کند. از این دستور می‌توان برای تعمیر فایل‌های خراب، باز کردن جریان‌های (streams) فشرده، فیلتر کردن محدوده‌ای از صفحات و غیره استفاده کرد.

اگر هیچ فایل خروجی مشخص نشود، فایل PDF پاک‌سازی‌شده در "out.pdf" در دایرکتوری جاری نوشته خواهد شد.

-p password: در صورت رمزگذاری بودن فایل، از گذرواژه (password) مشخص‌شده استفاده می‌کند.
-g: جمع‌آوری زباله (Garbage collect) برای اشیائی (objects) که هیچ ارجاعی از اشیاء دیگر ندارند.
-gg: علاوه بر -g، تمام اشیاء را دوباره شماره‌گذاری کرده و جدول ارجاع متقابل (cross reference table) را فشرده می‌کند.
-ggg: علاوه بر -gg، اشیای تکراری را ادغام کرده و دوباره استفاده می‌کند.
-gggg: علاوه بر -ggg، جریان‌های (streams) تکراری را نیز ادغام کرده و دوباره استفاده می‌کند.
-l: دیگر پشتیبانی نمی‌شود! خطی‌سازی (Linearize) خروجی. برای ایجاد یک فایل خروجی «بهینه‌شده برای وب» (Web Optimized) استفاده می‌شود.
-D: ذخیره فایل بدون رمزگذاری.
-E method: ذخیره فایل با روش رمزگذاری دلخواه، یکی از موارد: rc4-40،rc40-128،aes-128، یا aes-256.
-O password: گذرواژه مالک (Owner password) که هنگام رمزگذاری فایل خروجی به کار می‌رود. این گذرواژه برای ویرایش فایل خروجی لازم است.
-U password: گذرواژه کاربر (User password) که هنگام رمزگذاری فایل خروجی به کار می‌رود. این گذرواژه برای مشاهده فایل خروجی لازم است.
-P permissions: مجوزهای مورد استفاده هنگام رمزگذاری فایل خروجی. این‌ها مجوزهایی هستند که هنگام مشاهده فایل خروجی اعمال خواهند شد.
-a: کدگذاری اسکی هگز (ASCII Hex encode) جریان‌های دودویی (binary streams). در ترکیب با -d و -i یا -f استفاده شود تا اطمینان حاصل گردد اگرچه تصاویر و/یا قلم‌ها فشرده شده‌اند، فایل حاصل همچنان می‌تواند با یک ویرایشگر متنی مشاهده و ویرایش شود.
-d: خارج کردن جریان‌ها از حالت فشرده (Decompress). این کار حجم فایل خروجی را افزایش می‌دهد، اما دسترسی آسان برای خواندن و ویرایش محتوا را با یک ویرایشگر متنی فراهم می‌سازد.
-z: فشرده‌سازی (Deflate) جریان‌های غیرفشرده.
در صورت ترکیب با -d، هر جریانِ از فشرده‌سازی خارج‌شده، مجدداً فشرده خواهد شد.
در صورت ترکیب با -a، جریان‌ها پس از فشرده‌سازی، کدگذاری هگز نیز خواهند شد.
-e effort: تنظیم میزان تلاشی که صرف فشرده‌سازی فایل خروجی می‌شود. مقدار 0 پیش‌فرض است، در غیر این صورت درصدی از حداکثر تلاش است؛ 1 برای حداقل و 100 برای حداکثر تلاش.
-f: تغییر وضعیت خارج کردن جریان‌های قلم (font streams) از حالت فشرده. در ترکیب با -d استفاده کنید تا قلم‌ها فشرده باقی بمانند.
-i: تغییر وضعیت خارج کردن جریان‌های تصویر (image streams) از حالت فشرده. در ترکیب با -d استفاده کنید تا تصاویر فشرده باقی بمانند.
-c: قالب‌بندی مرتب و خوانا (Pretty-print) دستورهای گرافیکی در جریان‌های محتوا (content streams).
-s: پاک‌سازی (Sanitize) دستورهای گرافیکی در جریان‌های محتوا؛ این به معنای، به عنوان مثال، حذف دستورهای نامعتبر یا زائد است.
-t: استفاده از نحو فشرده اشیاء PDF. این کار در فضا صرفه‌جویی می‌کند.
-tt: استفاده از نحو دندانه‌دار اشیاء PDF. این حالت برای خواندن انسان مناسب‌تر است.
-L: چاپ توضیحاتی (comments) حاوی برچسب‌هایی که نشان می‌دهند چگونه می‌توان از Root به هر شیء دسترسی پیدا کرد.
-v: تبدیل تمام متن‌ها به دستورهای گرافیک برداری (vector graphics commands).
-A: ایجاد جریان‌های ظاهری (appearance streams) برای حاشیه‌نویسی‌هایی (annotations) که فاقد آن‌ها هستند.
-AA: ایجاد مجدد جریان‌های ظاهری برای تمام حاشیه‌نویسی‌ها.
-m: حفظ فراداده (metadata).
-S: زیرمجموعه‌گیری قلم‌ها (Subset fonts) در صورت امکان. (آزمایشی!)
-Z: استفاده از جریان‌های اشیاء (object streams) و جریان‌های ارجاع متقابل (cross reference streams) برای فشرده‌سازی بیشتر.
--(color|gray|bitonal)-(|lossy-|lossless-)image-subsample-method=method: تنظیم روش زیرنمونه‌گیری (subsampling method) (average یا bicubic) برای انواع تصویر مورد نظر، به عنوان مثال color-lossy و bitonal-lossless.
--(color|gray|bitonal)-(|lossy-|lossless-)image-subsample-dpi=dpi[,dpi]: تنظیم تفکیک‌پذیری (dpi) که زیرنمونه‌گیری در آن انجام می‌شود.
--(color|gray|bitonal)-(|lossy-|lossless-)image-recompress-method=quality: تنظیم کیفیت فشرده‌سازی مجدد بر روی یکی از موارد: never، same، lossless، jpeg، j2k، fax، یا jbig2.
--recompress-images-when=(smaller|always): فشرده‌سازی مجدد تصاویر زمانی که تصاویر بازنویسی‌شده توسط روش‌های زیرنمونه‌گیری یا فشرده‌سازی مجددِ بالا smaller (پیش‌فرض) باشند، یا با always همواره آن‌ها را دوباره فشرده می‌کند.
--structure=(keep|drop): نگه‌داشتن یا دور انداختن درخت ساختار (structure tree)..TP pages فهرستی از شماره صفحات و محدوده‌ها که با کاما از هم جدا شده‌اند (برای مثال: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات گنجانده خواهند شد.

تبدیل (CONVERT)

mutool convert [options] input.pdf [pages ...]

دستور convert برای تبدیل یک فایل از یک قالب به قالب دیگر استفاده می‌شود.

-p password: در صورت رمزگذاری بودن فایل، از گذرواژه مشخص‌شده استفاده می‌کند.
-o output: قالب خروجی از روی نام فایل خروجی تشخیص داده می‌شود. برای مشخص کردن شماره صفحه، %d را در نام قرار دهید (برای مثال: "page%d.png"). اصلاح‌کننده‌های Printf پشتیبانی می‌شوند، برای مثال "%03d". اگر هیچ خروجی‌ای مشخص نشود، خروجی به stdout فرستاده می‌شود.
-F format: تحمیل یک قالب خروجی خاص. فقط هنگام ارسال خروجی به stdout ضروری است، زیرا به طور معمول نام فایل خروجی برای تشخیص قالب خروجی به کار می‌رود.
-O options: فهرست جداشده با کاما از گزینه‌های خروجی مخصوص هر قالب؛ بخش‌های PDF OUTPUT OPTIONS و OUTPUT OPTIONS را در زیر ببینید.
-b box: استفاده از page box نام‌گذاری‌شده (MediaBox, CropBox, BleedBox, TrimBox, یا ArtBox).
-A bits: مشخص کردن تعداد بیت‌های مورد استفاده برای صاف کردن لبه‌ها (anti-aliasing). مقدار پیش‌فرض 8 است.
-W width: عرض صفحه بر حسب پوینت برای چینش EPUB.
-H height: ارتفاع صفحه بر حسب پوینت برای چینش EPUB.
-S size: اندازه قلم بر حسب پوینت برای چینش EPUB.
-U filename: شیوه‌نامه CSS کاربر برای چینش EPUB. -X غیرفعال کردن شیوه‌های سند برای چینش EPUB.
pages: فهرستی از شماره صفحات و محدوده‌ها که با کاما از هم جدا شده‌اند (برای مثال: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات رندر خواهند شد.

ایجاد (CREATE)

mutool create [-o output.pdf] [options] page.txt [page2.txt ...]

دستور create یک فایل PDF جدید را با محتوای ایجادشده از یک یا چند فایل ورودی حاوی دستورهای گرافیکی می‌سازد.

-o output: اگر هیچ فایل خروجی‌ای مشخص نشود، PDF ایجادشده را در "out.pdf" در دایرکتوری جاری می‌نویسد.
-O options: فهرست جداشده با کاما از گزینه‌های خروجی مخصوص هر قالب؛ بخش PDF OUTPUT OPTIONS را در زیر ببینید.
page.txt: به ازای هر فایل ورودی یک صفحه ایجاد می‌شود و محتوای فایل درون جریان محتوا (content stream) کپی می‌گردد. کامنت‌های ویژه در فایل‌های ورودی پردازش می‌شوند تا ابعاد صفحه و منابع قلم و تصویر را تعریف کنند:

%%MediaBox LLX LLY URX URY

تنظیم اندازه صفحه (پیش‌فرض A4).

%%Rotate Angle

تنظیم زاویه چرخش صفحه (پیش‌فرض 90 درجه).

%%Font Name Filename Encoding

ایجاد یک منبع قلم ساده با استفاده از Name تعریف‌شده. Filename می‌تواند یک فایل قلم یا یکی از نام‌های قلم Base-14 باشد (Times-Roman، و غیره). کدگذاری (Encoding) یکی از موارد Latin (برای ISO-8859-1)، Greek (برای ISO-8859-7) یا Cyrillic (برای KOI-8) است.

%%Font Name Language WMode Style Language

ایجاد یک منبع قلم CID برای خط‌های CJK با استفاده از Name تعریف‌شده. Language یکی از موارد zh-Hant، zh-Hans، ja یا ko است. Wmode یکی از موارد H یا V است. Style یکی از موارد serif یا sans است.

%%Image Im0 path/to/image.png

ایجاد یک منبع تصویر.

مثال کامل (COMPLETE EXAMPLE)

این دستور یک تصویر، یک مثلث و مقداری متن را به یک صفحه اضافه می‌کند:

%%MediaBox 0 0 595 842
%%Font TmRm Times-Roman
%%Font Helv-C Helvetica Cyrillic
%%Font Helv-G Helvetica Greek
%%CJKFont Song zh-Hant
%%CJKFont Mincho ja
%%CJKFont Batang ko
%%Image I0 docs/examples/huntingofthesnark.png

% Draw an image.
q
480 0 0 480 50 250 cm
/I0 Do
Q

% Draw a triangle.
q
1 0 0 rg
50 50 m
100 200 l
200 50 l
f
Q

% Show some text.
q
0 0 1 rg
BT /TmRm 24 Tf 50 760 Td (Hello, world!) Tj ET
BT /Helv-C 24 Tf 50 730 Td <fac4d2c1d7d3d4d7d5cad4c521> Tj ET
BT /Helv-G 24 Tf 50 700 Td <eae1ebe7ecddf1e1> Tj ET
BT /Song 24 Tf 50 670 Td <4F60 597D> Tj ET
BT /Mincho 24 Tf 50 640 Td <3053 3093 306b 3061 306f> Tj ET
BT /Batang 24 Tf 50 610 Td <c548 b155 d558 c138 c694> Tj ET
Q

mutool draw [گزینه‌ها] فایل [صفحات ...]

دستور draw سندی را به فایل‌های تصویری رندر می‌کند، آن را به یک قالب برداری دیگر تبدیل می‌نماید، یا محتوای متنی‌اش را استخراج می‌کند.
قالب‌های سند ورودی پشتیبانی‌شده عبارتند از: pdf, xps, cbz, md، و epub.
قالب‌های تصویر خروجی پشتیبانی‌شده عبارتند از: pbm, pgm, ppm, pam, png, pwg, pcl، و ps.
قالب‌های برداری خروجی پشتیبانی‌شده عبارتند از: svg، pdf، و debug trace (به‌صورت xml).
قالب‌های متن خروجی پشتیبانی‌شده عبارتند از: plain text ، html، و متن ساختاریافته (به‌صورت xml یا json).

-p password: در صورتی که فایل رمزگذاری شده باشد، از گذرواژه مشخص‌شده استفاده می‌کند.
-o output: قالب خروجی از روی نام فایل خروجی استنباط می‌شود. برای مشخص کردن شماره صفحه، %d را در نام بگنجانید (برای مثال: “page%d.png”). اصلاح‌کننده‌های Printf نظیر “%03d” نیز پشتیبانی می‌شوند. اگر خروجی مشخص نشود، خروجی به stdout فرستاده خواهد شد.
-F format: یک قالب خروجی مشخص را اجباری می‌کند. تنها هنگام ارسال خروجی به stdout ضروری است، زیرا معمولاً از نام فایل خروجی برای تشخیص قالب خروجی استفاده می‌شود.
-q: حالت بی‌صدا؛ پیام‌های پیشرفت را چاپ نمی‌کند.
-R angle: چرخش ساعت‌گرد به اندازه زاویه داده‌شده بر حسب درجه.
-r resolution: رندر صفحه با تفکیک‌پذیری (رزولوشن) مشخص‌شده. تفکیک‌پذیری پیش‌فرض 72 dpi است.
-w width: رندر صفحه با عرض مشخص‌شده (یا اگر پرچم -r استفاده شده باشد، رندر با حداکثر عرض).
-h height: رندر صفحه با ارتفاع مشخص‌شده (یا اگر پرچم -r استفاده شده باشد، رندر با حداکثر ارتفاع).
-f: برازش دقیق؛ هنگام تطبیق با عرض/ارتفاع مشخص‌شده، نسبت ابعاد (aspect ratio) را نادیده می‌گیرد.
-b box: استفاده از جعبه صفحه (page box) نام‌گذاری‌شده (MediaBox، CropBox، BleedBox، TrimBox، یا ArtBox).
-B bandheight: رندر در حالت نواری (banded mode) به‌گونه‌ای که ارتفاع هر نوار از مقدار داده‌شده بلندتر نباشد. این کار حافظه کمتری را در حین رندر مصرف می‌کند. تنها با قالب‌های خروجی pam، pgm، ppm، pnm و png سازگار است. رندر نواری و محاسبه جمع کنترلی md5 نمی‌توانند هم‌زمان استفاده شوند.
-T threads: تعداد ریسه‌ها (threads) مورد استفاده برای رندر (تنها در حالت نواری).
-W width: عرض صفحه بر حسب پوینت برای صفحه‌بندی EPUB.
-H height: ارتفاع صفحه بر حسب پوینت برای صفحه‌بندی EPUB.
-S size: اندازه قلم بر حسب پوینت برای صفحه‌بندی EPUB.
-U filename: شیوه‌نامه CSS کاربر برای صفحه‌بندی EPUB.
-X: غیرفعال کردن استایل‌های سند برای صفحه‌بندی EPUB.
-a: غیرفعال کردن استفاده از فایل شتاب‌دهنده.
-c colorspace: رندر در فضای رنگی مشخص‌شده. فضاهای رنگی پشتیبانی‌شده عبارتند از: mono، gray، grayalpha، rgb، rgbalpha، cmyk، cmykalpha. برخی اختصارات مجاز هستند: m، g، ga، rgba، cmyka. مقدار پیش‌فرض بر اساس قالب خروجی انتخاب می‌شود.
-e filename: نام فایل نمایه ICC نمونه (Proof ICC profile) جهت استفاده در رندر.
-G gamma: اعمال تصحیح گاما (gamma correction). برخی مقادیر رایج 0.7 یا 1.4 هستند تا رندر متن نازک‌تر یا تیره‌تر شود.
-I: معکوس کردن رنگ‌ها.
-s [mft5]: نمایش اطلاعات گوناگون: m برای حافظه نهان گلیف (glyph cache) و کل حافظه مصرفی، f برای ویژگی‌های صفحه مانند اینکه صفحه مقیاس خاکستری است یا رنگی، t برای زمان‌های رندر هر صفحه و همچنین آمار، و 5 برای جمع‌های کنترلی md5 تصاویر رندرشده که می‌توان از آن برای بررسی تغییر در رندر استفاده کرد.
-A bits: مشخص کردن تعداد بیت‌های anti-aliasing مورد استفاده. مقدار پیش‌فرض 8 است.
-A bits/bits: مشخص کردن تعداد بیت‌های anti-aliasing مورد استفاده. مقدار پیش‌فرض 8 است. بیت‌های گرافیک قبل از ممیز (اسلش)، و بیت‌های متن بعد از ممیز قرار می‌گیرند.
-l width: حداقل عرض خطوط رسم‌شده (بر حسب پیکسل).
-K: عدم رسم متن.
-KK: فقط متن را رسم کن.
-D: غیرفعال کردن استفاده از فهرست‌های نمایش (display lists). ممکن است سرعت را کاهش دهد، اما میزان حافظه مصرفی را کاهش می‌دهد.
-i: نادیده گرفتن خطاها.
-m limit: محدود کردن میزان حافظه مصرفی به بایت.
-L: حالت حافظه کم (جلوگیری از ذخیره اشیاء در حافظه موقت با پاک‌سازی آن پس از هر صفحه).
-P: اجرای هم‌زمان تفسیر و رندر.
-N: غیرفعال کردن گردش‌کار ICC.
-M overprint: کنترل رندر رنگ تفکیکی/روچاپ (spot/overprint): 0 برای عدم رندر spot، 1 برای شبیه‌سازی Overprint (پیش‌فرض)، یا 2 برای رندر کامل spot..TP -t language تعیین زبان/خط برای OCR (پیش‌فرض: eng)
-d ocr-file-path: تعیین مسیر برای فایل‌های OCR (پیش‌فرض: اتکا به متغیر محیطی TESSDATA_PREFIX ).
-k correction: تنظیم اصلاح کجی (skew correction)، یکی از مقادیر auto، 0 برای افزایش اندازه، 1 برای حفظ اندازه، یا 2 برای کاهش اندازه.
-k correction,angle: تنظیم اصلاح کجی و همچنین زاویه.
-y l: چاپ پیکربندی لایه‌ها در stderr.
-y layer-number: انتخاب پیکربندی لایه (با شماره حاصل از -y l ).
-y layer-number,item1,item2, ...: انتخاب پیکربندی لایه (با شماره حاصل از -y l ) و تغییر وضعیت موارد فهرست‌شده.
-Y: چاپ لایه‌های مجزا در stderr.
-z layer-number: پنهان‌سازی لایه مجزا.
-Z layer-number: نمایش لایه مجزا.
pages: فهرستی از شماره‌ها و محدوده‌های صفحات جداشده با ویرگول (برای نمونه: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، همه صفحات رندر خواهند شد.

استخراج (EXTRACT)

mutool extract [گزینه‌ها] file.pdf [object-number ...]

دستور extract می‌تواند برای استخراج تصاویر و فایل‌های قلم از یک فایل PDF به کار رود. اگر هیچ شماره شیئی در خط فرمان مشخص نشود، تمامی تصاویر و قلم‌ها استخراج خواهند شد.

-p password: استفاده از گذرواژه مشخص‌شده در صورتی که فایل رمزشده باشد.
-r: تبدیل تصاویر به RGB هنگام استخراج آن‌ها.
-a: جاسازی SMaskها به عنوان کانال آلفا.
-N: عدم استفاده از تبدیل‌های رنگی ICC.

اطلاعات (INFO)

mutool info [گزینه‌ها] file.pdf [pages ...]

دستور info منابع استفاده‌شده در هر صفحه از یک فایل PDF را فهرست می‌کند. حالت پیش‌فرض فهرست کردن تمام انواع منابع است، اما اگر یک یا چند پرچم مشخص شوند، فقط انواع علامت‌گذاری‌شده نمایش داده خواهند شد.

-p password: استفاده از گذرواژه مشخص‌شده در صورتی که فایل رمزشده باشد.
-F: فهرست کردن قلم‌ها.
-I: فهرست کردن تصاویر.
-M: فهرست کردن ابعاد صفحه.
-P: فهرست کردن الگوها (patterns).
-S: فهرست کردن سایه‌بندی‌ها (shadings).
-X: فهرست کردن XObjectهای form و postscript.
-Z: فهرست کردن اطلاعات ZUGFeRD.
pages: فهرستی از شماره‌ها و محدوده‌های صفحات جداشده با ویرگول (برای نمونه: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات گنجانده خواهند شد.

mutool merge [options] file1 [pages1] [file2 [pages2] ...]

دستور merge برای انتخاب صفحات از دو یا چند فایل و ادغام آن‌ها به ترتیب درون یک فایل خروجی PDF جدید استفاده می‌شود.

-o output: نام فایل خروجی.
-O options: فهرستی از گزینه‌های خروجی مخصوص قالب که با کاما از هم جدا شده‌اند؛ به PDF OUTPUT OPTIONS در ادامه مراجعه کنید.

PAGES

mutool pages [options] input.pdf [pages ...]

دستور pages اطلاعات مربوط به اندازه و جهت صفحات درون سند را نمایش می‌دهد.

-p password: در صورتی که فایل رمزنگاری شده باشد، از گذرواژه مشخص‌شده استفاده می‌کند.
pages: فهرستی از شماره‌ها و محدوده‌های صفحات که با کاما از هم جدا شده‌اند (برای مثال: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، همه صفحات در نظر گرفته خواهند شد.

POSTER

mutool poster [options] input.pdf [output.pdf]

دستور poster هر صفحه را به قطعات کوچک‌تر (کاشی‌وار) تقسیم کرده و هر قطعه را در یک صفحه اختصاصی قرار می‌دهد. این دستور برای چاپ یک صفحه بزرگ روی تکه‌کاغذهای کوچک‌تر که بتوان بعداً آن‌ها را برای ایجاد یک پوستر بزرگ به هم چسباند، کاربرد دارد.

-p password: در صورتی که فایل رمزنگاری شده باشد، از گذرواژه مشخص‌شده استفاده می‌کند.
-m margin: حاشیه (هم‌پوشانی) بین صفحات برحسب پوینت یا درصد.
-x factor: صفحه را به این تعداد قطعه افقی تقسیم می‌کند.
-y factor: صفحه را به این تعداد قطعه عمودی تقسیم می‌کند.
-r: تقسیم افقی را از راست به چپ انجام می‌دهد (پیش‌فرض، تقسیم از چپ به راست است).

خروجی به ازای هر صفحه ورودی، دارای x ضربدر y صفحه خواهد بود.

RECOLOR

mutool recolor [options] input.pdf

فضای رنگی استفاده‌شده در یک PDF را به فضای دلخواه تغییر می‌دهد. این دستور می‌تواند، برای مثال، یک PDF رنگی را به مقیاس خاکستری (grayscale) تبدیل کند.

-c colorspace: فضای رنگی خروجی دلخواه، یکی از موارد زیر را انتخاب کنید: gray (پیش‌فرض)، rgb، یا cmyk.
-o filename: نام فایل خروجی.
-r: هرگونه مقاصد خروجی (output intents) را حذف می‌کند.

mutool run script.js [arguments]

یک برنامهٔ Javascript را اجرا می‌کند که به بیشتر امکانات کتابخانهٔ MuPDF دسترسی دارد. این دستور از نحو ECMAScript 5 در حالت strict پشتیبانی می‌کند. تمام سازنده‌ها و توابع MuPDF در شیء سراسری (global object) قرار دارند و آرگومان‌های خط فرمان از طریق شیء سراسری argv در دسترس هستند.

اگر بدون هیچ آرگومانی فراخوانی شود، شما را به یک REPL (حلقهٔ خواندن-ارزیابی-چاپ) تعاملی می‌برد. در اعلان تعاملی، اگر در ابتدای یک خط نویسهٔ مساوی قرار دهید، نتیجهٔ آن خط به‌طور خودکار چاپ می‌شود.

برای جزئیات دربارهٔ رابط‌های Javascript، مستندات MuPDF را در https://mupdf.readthedocs.io ببینید.

SHOW

mutool show [options] file.pdf [object-number ...]

دستور show اشیاء و جریان‌های (streams) مشخص‌شده را در stdout چاپ می‌کند. به‌طور پیش‌فرض، جریان‌ها رمزگشایی می‌شوند و نویسه‌های غیرقابل‌چاپ با یک نقطه نمایش داده می‌شوند.

-p password: در صورت رمزگذاری بودن فایل، از گذرواژهٔ مشخص‌شده استفاده می‌کند.
-o file: نوشتن خروجی در فایل به‌جای stdout.
-e: چاپ جریان‌ها در قالب اصلی رمزگذاری‌شده (یا فشرده‌شدهٔ) آن‌ها.
-b: چاپ جریان‌ها به‌صورت داده‌های باینری و حذف سرآیند شیء.
-g: چاپ هر شیء در یک خط، مناسب برای grep.
-r: اجبار به ترمیم پیش از نمایش هر شیء.
-L: نمایش برچسب‌های شیء (چگونگی دسترسی به یک شیء از ریشه).

با استفاده از یکی از کلیدواژه‌های زیر یا مسیری به یک شیء، آنچه را که باید نمایش داده شود مشخص کنید:

'trailer': چاپ دیکشنری trailer.
'xref': چاپ جدول ارجاع متقابل (cross reference).
'pages': فهرست کردن شمارهٔ اشیاء برای هر صفحه.
'grep': چاپ تمام اشیاء موجود در فایل در یک قالب تک‌خطی و فشرده، مناسب برای ارسال از طریق لوله به grep.
'outline': چاپ طرح کلی (همچنین با عنوان «فهرست مطالب» یا «نشانک‌ها» شناخته می‌شود).
'js': چاپ Javascript در سطح سند.
'form': چاپ اشیاء فرم.
<path>: یک مسیر با یک شمارهٔ شیء، یک ویژگی در دیکشنری trailer، یا کلیدواژهٔ trailer یا pages شروع می‌شود. عناصر را با یک نقطه . یا اسلش / از هم جدا کنید. با استفاده از pages/N یک شیء صفحه را انتخاب کنید که در آن N شمارهٔ صفحه است. صفحهٔ نخست شمارهٔ ۱ است.
*: می‌توانید از * به‌عنوان عنصری برای پیمایش روی تمام اندیس‌های آرایه یا ویژگی‌های دیکشنری در یک شیء استفاده کنید.

mutool sign [options] input.pdf [signature-object-number ...]

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

-p password: در صورت رمزگذاری بودن فایل، از گذرواژه مشخص‌شده استفاده می‌کند.
-v: اعتبارسنجی تمام امضاها، یا تنها امضای مشخص‌شده.
-c: پاک کردن تمام امضاها، یا تنها امضای مشخص‌شده.
-s certificate-filename: خواندن یک گواهی از نام‌فایل داده‌شده و استفاده از آن برای امضای همه، یا فقط امضای مشخص‌شده.
-P certificate-password: استفاده از گذرواژه مشخص‌شده هنگام باز کردن گواهی.
-o filename: نام فایل خروجی. signature object numbers فهرستی از شماره اشیاء PDF برای امضاهایی که باید اعتبارسنجی/پاک/امضا شوند. اگر چنین شماره اشیایی داده نشود، تمام امضاها پردازش خواهند شد.

ردیابی (TRACE)

mutool trace [options] file1 [pages1] [file2 [pages2] ...]

ردیابی فراخوانی‌های دستگاهِ لازم برای رندر کردن صفحات مورد نظر از سند داده‌شده را چاپ می‌کند.

-p password: در صورت رمزگذاری بودن فایل، از گذرواژه مشخص‌شده استفاده می‌کند.
-b box: کادری که برش بر اساس آن انجام می‌شود، یکی از موارد: (MediaBox (پیش‌فرض)، CropBox، BleedBox، TrimBox، یا ArtBox).
-W width: عرض صفحه بر حسب پوینت برای صفحه‌آرایی EPUB.
-H height: ارتفاع صفحه بر حسب پوینت برای صفحه‌آرایی EPUB.
-S size: اندازه قلم بر حسب پوینت برای صفحه‌آرایی EPUB.
-U filename: شیوه‌نامه CSS کاربر برای صفحه‌آرایی EPUB.
-X: غیرفعال‌سازی شیوه‌های سند برای صفحه‌آرایی EPUB.
-d: فعال‌سازی استفاده از فهرست‌های نمایش (display lists).
pages: فهرستی از شماره‌ها و محدوده‌های صفحات که با کاما جدا شده‌اند (برای نمونه: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات رندر خواهند شد.

mutool trim [گزینه‌ها] input.pdf

نسخه‌ای اصلاح‌شده از یک فایل PDF می‌سازد که در آن، محتوای قرارگرفته در داخل (یا خارج) جعبهٔ مشخص‌شده حذف شده است.

-b box: مشخص می‌کند برش بر اساس کدام جعبه انجام شود، یکی از موارد: (MediaBox (پیش‌فرض)، CropBox، BleedBox، TrimBox، یا ArtBox).
-f: بازگشت به mediabox در صورت در دسترس نبودن جعبهٔ مشخص‌شده.
-m all: افزودن حاشیهٔ یکسان به تمام اضلاع جعبه، که در آن مقدار all برای جهت رو به داخل مثبت و برای جهت رو به خارج منفی است.
-m vertical,horizontal: افزودن حاشیه‌های مشخص برای اضلاع عمودی و افقی جعبه، که در آن vertical و horizontal برای جهت رو به داخل مثبت و برای جهت رو به خارج منفی هستند.
-m top,right,bottom,left: افزودن حاشیه‌های مشخص برای اضلاع بالا، راست، پایین و چپ جعبه، که در آن مقادیر top، right، bottom، و left هرکدام برای جهت رو به داخل مثبت و برای جهت رو به خارج منفی هستند.
-e: مستثنی کردن (حذف) محتویات جعبه به‌جای نگه‌داشتن آن‌ها.
-o filename: نام فایل خروجی.

گزینه‌های خروجی (OUTPUT OPTIONS)

پیکربندی خروجی با فهرستی از گزینه‌های خروجی که با کاما از هم جدا شده‌اند انجام می‌شود.

گزینه‌های خروجی رستر (Raster output options)

این گزینه‌ها برای این قالب‌های خروجی اعمال می‌شوند: cbz, png, pnm, pgm, ppm, pam, pbm, pkm.

rotate=N: چرخاندن صفحات رندرشده به میزان N درجه در خلاف جهت عقربه‌های ساعت.
resolution=N: تنظیم هر دو تفکیک‌پذیری X و Y بر روی N پیکسل بر اینچ.
x-resolution=N: تنظیم تفکیک‌پذیری محور X صفحات رندرشده بر حسب پیکسل بر اینچ.
y-resolution=N: تنظیم تفکیک‌پذیری محور Y صفحات رندرشده بر حسب پیکسل بر اینچ.
width=N: رندر صفحات متناسب با عرض N پیکسل (نادیده گرفتن گزینهٔ resolution).
height=N: رندر صفحات متناسب با ارتفاع N پیکسل (نادیده گرفتن گزینهٔ resolution).
colorspace=(gray|rgb|cmyk): رندر صفحات با استفاده از فضای رنگی مشخص‌شده.
alpha: رندر صفحات با کانال آلفا و پس‌زمینهٔ شفاف.
graphics=(aaN|cop|app) و text=(aaN|cop|app): تنظیم رسترایزر (rasterizer) مورد استفاده برای گرافیک یا متن به‌ترتیب:

aaN: هموارسازی لبه‌ها (Antialias) با N بیت (۰ تا ۸).
cop: مرکز پیکسل (Center of pixel).
app: هر بخشی از پیکسل (Any part of pixel).

این گزینه‌ها برای قالب‌های خروجی رستر چاپ (print-raster) اعمال می‌شوند: pcl, pclm, ps, pwg.

colorspace=(mono|rgb): رندر یک صفحه ۱-بیتی سیاه و سفید یا تمام‌رنگی.
preset=(generic|ljet4|dj500|fs600|lj|lj2|lj3|lj4|lj4pl|lj4d|lp2563b|oce9050): رندر یک صفحه ۱-بیتی سیاه و سفید یا تمام‌رنگی.
spacing=(0|1|2|3): تنظیم فاصله‌گذاری عمودی روی هیچ‌کدام (none)، PCL 3 (<ESC>*p+<n>Y)، PCL 5 (<ESC>*b<n>Y)، یا PCL 6 (<ESC>*b<n>Y و پاک‌سازی seed row).
mode2: فعال‌سازی فشرده‌سازی گرافیکی mode 2.
mode3: فعال‌سازی فشرده‌سازی گرافیکی mode 3.
eog_reset: پایان گرافیک (<ESC>+rB) تمام پارامترها را بازنشانی می‌کند.
has_duplex: پشتیبانی از چاپ دورو (<ESC>&l<duplex>S).
has_papersize: پشتیبانی از تنظیم اندازه کاغذ (<ESC>&l<sizecode>A).
has_copies: پشتیبانی از تعداد نسخه‌ها (<ESC>&l<copies>X).
is_ljet4pjl: غیرفعال/فعال‌سازی خروجی ویژه مدل HP 4PJL.
is_oce9050: غیرفعال/فعال‌سازی خروجی ویژه مدل‌های Oce 9050.

گزینه‌های PCLm

این گزینه‌ها تنها برای موارد زیر اعمال می‌شوند: pclm.

compression=(none|flate): بدون فشرده‌سازی (پیش‌فرض)، یا فعال‌سازی فشرده‌سازی flate.
strip-height=N: ارتفاع نوار (پیش‌فرض ۱۶).

گزینه‌های PWG

این گزینه‌ها تنها برای موارد زیر اعمال می‌شوند: pwg.

media_class=string: تنظیم فیلد media_class.
media_color=string: تنظیم فیلد media_color.
media_type=string: تنظیم فیلد media_type.
output_type=string: تنظیم فیلد output_type.
rendering_intent=string: تنظیم فیلد rendering_intent.
page_size_name=string: تنظیم فیلد page_size_name.
advance_distance=int: تنظیم فیلد advance_distance.
advance_media=int: تنظیم فیلد advance_media.
collate=int: تنظیم فیلد collate.
cut_media=int: تنظیم فیلد cut_media.
duplex=int: تنظیم فیلد duplex.
insert_sheet=int: تنظیم فیلد insert_sheet.
jog=int: تنظیم فیلد jog.
leading_edge=int: تنظیم فیلد leading_edge.
manual_feed=int: تنظیم فیلد manual_feed.
media_position=int: تنظیم فیلد media_position.
media_weight=int: تنظیم فیلد media_weight.
mirror_print=int: تنظیم فیلد mirror_print.
negative_print=int: تنظیم فیلد negative_print.
num_copies=int: تنظیم فیلد num_copies.
orientation=int: تنظیم فیلد orientation.
output_face_up=int: تنظیم فیلد output_face_up.
page_size_x=int: تنظیم فیلد page_size_x.
page_size_y=int: تنظیم فیلد page_size_y.
separations=int: تنظیم فیلد separations.
tray_switch=int: تنظیم فیلد tray_switch.
tumble=int: تنظیم فیلد tumble.
media_type_num=int: تنظیم فیلد media_type_num.
compression=int: تنظیم فیلد compression.
row_count=int: تنظیم فیلد row_count.
row_feed=int: تنظیم فیلد row_feed.
row_step=int: تنظیم فیلد row_step. این موارد فقط برای این قالب اعمال می‌شوند: svg.
text=text: تولید متن به‌صورت عنصرهای <text> (قلم‌های غیردقیق).
text=path: تولید متن به‌صورت عنصرهای <path> (قلم‌های دقیق).
no-reuse-images: عدم استفاده مجدد از تصاویر با استفاده از تعاریف <symbol>.

گزینه‌های متن (Text options)

این موارد بر قالب‌های خروجی زیر اعمال می‌شوند: html, xhtml, text, stext.

preserve-images: نگه‌داشتن تصاویر در خروجی.
preserve-ligatures: عدم تجزیه حروف پیوسته (ligature) به نویسه‌های سازنده.
preserve-spans: عدم ادغام spanهای واقع در یک سطر.
preserve-whitespace: عدم تبدیل همه فاصله‌های خالی به نویسه‌های فاصله (space).
inhibit-spaces: عدم افزودن فاصله در میان شکاف‌های درون متن.
paragraph-break: شکستن بلوک‌ها در مرزهای پاراگراف.
dehyphenate: تلاش برای اتصال واژه‌های شکسته‌شده با خط تیره.
ignore-actualtext: عدم اعمال جایگزینی‌های ActualText.
use-cid-for-unknown-unicode: استفاده از کد نویسه در صورت ناموفق بودن نگاشت یونیکد.
use-gid-for-unknown-unicode: استفاده از نمایه گلیف در صورت ناموفق بودن نگاشت یونیکد.
accurate-bboxes: محاسبه کادرهای مرزی (bboxes) از روی خطوط پیرامونی (outlines).
accurate-ascenders: محاسبه بالارونده/پایین‌رونده (ascender/descender) از گلیف‌های قلم.
accurate-side-bearings: گسترش کادرهای مرزی (bboxes) نویسه جهت دربرگیری کامل پهنای گلیف‌ها.
collect-styles: تلاش برای شناسایی ویژگی‌های متن (پررنگ جعلی، خط‌خورده، زیرخط‌دار و غیره).
clip: عدم گنجاندن متنی که به‌طور کامل برش خورده (clipped) است.
clip-rect=x0:y0:x1:y1: تعیین مستطیل برشی که محتوا باید از درون آن گردآوری شود.
structured: گردآوری نشانه‌گذاری ساختار.
vectors: گنجاندن کادرهای مرزی برداری (vector bboxes) در خروجی.
lazy-vectors: به تأخیر انداختن بردارهایی در استخراج که در غیر این صورت موجب تقسیم یک سطر متنی می‌شدند.
fuzzy-vectors: ادغام بردارهای افقی و عمودی مماس بر هم.
segment: تلاش برای قطعه‌بندی صفحه.
table-hunt: جستجو به دنبال جدول‌ها درون یک صفحه (قطعه‌بندی‌شده).
vertically-collapse-bordered-cells (آزمایشی): در صورت تعیین به عنوان true، محتوای اَبَرسلول‌های کاملاً دارای حاشیه به‌صورت عمودی قابل‌جمع‌شدن در نظر گرفته می‌شود. این موارد فقط برای خروجی زیر اعمال می‌شوند: PDF.
decompress: خارج کردن تمام جریان‌ها از حالت فشرده (به‌جز compress-fonts/images).
compress=(yes|flate|brotli): فشرده‌سازی تمام جریان‌ها؛ در صورتی که مقداری داده نشود یا مقدار yes باشد، پیش‌فرض استفاده از flate است.
compress-fonts: فشرده‌سازی جریان شیء برای فونت‌های جاسازی‌شده.
compress-images: فشرده‌سازی جریان‌های شیء برای تصاویر.
compress-effort=(0|percentage): میزان تلاش صرف‌شده برای فشرده‌سازی؛ 0 پیش‌فرض است، در غیر این صورت درصدی از بیشینهٔ تلاش.
ascii: کدگذاری جریان‌های شیء با استفاده از کدگذاری ASCII hex.
pretty: چاپ آراستهٔ (pretty-print) اشیاء به همراه تورفتگی.
labels: چاپ برچسب‌های اشیاء.
linearize: دیگر پشتیبانی نمی‌شود! بهینه‌سازی سند برای بارگذاری تدریجی در نمایش‌دهنده‌ها.
clean: چاپ آراستهٔ دستورهای گرافیکی در جریان‌های محتوا.
sanitize: پاک‌سازی دستورهای گرافیکی در جریان‌های محتوا.
garbage: جمع‌آوری زبالهٔ (garbage collection) اشیاء استفاده‌نشده.
garbage=compact: جمع‌آوری زبالهٔ اشیاء استفاده‌نشده و فشرده‌سازی جدول ارجاع متقابل (cross-reference).
garbage=deduplicate: جمع‌آوری زبالهٔ اشیاء استفاده‌نشده، فشرده‌سازی جدول ارجاع متقابل و بازترکیب اشیاء تکراری.
incremental: نوشتن تغییرات به‌صورت به‌روزرسانی افزایشی.
objstms: استفاده از جریان‌های شیء و جریان‌های ارجاع متقابل.
appearance=(yes|all): تولید ساختگی جریان‌های نمایشیِ حاشیه‌نویسی/ابزارک، فقط برای موارد ناموجود یا همهٔ آن‌ها.
continue-on-error: ادامه دادن به ذخیرهٔ سند حتی در صورت وقوع خطا.
decrypt: این گزینه منسوخ شده است: به‌جای decrypt از encrypt=none استفاده کنید.
encrypt=(none|keep|rc4-40|rc4-128|aes-128|aes-256): نوشتن سند رمزگذاری‌شده با استفاده از روش رمزگذاری مشخص‌شده. مقدار پیش‌فرض keep است.
permissions=number: مجوزهای سند برای اعطا در زمان رمزگذاری.
user-password=password: گذرواژهٔ لازم برای خواندن سند.
owner-password=password: گذرواژهٔ لازم برای ویرایش سند.
regenerate-id=(yes|no): تولید مجدد شناسهٔ سند (پیش‌فرض yes).
reproducible=(yes|no): تلاش برای بازتولیدپذیر ساختن اسناد تولیدشده (پیش‌فرض no). وضعیت خروج در صورت اجرای موفقیت‌آمیز 0 و در صورت بروز خطا غیرصفر است.

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

mupdf(1),

نویسنده (AUTHOR)

حق کپی‌رایت MuPDF برای سال‌های 2004-2026 متعلق به Artifex Software, Inc. است.