DjVu Small v0.3

Руководство пользователя

Помощь по консольным утилитам (на английском языке)

DjVu Small - это программный пакет для группового кодирования-декодирования в/из DjVu (OC Windows).

Пакет составлен на основе программы Document Express Enterprise with DjVu v5.0, доступной на http://www.lizardtech.com/ и по своим возможностям практически эквивалентен ей (в некоторых отношениях превосходя её по удобству использования).

Он сделан специально небольшого размера (в пределах 2 МБ) - для того, чтобы облегчить его распространение через Интернет. (Исходная программа Document Express Enterprise with DjVu v5.0 занимает 178 МБ).

DjVu Small предлагается к использованию в качестве основного средства для работы с форматом DjVu (под ОС Windows).


Возможности:

1. Работает как под Win98, так и под Win2000/XP.

2. Кодирует в DjVu как отдельные файлы, так и группы графических файлов.

3. Декодирует одно- и многостраничные DjVu-файлы (в пакетном режиме) в обычные графические форматы.


Использование:

1. Запустите файл DjVu Small.exe.

2. Просматривая окно программы сверху вниз, заполните все необходимые поля ввода.

3. Если надо, измените опции кодирования: нажмите кнопку Опции и в открывшемся окне выберите другие значения параметров (при обычном использовании программы это практически никогда не потребуется делать).

4. Нажмите на кнопку Пуск - начнётся процесс (де)кодирования.


Подробности:

Файл DjVu Small.exe - это просто GUI, управляющий пропатченными консольными экзешниками от LizardTech. "Пропатченные" - т.е. такие, из которых удалена привязка к серийному инсталляционному номеру. Эти экзешники (а также все завязанные на них файлы) были взяты из пакета Document Express Enterprise with DjVu v5.0, доступного на http://www.lizardtech.com/.

Пакет содержит 3 таких экзешника:

- documenttodjvu.exe (пропатчен) - консольная утилита для пакетного кодирования чёрно-белых, серых и цветных графических файлов в форматах bmp, jpeg, jpg, gif, tiff, tif, pnm, ppm, pgm, pbm.

- phototodjvu.exe (пропатчен) - консольная утилита для пакетного кодирования серых и цветных графических файлов  (в тех же форматах) с улучшенным качеством.

- djvudecode.exe - консольная утилита для пакетного декодирования любых DjVu-файлов: одно- и многостраничных; содержащих чёрно-белые, серые и цветные изображения (при декодировании   автоматически создаются файлы соответствующей битовой разрядности).

DjVu Small имеет 3 режима работы, соответствующие этим консольным экзешникам:

- Документ -> DjVu    (управление консольной утилитой documenttodjvu.exe)

- Фото -> DjVu    (управление консольной утилитой phototodjvu.exe)

- Декодировать DjVu    (управление консольной утилитой djvudecode.exe)

В любом из режимов работы пользователь визуально формирует параметры (де)кодирования, которые DjVu Small подаёт затем через командную строку на вход соответствующей консольной утилиты. При этом сформированная командная строка отображается в процессе (де)кодирования в лог-окне (в полном или кратком виде - по желанию пользователя).


Профили кодирования:

Профили кодирования - это сгруппированные и специально подобранные LizardTech наборы опций кодирования. Профили кодирования находятся в файле "profiles\documenttodjvu.conf". Их можно править вручную (если знать синтаксис) - например, создавать профили-наследники от имеющихся (с целью изменить какой-либо параметр). Именно таким способом были созданы пользовательские профили вида "user B/W (*** dpi)" (см. ниже).

DjVu Small считывает при запуске имена всех имеющихся профилей из файла documenttodjvu.conf и заполняет этими именами список под надписью Выберите профиль кодирования:.

Для эффективного кодирования в DjVu ЧЁРНО-БЕЛЫХ графических файлов рекомендуется использовать соответствующий профиль кодирования вида "user B/W (*** dpi)", где *** - разрешение входных графических файлов. Профили вида "user B/W (*** dpi)" были созданы на базе профиля "Very Aggressive 300" и дают практически наименьший размер выходного DjVu-файла. Обратите внимание - для СЕРЫХ и ЦВЕТНЫХ входных графических файлов эти профили кодирования НЕ подходят (!).


Опции:

При нажатии на кнопку Опции открывается окно выбора опций программы. Это окно имеет 5 вкладок:

- Общие - опции самой программы DjVu Small.

- Документ -> DjVu    (опции командной строки утилиты documenttodjvu.exe)

- Документ -> DjVu (2)    (дополнительные опции командной строки утилиты documenttodjvu.exe)

- Фото -> DjVu    (опции командной строки утилиты phototodjvu.exe)

- Декодировать DjVu    (опции командной строки утилиты djvudecode.exe)

Смысл и значения опций командной строки всех 3 утилит можно узнать в специально составленной выдержке из хелпа к пакету Document Express Enterprise v5.0:

Помощь по консольным утилитам (на английском языке)    (эта ссылка также есть в самом верху страницы)

В этом пакете помощи опции сгруппированы по 3 консольным утилитам.

Общие опции:

Рассмотрим смысл и значения некоторых неочевидных общих опций программы (вкладка №1 в окне Опции):

Создать папку декодирования - При декодировании многостраничного DjVu-файла создаётся множество одностраничных графических файлов, которые помещаются программой в выходную папку. Если включить этот параметр (это значение по умолчанию), то в выходной папке будет создана подпапка с заданным пользователем именем и декодируемые файлы будут помещены туда.

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

Вывод ком. строки - Здесь пользователь может выбрать режим вывода командной строки, выдаваемой в лог-окне программы (точнее, DjVu Small формирует командную строку и подаёт её на вход соответствующей консольной утилиты, а в лог-окне эта командная строка просто дублируется - для сведения пользователя).

Командная строка может выдаваться либо целиком, либо в сокращённом виде - когда выводятся только дополнительные опции, введённые в окне Опции.


Замечания:

1. По умолчанию в списке профилей указан профиль с именем Default.

ВНИМАНИЕ: это - не первый профиль в списке, как это может показаться на первый взгляд, прокрутите список профилей выше и увидите все остальные профили. Профиль Default - это последний из списке "фирменный" профиль от LizardTech, ниже него идут уже пользовательските профили.

2. Список входящих файлов (под надписью Введите файл(ы):) поддерживает свойство Drag'n'drop: Вы можете перетащить туда мышкой один или несколько графических файлов, подлежащих кодированию в DjVu или папку с ними; или же один DjVu-файл, подлежащий декодированию.

При этом при необходимости автоматически переключится режим работы программы (если "бросить" графические файлы или папку с ними - включится режим Документ -> DjVu (если Вам при этом был нужен режим Фото -> DjVu, установите его вручную), если "бросить" DjVu-файл - включится режим Декодировать DjVu).

3. Одновременное декодирование нескольких DjVu-файлов не поддерживается (в этом нет большого смысла).

4. Добавление/удаление файлов в/из загруженного списка, а также изменение порядка файлов в загруженном списке не поддерживаются - это тоже не слишком нужная возможность.

5. Все изменённые вручную параметры программы автоматически запоминаются.

6. По умолчанию в качестве выходной папки используется Рабочий стол - для удобства низкоквалифицированных пользователей программы (привыкших работать исключительно с Рабочим столом).

Путь к Рабочему столу определяется программой автоматически - в зависимости от операционной системы и при переносе программы с одной операционной системы на другую этот путь автоматически изменяется соответствующим образом (только если он не был заранее изменён пользователем).

7. Программа не выдаёт предупреждений, когда производится запись поверх существующего файла (папки) - это сделано умышленно, т.к. такие предупреждения обычно не слишком полезны, а просто раздражают пользователя.

8. Полные исходные коды программы DjVu Small свободно доступны всем желающим для любых целей (см. ссылку на сайт программы внизу страницы). Программа распространяется по лицензии GPL (все последующие модификации программы в случае публичного распространения обязаны распространяться с исходниками).

9. Программа имеет русскую локализацию - но можно сделать и какую-либо другую: создайте локализационный текстовый файл по образцу файла "russian.txt" и поместите его в папку "languages".


Известные недостатки программы:

1. При создании новой папки в окне выбора папки это окно автоматически закрывается и его нужно вновь открыть вручную, чтобы увидеть созданную папку. Возможная причина: в Win98, по-видимому, не работает (или плохо работает) раскрытие узла дерева по команде.

2. Иногда конкретизация сообщений об ошибках не выводится в лог-окно (это строка, начинающаяся со слова "Error"). Возможная причина: не очищаются своевременно буферы вывода в консольных приложениях.

3. Программа рассчитана в основном на использование в режиме русского интерфейса. В режиме английского интерфейса между названиями и полями элементов управления оказываются длинные промежутки - из-за того, что английский язык более "компактен", чем русский.

4. Нет удобной возможности править профили кодирования - это можно сделать только ручной правкой файла documenttodjvu.conf, зная и понимая его синтаксис.

5. Есть некоторые мелкие шероховатости в навигации по файлам пакета хелпа (некоторые единичные ссылки не работают).

6. При (де)кодировании файлов линейка прогресса в окне Прогресс просто бесконечно-зациклена и не отражает ход процесса (де)кодирования.

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


Авторы:

Взлом консольных экзешников:

mas,
Arcand,
monday2000.

Создание GUI:

monday2000.


03.11.2006.

http://www.djvu-soft.narod.ru/