DJVUDIGITAL(1) DjVuLibre-3.5 DJVUDIGITAL(1)

djvudigital - ساخت پرونده‌های DjVu از پرونده‌های PS یا PDF

djvudigital [گزینه‌ها] پرونده_ورودی [پرونده_خروجی]

این برنامه یک پرونده DjVu از پرونده‌های PostScript (.ps)، PostScript فشرده‌شده با GZip (.ps.gz)، Encapsulated PostScript (.eps)، یا Portable Document Format (.pdf) با نام پرونده_ورودی می‌سازد.

نام پرونده خروجی یا توسط آرگومان پرونده_خروجی مشخص می‌شود یا با جایگزینی پسوندهای پرونده ورودی با پسوند DjVu (.djvu) تولید می‌گردد.

این برنامه به یک درایور خاص GhostScript وابسته است. اگر برنامه GhostScript شما این درایور را ارائه نمی‌دهد، لطفاً http://djvu.sourceforge.net/gsdjvu.html را بررسی کنید.

نمایش پیام‌های اطلاعاتی بیشتر در هنگام تبدیل پرونده.
عدم نمایش پیام‌های اطلاعاتی در هنگام تبدیل پرونده.
تعیین وضوح (تفکیک‌پذیری) مورد نظر به وضوح نقطه در اینچ (dpi). مقدار پیش‌فرض ۳۰۰ نقطه در اینچ است.
چرخش پرونده PostScript به میزان زاویه درجه در جهت عقربه‌های ساعت. فقط مقادیر 0، 90، 180 و 270 پشتیبانی می‌شوند. این گزینه فقط برای پرونده‌های PostScript اعمال می‌شود. پرونده‌های PDF همیشه بر اساس جهت‌گیری اصلی خود تبدیل می‌شوند.
تعیین نحوه مدیریت پرونده‌های Encapsulated PostScript. آرگومان آرایش می‌تواند مقادیر crop، fit و ignore را بپذیرد. آرایش پیش‌فرض crop یک پرونده DjVu می‌سازد که اندازه آن با کادر مرزی (bounding box) پرونده Encapsulated PostScript مطابقت دارد. مقدار fit ابعاد گرافیک را به اندازه پیش‌فرض صفحه تغییر مقیاس می‌دهد. مقدار ignore تمام کدهای مختص Encapsulated PostScript را غیرفعال می‌کند. این گزینه به Ghostscript نسخه ۷.۰۷ یا بالاتر نیاز دارد.
رندرینگ دقیق‌تر رنگ‌ها را فعال می‌کند. این گزینه به GhostScript نسخه ۶.۵۲ یا بالاتر نیاز دارد.
تعیین حد آستانه برای کد جداسازی پیش‌زمینه/پس‌زمینه. مقادیر قابل قبول برای آستانه از ۰ تا ۱۰۰ متغیر است. مقادیر بزرگتر اطلاعات بیشتری را در لایه پیش‌زمینه قرار می‌دهند. مقدار آستانه پیش‌فرض ۸۰ است.
تعیین نسبت زیرنمونه‌برداری پس‌زمینه. آرگومان نمونه‌برداری باید یک عدد صحیح بین ۱ و ۶ باشد. مقدار پیش‌فرض ۳ است.
تعیین کیفیت کدگذاری لایه پس‌زمینه. نحو این آرگومان مشابه موارد شرح داده شده برای گزینه -slice در دستور c44 است. مقدار پیش‌فرض 72+11+10+10 می‌باشد.
تعیین حداکثر تعداد رنگ‌های مجزا در لایه پیش‌زمینه. آرگومان تعداد_رنگ‌ها می‌تواند مقادیر صحیح بین ۱ تا ۴۰۰۰ را بپذیرد. مقدار پیش‌فرض ۲۵۶ است.
تعیین حداکثر تعداد رنگ‌های مجزا در یک تصویر جهت در نظر گرفتن آن برای کدگذاری در لایه پیش‌زمینه. آرگومان تعداد_رنگ‌ها می‌تواند مقادیر صحیح بین ۱ تا ۴۰۰۰ را بپذیرد. مقدار پیش‌فرض ۲۵۶ است.
استخراج متن از کد PostScript و گنجاندن این اطلاعات در پرونده DjVu. این گزینه مکان دقیق هر کلمه را ثبت می‌کند.
استخراج متن از کد PostScript و گنجاندن این اطلاعات در پرونده DjVu. این گزینه با ثبت مکان هر سطر، چند بایت در فضا صرفه‌جویی می‌کند.
درج آرگومان‌های اضافی در خط فرمان GhostScript.
درج آرگومان‌های اضافی در خط فرمان برنامه csepdjvu یا msepdjvu.
این گزینه موجب می‌شود djvudigital اطلاعات تکمیلی را با استفاده از ابزار pdftotext (همراه کتابخانه Poppler) از پرونده‌های PDF استخراج کند. اطلاعات انتخاب‌شده در مرحله پس‌پردازش به پرونده DjVu اضافه می‌شوند. این گزینه در صورتی که پرونده ورودی PDF نباشد نادیده گرفته می‌شود. آرگومان کلیدواژه‌ها فهرستی از کلیدواژه‌ها است که با کاما از هم جدا شده‌اند. هنگامی که این فهرست حاوی کلیدواژه meta باشد، متادیتای استخراج‌شده توسط pdftotext در پرونده DjVu درج می‌شود. هنگامی که این فهرست حاوی کلیدواژه text باشد، اطلاعات متنی استخراج‌شده توسط pdftotext در پرونده DjVu درج می‌گردد، که ممکن است جایگزین اطلاعات جمع‌آوری‌شده با گزینه‌های --words یا --lines شود. این ویژگی مثلاً هنگامی کاربرد دارد که یک پرونده PDF اسکن‌شده دارای لایه متنی مخفی باشد که توسط Ghostscript شناسایی نشده و در نتیجه به بک‌اند djvudigital ارسال نگردیده است.
تولید یک پرونده داده تفکیک‌شده به جای پرونده DjVu. برنامه csepdjvu می‌تواند این پرونده داده تفکیک‌شده را به یک پرونده DjVu تبدیل کند.
نمایش نام‌های دو برنامه کمکی یافت‌شده توسط djvudigital، یعنی یک مفسر مناسب Ghostscript و یک انکودر بک‌اند مناسب. برای جزئیات بیشتر به دو بخش بعدی مراجعه کنید.
صرفاً خط فرمان Ghostscript تولید شده توسط djvudigital را بدون اجرای آن نمایش می‌دهد. هیچ پرونده خروجی تولید نمی‌شود.
نمایش صفحه راهنمای djvudigital.

برنامه djvudigital به طور داخلی به درایور خاصی از Ghostscript به نام djvusep متکی است. این درایور ساختار منطقی توالی دستورات رندرینگ PostScript را تحلیل کرده و تصمیم می‌گیرد که هر دستور در لایه پیش‌زمینه یا پس‌زمینه اجرا شود. درایور GhostScript یک پرونده داده تفکیک‌شده تولید می‌کند که سپس با استفاده از برنامه csepdjvu از مجموعه‌ی DjVuLibre فشرده می‌شود.

پیش از پردازش پرونده ورودی، برنامه djvudigital به دنبال یک فایل اجرایی Ghostscript می‌گردد که درایور djvusep را ارائه دهد. این جستجو با پرونده مشخص‌شده در متغیر محیطی GSDJVU آغاز می‌شود و با فایل‌های اجرایی خط فرمان با نام‌های gs و gsdjvu ادامه می‌یابد.

کد منبع DjVuLibre حاوی دستورالعمل‌هایی برای کامپایل چنین فایل اجرایی GhostScript است. اطلاعات بیشتر را می‌توان از http://djvu.sourceforge.net/gsdjvu.html به دست آورد.

خروجی درایور djvusep در GhostScript باید توسط برنامه csepdjvu از مجموعه‌ی DjVuLibre پردازش شود. این برنامه همچنین می‌تواند با برنامه اختصاصی Lizardtech به نام msepdjvu جایگزین گردد. پیش از پردازش پرونده ورودی، برنامه djvudigital به دنبال چنین فایل اجرایی می‌گردد. این جستجو با پرونده مشخص‌شده در متغیر محیطی CSEPDJVU آغاز شده و با فایل‌های اجرایی خط فرمان با نام‌های msepdjvu و csepdjvu ادامه می‌یابد.

گزینه --poppler=کلیدواژه‌ها به ابزار pdftotext همراه کتابخانه Poppler و ابزار djvused همراه djvulibre متکی است. فقط نسخه‌های جدید pdftotext که گزینه -bbox را می‌پذیرند پشتیبانی می‌شوند. هر دو ابزار ابتدا با بررسی پرونده‌های مشخص‌شده در متغیرهای محیطی PDFTOTEXT و DJVUSED جستجو می‌شوند، و سپس در میان فایل‌های اجرایی با نام‌های pdftotext یا djvused موجود در مسیر اجرایی شل (PATH) جستجو می‌گردند.

نخستین نسخه این مبدل توسط Léon Bottou <leonb@users.sourceforge.net> در آزمایشگاه‌های AT&T نوشته شد. نسخه DjVuLibre از کدی برگرفته شده که با سخاوتمندی توسط Lizardtech در ژانویه ۲۰۰۴ منتشر گردید.

برنامه djvudigital تنها می‌تواند پرونده‌های ورودی را پردازش کند که GhostScript قادر به پردازش صحیح آن‌ها باشد.

djvu(1), csepdjvu(1), c44(1), gs(1), gzip(1)

1/31/2004 DjVuLibre-3.5