.TH "MUTOOL" "1" "June 3, 2026" .\" Please adjust this date whenever revising the manpage. .\" no hyphenation .nh .\" adjust left .ad l . .SH "نام (NAME)" mutool \- ابزار همه‌منظوره برای کار با فایل‌های PDF . .SH "خلاصه دستور (SYNOPSIS)" .SY mutool .I sub-command .RI [ options ] .YS . .SH "توضیحات (DESCRIPTION)" دستور mutool ابزاری مبتنی بر MuPDF برای کار با فایل‌های سندی به روش‌های گوناگون است. چندین زیردستور مختلف در دسترس است که در ادامه شرح داده شده‌اند. . .SH "نسخه (VERSION)" .SY mutool .B \-v .YS .PP نسخه MuPDF استفاده‌شده برای ساخت mutool را نمایش می‌دهد. . .SH AUDIT .SY mutool .B audit .RI [ options ] .I file1.pdf .RI [ file2.pdf\~ .\|.\|.] .YS .PP گزارشی از عملگرها و فضای استفاده‌شده برای هر فایل PDF داده‌شده تولید می‌کند. .TP .BI \-o\~ filename نام فایل خروجی برای گزارش. . .SH BAKE .SY mutool .B bake .RI [ options ] .I input.pdf .RI [ output.pdf ] .YS .PP به‌طور معمول یادداشت‌ها (annotations) و ویجت‌های فیلدهای فرم، جریان‌های محتوایی جداگانه‌ای هستند که روی محتوای صفحه رسم می‌شوند. این دستور یادداشت‌ها و/یا ویجت‌ها را در محتوای صفحه ادغام و تثبیت (bake) می‌کند و آن‌ها را جدایی‌ناپذیر می‌سازد. پس از تثبیت یادداشت‌ها و ویجت‌ها، آن‌ها تنها بازنمایی‌هایی بصری از شکل قبلی یادداشت/ویجت اصلی خواهند بود؛ ویژگی‌های آن‌ها دیگر قابل ویرایش نیست زیرا دیگر به‌صورت یادداشت/ویجت واقعی وجود ندارند. .TP .B \-A یادداشت‌ها تثبیت نشوند. .TP .B \-F ویجت‌های فیلد فرم تثبیت نشوند. .TP .BI \-O\~ options فهرستی از گزینه‌های PDF جداشده با کاما. بخش .B PDF OUTPUT OPTIONS در ادامه را ببینید. . .SH BARCODE .SY mutool .B barcode -d .RI [ options ] .I file1.pdf .RI [ pages1 ] .RI [ file2.pdf ] .RI [ pages2 ] .YS .PP یک بارکد را از یک تصویر یا یک سند رمزگشایی می‌کند. .TP .BI \-p\~ password در صورت رمزگذاری شدن فایل، از گذرواژه مشخص‌شده استفاده می‌کند. .TP .BI \-o\~ output نام فایل خروجی. اگر خروجی مشخص نشود، هر متنی از بارکدهای رمزگشایی‌شده به stdout ارسال خواهد شد. .TP .BI \-r\~ angle میزان چرخش صفحات ورودی بر حسب درجه (0-360)، پیش از تلاش برای رمزگشایی بارکدها. .TP .I pages فهرستی از شماره‌ها و بازه‌های صفحات جداشده با کاما (برای مثال: 1,5,10-15,20-N)، که در آن نویسه N بیانگر آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات پردازش خواهند شد. . .SY mutool .B barcode -c .RI [ options ] .I text .YS .PP یک بارکد جدید شامل آرگومان text و قالب‌بندی‌شده بر اساس گزینه‌های مشخص‌شده ایجاد می‌کند. .TP .BI \-o\~ output قالب خروجی بر اساس نام فایل خروجی (PNG یا PDF) تعیین می‌شود. اگر خروجی مشخص نشود، پیش‌فرض .B out.png است. .TP .BI \-F\~ format قالب بارکد خروجی مورد نظر: .in +4n .B aztec .br .B codabar .br .B code39 .br .B code93 .br .B code128 .br .B databar .br .B databarexpanded .br .B datamatrix .br .B ean8 .br .B ean13 .br .B itf .br .B maxicode .br .B pdf417 .br .B qrcode .br .B upca .br .B upce .br .B microqrcode .br .B rmqrcode .br .B dxfilmedge .br .B databarlimited .br .TP .BI \-s\~ size تنظیم اندازه بارکد خروجی بر حسب پیکسل. اگر مشخص نشود، کوچک‌ترین اندازه‌ای که قابل رمزگشایی باشد انتخاب خواهد شد. .TP .B \-q افزودن حاشیه امن (quiet zones) در اطراف بارکد. این گزینه یک حاشیه خالی در اطراف بارکدهای ایجادشده قرار می‌دهد. .TP .B \-t افزودن متن خوانا برای انسان، در صورت در دسترس بودن. برخی از بارکدها، مانند EAN-13، می‌توانند محتوای بارکد را به‌صورت متنی خوانا در کنار بارکد چاپ کنند که این قابلیت با این پرچم فعال می‌شود. .TP .BI \-t\~ level تنظیم سطح تصحیح خطا (0-8). برخی از بارکدها، مانند QR-codeها، از چندین سطح تصحیح خطا پشتیبانی می‌کنند که از طریق این گزینه قابل سفارشی‌سازی است. .TP .I text متنی که باید در یک بارکد کدگذاری شود. ..SH CLEAN .SY mutool .B clean .RI [ options ] .I input.pdf .RI [ output.pdf ] .RI [ pages\~ .\|.\|.] .YS .PP دستور clean ساختار نحوی (syntax) یک فایل PDF را بازنویسی کرده و آن را به‌صورت مرتب قالب‌بندی (pretty print) می‌کند. از این دستور می‌توان برای تعمیر فایل‌های خراب، باز کردن جریان‌های (streams) فشرده، فیلتر کردن محدوده‌ای از صفحات و غیره استفاده کرد. .PP اگر هیچ فایل خروجی مشخص نشود، فایل PDF پاک‌سازی‌شده در "out.pdf" در دایرکتوری جاری نوشته خواهد شد. .TP .BI \-p\~ password در صورت رمزگذاری بودن فایل، از گذرواژه (password) مشخص‌شده استفاده می‌کند. .TP .B \-g جمع‌آوری زباله (Garbage collect) برای اشیائی (objects) که هیچ ارجاعی از اشیاء دیگر ندارند. .TP .B \-gg علاوه بر .BR \-g ، تمام اشیاء را دوباره شماره‌گذاری کرده و جدول ارجاع متقابل (cross reference table) را فشرده می‌کند. .TP .B \-ggg علاوه بر .BR \-gg ، اشیای تکراری را ادغام کرده و دوباره استفاده می‌کند. .TP .B \-gggg علاوه بر .BR \-ggg ، جریان‌های (streams) تکراری را نیز ادغام کرده و دوباره استفاده می‌کند. .TP .B \-l .B دیگر پشتیبانی نمی‌شود! خطی‌سازی (Linearize) خروجی. برای ایجاد یک فایل خروجی «بهینه‌شده برای وب» (Web Optimized) استفاده می‌شود. .TP .B \-D ذخیره فایل بدون رمزگذاری. .TP .BI \-E\~ method ذخیره فایل با روش رمزگذاری دلخواه، یکی از موارد: .BR rc4-40 ، rc40-128 ، aes-128 ، یا .BR aes-256 . .TP .BI \-O\~ password گذرواژه مالک (Owner password) که هنگام رمزگذاری فایل خروجی به کار می‌رود. این گذرواژه برای ویرایش فایل خروجی لازم است. .TP .BI \-U\~ password گذرواژه کاربر (User password) که هنگام رمزگذاری فایل خروجی به کار می‌رود. این گذرواژه برای مشاهده فایل خروجی لازم است. .TP .BI \-P\~ permissions مجوزهای مورد استفاده هنگام رمزگذاری فایل خروجی. این‌ها مجوزهایی هستند که هنگام مشاهده فایل خروجی اعمال خواهند شد. .TP .B \-a کدگذاری اسکی هگز (ASCII Hex encode) جریان‌های دودویی (binary streams). در ترکیب با .B \-d و .B \-i یا .B \-f استفاده شود تا اطمینان حاصل گردد اگرچه تصاویر و/یا قلم‌ها فشرده شده‌اند، فایل حاصل همچنان می‌تواند با یک ویرایشگر متنی مشاهده و ویرایش شود. .TP .B \-d خارج کردن جریان‌ها از حالت فشرده (Decompress). این کار حجم فایل خروجی را افزایش می‌دهد، اما دسترسی آسان برای خواندن و ویرایش محتوا را با یک ویرایشگر متنی فراهم می‌سازد. .TP .B \-z فشرده‌سازی (Deflate) جریان‌های غیرفشرده. .br در صورت ترکیب با .BR \-d ، هر جریانِ از فشرده‌سازی خارج‌شده، مجدداً فشرده خواهد شد. .br در صورت ترکیب با .BR \-a ، جریان‌ها پس از فشرده‌سازی، کدگذاری هگز نیز خواهند شد. .TP .BI \-e\~ effort تنظیم میزان تلاشی که صرف فشرده‌سازی فایل خروجی می‌شود. مقدار .B 0 پیش‌فرض است، در غیر این صورت درصدی از حداکثر تلاش است؛ .B 1 برای حداقل و .B 100 برای حداکثر تلاش. .TP .B \-f تغییر وضعیت خارج کردن جریان‌های قلم (font streams) از حالت فشرده. در ترکیب با .B \-d استفاده کنید تا قلم‌ها فشرده باقی بمانند. .TP .B \-i تغییر وضعیت خارج کردن جریان‌های تصویر (image streams) از حالت فشرده. در ترکیب با .B \-d استفاده کنید تا تصاویر فشرده باقی بمانند. .TP .B \-c قالب‌بندی مرتب و خوانا (Pretty-print) دستورهای گرافیکی در جریان‌های محتوا (content streams). .TP .B \-s پاک‌سازی (Sanitize) دستورهای گرافیکی در جریان‌های محتوا؛ این به معنای، به عنوان مثال، حذف دستورهای نامعتبر یا زائد است. .TP .B \-t استفاده از نحو فشرده اشیاء PDF. این کار در فضا صرفه‌جویی می‌کند. .TP .B \-tt استفاده از نحو دندانه‌دار اشیاء PDF. این حالت برای خواندن انسان مناسب‌تر است. .TP .B \-L چاپ توضیحاتی (comments) حاوی برچسب‌هایی که نشان می‌دهند چگونه می‌توان از Root به هر شیء دسترسی پیدا کرد. .TP .B \-v تبدیل تمام متن‌ها به دستورهای گرافیک برداری (vector graphics commands). .TP .B \-A ایجاد جریان‌های ظاهری (appearance streams) برای حاشیه‌نویسی‌هایی (annotations) که فاقد آن‌ها هستند. .TP .B \-AA ایجاد مجدد جریان‌های ظاهری برای تمام حاشیه‌نویسی‌ها. .TP .B \-m حفظ فراداده (metadata). .TP .B \-S زیرمجموعه‌گیری قلم‌ها (Subset fonts) در صورت امکان. (آزمایشی!) .TP .B \-Z استفاده از جریان‌های اشیاء (object streams) و جریان‌های ارجاع متقابل (cross reference streams) برای فشرده‌سازی بیشتر. .TP .BR \-\- ( color | gray | bitonal )\c .BR \- (\c .RB | lossy- | lossless- )\c .BI image-subsample-method= method تنظیم روش زیرنمونه‌گیری (subsampling method) .RB ( average\~ یا\~ bicubic ) برای انواع تصویر مورد نظر، به عنوان مثال color-lossy و bitonal-lossless. .TP .BR \-\- ( color | gray | bitonal )\c .BR \- (\c .RB | lossy- | lossless- )\c .BI image-subsample-dpi= dpi\c .RI [, dpi ] تنظیم تفکیک‌پذیری (dpi) که زیرنمونه‌گیری در آن انجام می‌شود. .TP .BR \-\- ( color | gray | bitonal )\c .BR \- (\c .RB | lossy- | lossless- )\c .BI image-recompress-method= quality تنظیم کیفیت فشرده‌سازی مجدد بر روی یکی از موارد: .BR never ، .BR same ، .BR lossless ، .BR jpeg ، .BR j2k ، .BR fax ، یا .BR jbig2 . .TP .BI \-\-recompress-images-when=\c .RB ( smaller | always ) فشرده‌سازی مجدد تصاویر زمانی که تصاویر بازنویسی‌شده توسط روش‌های زیرنمونه‌گیری یا فشرده‌سازی مجددِ بالا .BR smaller\~ (پیش‌فرض) باشند، یا با .B always همواره آن‌ها را دوباره فشرده می‌کند. .TP .BR \-\-structure =\c .RB ( keep | drop ) نگه‌داشتن یا دور انداختن درخت ساختار (structure tree)..TP .I pages فهرستی از شماره صفحات و محدوده‌ها که با کاما از هم جدا شده‌اند (برای مثال: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات گنجانده خواهند شد. . .SH "تبدیل (CONVERT)" .SY mutool .B convert .RI [ options ] .I input.pdf .RI [ pages\~ .\|.\|.] .YS .PP دستور convert برای تبدیل یک فایل از یک قالب به قالب دیگر استفاده می‌شود. .TP .BI \-p\~ password در صورت رمزگذاری بودن فایل، از گذرواژه مشخص‌شده استفاده می‌کند. .TP .BI \-o\~ output قالب خروجی از روی نام فایل خروجی تشخیص داده می‌شود. برای مشخص کردن شماره صفحه، %d را در نام قرار دهید (برای مثال: "page%d.png"). اصلاح‌کننده‌های Printf پشتیبانی می‌شوند، برای مثال "%03d". اگر هیچ خروجی‌ای مشخص نشود، خروجی به stdout فرستاده می‌شود. .TP .BI \-F\~ format تحمیل یک قالب خروجی خاص. فقط هنگام ارسال خروجی به stdout ضروری است، زیرا به طور معمول نام فایل خروجی برای تشخیص قالب خروجی به کار می‌رود. .TP .BI \-O\~ options فهرست جداشده با کاما از گزینه‌های خروجی مخصوص هر قالب؛ بخش‌های .B PDF OUTPUT OPTIONS و .B OUTPUT OPTIONS را در زیر ببینید. .TP .BI \-b\~ box استفاده از page box نام‌گذاری‌شده .RB ( MediaBox , .BR CropBox , .BR BleedBox , .BR TrimBox , یا .BR ArtBox ). .TP .BI \-A\~ bits مشخص کردن تعداد بیت‌های مورد استفاده برای صاف کردن لبه‌ها (anti-aliasing). مقدار پیش‌فرض 8 است. .TP .BI \-W\~ width عرض صفحه بر حسب پوینت برای چینش EPUB. .TP .BI \-H\~ height ارتفاع صفحه بر حسب پوینت برای چینش EPUB. .TP .BI \-S\~ size اندازه قلم بر حسب پوینت برای چینش EPUB. .TP .BI \-U\~ filename شیوه‌نامه CSS کاربر برای چینش EPUB. .B \-X غیرفعال کردن شیوه‌های سند برای چینش EPUB. .TP .I pages فهرستی از شماره صفحات و محدوده‌ها که با کاما از هم جدا شده‌اند (برای مثال: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات رندر خواهند شد. . .SH "ایجاد (CREATE)" .SY mutool .B create .RB [ \-o .IR output.pdf ] .RI [ options ] .I page.txt .RI [ page2.txt\~ .\|.\|.] .YS .PP دستور create یک فایل PDF جدید را با محتوای ایجادشده از یک یا چند فایل ورودی حاوی دستورهای گرافیکی می‌سازد. .TP .BI \-o\~ output اگر هیچ فایل خروجی‌ای مشخص نشود، PDF ایجادشده را در "out.pdf" در دایرکتوری جاری می‌نویسد. .TP .BI \-O\~ options فهرست جداشده با کاما از گزینه‌های خروجی مخصوص هر قالب؛ بخش .B PDF OUTPUT OPTIONS را در زیر ببینید. .TP .B page.txt به ازای هر فایل ورودی یک صفحه ایجاد می‌شود و محتوای فایل درون جریان محتوا (content stream) کپی می‌گردد. کامنت‌های ویژه در فایل‌های ورودی پردازش می‌شوند تا ابعاد صفحه و منابع قلم و تصویر را تعریف کنند: .RS .TP .B %%MediaBox LLX LLY URX URY تنظیم اندازه صفحه (پیش‌فرض A4). .TP .B %%Rotate Angle تنظیم زاویه چرخش صفحه (پیش‌فرض 90 درجه). .TP .B %%Font Name Filename Encoding ایجاد یک منبع قلم ساده با استفاده از .BR Name تعریف‌شده. .B Filename می‌تواند یک فایل قلم یا یکی از نام‌های قلم Base-14 باشد .RB ( Times-Roman\c ، و غیره). کدگذاری (Encoding) یکی از موارد .B Latin (برای ISO-8859-1)، .B Greek (برای ISO-8859-7) یا .B Cyrillic (برای KOI-8) است. .TP .B %%Font Name Language WMode Style Language ایجاد یک منبع قلم CID برای خط‌های CJK با استفاده از .BR Name تعریف‌شده. .B Language یکی از موارد .BR zh-Hant ، .BR zh-Hans ، .BR ja یا .BR ko است. .B Wmode یکی از موارد .BR H یا .BR V است. .BR Style یکی از موارد .BR serif یا .BR sans است. .TP .B %%Image Im0 path/to/image.png ایجاد یک منبع تصویر. .TP .B "مثال کامل (COMPLETE EXAMPLE)" این دستور یک تصویر، یک مثلث و مقداری متن را به یک صفحه اضافه می‌کند: .in +4n .sp .EX %%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 .sp % Draw an image. q 480 0 0 480 50 250 cm /I0 Do Q .sp % Draw a triangle. q 1 0 0 rg 50 50 m 100 200 l 200 50 l f Q .sp % 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 Tj ET BT /Helv-G 24 Tf 50 700 Td 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 Tj ET Q .EE .RE ..SH DRAW .SY mutool .B draw .RI [ گزینه‌ها ] .I فایل .RI [ صفحات\~ .\|.\|.] .YS .PP دستور draw سندی را به فایل‌های تصویری رندر می‌کند، آن را به یک قالب برداری دیگر تبدیل می‌نماید، یا محتوای متنی‌اش را استخراج می‌کند. .br قالب‌های سند ورودی پشتیبانی‌شده عبارتند از: .BR pdf ,\~ xps ,\~ cbz ,\~ md ، .RB و\~ epub . .br قالب‌های تصویر خروجی پشتیبانی‌شده عبارتند از: .BR pbm ,\~ pgm ,\~ ppm ,\~ pam ,\~ png ,\~ pwg ,\~ pcl ، .RB و\~ ps . .br قالب‌های برداری خروجی پشتیبانی‌شده عبارتند از: .BR svg ،\~ pdf ، و .B debug trace .RB (به‌صورت\~ xml ). .br قالب‌های متن خروجی پشتیبانی‌شده عبارتند از: .B plain text .RB ،\~ html ، و متن ساختاریافته (به‌صورت .BR xml\~ یا\~ json ). .TP .BI \-p\~ password در صورتی که فایل رمزگذاری شده باشد، از گذرواژه مشخص‌شده استفاده می‌کند. .TP .BI \-o\~ output قالب خروجی از روی نام فایل خروجی استنباط می‌شود. برای مشخص کردن شماره صفحه، %d را در نام بگنجانید (برای مثال: \(lqpage%d.png\(rq). اصلاح‌کننده‌های Printf نظیر \(lq%03d\(rq نیز پشتیبانی می‌شوند. اگر خروجی مشخص نشود، خروجی به stdout فرستاده خواهد شد. .TP .BI \-F\~ format یک قالب خروجی مشخص را اجباری می‌کند. تنها هنگام ارسال خروجی به stdout ضروری است، زیرا معمولاً از نام فایل خروجی برای تشخیص قالب خروجی استفاده می‌شود. .TP .B \-q حالت بی‌صدا؛ پیام‌های پیشرفت را چاپ نمی‌کند. .TP .BI \-R\~ angle چرخش ساعت‌گرد به اندازه زاویه داده‌شده بر حسب درجه. .TP .BI \-r\~ resolution رندر صفحه با تفکیک‌پذیری (رزولوشن) مشخص‌شده. تفکیک‌پذیری پیش‌فرض 72 dpi است. .TP .BI \-w\~ width رندر صفحه با عرض مشخص‌شده (یا اگر پرچم .B \-r استفاده شده باشد، رندر با حداکثر عرض). .TP .BI \-h\~ height رندر صفحه با ارتفاع مشخص‌شده (یا اگر پرچم .B \-r استفاده شده باشد، رندر با حداکثر ارتفاع). .TP .B \-f برازش دقیق؛ هنگام تطبیق با عرض/ارتفاع مشخص‌شده، نسبت ابعاد (aspect ratio) را نادیده می‌گیرد. .TP .BI \-b\~ box استفاده از جعبه صفحه (page box) نام‌گذاری‌شده .RB ( MediaBox ، .BR CropBox ، .BR BleedBox ، .BR TrimBox ، یا .BR ArtBox ). .TP .BI \-B\~ bandheight رندر در حالت نواری (banded mode) به‌گونه‌ای که ارتفاع هر نوار از مقدار داده‌شده بلندتر نباشد. این کار حافظه کمتری را در حین رندر مصرف می‌کند. تنها با قالب‌های خروجی pam، pgm، ppm، pnm و png سازگار است. رندر نواری و محاسبه جمع کنترلی md5 نمی‌توانند هم‌زمان استفاده شوند. .TP .BI \-T\~ threads تعداد ریسه‌ها (threads) مورد استفاده برای رندر (تنها در حالت نواری). .TP .BI \-W\~ width عرض صفحه بر حسب پوینت برای صفحه‌بندی EPUB. .TP .BI \-H\~ height ارتفاع صفحه بر حسب پوینت برای صفحه‌بندی EPUB. .TP .BI \-S\~ size اندازه قلم بر حسب پوینت برای صفحه‌بندی EPUB. .TP .BI \-U\~ filename شیوه‌نامه CSS کاربر برای صفحه‌بندی EPUB. .TP .B \-X غیرفعال کردن استایل‌های سند برای صفحه‌بندی EPUB. .TP .B \-a غیرفعال کردن استفاده از فایل شتاب‌دهنده. .TP .BI \-c\~ colorspace رندر در فضای رنگی مشخص‌شده. فضاهای رنگی پشتیبانی‌شده عبارتند از: .BR mono ، .BR gray ، .BR grayalpha ، .BR rgb ، .BR rgbalpha ، .BR cmyk ، .BR cmykalpha . برخی اختصارات مجاز هستند: .BR m ، .BR g ، .BR ga ، .BR rgba ، .BR cmyka . مقدار پیش‌فرض بر اساس قالب خروجی انتخاب می‌شود. .TP .BI \-e\~ filename نام فایل نمایه ICC نمونه (Proof ICC profile) جهت استفاده در رندر. .TP .BI \-G\~ gamma اعمال تصحیح گاما (gamma correction). برخی مقادیر رایج 0.7 یا 1.4 هستند تا رندر متن نازک‌تر یا تیره‌تر شود. .TP .B \-I معکوس کردن رنگ‌ها. .TP .BI \-s\~ [mft5] نمایش اطلاعات گوناگون: .B m برای حافظه نهان گلیف (glyph cache) و کل حافظه مصرفی، .B f برای ویژگی‌های صفحه مانند اینکه صفحه مقیاس خاکستری است یا رنگی، .B t برای زمان‌های رندر هر صفحه و همچنین آمار، و .B 5 برای جمع‌های کنترلی md5 تصاویر رندرشده که می‌توان از آن برای بررسی تغییر در رندر استفاده کرد. .TP .BI \-A\~ bits مشخص کردن تعداد بیت‌های anti-aliasing مورد استفاده. مقدار پیش‌فرض 8 است. .TP .BI \-A\~ bits/bits مشخص کردن تعداد بیت‌های anti-aliasing مورد استفاده. مقدار پیش‌فرض 8 است. بیت‌های گرافیک قبل از ممیز (اسلش)، و بیت‌های متن بعد از ممیز قرار می‌گیرند. .TP .BI \-l\~ width حداقل عرض خطوط رسم‌شده (بر حسب پیکسل). .TP .B \-K عدم رسم متن. .TP .B \-KK فقط متن را رسم کن. .TP .B \-D غیرفعال کردن استفاده از فهرست‌های نمایش (display lists). ممکن است سرعت را کاهش دهد، اما میزان حافظه مصرفی را کاهش می‌دهد. .TP .B \-i نادیده گرفتن خطاها. .TP .BI \-m\~ limit محدود کردن میزان حافظه مصرفی به بایت. .TP .B \-L حالت حافظه کم (جلوگیری از ذخیره اشیاء در حافظه موقت با پاک‌سازی آن پس از هر صفحه). .TP .B \-P اجرای هم‌زمان تفسیر و رندر. .TP .B \-N غیرفعال کردن گردش‌کار ICC. .TP .BI \-M\~ overprint کنترل رندر رنگ تفکیکی/روچاپ (spot/overprint): .B 0 برای عدم رندر spot، .B 1 برای شبیه‌سازی Overprint (پیش‌فرض)، یا .B 2 برای رندر کامل spot..TP .BI \-t\~ language تعیین زبان/خط برای OCR (پیش‌فرض: eng) .TP .BI \-d\~ ocr-file-path تعیین مسیر برای فایل‌های OCR (پیش‌فرض: اتکا به متغیر محیطی .B TESSDATA_PREFIX ). .TP .BI \-k\~ correction تنظیم اصلاح کجی (skew correction)، یکی از مقادیر .BR auto ، .B 0 برای افزایش اندازه، .B 1 برای حفظ اندازه، یا .B 2 برای کاهش اندازه. .TP .BI \-k\~ correction,angle تنظیم اصلاح کجی و همچنین زاویه. .TP .BI \-y\~ l چاپ پیکربندی لایه‌ها در stderr. .TP .BI \-y\~ layer-number انتخاب پیکربندی لایه (با شماره حاصل از .B \-y l ). .TP .BI \-y\~ layer-number\c .RI , item1\c .RI , item2\c , ... انتخاب پیکربندی لایه (با شماره حاصل از .B \-y l ) و تغییر وضعیت موارد فهرست‌شده. .TP .B \-Y چاپ لایه‌های مجزا در stderr. .TP .BI \-z\~ layer-number پنهان‌سازی لایه مجزا. .TP .BI \-Z\~ layer-number نمایش لایه مجزا. .TP .I pages فهرستی از شماره‌ها و محدوده‌های صفحات جداشده با ویرگول (برای نمونه: 1,5,10\-15,20\-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، همه صفحات رندر خواهند شد. . .SH "استخراج (EXTRACT)" .SY mutool .B extract .RI [ گزینه‌ها ] .I file.pdf .RI [ object-number\~ .\|.\|.] .YS .PP دستور extract می‌تواند برای استخراج تصاویر و فایل‌های قلم از یک فایل PDF به کار رود. اگر هیچ شماره شیئی در خط فرمان مشخص نشود، تمامی تصاویر و قلم‌ها استخراج خواهند شد. .TP .BI \-p\~ password استفاده از گذرواژه مشخص‌شده در صورتی که فایل رمزشده باشد. .TP .B \-r تبدیل تصاویر به RGB هنگام استخراج آن‌ها. .TP .B \-a جاسازی SMaskها به عنوان کانال آلفا. .TP .B \-N عدم استفاده از تبدیل‌های رنگی ICC. . .SH "اطلاعات (INFO)" .SY mutool .B info .RI [ گزینه‌ها ] .I file.pdf .RI [ pages\~ .\|.\|.] .YS .PP دستور info منابع استفاده‌شده در هر صفحه از یک فایل PDF را فهرست می‌کند. حالت پیش‌فرض فهرست کردن تمام انواع منابع است، اما اگر یک یا چند پرچم مشخص شوند، فقط انواع علامت‌گذاری‌شده نمایش داده خواهند شد. .TP .BI \-p\~ password استفاده از گذرواژه مشخص‌شده در صورتی که فایل رمزشده باشد. .TP .B \-F فهرست کردن قلم‌ها. .TP .B \-I فهرست کردن تصاویر. .TP .B \-M فهرست کردن ابعاد صفحه. .TP .B \-P فهرست کردن الگوها (patterns). .TP .B \-S فهرست کردن سایه‌بندی‌ها (shadings). .TP .B \-X فهرست کردن XObjectهای form و postscript. .TP .B \-Z فهرست کردن اطلاعات ZUGFeRD. .TP .I pages فهرستی از شماره‌ها و محدوده‌های صفحات جداشده با ویرگول (برای نمونه: 1,5,10\-15,20\-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات گنجانده خواهند شد. ..SH MERGE .SY mutool .B merge .RI [ options ] .IR file1\~ [ pages1 ] .RI [ file2\~ [ pages2 ] .RI .\|.\|.] .YS .PP دستور merge برای انتخاب صفحات از دو یا چند فایل و ادغام آن‌ها به ترتیب درون یک فایل خروجی PDF جدید استفاده می‌شود. .TP .BI \-o\~ output نام فایل خروجی. .TP .BI \-O\~ options فهرستی از گزینه‌های خروجی مخصوص قالب که با کاما از هم جدا شده‌اند؛ به .B PDF OUTPUT OPTIONS در ادامه مراجعه کنید. . .SH PAGES .SY mutool .B pages .RI [ options ] .IR input.pdf\~ [ pages\~ .\|.\|.] .YS .PP دستور pages اطلاعات مربوط به اندازه و جهت صفحات درون سند را نمایش می‌دهد. .TP .BI \-p\~ password در صورتی که فایل رمزنگاری شده باشد، از گذرواژه مشخص‌شده استفاده می‌کند. .TP .I pages فهرستی از شماره‌ها و محدوده‌های صفحات که با کاما از هم جدا شده‌اند (برای مثال: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، همه صفحات در نظر گرفته خواهند شد. . .SH POSTER .SY mutool .B poster .RI [ options ] .I input.pdf .RI [ output.pdf ] .YS .PP دستور poster هر صفحه را به قطعات کوچک‌تر (کاشی‌وار) تقسیم کرده و هر قطعه را در یک صفحه اختصاصی قرار می‌دهد. این دستور برای چاپ یک صفحه بزرگ روی تکه‌کاغذهای کوچک‌تر که بتوان بعداً آن‌ها را برای ایجاد یک پوستر بزرگ به هم چسباند، کاربرد دارد. .TP .BI \-p\~ password در صورتی که فایل رمزنگاری شده باشد، از گذرواژه مشخص‌شده استفاده می‌کند. .TP .BI \-m\~ margin حاشیه (هم‌پوشانی) بین صفحات برحسب پوینت یا درصد. .TP .BI \-x\~ factor صفحه را به این تعداد قطعه افقی تقسیم می‌کند. .TP .BI \-y\~ factor صفحه را به این تعداد قطعه عمودی تقسیم می‌کند. .TP .B \-r تقسیم افقی را از راست به چپ انجام می‌دهد (پیش‌فرض، تقسیم از چپ به راست است). .PP خروجی به ازای هر صفحه ورودی، دارای x ضربدر y صفحه خواهد بود. . .SH RECOLOR .SY mutool .B recolor .RI [ options ] .I input.pdf .YS .PP فضای رنگی استفاده‌شده در یک PDF را به فضای دلخواه تغییر می‌دهد. این دستور می‌تواند، برای مثال، یک PDF رنگی را به مقیاس خاکستری (grayscale) تبدیل کند. .TP .BI \-c\~ colorspace فضای رنگی خروجی دلخواه، یکی از موارد زیر را انتخاب کنید: .BR gray\~ "(پیش‌فرض)،" .BR rgb ، یا .BR cmyk . .TP .BI \-o\~ filename نام فایل خروجی. .TP .B \-r هرگونه مقاصد خروجی (output intents) را حذف می‌کند. ..SH RUN .SY mutool .B run .I script.js .RI [ arguments ] .YS .PP یک برنامهٔ Javascript را اجرا می‌کند که به بیشتر امکانات کتابخانهٔ MuPDF دسترسی دارد. این دستور از نحو ECMAScript 5 در حالت strict پشتیبانی می‌کند. تمام سازنده‌ها و توابع MuPDF در شیء سراسری (global object) قرار دارند و آرگومان‌های خط فرمان از طریق شیء سراسری argv در دسترس هستند. .PP اگر بدون هیچ آرگومانی فراخوانی شود، شما را به یک REPL (حلقهٔ خواندن-ارزیابی-چاپ) تعاملی می‌برد. در اعلان تعاملی، اگر در ابتدای یک خط نویسهٔ مساوی قرار دهید، نتیجهٔ آن خط به‌طور خودکار چاپ می‌شود. .PP برای جزئیات دربارهٔ رابط‌های Javascript، مستندات MuPDF را در https://mupdf.readthedocs.io ببینید. . .SH SHOW .SY mutool .B show .RI [ options ] .I file.pdf .RI [ object-number\~ .\|.\|.] .YS .PP دستور show اشیاء و جریان‌های (streams) مشخص‌شده را در stdout چاپ می‌کند. به‌طور پیش‌فرض، جریان‌ها رمزگشایی می‌شوند و نویسه‌های غیرقابل‌چاپ با یک نقطه نمایش داده می‌شوند. .TP .BI \-p\~ password در صورت رمزگذاری بودن فایل، از گذرواژهٔ مشخص‌شده استفاده می‌کند. .TP .BI \-o\~ file نوشتن خروجی در فایل به‌جای stdout. .TP .B \-e چاپ جریان‌ها در قالب اصلی رمزگذاری‌شده (یا فشرده‌شدهٔ) آن‌ها. .TP .B \-b چاپ جریان‌ها به‌صورت داده‌های باینری و حذف سرآیند شیء. .TP .B \-g چاپ هر شیء در یک خط، مناسب برای grep. .TP .B \-r اجبار به ترمیم پیش از نمایش هر شیء. .TP .B \-L نمایش برچسب‌های شیء (چگونگی دسترسی به یک شیء از ریشه). .PP با استفاده از یکی از کلیدواژه‌های زیر یا مسیری به یک شیء، آنچه را که باید نمایش داده شود مشخص کنید: .TP .B 'trailer' چاپ دیکشنری trailer. .TP .B 'xref' چاپ جدول ارجاع متقابل (cross reference). .TP .B 'pages' فهرست کردن شمارهٔ اشیاء برای هر صفحه. .TP .B 'grep' چاپ تمام اشیاء موجود در فایل در یک قالب تک‌خطی و فشرده، مناسب برای ارسال از طریق لوله به grep. .TP .B 'outline' چاپ طرح کلی (همچنین با عنوان «فهرست مطالب» یا «نشانک‌ها» شناخته می‌شود). .TP .B 'js' چاپ Javascript در سطح سند. .TP .B 'form' چاپ اشیاء فرم. .TP .B یک مسیر با یک شمارهٔ شیء، یک ویژگی در دیکشنری trailer، یا کلیدواژهٔ .BR trailer " یا " pages شروع می‌شود. عناصر را با یک نقطه .B . یا اسلش .BR / از هم جدا کنید. با استفاده از .BI pages/ N یک شیء صفحه را انتخاب کنید که در آن .I N شمارهٔ صفحه است. صفحهٔ نخست شمارهٔ ۱ است. .TP .B * می‌توانید از .B * به‌عنوان عنصری برای پیمایش روی تمام اندیس‌های آرایه یا ویژگی‌های دیکشنری در یک شیء استفاده کنید. ..SH "امضا (SIGN)" .SY mutool .B sign .RI [ options ] .I input.pdf .RI [ signature-object-number\~ .\|.\|.] .YS .PP یک فایل PDF را می‌خواند و اطلاعات مربوط به هر شیء فیلد امضا را چاپ می‌کند. با گزینه‌های مناسب، می‌توان تمام یا امضاهای مشخص‌شده را اعتبارسنجی، پاک یا امضا کرد. .TP .BI \-p\~ password در صورت رمزگذاری بودن فایل، از گذرواژه مشخص‌شده استفاده می‌کند. .TP .B \-v اعتبارسنجی تمام امضاها، یا تنها امضای مشخص‌شده. .TP .B \-c پاک کردن تمام امضاها، یا تنها امضای مشخص‌شده. .TP .BI \-s\~ certificate-filename خواندن یک گواهی از نام‌فایل داده‌شده و استفاده از آن برای امضای همه، یا فقط امضای مشخص‌شده. .TP .BI \-P\~ certificate-password استفاده از گذرواژه مشخص‌شده هنگام باز کردن گواهی. .TP .BI \-o\~ filename نام فایل خروجی. .B signature object numbers فهرستی از شماره اشیاء PDF برای امضاهایی که باید اعتبارسنجی/پاک/امضا شوند. اگر چنین شماره اشیایی داده نشود، تمام امضاها پردازش خواهند شد. . .SH "ردیابی (TRACE)" .SY mutool .B trace .RI [ options ] .IR file1\~ [ pages1 ] .RI [ file2\~ [ pages2 ] .RI .\|.\|.] .YS .PP ردیابی فراخوانی‌های دستگاهِ لازم برای رندر کردن صفحات مورد نظر از سند داده‌شده را چاپ می‌کند. .TP .BI \-p\~ password در صورت رمزگذاری بودن فایل، از گذرواژه مشخص‌شده استفاده می‌کند. .TP .BI \-b\~ box کادری که برش بر اساس آن انجام می‌شود، یکی از موارد: .RB ( MediaBox\~ (پیش‌فرض)، .BR CropBox ، .BR BleedBox ، .BR TrimBox ، یا .BR ArtBox ). .TP .BI \-W\~ width عرض صفحه بر حسب پوینت برای صفحه‌آرایی EPUB. .TP .BI \-H\~ height ارتفاع صفحه بر حسب پوینت برای صفحه‌آرایی EPUB. .TP .BI \-S\~ size اندازه قلم بر حسب پوینت برای صفحه‌آرایی EPUB. .TP .BI \-U\~ filename شیوه‌نامه CSS کاربر برای صفحه‌آرایی EPUB. .TP .B \-X غیرفعال‌سازی شیوه‌های سند برای صفحه‌آرایی EPUB. .TP .B \-d فعال‌سازی استفاده از فهرست‌های نمایش (display lists). .TP .I pages فهرستی از شماره‌ها و محدوده‌های صفحات که با کاما جدا شده‌اند (برای نمونه: 1,5,10-15,20-N)، که در آن نویسه N نشان‌دهنده آخرین صفحه است. اگر هیچ صفحه‌ای مشخص نشود، تمام صفحات رندر خواهند شد. ..SH TRIM .SY mutool .B trim .RI [ گزینه‌ها ] .I input.pdf .YS .PP نسخه‌ای اصلاح‌شده از یک فایل PDF می‌سازد که در آن، محتوای قرارگرفته در داخل (یا خارج) جعبهٔ مشخص‌شده حذف شده است. .TP .BI \-b\~ box مشخص می‌کند برش بر اساس کدام جعبه انجام شود، یکی از موارد: .RB ( MediaBox\~ (پیش‌فرض)، .BR CropBox ، .BR BleedBox ، .BR TrimBox ، یا .BR ArtBox ). .TP .B \-f بازگشت به mediabox در صورت در دسترس نبودن جعبهٔ مشخص‌شده. .TP .BI \-m\~ all افزودن حاشیهٔ یکسان به تمام اضلاع جعبه، که در آن مقدار .B all برای جهت رو به داخل مثبت و برای جهت رو به خارج منفی است. .TP .BI \-m\~ vertical,horizontal افزودن حاشیه‌های مشخص برای اضلاع عمودی و افقی جعبه، که در آن .BR vertical \~و\~ horizontal برای جهت رو به داخل مثبت و برای جهت رو به خارج منفی هستند. .TP .BI \-m\~ top,right,bottom,left افزودن حاشیه‌های مشخص برای اضلاع بالا، راست، پایین و چپ جعبه، که در آن مقادیر .BR top ،\~ right ،\~ bottom ، .RB و\~ left هرکدام برای جهت رو به داخل مثبت و برای جهت رو به خارج منفی هستند. .TP .B \-e مستثنی کردن (حذف) محتویات جعبه به‌جای نگه‌داشتن آن‌ها. .TP .BI \-o\~ filename نام فایل خروجی. . .SH "گزینه‌های خروجی (OUTPUT OPTIONS)" پیکربندی خروجی با فهرستی از گزینه‌های خروجی که با کاما از هم جدا شده‌اند انجام می‌شود. . .SS "گزینه‌های خروجی رستر (Raster output options)" این گزینه‌ها برای این قالب‌های خروجی اعمال می‌شوند: .BR cbz ,\~ png ,\~ pnm ,\~ pgm ,\~ ppm ,\~ pam ,\~ pbm ,\~ pkm . .TP .BI rotate= N چرخاندن صفحات رندرشده به میزان N درجه در خلاف جهت عقربه‌های ساعت. .TP .BI resolution= N تنظیم هر دو تفکیک‌پذیری X و Y بر روی .I N پیکسل بر اینچ. .TP .BI x-resolution= N تنظیم تفکیک‌پذیری محور X صفحات رندرشده بر حسب پیکسل بر اینچ. .TP .BI y-resolution= N تنظیم تفکیک‌پذیری محور Y صفحات رندرشده بر حسب پیکسل بر اینچ. .TP .BI width= N رندر صفحات متناسب با عرض N پیکسل (نادیده گرفتن گزینهٔ resolution). .TP .BI height= N رندر صفحات متناسب با ارتفاع N پیکسل (نادیده گرفتن گزینهٔ resolution). .TP .BR colorspace= ( gray | rgb | cmyk ) رندر صفحات با استفاده از فضای رنگی مشخص‌شده. .TP .B alpha رندر صفحات با کانال آلفا و پس‌زمینهٔ شفاف. .TP .BR graphics= ( aa\c .IR N |\c .BR cop | app )\~ \c .RB و\~ text= ( aa\c .IR N |\c .BR cop | app ) تنظیم رسترایزر (rasterizer) مورد استفاده برای گرافیک یا متن به‌ترتیب: .RS .TP .BI aa N هموارسازی لبه‌ها (Antialias) با .I N بیت (۰ تا ۸). .TP .B cop مرکز پیکسل (Center of pixel). .TP .B app هر بخشی از پیکسل (Any part of pixel). .RE ..SS گزینه‌های PCL این گزینه‌ها برای قالب‌های خروجی رستر چاپ (print-raster) اعمال می‌شوند: .BR pcl ,\~ pclm ,\~ ps ,\~ pwg . .TP .BR colorspace= ( mono | rgb ) رندر یک صفحه ۱-بیتی سیاه و سفید یا تمام‌رنگی. .TP .BR preset= ( generic | ljet4 | dj500 | fs600 | lj | lj2 | lj3 | lj4 | lj4pl | lj4d | lp2563b | oce9050 ) رندر یک صفحه ۱-بیتی سیاه و سفید یا تمام‌رنگی. .TP .BR spacing= ( 0 | 1 | 2 | 3 ) تنظیم فاصله‌گذاری عمودی روی هیچ‌کدام (none)، PCL 3 (*p+Y)، PCL 5 (*bY)، یا PCL 6 (*bY و پاک‌سازی seed row). .TP .B mode2 فعال‌سازی فشرده‌سازی گرافیکی mode 2. .TP .B mode3 فعال‌سازی فشرده‌سازی گرافیکی mode 3. .TP .B eog_reset پایان گرافیک (+rB) تمام پارامترها را بازنشانی می‌کند. .TP .B has_duplex پشتیبانی از چاپ دورو (&lS). .TP .B has_papersize پشتیبانی از تنظیم اندازه کاغذ (&lA). .TP .B has_copies پشتیبانی از تعداد نسخه‌ها (&lX). .TP .B is_ljet4pjl غیرفعال/فعال‌سازی خروجی ویژه مدل HP 4PJL. .TP .B is_oce9050 غیرفعال/فعال‌سازی خروجی ویژه مدل‌های Oce 9050. . .SS گزینه‌های PCLm این گزینه‌ها تنها برای موارد زیر اعمال می‌شوند: .BR pclm . .TP .BR compression= ( none | flate ) بدون فشرده‌سازی (پیش‌فرض)، یا فعال‌سازی فشرده‌سازی flate. .TP .BI strip-height= N ارتفاع نوار (پیش‌فرض ۱۶). . .SS گزینه‌های PWG این گزینه‌ها تنها برای موارد زیر اعمال می‌شوند: .BR pwg . .TP .BI media_class= string تنظیم فیلد media_class. .TP .BI media_color= string تنظیم فیلد media_color. .TP .BI media_type= string تنظیم فیلد media_type. .TP .BI output_type= string تنظیم فیلد output_type. .TP .BI rendering_intent= string تنظیم فیلد rendering_intent. .TP .BI page_size_name= string تنظیم فیلد page_size_name. .TP .BI advance_distance= int تنظیم فیلد advance_distance. .TP .BI advance_media= int تنظیم فیلد advance_media. .TP .BI collate= int تنظیم فیلد collate. .TP .BI cut_media= int تنظیم فیلد cut_media. .TP .BI duplex= int تنظیم فیلد duplex. .TP .BI insert_sheet= int تنظیم فیلد insert_sheet. .TP .BI jog= int تنظیم فیلد jog. .TP .BI leading_edge= int تنظیم فیلد leading_edge. .TP .BI manual_feed= int تنظیم فیلد manual_feed. .TP .BI media_position= int تنظیم فیلد media_position. .TP .BI media_weight= int تنظیم فیلد media_weight. .TP .BI mirror_print= int تنظیم فیلد mirror_print. .TP .BI negative_print= int تنظیم فیلد negative_print. .TP .BI num_copies= int تنظیم فیلد num_copies. .TP .BI orientation= int تنظیم فیلد orientation. .TP .BI output_face_up= int تنظیم فیلد output_face_up. .TP .BI page_size_x= int تنظیم فیلد page_size_x. .TP .BI page_size_y= int تنظیم فیلد page_size_y. .TP .BI separations= int تنظیم فیلد separations. .TP .BI tray_switch= int تنظیم فیلد tray_switch. .TP .BI tumble= int تنظیم فیلد tumble. .TP .BI media_type_num= int تنظیم فیلد media_type_num. .TP .BI compression= int تنظیم فیلد compression. .TP .BI row_count= int تنظیم فیلد row_count. .TP .BI row_feed= int تنظیم فیلد row_feed. .TP .BI row_step= int تنظیم فیلد row_step. ..SS "گزینه‌های SVG (SVG options)" این موارد فقط برای این قالب اعمال می‌شوند: .BR svg . .TP .BI text= text تولید متن به‌صورت عنصرهای (قلم‌های غیردقیق). .TP .BI text= path تولید متن به‌صورت عنصرهای (قلم‌های دقیق). .TP .B no-reuse-images عدم استفاده مجدد از تصاویر با استفاده از تعاریف . . .SS "گزینه‌های متن (Text options)" این موارد بر قالب‌های خروجی زیر اعمال می‌شوند: .BR html ,\~ xhtml ,\~ text ,\~ stext . .TP .B preserve-images نگه‌داشتن تصاویر در خروجی. .TP .B preserve-ligatures عدم تجزیه حروف پیوسته (ligature) به نویسه‌های سازنده. .TP .B preserve-spans عدم ادغام spanهای واقع در یک سطر. .TP .B preserve-whitespace عدم تبدیل همه فاصله‌های خالی به نویسه‌های فاصله (space). .TP .B inhibit-spaces عدم افزودن فاصله در میان شکاف‌های درون متن. .TP .B paragraph-break شکستن بلوک‌ها در مرزهای پاراگراف. .TP .B dehyphenate تلاش برای اتصال واژه‌های شکسته‌شده با خط تیره. .TP .B ignore-actualtext عدم اعمال جایگزینی‌های ActualText. .TP .B use-cid-for-unknown-unicode استفاده از کد نویسه در صورت ناموفق بودن نگاشت یونیکد. .TP .B use-gid-for-unknown-unicode استفاده از نمایه گلیف در صورت ناموفق بودن نگاشت یونیکد. .TP .B accurate-bboxes محاسبه کادرهای مرزی (bboxes) از روی خطوط پیرامونی (outlines). .TP .B accurate-ascenders محاسبه بالارونده/پایین‌رونده (ascender/descender) از گلیف‌های قلم. .TP .B accurate-side-bearings گسترش کادرهای مرزی (bboxes) نویسه جهت دربرگیری کامل پهنای گلیف‌ها. .TP .B collect-styles تلاش برای شناسایی ویژگی‌های متن (پررنگ جعلی، خط‌خورده، زیرخط‌دار و غیره). .TP .B clip عدم گنجاندن متنی که به‌طور کامل برش خورده (clipped) است. .TP .BI clip-rect= x0 : y0 : x1 : y1 تعیین مستطیل برشی که محتوا باید از درون آن گردآوری شود. .TP .B structured گردآوری نشانه‌گذاری ساختار. .TP .B vectors گنجاندن کادرهای مرزی برداری (vector bboxes) در خروجی. .TP .B lazy-vectors به تأخیر انداختن بردارهایی در استخراج که در غیر این صورت موجب تقسیم یک سطر متنی می‌شدند. .TP .B fuzzy-vectors ادغام بردارهای افقی و عمودی مماس بر هم. .TP .B segment تلاش برای قطعه‌بندی صفحه. .TP .B table-hunt جستجو به دنبال جدول‌ها درون یک صفحه (قطعه‌بندی‌شده). .TP .B vertically-collapse-bordered-cells (آزمایشی) در صورت تعیین به عنوان true، محتوای اَبَرسلول‌های کاملاً دارای حاشیه به‌صورت عمودی قابل‌جمع‌شدن در نظر گرفته می‌شود. . ..SH "گزینه‌های خروجی پی‌دی‌اف (PDF OUTPUT OPTIONS)" این موارد فقط برای خروجی زیر اعمال می‌شوند: .BR PDF . .TP .B decompress خارج کردن تمام جریان‌ها از حالت فشرده (به‌جز compress-fonts/images). .TP .BR compress=\c .RB ( yes | flate | brotli ) فشرده‌سازی تمام جریان‌ها؛ در صورتی که مقداری داده نشود یا مقدار .B yes باشد، پیش‌فرض استفاده از flate است. .TP .B compress-fonts فشرده‌سازی جریان شیء برای فونت‌های جاسازی‌شده. .TP .B compress-images فشرده‌سازی جریان‌های شیء برای تصاویر. .TP .BR compress-effort= ( 0 |\c .IR percentage ) میزان تلاش صرف‌شده برای فشرده‌سازی؛ 0 پیش‌فرض است، در غیر این صورت درصدی از بیشینهٔ تلاش. .TP .B ascii کدگذاری جریان‌های شیء با استفاده از کدگذاری ASCII hex. .TP .B pretty چاپ آراستهٔ (pretty-print) اشیاء به همراه تورفتگی. .TP .B labels چاپ برچسب‌های اشیاء. .TP .B linearize .B دیگر پشتیبانی نمی‌شود! بهینه‌سازی سند برای بارگذاری تدریجی در نمایش‌دهنده‌ها. .TP .B clean چاپ آراستهٔ دستورهای گرافیکی در جریان‌های محتوا. .TP .B sanitize پاک‌سازی دستورهای گرافیکی در جریان‌های محتوا. .TP .B garbage جمع‌آوری زبالهٔ (garbage collection) اشیاء استفاده‌نشده. .TP .B garbage=compact جمع‌آوری زبالهٔ اشیاء استفاده‌نشده و فشرده‌سازی جدول ارجاع متقابل (cross-reference). .TP .B garbage=deduplicate جمع‌آوری زبالهٔ اشیاء استفاده‌نشده، فشرده‌سازی جدول ارجاع متقابل و بازترکیب اشیاء تکراری. .TP .B incremental نوشتن تغییرات به‌صورت به‌روزرسانی افزایشی. .TP .B objstms استفاده از جریان‌های شیء و جریان‌های ارجاع متقابل. .TP .BR appearance= ( yes | all ) تولید ساختگی جریان‌های نمایشیِ حاشیه‌نویسی/ابزارک، فقط برای موارد ناموجود یا همهٔ آن‌ها. .TP .B continue-on-error ادامه دادن به ذخیرهٔ سند حتی در صورت وقوع خطا. .TP .B decrypt این گزینه منسوخ شده است: به‌جای decrypt از encrypt=none استفاده کنید. .TP .BR encrypt= ( none | keep | rc4-40 | rc4-128 | aes-128 | aes-256 ) نوشتن سند رمزگذاری‌شده با استفاده از روش رمزگذاری مشخص‌شده. مقدار پیش‌فرض keep است. .TP .BI permissions= number مجوزهای سند برای اعطا در زمان رمزگذاری. .TP .BI user-password= password گذرواژهٔ لازم برای خواندن سند. .TP .BI owner-password= password گذرواژهٔ لازم برای ویرایش سند. .TP .BR regenerate-id= ( yes | no ) تولید مجدد شناسهٔ سند (پیش‌فرض yes). .TP .BR reproducible= ( yes | no ) تلاش برای بازتولیدپذیر ساختن اسناد تولیدشده (پیش‌فرض no). ..SH "وضعیت خروج (EXIT STATUS)" وضعیت خروج در صورت اجرای موفقیت‌آمیز 0 و در صورت بروز خطا غیرصفر است. . .SH "همچنین ببینید (SEE ALSO)" .BR mupdf (1), . .SH "نویسنده (AUTHOR)" حق کپی‌رایت MuPDF برای سال‌های 2004-2026 متعلق به Artifex Software, Inc. است.