.\" t .\" .\" 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 DJVUMAKE 1 "10/11/2001" "DjVuLibre-3.5" "DjVuLibre-3.5" .de SS .SH \\0\\0\\0\\$* .. .SH "نام (NAME)" djvumake \- سرهم‌بندی فایل‌های تصویری DjVu .SH "خلاصه دستور (SYNOPSIS)" .BI "djvumake " "djvufile" " [" "chkid" "=" "argument" "]..." .SH "توضیحات (DESCRIPTION)" برنامهٔ .B djvumake یک فایل تک‌صفحه‌ای DjVu با نام .I djvufile را با کپی کردن یا ایجاد تکه‌ها (chunks) بر اساس آرگومان‌های ارائه‌شده سرهم‌بندی می‌کند. آرگومان‌های پشتیبانی‌شده به شرح زیر هستند: .TP .BI INFO= w , h , dpi ایجاد تکهٔ اطلاعات اولیه. آرگومان‌های .IR w "، " h و .IR dpi عرض، ارتفاع و وضوح (تفکیک‌پذیری) تصویر را توصیف می‌کنند. همهٔ آرگومان‌ها می‌توانند حذف شوند. وضوح پیش‌فرض 300 dpi است. عرض و ارتفاع پیش‌فرض از اولین تکهٔ ماسک مشخص‌شده در گزینه‌های خط فرمان دریافت خواهد شد. .TP .BI Sjbz= jb2file ایجاد یک تکهٔ ماسک پیش‌زمینهٔ .SM JB2 . فایل .I jb2file می‌تواند حاوی داده‌های خام JB2 یا یک فایل DjVu شامل داده‌های JB2 باشد، مانند مواردی که توسط برنامهٔ .BR cjb2 تولید می‌شوند. .TP .BI Smmr= mmrfile ایجاد یک تکهٔ ماسک پیش‌زمینهٔ .SM MMR/G4 . فایل .I mmrfile می‌تواند حاوی داده‌های خام MMR یا یک فایل DjVu شامل داده‌های MMR باشد. .TP .BI BG44= iw44file "[:" n "]" ایجاد یک یا چند تکهٔ پس‌زمینهٔ .SM IW44 . فایل .I iw44file باید حاوی داده‌های .SM IW44 باشد. چنین فایل‌هایی را می‌توان با فشرده‌سازی تصویر پس‌زمینه توسط برنامهٔ .B c44 و استخراج داده‌های خام .SM IW44 با استفاده از برنامهٔ .BR djvuextract به دست آورد. آرگومان اختیاری .I n تعداد تکه‌هایی که باید از فایل IW44 کپی شوند را مشخص می‌کند. حذف کردن تعداد تکه‌ها موجب کپی شدن تمام تکه‌های موجود می‌شود. .TP .BI BGjp= jpegfile ایجاد یک تکهٔ پس‌زمینه با کدگذاری .SM JPEG . فایل .I jpegfile باید حاوی داده‌های کدگذاری‌شدهٔ .SM JPEG باشد. .TP .BI BG2k= jpegfile ایجاد یک تکهٔ پس‌زمینهٔ .SM JPEG-2000 . فایل .I jpegfile باید حاوی داده‌های کدگذاری‌شدهٔ .SM JPEG-2000 باشد. رمزگشای DjVu هنوز فایل‌های حاوی داده‌های JPEG-2000 را نمایش نمی‌دهد. .TP .BI FGbz=( filename |{# color [: x , y , w , h ]}) ایجاد یک تکهٔ رنگ پیش‌زمینه که یک رنگ یکدست را برای هر علامت کدگذاری‌شدهٔ .SM JB2 توصیف می‌کند. این آرگومان می‌تواند نام .I filename فایلی حاوی داده‌های خام باشد. بهترین روش برای ایجاد چنین فایل‌هایی استفاده از برنامهٔ .BR djvuextract (1) است. در غیر این صورت، این آرگومان می‌تواند توالی‌ای از ناحیه‌های رنگی را توصیف کند. هر ناحیهٔ رنگی یک نام رنگ .IR color و به صورت اختیاری مختصات .IR x , y , w , h یک مستطیل را مشخص می‌کند. هر علامت رنگِ آخرین ناحیهٔ رنگی را دریافت می‌کند که مستطیل آن با جعبهٔ محاطی (bounding box) علامت تلاقی داشته باشد. اگر جعبهٔ محاطی علامت با هیچ‌یک از ناحیه‌ها تلاقی نداشته باشد، علامت به رنگ سیاه ترسیم می‌شود. مختصات مستطیل بر حسب پیکسل و با مبدأ در گوشهٔ پایین سمت چپ صفحه بیان می‌شوند. در صورتی که هیچ مختصات مستطیلی مشخص نشود، کل صفحه در نظر گرفته می‌شود. نام‌های رنگ را می‌توان دقیقاً با شش رقم هگزادسیمال مشخص کرد، مانند .BR FGbz=#FF8080 ، یا با یکی از شانزده نام رنگ HTML زیر که توسط W3C تعریف شده‌اند، مانند .BR FGbz=#red . .br .TS center,box; lfB lfB lfB lfB lfB lfB lfB lfB lfB lfB lfB lfB lfB lfB lfB lfB . aqua black blue fuchsia gray green lime maroon navy olive purple red silver teal white yellow .TE .TP .BI FG44= iw44file ایجاد یک تکهٔ رنگ پیش‌زمینهٔ .SM IW44 . فایل .I iw44file باید حاوی داده‌های .SM IW44 باشد. چنین فایل‌هایی را می‌توان با فشرده‌سازی تصویر پس‌زمینه توسط دستور .B c44 و استخراج داده‌های خام .SM IW44 با استفاده از برنامهٔ .BR djvuextract به دست آورد. تنها اولین تکه کپی می‌شود. .TP .BI FGjp= jpegfile ایجاد یک تکهٔ رنگ پیش‌زمینهٔ .SM JPEG . .TP .BI FG2k= jpegfile ایجاد یک تکهٔ رنگ پیش‌زمینهٔ .SM JPEG-2000 . رمزگشای DjVu هنوز فایل‌های حاوی داده‌های JPEG-2000 را نمایش نمی‌دهد. .TP .BI INCL= fileid ایجاد یک تکهٔ گنجاندن (include chunk) در DjVu3 که به فایل مؤلفه‌ای به نام .IR fileid اشاره می‌کند. فایل حاصل سپس باید با استفاده از دستور .BR djvm در یک سند چندصفحه‌ای گنجانده شود. .TP .BI Djbz= jb2file ایجاد یک واژه‌نامهٔ شکل در قالب .SM JB2 . فایل .I jb2file باید حاوی داده‌های خام JB2 باشد که یک واژه‌نامهٔ JB2 را توصیف می‌کنند. .TP .BI PPM= ppmfile ایجاد یک تکهٔ پس‌زمینهٔ .SM IW44 و یک تکهٔ رنگ پیش‌زمینهٔ .SM IW44 با اعمال ماسک و زیرنمونه‌گیری (subsampling) از فایل .SM PPM با نام .IR ppmfile . برای نمونه، فرض کنید یک تصویر .SM PPM به نام .B myimage.ppm و یک تصویر دوسطحی (bitonal) در قالب .SM PBM با همان ابعاد به نام .B mymask.pbm داریم که پیکسل‌های سیاه آن نشان‌دهندهٔ پیکسل‌های متعلق به پیش‌زمینه هستند. چنین فایل دوسطحی‌ای ممکن است با آستانه‌گذاری یا کلیدگذاری رنگی تصویر .SM PPM به دست آمده باشد. سپس می‌توانیم با استفاده از دو دستور زیر، یک تصویر DjVuDocument تولید کنیم: .IP "" 3 .B cjb2 mymask.pbm mymask.djvu .br .B djvumake my.djvu Sjbz=mymask.djvu PPM=myimage.ppm .br .br .PP مستندات مشخصات DjVu در دایرکتوری .B doc از توزیع DjVuLibre، اطلاعات موثق و رسمی را دربارهٔ ساختار یک فایل تصویری معتبر DjVu ارائه می‌دهند. .SH "نویسندگان (AUTHORS)" این برنامه توسط L\('eon Bottou نوشته شده است و سپس توسط Andrei Erofeev ، Bill Riemers و بسیاری افراد دیگر بهبود یافته است. .SH "همچنین ببینید (SEE ALSO)" .BR djvu (1), .BR djvuextract (1), .BR cjb2 (1), .BR c44 (1)