Provided by: minidjvu_0.8.svn.2010.01.15-1_i386 bug

NAME

       minidjvu - кодирование и расшифровка монохромных DJVU-страниц

ОБЗОР

       minidjvu  [options] input_file output_file

       Предусмотрен также подобный синтаксис для многостраничного сжатия:

       minidjvu  [options] input_files output_file

       См.  ниже  раздел МНОГОСТРАНИЧНОЕ КОДИРОВАНИЕ где об этом сказано более
       подробно.

ОПИСАНИЕ

       minidjvu может кодировать и расшифровывать  одностраничные  монохромные
       файлы DjVu.

       Программа  minidjvu  основана  на  коде  DjVuLibre, базовой библиотеки,
       обеспечивающей поддержку формата DjVu.

       Кроме монохромных файлов DjVu, minidjvu распознает форматы Windows BMP,
       PBM  и  TIFF  (с  помощью  библиотеки  libtiff).   Как  , так и
        файлы могут иметь формат BMP, PBM, TIFF или DjVu. Формат
       файла  определяется  по его расширению. Исходный и результирующий файлы
       могут совпадать.

       Если  задано  преобразование  из  DjVu   в   DjVu,   minidjvu   сначала
       расшифровывает, а затем вновь кодирует изображение. При этом содержимое
       файла DjVu, за исключением текстового слоя, теряется.

       Преобразование одного битового изображения в другое также допустимо, но
       имеет некоторый смысл только при указании параметра --smooth.

       Все  параметры могут предваряться как одним, так и двумя дефисами.  Это
       сделано для того, чтобы сделать интерфейс MiniDjvu  более  удобным  для
       пользователей DjVuLibre.

МНОГОСТРАНИЧНОЕ КОДИРОВАНИЕ

       Чтобы  активизировать  многостраничный режим, нужно указать в командной
       строке minidjvu либо несколько файлов, подлежащих обработке, либо  один
       многостраничный  документ  tiff.  По  умолчанию (если не задан параметр
       --indirect ) сжатые страницы  помещаются  в  составной  многостраничный
       документ под тем именем, которое было указано в командной строке.

       Некоторые  из  параметров  minidjvu  (  --pages-per-dict,  --indirect и
       --report ) предназначены специально для  контроля  работы  программы  в
       многостраничном режиме.

ПАРАМЕТРЫ

       -A

       --Averaging
              Вычислять   усредненные  варианты  представления  символов,  для
              которых обнаружено соответствию образцу.

       -a n

       --aggression n
              Задает уровень "агрессии" для сопоставления образцов.  Чем  выше
              агрессия,  тем  меньше размер файла и выше вероятность ошибочных
              подстановок. По умолчанию используется значение 100. Обычно  его
              можно  с  большей или меньшей уверенностью увеличить примерно до
              110. Скорее всего, даже 200 даст вполне подходящий результат, но
              на это не стоит полагаться.

              Фактический  уровень  сжатия  при выборе того или иного значения
              этого параметра может изменяться от  версии  к  версии.  Тем  не
              менее, значение 100 всегда будет использоваться по умолчанию.

              Данный параметр автоматически активирует параметр --match.

       -c

       --clean
              Удалять   небольшие   черные   пятна,   которые,  скорее  всего,
              представляют   собой   шум.    Этот   алгоритм   может   оказать
              разрушительное  действие  на  полутоновые  картинки, поэтому его
              следует применять с осторожностью.

              Данный параметр активируется при указании --lossy.

       -d n

       --dpi n
              Указать разрешение изображения  в  точках  на  дюйм.  Разрешение
              оказывает  влияние  на работу некоторых алгоритмов, а при записи
              файлов DjVu и BMP (поддержка формата TIFF должна быть  добавлена
              в будущем) сохраняется в них.

       -e

       --erosion
              Пожертвовать  качеством  изображения  для  того,  чтобы выиграть
              5-10% объема файла.   Одиночное  применение  эрозии  практически
              незаметно,  но  10  таких  случаев  в  одной строке могут сильно
              испортить изображение, причем, к сожалению,  это  всё  равно  не
              даст  слишком  большого  выигрыша  в  размере.  Бонус  за эрозию
              начисляется при сопоставлении образцов.

              Использование эрозии не имеет смысла, если вывод  осуществляется
              не в формат DjVu.

              Данный параметр активируется при указании --lossy.

       -i

       --indirect

              Этот параметр может использоваться в многостраничном режиме: его
              указание заставляет minidjvu создавать на выходе  документ  DjVu
              indirect.    Такие   документы   состоят  из  индексного  файла,
              некоторого количества одностраничных документов  (по  одному  на
              каждое   изображение,  указанное  на  входе),  а  также  файлов,
              содержащих   разделяемые   словари.   Обратите   внимание,   что
              индексному файлу присваивается имя, указанное в командной строке
              для результирующего документа, в то время как отдельные страницы
              сохраняются   под   именами   исходных   изображений  с  заменой
              расширения на djvu.

              Данный режим может быть полезен для больших документов,  которые
              планируется  разместить на Web-сервере, а также если планируется
              последующая  обработка  созданных  файлов  (например,  с   целью
              добавления  фоновых  изображений).  В последнем случае вы можете
              затем воспользоваться утилитой djvmcvt  из  поставки  DjVuLibre,
              чтобы сконвертировать документ в формат DjVu bundled.

       -l

       --lossy
              Активировать все параметры, отвечающие за сжатие с потерями. Это
              равнозначно  указанию  --Averaging  --clean  --erosion   --match
              --smooth.

       -m

       --match
              Запустить  сопоставление  образцов. Это основной метод, служащий
              для уменьшения размера файла, но он может привести  к  проблемам
              из-за  ошибок  подстановки.  Используйте  параметр --aggression,
              чтобы  регулировать   соотношение   между   размером   файла   и
              возможностью возникновения ошибок.

              Данный   параметр   активируется   при   указании   --lossy  или
              --aggression.

       -n

       --no-prototypes
              Отключить  поиск  прототипов.  Это  позволяет  ускорить  процесс
              сжатия без потерь, но значительно увеличивает размер создаваемых
              файлов.

       -p

       --pages-per-dict
              Указывает, сколько  страниц  следует  сжимать  за  один  проход.
              Значение  по  умолчанию  -  10. При указании значения 0 ( -p 0 )
              minidjvu  попытается  обработать  все  страницы  сразу,   однако
              следует иметь в виду, что такая операция может потребовать очень
              много памяти, особенно на больших по объему книгах.

       -r

       --report
              Выводить подробные сообщения о ходе обработки каждой страницы  в
              многостраничном  режиме.  Это  полезно  только  для  того, чтобы
              скрасить долгое ожидание в процессе сжатия книги.

       -s

       --smooth
              Отключить  некоторые  пиксели,  которые,  по  всей  вероятности,
              представляют  собой шум. Это позволяет выиграть около 5% размера
              файла.  Внешний  вид  изображения  слегка  улучшается,  но   это
              малозаметно.

              В  текущей  версии  алгоритм  обработки  является  примитивным и
              удаляет только те черные пиксели, которые окружены белыми с трех
              или  четырех сторон.  Эффект, скорее всего, окажется незаметным.

              Данный параметр активируется при указании --lossy.

       -v

       --verbose
              Выводить сообщения о разных стадиях обработки. Они  не  особенно
              полезны, но не лишены некоторого интереса.

       -X  ext

       --Xtension  ext
              Задает  расширение,  которое  minidjvu  будет  использовать  для
              файлов,  содержащих   разделяемые   словари   (начальную   точку
              указывать не нужно).  Значение по умолчанию "iff".

       -w

       --warnings
              Не  подавлять  предупреждения  библиотеки  libtiff. По умолчанию
              такое  подавление  включено.  Дело  в  том,  что   под   Windows
              стандартный  обработчик  предупреждений  TIFF  выводит их в виде
              диалогового окна с сообщением,  что,  конечно,  неприемлемо  при
              обработке в пакетном режиме.

ОШИБКИ

       Многостраничное  кодирование  работает неправильно, если страницы имеют
       разные разрешения.