| 1 |
.\" Copyright (c) 2005 Ilya Mezhirov |
| 2 |
.\" Copyright (c) 2009 Alexey Kryukov |
| 3 |
.\" |
| 4 |
.\" This is free documentation; you can redistribute it and/or |
| 5 |
.\" modify it under the terms of the GNU General Public License as |
| 6 |
.\" published by the Free Software Foundation; either version 2 of |
| 7 |
.\" the License, or (at your option) any later version. |
| 8 |
.\" |
| 9 |
.\" The GNU General Public License's references to "object code" |
| 10 |
.\" and "executables" are to be interpreted as the output of any |
| 11 |
.\" document formatting or typesetting system, including |
| 12 |
.\" intermediate and printed output. |
| 13 |
.\" |
| 14 |
.\" This manual is distributed in the hope that it will be useful, |
| 15 |
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 16 |
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 17 |
.\" GNU General Public License for more details. |
| 18 |
.\" |
| 19 |
.\" You should have received a copy of the GNU General Public |
| 20 |
.\" License along with this manual. Otherwise check the web site |
| 21 |
.\" of the Free Software Foundation at http://www.fsf.org. |
| 22 |
.\" |
| 23 |
.TH "MINIDJVU" "1" "July 2009" "minidjvu-0.8" "minidjvu-0.8" |
| 24 |
.SH "NAME" |
| 25 |
minidjvu - кодирование и расшифровка монохромных DJVU-страниц |
| 26 |
|
| 27 |
.SH "ОБЗОР" |
| 28 |
.BI "minidjvu [" "options" "] " "input_file" " " "output_file" |
| 29 |
|
| 30 |
Предусмотрен также подобный синтаксис для многостраничного сжатия: |
| 31 |
|
| 32 |
.BI "minidjvu [" "options" "] " "input_files" " " "output_file" |
| 33 |
|
| 34 |
См. ниже раздел |
| 35 |
.B "МНОГОСТРАНИЧНОЕ КОДИРОВАНИЕ" |
| 36 |
где об этом сказано более подробно. |
| 37 |
|
| 38 |
.SH "ОПИСАНИЕ" |
| 39 |
minidjvu может кодировать и расшифровывать одностраничные монохромные |
| 40 |
файлы DjVu. |
| 41 |
|
| 42 |
Программа minidjvu основана на коде DjVuLibre, базовой библиотеки, |
| 43 |
обеспечивающей поддержку формата DjVu. |
| 44 |
|
| 45 |
Кроме монохромных файлов DjVu, minidjvu распознает форматы Windows BMP, PBM |
| 46 |
и TIFF (с помощью библиотеки libtiff). |
| 47 |
Как |
| 48 |
.I исходный, |
| 49 |
так и |
| 50 |
.I результирующий |
| 51 |
файлы могут иметь формат BMP, PBM, TIFF или DjVu. Формат файла определяется |
| 52 |
по его расширению. Исходный и результирующий файлы могут совпадать. |
| 53 |
|
| 54 |
Если задано преобразование из DjVu в DjVu, minidjvu сначала расшифровывает, |
| 55 |
а затем вновь кодирует изображение. При этом содержимое файла DjVu, за исключением |
| 56 |
текстового слоя, теряется. |
| 57 |
|
| 58 |
Преобразование одного битового изображения в другое также допустимо, но имеет |
| 59 |
некоторый смысл только при указании параметра |
| 60 |
.BR --smooth. |
| 61 |
|
| 62 |
Все параметры могут предваряться как одним, так и двумя дефисами. |
| 63 |
Это сделано для того, чтобы сделать интерфейс MiniDjvu более удобным |
| 64 |
для пользователей DjVuLibre. |
| 65 |
|
| 66 |
.SH "МНОГОСТРАНИЧНОЕ КОДИРОВАНИЕ" |
| 67 |
|
| 68 |
Чтобы активизировать многостраничный режим, нужно указать в командной строке |
| 69 |
minidjvu либо несколько файлов, подлежащих обработке, либо один многостраничный документ |
| 70 |
tiff. По умолчанию (если не задан параметр |
| 71 |
.BR --indirect |
| 72 |
) сжатые страницы помещаются в составной многостраничный документ |
| 73 |
под тем именем, которое было указано в командной строке. |
| 74 |
|
| 75 |
Некоторые из параметров minidjvu ( |
| 76 |
.B --pages-per-dict, |
| 77 |
.B --indirect |
| 78 |
и |
| 79 |
.B --report |
| 80 |
) предназначены специально для контроля работы программы в многостраничном |
| 81 |
режиме. |
| 82 |
|
| 83 |
.SH "ПАРАМЕТРЫ" |
| 84 |
.TP |
| 85 |
.BI "-A " |
| 86 |
.TP |
| 87 |
.BI "--Averaging" |
| 88 |
Вычислять усредненные варианты представления символов, для которых обнаружено |
| 89 |
соответствию образцу. |
| 90 |
|
| 91 |
.TP |
| 92 |
.BI "-a " "n" |
| 93 |
.TP |
| 94 |
.BI "--aggression " "n" |
| 95 |
Задает уровень "агрессии" для сопоставления образцов. Чем выше агрессия, тем |
| 96 |
меньше размер файла и выше вероятность ошибочных подстановок. По умолчанию |
| 97 |
используется значение 100. Обычно его можно с большей или меньшей уверенностью |
| 98 |
увеличить примерно до 110. Скорее всего, даже 200 даст вполне подходящий результат, |
| 99 |
но на это не стоит полагаться. |
| 100 |
|
| 101 |
Фактический уровень сжатия при выборе того или иного значения этого параметра |
| 102 |
может изменяться от версии к версии. Тем не менее, значение 100 всегда будет |
| 103 |
использоваться по умолчанию. |
| 104 |
|
| 105 |
Данный параметр автоматически активирует параметр |
| 106 |
.BR --match. |
| 107 |
|
| 108 |
.TP |
| 109 |
.B "-c" |
| 110 |
.TP |
| 111 |
.B "--clean" |
| 112 |
Удалять небольшие черные пятна, которые, скорее всего, представляют собой шум. |
| 113 |
Этот алгоритм может оказать разрушительное действие на полутоновые картинки, |
| 114 |
поэтому его следует применять с осторожностью. |
| 115 |
|
| 116 |
Данный параметр активируется при указании |
| 117 |
.BR "--lossy". |
| 118 |
|
| 119 |
.TP |
| 120 |
.BI "-d " "n" |
| 121 |
.TP |
| 122 |
.BI "--dpi " "n" |
| 123 |
Указать разрешение изображения в точках на дюйм. Разрешение оказывает |
| 124 |
влияние на работу некоторых алгоритмов, а при записи файлов DjVu |
| 125 |
и BMP (поддержка формата TIFF должна быть добавлена в будущем) сохраняется |
| 126 |
в них. |
| 127 |
|
| 128 |
.TP |
| 129 |
.B "-e" |
| 130 |
.TP |
| 131 |
.B "--erosion" |
| 132 |
Пожертвовать качеством изображения для того, чтобы выиграть 5-10% объема файла. |
| 133 |
Одиночное применение эрозии практически незаметно, но 10 таких случаев в одной |
| 134 |
строке могут сильно испортить изображение, причем, к сожалению, это всё равно |
| 135 |
не даст слишком большого выигрыша в размере. Бонус за эрозию начисляется при |
| 136 |
сопоставлении образцов. |
| 137 |
|
| 138 |
Использование эрозии не имеет смысла, если вывод осуществляется не в формат |
| 139 |
DjVu. |
| 140 |
|
| 141 |
Данный параметр активируется при указании |
| 142 |
.BR "--lossy". |
| 143 |
|
| 144 |
.TP |
| 145 |
.B "-i" |
| 146 |
.TP |
| 147 |
.B "--indirect" |
| 148 |
|
| 149 |
Этот параметр может использоваться в многостраничном режиме: его указание |
| 150 |
заставляет minidjvu создавать на выходе документ |
| 151 |
.I DjVu indirect. |
| 152 |
Такие документы состоят из индексного файла, некоторого количества |
| 153 |
одностраничных документов (по одному на каждое изображение, указанное |
| 154 |
на входе), а также файлов, содержащих разделяемые словари. Обратите |
| 155 |
внимание, что индексному файлу присваивается имя, указанное в командной |
| 156 |
строке для результирующего документа, в то время как отдельные страницы |
| 157 |
сохраняются под именами исходных изображений с заменой расширения на djvu. |
| 158 |
|
| 159 |
Данный режим может быть полезен для больших документов, которые планируется |
| 160 |
разместить на Web-сервере, а также если планируется последующая обработка |
| 161 |
созданных файлов (например, с целью добавления фоновых изображений). |
| 162 |
В последнем случае вы можете затем воспользоваться утилитой |
| 163 |
.B djvmcvt |
| 164 |
из поставки DjVuLibre, чтобы сконвертировать документ в формат |
| 165 |
.I DjVu bundled. |
| 166 |
|
| 167 |
.TP |
| 168 |
.B "-l" |
| 169 |
.TP |
| 170 |
.B "--lossy" |
| 171 |
Активировать все параметры, отвечающие за сжатие с потерями. Это равнозначно |
| 172 |
указанию |
| 173 |
.BR --Averaging |
| 174 |
.BR --clean |
| 175 |
.BR --erosion |
| 176 |
.BR --match |
| 177 |
.BR --smooth. |
| 178 |
|
| 179 |
|
| 180 |
.TP |
| 181 |
.B "-m" |
| 182 |
.TP |
| 183 |
.B "--match" |
| 184 |
Запустить сопоставление образцов. Это основной метод, служащий для |
| 185 |
уменьшения размера файла, но он может привести к проблемам из-за |
| 186 |
ошибок подстановки. Используйте параметр |
| 187 |
.BR --aggression, |
| 188 |
чтобы регулировать соотношение между размером файла и возможностью |
| 189 |
возникновения ошибок. |
| 190 |
|
| 191 |
Данный параметр активируется при указании |
| 192 |
.BR "--lossy" |
| 193 |
или |
| 194 |
.BR "--aggression". |
| 195 |
|
| 196 |
.TP |
| 197 |
.B "-n" |
| 198 |
.TP |
| 199 |
.B "--no-prototypes" |
| 200 |
Отключить поиск прототипов. Это позволяет ускорить процесс сжатия без |
| 201 |
потерь, но значительно увеличивает размер создаваемых файлов. |
| 202 |
|
| 203 |
.TP |
| 204 |
.B "-p" |
| 205 |
.TP |
| 206 |
.B "--pages-per-dict" |
| 207 |
Указывает, сколько страниц следует сжимать за один проход. Значение по |
| 208 |
умолчанию - 10. При указании значения 0 ( |
| 209 |
.BR "-p 0" |
| 210 |
) minidjvu попытается обработать все страницы сразу, однако следует иметь |
| 211 |
в виду, что такая операция может потребовать очень много памяти, особенно |
| 212 |
на больших по объему книгах. |
| 213 |
|
| 214 |
.TP |
| 215 |
.B "-r" |
| 216 |
.TP |
| 217 |
.B "--report" |
| 218 |
Выводить подробные сообщения о ходе обработки каждой страницы в многостраничном |
| 219 |
режиме. Это полезно только для того, чтобы скрасить долгое ожидание в процессе |
| 220 |
сжатия книги. |
| 221 |
|
| 222 |
|
| 223 |
.TP |
| 224 |
.B "-s" |
| 225 |
.TP |
| 226 |
.B "--smooth" |
| 227 |
Отключить некоторые пиксели, которые, по всей вероятности, представляют |
| 228 |
собой шум. Это позволяет выиграть около 5% размера файла. Внешний вид |
| 229 |
изображения слегка улучшается, но это малозаметно. |
| 230 |
|
| 231 |
В текущей версии алгоритм обработки является примитивным и удаляет только |
| 232 |
те черные пиксели, которые окружены белыми с трех или четырех сторон. |
| 233 |
Эффект, скорее всего, окажется незаметным. |
| 234 |
|
| 235 |
Данный параметр активируется при указании |
| 236 |
.BR "--lossy". |
| 237 |
|
| 238 |
.TP |
| 239 |
.B "-v" |
| 240 |
.TP |
| 241 |
.B "--verbose" |
| 242 |
Выводить сообщения о разных стадиях обработки. Они не особенно полезны, |
| 243 |
но не лишены некоторого интереса. |
| 244 |
|
| 245 |
.TP |
| 246 |
.B "-X " "ext" |
| 247 |
.TP |
| 248 |
.B "--Xtension " "ext" |
| 249 |
Задает расширение, которое minidjvu будет использовать для файлов, |
| 250 |
содержащих разделяемые словари (начальную точку указывать не нужно). |
| 251 |
Значение по умолчанию "iff". |
| 252 |
|
| 253 |
.TP |
| 254 |
.B "-w" |
| 255 |
.TP |
| 256 |
.B "--warnings" |
| 257 |
Не подавлять предупреждения библиотеки libtiff. По умолчанию такое подавление |
| 258 |
включено. Дело в том, что под Windows стандартный обработчик предупреждений |
| 259 |
TIFF выводит их в виде диалогового окна с сообщением, что, конечно, неприемлемо |
| 260 |
при обработке в пакетном режиме. |
| 261 |
|
| 262 |
.SH ОШИБКИ |
| 263 |
|
| 264 |
Многостраничное кодирование работает неправильно, если страницы имеют разные |
| 265 |
разрешения. |