نام (NAME)

ddjvu - رمزگشای خط فرمان DjVu

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

ddjvu -format=fmt [options] [djvufile] [outputfile]

توضیحات (DESCRIPTION)

پروندهٔ DjVu به نام djvufile را رمزگشایی کرده و پروندهٔ تصویری outputfile را تولید می‌کند.

هنگامی که آرگومان djvufile مشخص نشده باشد یا برابر با یک خط تیره منفرد (-) باشد، داده‌های DjVu از ورودی استاندارد خوانده می‌شوند. به همین ترتیب، هنگامی که آرگومان outputfile مشخص نشده باشد یا برابر با یک خط تیره منفرد باشد، داده‌های خروجی در خروجی استاندارد نوشته می‌شوند. با این حال، هنگام ایجاد پرونده‌های TIFF یا PDF، همیشه تعیین یک نام معتبر برای پروندهٔ خروجی الزامی است.

گزینه‌های اصلی (MAIN OPTIONS)

-format=fmt: فرمت‌های پروندهٔ خروجی را مشخص می‌کند. فرمت‌های شناخته‌شده عبارتند از pbm، pgm، ppm، pnm، rle، tiff و pdf.

فرمت‌های pbm، pgm و ppm به ترتیب یک پروندهٔ Portable Bitmap (PBM)، Portable Graymap (PGM) یا Portable Pixmap (PPM) تولید می‌کنند. فرمت pnm بر اساس محتوای رنگ تصویر خروجی، یک پروندهٔ خروجی PBM، PGM یا PPM تولید می‌کند.
فرمت rle یک پروندهٔ دوسطحی (bitonal) فشرده با کدگذاری طول اجرا (run length encoded) تولید می‌کند که برای دستورات DjVuLibre یعنی cjb2 و csepdjvu قابل فهم است.
فرمت tiff با استفاده از فشرده‌سازی بدون اتلاف، یک پروندهٔ Tagged Image Format (TIFF) تولید می‌کند. فعال‌سازی فشرده‌سازی با اتلاف JPEG (گزینهٔ -quality در زیر را ببینید) اغلب پرونده‌های بسیار کوچک‌تری ایجاد می‌کند. دستورات tiffcp(1) و tiffsplit(1) برای کار با پرونده‌های TIFF حاصل کاربردی هستند.
فرمت pdf یک پروندهٔ Portable Document Format (PDF) تولید می‌کند. هر صفحه در پروندهٔ حاصل به صورت یک تصویر با وضوح مشخص‌شده و با استفاده از فشرده‌سازی بدون اتلاف نمایش داده می‌شود. فعال‌سازی فشرده‌سازی با اتلاف JPEG (گزینهٔ -quality در زیر را ببینید) اغلب پرونده‌های بسیار کوچک‌تری ایجاد می‌کند. یک روش جایگزین برای تولید پروندهٔ PDF این است که ابتدا از djvups(1) استفاده شود و پروندهٔ PostScript حاصل به PDF تبدیل گردد. اینکه کدام روش نتیجهٔ بهتری می‌دهد، به محتوای پروندهٔ DjVu و قابلیت‌های مبدل PS به PDF بستگی دارد.

: هنگامی که گزینهٔ -format مشخص نشده باشد، پسوند آرگومان outputfile هیچ تأثیری بر فرمت خروجی پیش‌فرض نخواهد داشت. در عوض رفتار برنامه برای اطمینان از سازگاری رو به عقب با نسخه‌های پیشین ddjvu تغییر می‌کند. توصیه می‌کنیم همیشه با استفاده از این گزینه، فرمت خروجی را مشخص کنید.
-page=pagespec: مشخص می‌کند کدام صفحات باید رمزگشایی شوند. هنگامی که این گزینه مشخص نشده باشد، تمام صفحات اسناد رمزگشایی شده و به صورت متوالی در پروندهٔ خروجی قرار می‌گیرند. مشخصهٔ صفحه pagespec شامل یک یا چند محدودهٔ صفحه است که با کاما از هم جدا شده‌اند. محدودهٔ صفحه یا یک شمارهٔ صفحه است، یا دو شمارهٔ صفحه که با یک خط تیره از هم جدا شده‌اند. برای نمونه، مشخصهٔ 1-10 صفحات ۱ تا ۱۰ را در خروجی قرار می‌دهد، و مشخصهٔ 1,3,99999-4 صفحات ۱ و ۳ و به دنبال آن تمام صفحات سند به ترتیب معکوس تا صفحهٔ ۴ را در خروجی قرار می‌دهد.
-eachpage: هنگامی که این گزینه مشخص شود، برنامهٔ ddjvu به ازای هر صفحه یک پروندهٔ جداگانه ایجاد می‌کند که نام آن با جایگزینی مشخصهٔ %d در outputfilename با شمارهٔ صفحه، به شیوه‌ای مشابه تابع printf(3) تعیین می‌شود.
-mode=mod: انتخاب می‌کند که کدام لایه‌های تصویر DjVu باید رندر شوند. حالت‌های رندر معتبر عبارتند از color، black، mask، foreground و background.

حالت رندر color حالت پیش‌فرض است. هنگامی که پروندهٔ DjVu دوسطحی (bitonal) باشد، بسته به ضریب زیرنمونه‌برداری، خروجی دوسطحی یا طیف خاکستری تولید می‌شود. در غیر این صورت یک تصویر رنگی تولید می‌شود.
حالت رندر black برای استخراج یک تصویر سیاه‌وسفید معنادار مفید است. بسته به ضریب زیرنمونه‌برداری، خروجی دوسطحی یا سطح خاکستری تولید می‌شود.
حالت‌های رندر mask، foreground و background لایه‌های خاصی از یک تصویر DjVu را انتخاب می‌کنند. در صورتی که تصویر DjVu حاوی لایهٔ انتخاب‌شده نباشد، این حالت‌ها ممکن است با خطا مواجه شوند.

-skip: به جای متوقف کردن برنامه هنگام برخورد با یک صفحهٔ خراب، این گزینه باعث می‌شود که ddjvu به سادگی از صفحهٔ خراب صرف‌نظر کرده و با صفحهٔ بعدی ادامه دهد. این گزینه برای پردازش برخی پرونده‌های آسیب‌دیده مفید است.

گزینه‌های وضوح (RESOLUTION OPTIONS)

گزینه‌های زیر وضوح تصویر خروجی را کنترل می‌کنند. وضوح پیش‌فرض، وضوح اصلی پروندهٔ DjVu است که معادل با انتخاب -1 می‌باشد.

-n: یک ضریب زیرنمونه‌برداری عدد صحیح را مشخص می‌کند. ابعاد تصویر خروجی کامل n برابر کوچک‌تر از اندازهٔ تصویر DjVu خواهد بود. مقادیر مجاز برای آرگومان n از ۱ تا ۱۲ است. برای نمونه، گزینهٔ -1 تصویر خروجی‌ای تولید می‌کند که وضوح آن برابر با وضوح پروندهٔ تصویر DjVu ورودی است.
-subsample=n: این گزینه معادل گزینهٔ -n است.
-scale=mag: یک ضریب بزرگ‌نمایی را نسبت به وضوح ذخیره‌شده در تصویر DjVu مشخص می‌کند. مشخص کردن بزرگ‌نمایی ۱۰۰ تصویری مناسب برای نمایش روی دستگاهی با ۱۰۰ dpi مانند صفحه‌نمایش رایانه تولید می‌کند. ضریب بزرگ‌نمایی mag همچنین می‌تواند به عنوان وضوح تصویر خروجی بر حسب نقطه در اینچ (DPI) تفسیر شود.
-size=wxh: اندازهٔ کل تصویر خروجی را مشخص می‌کند. رندر تصویر کامل DjVu یک تصویر خروجی ایجاد می‌کند که عرض و ارتفاع آن از w و h تجاوز نخواهد کرد. برای تغییر نسبت تصویر (aspect ratio)، باید از گزینهٔ -aspect=no نیز استفاده کنید.
-aspect=yesno: این گزینه مشخص می‌کند که آیا نسبت تصویر باید حفظ شود یا خیر. حالت پیش‌فرض حفظ نسبت تصویر است. این گزینه هنگام استفاده در ترکیب با گزینهٔ -size اجازهٔ تغییر در نسبت تصویر را می‌دهد.

سایر گزینه‌ها (OTHER OPTIONS)

-verbose: پیام‌های اطلاعاتی در توصیف ساختار تصویر DjVu و فرمت پروندهٔ خروجی را نمایش می‌دهد.
-segment=wxh+x+y: یک قطعه از تصویر را برای رندر مشخص می‌کند. برنامهٔ ddjvu از نظر مفهومی کل صفحه را با وضوح مشخص‌شده رندر کرده و سپس یک زیرتصویر به عرض w و ارتفاع h، از موقعیت (x,y) نسبت به گوشهٔ پایین سمت چپ صفحه استخراج می‌کند. البته هر دو عملیات به طور هم‌زمان انجام می‌شوند. رندر یک زیرتصویر کوچک بسیار سریع‌تر از رندر تصویر کامل است. هنگامی که این گزینه مشخص شود، پروندهٔ خروجی همواره دارای اندازهٔ wxh خواهد بود.
-quality=factor: فشرده‌سازی با اتلاف JPEG را برای پرونده‌های TIFF و PDF فعال می‌کند. این گزینه فقط تصاویری را تحت تأثیر قرار می‌دهد که نمی‌توان آن‌ها را با فشرده‌سازی ترجیحی TIFF/G4 کدگذاری کرد. آرگومان factor یک ضریب کوانتیزاسیون از ۲۵ تا ۱۵۰ است. برای اطلاعات بیشتر دربارهٔ ضرایب کوانتیزاسیون JPEG، دستور cjpeg(1) را ببینید. مقدار ۸۰ یک نقطهٔ شروع مناسب است.
-quality=uncompressed: فشرده‌سازی را در پرونده‌های TIFF و PDF به طور کامل غیرفعال می‌کند. اگرچه پرونده‌های حاصل اغلب بسیار حجیم هستند، اما گاهی اوقات برای بیشترین سازگاری با نرم‌افزارهای شتاب‌زده نوشته‌شده کاربردی است.
-quality=deflate: فشرده‌سازی DEFLATE را برای پرونده‌های TIFF فعال می‌کند. تصاویری که نتوان آن‌ها را با استفاده از فشرده‌سازی ترجیحی TIFF/G4 کدگذاری کرد، در صورت در دسترس بودن با فشرده‌سازی DEFLATE کدگذاری خواهند شد. در غیر این صورت از فشرده‌سازی سازگارتر PACKBITS استفاده می‌شود. مشخص کردن این گزینه برای پرونده‌های PDF ضروری نیست زیرا این رفتار پیش‌فرض آن‌ها است.

گزینه‌های منسوخ‌شده (DEPRECATED OPTIONS)

گزینه‌های مختلفی برای اطمینان از سازگاری رو به عقب با نسخه‌های پیشین ddjvu حفظ شده‌اند. هنگامی که گزینهٔ -format مشخص نشده باشد، برنامه تنها نخستین صفحهٔ سند را رمزگشایی می‌کند و وضوح پیش‌فرض برابر با -scale=100 می‌شود. گزینه‌های -size، -scale، -segment و -page یک آرگومان جداشده با فاصله را می‌پذیرند. گزینه‌های -foreground، -background و -black کوته‌نوشت‌هایی برای گزینهٔ -mode=mod هستند. لطفاً به این قابلیت‌ها اتکا نکنید.

مثال‌ها (EXAMPLES)

دستور

: ddjvu -format=tiff myfile.djvu myfile.tif

تمام صفحات را رمزگشایی کرده و یک پروندهٔ چندصفحه‌ای TIFF تولید می‌کند.

دستور

: ddjvu -format=ppm -page=1-10 -eachpage -size=100x100 myfile.djvu thumb%03d.ppm

تصاویر بندانگشتی 100x100 را برای ده صفحهٔ نخست یک سند تولید کرده و آن‌ها را به صورت پرونده‌های PPM با نام‌های thumb001.ppm تا thumb010.ppm خروجی می‌دهد.

اعتبار و سازندگان (CREDITS)

نسخهٔ جدید این برنامه توسط Léon Bottou <leonb@users.sourceforge.net> نوشته شده است.

این برنامه شامل کدهای برگرفته از برنامهٔ tiff2pdf است که توسط Ross Finlayson نوشته شده و تحت مجوز BSD منتشر شده است.

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

djvu(1), djview(1), pnm(5), pbm(5), pgm(5), ppm(5), cjpeg(1), tiffsplit(1), tiffcp(1), printf(3)