DjVu Solo 3.1 extension by gencho (c) 2004 - BETA1
=================================================

Терминология
------------
DjVu Solo 3.1 - продукт фирмы Lizardtech для создания DJVU-книгы
SoloX         - моя программа, меняющая возможности DjVu Solo 3.1

Назначение
----------
Программа SoloX.EXE является разширением Djvu Solo 3.1 commercial.
Она позволяет автоматизирование процесса создания книг и запуска DjVu Solo
с командной строки и задание project-файл с описание задания для Solo.
Ето BETA-версия, возможны ошибки в управление DjVu Solo 3.1

Содержание пакета
-----------------
Пакет содержит программа SoloX.EXE, а также и сам пакет DjVu Solo 3.1 
commercial в готовом для работы состояние. Инсталяция не нужна. Надо только
расспаковать в какая-то папка. Никакие изменения в оригинальном Solo нет.
Программа SoloX.EXE привязана к бинарник DjVuSolo.EXE комерсиальной
версии Solo, и с других версиях работат не будеть.

Запуск
------
Для автоматизированной работы запускается SoloX.EXE. Можно сделать shortcut
к SoloX.EXE, находящийся где угодно, включително и на desktop. Сама программа
SolOX.EXE должна находится в папке, где находится и DjVuSolo.exe.

Для нормалной (неавтоматизированой) работы надо запускать DjVuSolo.exe

Если запустить SoloX.EXE с пустой командной строки, открывается диалог,
где можно выбрать файл, содержащий набор задании для Solo. 
Для запуска с командной строки надо имет пут до SoloX.EXE или до его
shortcut.
Нельзя запускать более одного SoloX.EXE.

Файл-набор задании можно указать и на командной строки SoloX.EXE:

SoloX [-m] [project_file}
    m            - указывает что DjVu Solo 3.1 будеть работат в 
                       минимизированное окно;
    project_file - файл, содержащий список задании для DjVu Solo 3.1

Если указанны несколько задании, SoloX перезапускает DjVu Solo 3.1
для каждое задание.

Если во время работы DjVu Solo 3.1 появятся окна содержащие сообщения об 
ошибок, на них надо отвечать вручную. Здесь нет автоматизация. Ето сообщения 
оригинального пакета.


Файл-набор задания
------------------
Набор задании представляет текстовый файл, содержащий список параметров для
каждое задание. Все параметры для одного задания должны быть указаны на
одной строки. Параметры разделяются интервалом и начинаются символом '-'.
Пустые строки игнорируются. Строки, начинающие с ';' являются коментариями
и тоже игнорируются.

Пример строки задания:
  -param1 value1 -param2 -param3 value3 ....

Параметры задания
-----------------
Последовательность параметров не имеет значение.
Желательно везде, где указываются имена файлов, указывать полный путь.
Длинные имена, содержащие пробел, должны начинать и кончатся с кавычка.
Каждый параметер имеет два способа записи, краткая и длинная.
Параметры, которые понимает SoloX, следующие:
      -f     <[@]filelist>
      -files <[@]filelist>
          Указывает список графических файлов для обработки.
          Если имя содержит '?', '*", то ето считается как маска для
            выбора файлов. Выбранные таким образом файли сортируются.
          Если имя начинает с '@', то ето текстовой файл, содержащий
            список графических файлов в нужном порядке. Каждое имя на
            отделцной строки.
          Если имя не попадает под указанные ограничения, то ето одна 
            страница книги.
          Можно указать несколко опции '-files'

      -u
      -bundled
          Указывает тип файла BUNDLED. Ето default тип.

      -i
      -indirect
          Указывает тип файла INDIRECT.

      -s
      -scanned
          Указывает режим компресии SCANNED. Ето default режим.

      -c
      -clean
          Указывает режим компресии CLEAN.

      -p
      -photo
          Указывает режим компресии PHOTO.

      -b
      -bitonal
          Указывает режим компресии BITONAL.

      -d   <dpi>
      -dpi <dpi>
          Указывает графическое разрешение. Для сохранение 100% качество
            выходних изображении надо указать здесь разрешение изображения.
          Если скажем изображение 300 dpi, а здесь указать 600 dpi, то в
          браузере изображение будеть два раза менше чем оригинальное,
          и при етом будеть потеря качества при компресии.

          Default стойность - 300 dpi
          Допустимое значение: 50-1200


      -o      <output file>
      -output <output file>
          Имя выходного DJVU файла.


      -n  - если указана, то не выводятся сообщения о "Access Violation", 
            которые выводит DjVu Solo 3.1. При етом DjVu Solo мирно умирает
            и начинается выполнение следующего задания.

            Если етот параметр не указан, то появляется окно со сообщение об
            ошибки, и нужно нажать OK для продолжение.


Примеры
-------
Содержание примерного файла с заданиями для выполнение:
<-------- начало файла -------------->
; Ето коментарная строка
; BUNDLED BITONAL документ с имя output1.djvu, 300 dpi
  -b -files "d:\my files\book1*.gif" -o d:\output1.djvu

; BUNDLED SCANNED документ, содержащий несколько груп страниц, 300 dpi
  -u -s -files d:\mydocs\chapter1\*.tif -files d:\mydocs\chapter2\*.bmp -output out.djvu

; INDIRECT PHOTO 600 dpi, исходные файли указаны в файл-список SPISOK.TXT
  -dpi 600 -i -p -files d:\@SPISOK.TXT -o d:\out2.djvu
<-------- конец файла --------------->


Гарантии
--------
Гарантии никаких. Ето BETA-версия. Все может работать или не работать 
так как описано выше. Вроде бы ето работает как надо под Windows 98.
Пробовал раз и под WinXP.

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

Кнопка "Cancel" не работает. Ето дело будущего.


-------------------------------------------------------------------------------
Все пожелания и сообщения об ошибки желательно направлят на
gencho (собака) yourwap . com или на ПМ в ru-board

София, 15.08.2004

gencho