.\" Copyright (c) 2001-2003 Leon Bottou, Yann Le Cun, Patrick Haffner,
.\" Copyright (c) 2001 AT&T Corp., and Lizardtech, Inc.
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual. Otherwise check the web site
.\" of the Free Software Foundation at http://www.fsf.org.
.TH DDJVU 1 "10/19/2002" "DjVuLibre-3.5" "DjVuLibre-3.5"
.SH "نام (NAME)"
ddjvu \- رمزگشای خط فرمان DjVu

.SH "خلاصه دستور (SYNOPSIS)"
.BI "ddjvu -format=" "fmt" " [" "options" "] [" "djvufile" "] [" "outputfile" "]"

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

.SH "گزینه‌های اصلی (MAIN OPTIONS)"
.TP
.BI "-format=" "fmt"
فرمت‌های پروندهٔ خروجی را مشخص می‌کند.
فرمت‌های شناخته‌شده عبارتند از
.BR "pbm" ،
.BR "pgm" ،
.BR "ppm" ،
.BR "pnm" ،
.BR "rle" ،
.BR "tiff"
و
.BR "pdf" .
.RS
.IP "*" 3
فرمت‌های
.BR "pbm" ،
.BR "pgm"
و
.BR "ppm"
به ترتیب یک پروندهٔ Portable Bitmap (PBM)،
Portable Graymap (PGM)
یا Portable Pixmap (PPM) تولید می‌کنند.
فرمت
.B "pnm"
بر اساس محتوای رنگ تصویر خروجی، یک پروندهٔ خروجی PBM، PGM یا PPM تولید می‌کند.
.IP "*"
فرمت
.B "rle"
یک پروندهٔ دوسطحی (bitonal) فشرده با کدگذاری طول اجرا (run length encoded) تولید می‌کند
که برای دستورات DjVuLibre یعنی
.BR "cjb2"
و
.BR "csepdjvu"
قابل فهم است.
.IP "*"
فرمت
.B "tiff"
با استفاده از فشرده‌سازی بدون اتلاف، یک پروندهٔ Tagged Image Format (TIFF) تولید می‌کند.
فعال‌سازی فشرده‌سازی با اتلاف JPEG (گزینهٔ
.BI "-quality"
در زیر را ببینید) اغلب پرونده‌های بسیار کوچک‌تری ایجاد می‌کند.
دستورات
.BR tiffcp (1)
و
.BR tiffsplit (1)
برای کار با پرونده‌های TIFF حاصل کاربردی هستند.
.IP "*"
فرمت
.B "pdf"
یک پروندهٔ Portable Document Format (PDF) تولید می‌کند.
هر صفحه در پروندهٔ حاصل به صورت یک تصویر با وضوح مشخص‌شده و با استفاده از فشرده‌سازی بدون اتلاف نمایش داده می‌شود.
فعال‌سازی فشرده‌سازی با اتلاف JPEG (گزینهٔ
.BI "-quality"
در زیر را ببینید) اغلب پرونده‌های بسیار کوچک‌تری ایجاد می‌کند.
یک روش جایگزین برای تولید پروندهٔ PDF این است که ابتدا از
.BR djvups (1)
استفاده شود و پروندهٔ PostScript حاصل به PDF تبدیل گردد.
اینکه کدام روش نتیجهٔ بهتری می‌دهد، به محتوای پروندهٔ DjVu و قابلیت‌های مبدل PS به PDF بستگی دارد.
.RE
.TP
.B ""
هنگامی که گزینهٔ
.B "-format"
مشخص نشده باشد، پسوند آرگومان
.I "outputfile"
هیچ تأثیری بر فرمت خروجی پیش‌فرض نخواهد داشت.
در عوض رفتار برنامه برای اطمینان از سازگاری رو به عقب با نسخه‌های پیشین
.BR "ddjvu"
تغییر می‌کند.
توصیه می‌کنیم همیشه با استفاده از این گزینه، فرمت خروجی را مشخص کنید.
.TP
.BI "-page=" "pagespec"
مشخص می‌کند کدام صفحات باید رمزگشایی شوند.
هنگامی که این گزینه مشخص نشده باشد، تمام صفحات اسناد رمزگشایی شده و به صورت متوالی در پروندهٔ خروجی قرار می‌گیرند.
مشخصهٔ صفحه
.I pagespec
شامل یک یا چند محدودهٔ صفحه است که با کاما از هم جدا شده‌اند.
محدودهٔ صفحه یا یک شمارهٔ صفحه است، یا دو شمارهٔ صفحه که با یک خط تیره از هم جدا شده‌اند.
برای نمونه، مشخصهٔ
.BR "1-10"
صفحات ۱ تا ۱۰ را در خروجی قرار می‌دهد، و مشخصهٔ
.BR "1,3,99999-4"
صفحات ۱ و ۳ و به دنبال آن تمام صفحات سند به ترتیب معکوس تا صفحهٔ ۴ را در خروجی قرار می‌دهد.
.TP
.BI "-eachpage"
هنگامی که این گزینه مشخص شود، برنامهٔ
.B ddjvu
به ازای هر صفحه یک پروندهٔ جداگانه ایجاد می‌کند که نام آن با جایگزینی مشخصهٔ
.B %d
در
.I outputfilename
با شمارهٔ صفحه، به شیوه‌ای مشابه تابع
.BR printf (3)
تعیین می‌شود.
.TP
.BI "-mode=" "mod"
انتخاب می‌کند که کدام لایه‌های تصویر DjVu باید رندر شوند.
حالت‌های رندر معتبر عبارتند از
.BR "color" ،
.BR "black" ،
.BR "mask" ،
.BR "foreground"
و
.BR "background" .
.RS
.IP "*" 3
حالت رندر
.BR "color"
حالت پیش‌فرض است.
هنگامی که پروندهٔ DjVu دوسطحی (bitonal) باشد، بسته به ضریب زیرنمونه‌برداری، خروجی دوسطحی یا طیف خاکستری تولید می‌شود.
در غیر این صورت یک تصویر رنگی تولید می‌شود.
.IP "*"
حالت رندر
.B "black"
برای استخراج یک تصویر سیاه‌وسفید معنادار مفید است.
بسته به ضریب زیرنمونه‌برداری، خروجی دوسطحی یا سطح خاکستری تولید می‌شود.
.IP "*"
حالت‌های رندر
.BR "mask" ،
.BR "foreground"
و
.BR "background"
لایه‌های خاصی از یک تصویر DjVu را انتخاب می‌کنند.
در صورتی که تصویر DjVu حاوی لایهٔ انتخاب‌شده نباشد، این حالت‌ها ممکن است با خطا مواجه شوند.
.RE
.TP
.BI "-skip"
به جای متوقف کردن برنامه هنگام برخورد با یک صفحهٔ خراب، این گزینه باعث می‌شود که
.BR ddjvu
به سادگی از صفحهٔ خراب صرف‌نظر کرده و با صفحهٔ بعدی ادامه دهد.
این گزینه برای پردازش برخی پرونده‌های آسیب‌دیده مفید است.

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

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

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

.SH "مثال‌ها (EXAMPLES)"
دستور
.IP "" 3
.BI "ddjvu -format=tiff " "myfile.djvu" " " "myfile.tif"
.PP
تمام صفحات را رمزگشایی کرده و یک پروندهٔ چندصفحه‌ای TIFF تولید می‌کند.

دستور
.IP "" 3
.BI "ddjvu -format=ppm -page=1-10 -eachpage -size=100x100 " "myfile.djvu" " thumb%03d.ppm"
.PP
تصاویر بندانگشتی 100x100 را برای ده صفحهٔ نخست یک سند تولید کرده و آن‌ها را به صورت پرونده‌های PPM با نام‌های
.BR thumb001.ppm
تا
.BR thumb010.ppm
خروجی می‌دهد.

.SH "اعتبار و سازندگان (CREDITS)"
نسخهٔ جدید این برنامه توسط
L\('eon Bottou <leonb@users.sourceforge.net>
نوشته شده است.
.PP
این برنامه شامل کدهای برگرفته از برنامهٔ
.BR tiff2pdf
است که توسط Ross Finlayson نوشته شده و تحت مجوز BSD منتشر شده است.

.SH "همچنین ببینید (SEE ALSO)"
.BR djvu (1),
.BR djview (1),
.BR pnm (5),
.BR pbm (5),
.BR pgm (5),
.BR ppm (5),
.BR cjpeg (1),
.BR tiffsplit (1),
.BR tiffcp (1),
.BR printf (3)