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
              выводит их в виде диалогового окна с  сообщением,  что,  конечно,  неприемлемо  при
              обработке в пакетном режиме.

ОШИБКИ

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