.\" 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 CSEPDJVU 1 "10/11/2001" "DjVuLibre-3.5" "DjVuLibre-3.5" .SH "نام (NAME)" csepdjvu \- رمزگذار DjVu برای پرونده‌های داده تفکیک‌شده .SH "خلاصه دستور (SYNOPSIS)" .BI "csepdjvu [" "options" "] [" "sepfiles" "]... " "outputdjvufile" .SH "توضیحات (DESCRIPTION)" این برنامه یک پرونده DjVuDocument به نام .I outputdjvufile را از پرونده‌های داده تفکیک‌شده .IR sepfiles تولید می‌کند. چنانچه به جای نام پرونده‌های داده تفکیک‌شده یک خط تیره منفرد داده شود، برنامه می‌تواند داده‌های تفکیک‌شده را از ورودی استاندارد بخواند. این قابلیت برای برنامه‌های پیش‌پردازشی در نظر گرفته شده است که داده‌های تفکیک‌شده را از طریق لوله (pipe) به .B csepdjvu ارسال می‌کنند. .PP هر پرونده داده تفکیک‌شده نمایانگر یک یا چند تصویر صفحه است. هنگامی که آرگومان‌های برنامه چندین صفحه را مشخص کنند، تمامی صفحات رمزگذاری شده و به عنوان یک سند چندصفحه‌ای یکپارچه ذخیره می‌شوند. زمانی که آرگومان‌های برنامه تنها یک صفحه را مشخص کنند، آن صفحه رمزگذاری شده و به عنوان یک پرونده تک‌صفحه‌ای ذخیره می‌شود. .SH "گزینه‌ها (OPTIONS)" .TP .BI "-d " "n" اطلاعات وضوح رمزگذاری‌شده در پرونده خروجی را بر حسب نقطه در اینچ (dpi) مشخص می‌کند. اطلاعات وضوح موجود در پرونده‌های DjVu تعیین می‌کند که رمزگشا چگونه تصویر را در یک نمایشگر خاص مقیاس‌بندی کند. وضوح‌های معنادار در بازه ۲۵ تا ۶۰۰۰ قرار دارند. مقدار پیش‌فرض ۳۰۰ نقطه در اینچ است. .TP .BI "-q " "n" ",...," "n" .TP .BI "-q " "n" "+...+" "n" کیفیت رمزگذاری لایه پس‌زمینه رمزگذاری‌شده با IW44 را مشخص می‌کند. آرگومان گزینه شامل چندین عدد صحیح (یک عدد برای هر تکه) است که با کاما یا علامت بعلاوه از یکدیگر جدا می‌شوند. این گزینه مشابه گزینه .B \-slice در برنامه .B c44 است. لطفاً برای جزئیات بیشتر به صفحه راهنمای .BR c44 (1) مراجعه کنید. مشخصات کیفیت پیش‌فرض برابر با .BR "\-q 72,83,93,103" است. .PP این گزینه برای پس‌زمینه‌های یکدست سفیدی که در داده‌های تفکیک‌شده مشخص نشده‌اند اما بر اساس مشخصات فنی DjVu الزامی هستند اعمال نمی‌شود. چنین تصاویر پس‌زمینه‌ای همواره با کمترین وضوح ممکن و با تنظیمات کیفیت استانداردی تولید می‌شوند که یکنواختی رنگ را تضمین می‌کند. .TP .B "\-t" برنامه .B csepdjvu برخی از توضیحات موجود در پرونده تفکیک‌شده را برای ایجاد یک لایه متنی پنهان در پرونده DjVu تفسیر می‌کند. این لایه موقعیت هر کلمه را برای اهداف برجسته‌سازی (highlighting) ثبت می‌نماید. این گزینه حجم پرونده را با ثبت صرفِ موقعیت هر خط به جای تک‌تک کلمات کاهش می‌دهد. .TP .B "\-v" نمایش پیامی کوتاه در توصیف هر صفحه. .TP .B "\-vv" نمایش پیام‌های اطلاعاتی جامع در طول فرآیند رمزگذاری. .SH "قالب پرونده داده تفکیک‌شده (SEPARATED DATA FILE FORMAT)" هر پرونده داده تفکیک‌شده شامل الحاق یک یا چند تصویر صفحه تفکیک‌شده است. هر صفحه به صورت منطقی توسط یک تصویر پیش‌زمینه با یک رنگ شفاف و یک تصویر پس‌زمینه که از میان پیکسل‌های شفاف قابل مشاهده است، نشان داده می‌شود. داده‌های مربوط به هر تصویر صفحه تفکیک‌شده، از الحاق بلوک‌های داده زیر تشکیل شده است: .IP "*" 3 یک تصویر پیش‌زمینه که با استفاده از «قالب RLE رنگی» یا «قالب RLE دورنگ (Bitonal)» رمزگذاری شده است. این قالب‌ها در ادامه این بخش توضیح داده شده‌اند. .IP "*" 3 یک تصویر پس‌زمینه اختیاری که به عنوان «پیکسمپ قابل حمل» ( .SM PPM ) رمزگذاری شده است. این قالب شناخته‌شده در ادامه این بخش به طور خلاصه شرح داده شده است. نبود تصویر پس‌زمینه صرفاً نشان می‌دهد که باید یک پس‌زمینه یکدست سفید در نظر گرفته شود. .IP "*" 3 تعداد دلخواهی از خطوط توضیحات که با نویسه «#» آغاز شده و با یک نویسه خط جدید (linefeed) پایان می‌یابند. خطوط توضیحی که اولین کلمه آن‌ها با یک حرف بزرگ لاتین آغاز می‌شود، معانی ویژه‌ای دارند که در ادامه این سند تشریح شده است. .PP ابعاد (عرض و ارتفاع) تصویر پس‌زمینه باید از طریق گرد کردنِ رو به بالایِ حاصل‌تقسیم ابعاد تصویر پیش‌زمینه بر یک ضریب کاهش صحیح در بازه ۱ تا ۱۲ به دست آید. برای نمونه، فرض کنید که عرض تصویر پیش‌زمینه ۲۵۰۷ و ضریب کاهش ۳ باشد. عرض تصویر پس‌زمینه برابر با نسبت صحیح (2507+2)/3 خواهد بود. .SS "قالب RLE رنگی (Color RLE format)" قالب RLE رنگی یک طرح فشرده‌سازی ساده مبتنی بر کدگذاری طول اجرا (Run-Length Encoding) برای تصاویر رنگی با تعداد محدودی رنگ متمایز است. داده‌ها همواره با یک سربرگ متنی آغاز می‌شوند که متشکل از دو نویسه «R6»، تعداد ستون‌ها، تعداد سطرها و تعداد مدخل‌های پالت رنگ است. تمامی اعداد به صورت ده‌دهی .SM ASCII بیان می‌شوند. این چهار مورد توسط نویسه‌های خالی (فاصله، تب، بازگشت به ابتدای سطر، یا خط جدید) یا خطوط توضیحی که با نویسه «#» مشخص شده‌اند، از یکدیگر جدا می‌شوند. پس از آخرین عدد، دقیقاً یک نویسه قرار می‌گیرد که معمولاً یک نویسه خط جدید است. .PP پس از سربرگ، پالت رنگ قرار دارد که برای هر مدخل رنگ شامل سه بایت است. این بایت‌ها نشان‌دهنده مولفه‌های قرمز، سبز و آبی رنگ هستند. .PP پس از پالت، مجموعه‌ای از اعداد صحیح چهار بایتی (ابتدا باارزش‌ترین بیت) قرار دارد که دنباله‌های پیکسلی با رنگ یکسان را نشان می‌دهند. دوازده بیت بالایی این عدد صحیح، نمایه رنگ دنباله را در مدخل پالت مشخص می‌کند. بیست بیت پایینی عدد صحیح، طول دنباله را تعیین می‌کند. نمایه‌های رنگ بزرگ‌تر از 0xff0 رزرو شده‌اند. نمایه رنگ 0xfff برای دنباله‌های شفاف به کار می‌رود. هر سطر با دنباله‌ای از طول‌های اجرا نشان داده می‌شود که مجموع طول‌های آن‌ها برابر با عرض تصویر است. سطرها با شروع از بالاترین سطر و پیشروی به سمت پایین‌ترین سطر رمزگذاری می‌شوند. .SS "قالب RLE دورنگ (Bitonal RLE format)" قالب RLE دورنگ (Bitonal) یک طرح ساده کدگذاری طول اجرا برای تصاویر تک‌رنگ یا دورنگ است. داده‌ها همواره با یک سربرگ متنی آغاز می‌شوند که متشکل از دو نویسه «R4»، تعداد ستون‌ها و تعداد سطرها است. تمامی اعداد به صورت ده‌دهی .SM ASCII بیان می‌شوند. این سه مورد با نویسه‌های خالی (فاصله، تب، بازگشت به ابتدای سطر، یا خط جدید) یا خطوط توضیحی که با نویسه «#» معرفی شده‌اند، از یکدیگر جدا می‌شوند. پس از آخرین عدد دقیقاً یک نویسه قرار می‌گیرد که معمولاً یک نویسه خط جدید است. .PP باقی‌مانده پرونده، دنباله‌ای از اعداد را رمزگذاری می‌کند که نشان‌دهنده طول دنباله‌های متناوب از پیکسل‌های شفاف و سیاه هستند. خطوط با شروع از بالاترین خط و پیشروی به سمت پایین‌ترین خط رمزگذاری می‌شوند. هر خط با یک دنباله سفید آغاز می‌شود. رمزگشا زمانی متوجه پایان یک خط می‌شود که مجموع طول دنباله‌ها برای آن خط برابر با تعداد ستون‌های تصویر باشد. اعداد در بازه ۰ تا ۱۹۱ با یک بایت تکی در بازه 0x00 تا 0xbf نشان داده می‌شوند. اعداد در بازه ۱۹۲ تا ۱۶۳۸۳ با یک توالی دو بایتی نشان داده می‌شوند: بایت اول، در بازه 0xc0 تا 0xff، شش بیت باارزش‌تر عدد را رمزگذاری می‌کند و بایت دوم، هشت بیت باقی‌مانده عدد را رمزگذاری می‌نماید. این طرح امکان دنباله‌هایی با طول صفر را فراهم می‌کند؛ امری که زمانی مفید است که یک خط با یک پیکسل سیاه آغاز شود یا هنگامی که یک دنباله بسیار طولانی (با طولی بیش از ۱۶۳۸۳) باید به دنباله‌های کوچک‌تر تقسیم شود. .SS "قالب پیکسمپ قابل حمل (Portable Pixmap (PPM) format)" قالب Portable Pixmap قالبی شناخته‌شده برای نمایش تصاویر رنگی است. برای اطلاعات کامل به صفحه راهنمای .BR ppm (1) مراجعه فرمایید. .PP داده‌ها همواره با یک سربرگ متنی آغاز می‌شوند که متشکل از دو نویسه «P6»، تعداد ستون‌ها، تعداد سطرها و بیشینه مقدار یک مولفه رنگی (معمولاً ۲۵۵) است. تمامی اعداد به صورت ده‌دهی .SM ASCII بیان می‌شوند. این سه مورد با نویسه‌های خالی (فاصله، تب، بازگشت به ابتدای سطر، یا خط جدید) یا خطوط توضیحی که با نویسه «#» مشخص شده‌اند، از هم جدا می‌شوند. پس از آخرین عدد دقیقاً یک نویسه قرار می‌گیرد که معمولاً یک نویسه خط جدید است. .PP باقی‌مانده پرونده تمام پیکسل‌ها را رمزگذاری می‌کند. هر پیکسل با سه بایت نشان داده می‌شود که بیانگر مولفه‌های قرمز، سبز و آبی آن پیکسل هستند. پیکسل‌ها به ترتیب از چپ به راست و از بالا به پایین چیده شده‌اند. .SS "توضیحات در پرونده‌های تفکیک‌شده (Comments in separated files)" هر صفحه با تعداد دلخواهی از خطوط توضیحات دنبال می‌شود که با نویسه «#» آغاز شده و با نویسه خط جدید (linefeed) پایان می‌یابند. برخی از خطوط توضیحات دارای معانی ویژه‌ای هستند. در ساختارهای زیر، تمامی رشته‌ها با کدگذاری UTF-8 بوده و به سبک رشته‌های پست‌اسکریپت (Postscript) بیان می‌شوند، بدین معنا که درون پرانتز قرار گرفته و از توالی‌های گریز به سبک C که با یک بک‌اسلش مشخص می‌شوند، استفاده می‌کنند. .IP "*" 3 .BI "# T " px ":" py " " dx ":" dy " " w "x" h "+" x "+" y " (" string ")" .br چنین خط توضیحی مشخص می‌کند که قطعه متن .I string باید به ناحیه‌ای با اندازه .IR w "x" h در موقعیت .IR x "," y نسبت به گوشه پایین-چپ صفحه اختصاص یابد. اعداد صحیح .IR px " و " py بیانگر موقعیت نقطه جاری روی خط مبنای متن (baseline) پیش از رسم متن هستند. عملیات رسم سپس نقطه جاری را به اندازه .IR dx " و " dy پیکسل جابه‌جا می‌کند. در صورت وجود چنین توضیحاتی، .BR csepdjvu یک لایه متنی پنهان برای صفحات مربوطه تولید می‌کند. .IP "*" 3 .BI "# L " w "x" h "+" x "+" y " (" url ")" .br چنین خط توضیحی مشخص می‌کند که پیوندی به نشانی اینترنتی .I url باید به ناحیه‌ای به اندازه .IR w "x" h در موقعیت .IR x "," y اختصاص یابد. در صورت وجود چنین توضیحاتی، .BR csepdjvu صفحاتی با یک تکه حاشیه‌نویسی (annotation chunk) حاوی پیوندهای وب مشخص‌شده تولید می‌کند. .IP "*" 3 .BI "# B " count " (" string ") (#" pageno ")" .br چنین خط توضیحی اطلاعات طرح کلی (outline/سرفصل‌ها) را برای سند فراهم می‌کند. یک مدخل طرح کلی با عنوان .I string به صفحه .IR pageno اختصاص می‌یابد. عدد صحیح .I count مشخص می‌کند چه تعداد از مدخل‌های طرح کلیِ بعدی باید به عنوان زیرمدخل به مدخل جاری ضمیمه شوند. هنگامی که چنین توضیحاتی در صفحه نخست وجود داشته باشد، .BR csepdjvu یک تکه ناوبری (navigation chunk) با طرح کلی مشخص‌شده تولید می‌کند. .IP "*" 3 .BI "# P (" string ")" .br چنین خط توضیحی یک عنوان .I string برای صفحه جاری ارائه می‌دهد. .SH "اعتبارات (CREDITS)" این برنامه ابتدا توسط L\('eon Bottou نوشته شد و توسط Bill Riemers و افراد بسیار دیگری بهبود یافت. .SH "همچنین ببینید (SEE ALSO)" .BR djvu (1), .BR ppm (5), .BR c44 (1)