                              jBooster 2.03c
                                 Freeware

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

                                                                            

                                 ОПИСАНИЕ

    Поле "Files" задает маску и расширение обрабатываемых файлов. В данной 
версии программы поддерживаются только "jpg", "bmp" и "png" форматы. 

    Поле "Path" задает каталог с исходными файлами. Сканирование содержимого
каталога происходит при выходе из поля или при нажатии клавиши "Enter". 

    Список показывает текущие файлы. Meню операций над выбранным(выделенным) 
файлом вызывается левой кнопкой мыши или клавишей "F9".

	Пункт "View image" открывает окно просмотра выбранного файла. При 
    этом в окне просмотра остаются доступными все пункты меню списка файлов.  

	Пункт "Switching" позволяет переключаться между окном просмотра и 
    окном программы.

	Пункты "Zoom ..." изменяют размеры просматриваемого изображения. 

	Пункты "Next ...", "Prev ..." осуществляют навигацию по списку 
    файлов.

	Пункт "Equal Image" осушествляет переход на файл, содержащий
    изображение эквивалентное выбранному. (см. "Проверка коллекции").

	Пункты "Copy" и "Move" позволяют копировать или перемещять
    выбранный файл в один из заданных каталогов.

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

	Пункт "Del" перемещает выбранный файл в корзину Windows.



    Кнопка "Browse" открывает стандартный диалог выбора каталога.
    
    Кнопка "Run" запускает обработку выбранных файлов согласно заданным
режимам. При этом выводится окно протокола работы программы. Сообщения об
ошибках выделяются красным цветом. 
    Внимание! При выключенной опции "Detailed log file" (см. "Настройка") 
и отсутствии ошибок в ходе работы программы окно протокола закрывается 
автоматически.



НАСТРОЙКА
    
    Кнопка "Options" открывает форму дополнительных настроек:

	Поля "Sort order" и "Decrease" задают режим сортировки списка
    выбранных файлов.
   
	Поле "Find file number from the end" включает режим поиска номера
    файла начиная с окончания имени (см. "Переименование файлов").

	Поле "Recursive subdirectories" включает режим сканирования 
    подкаталогов выбранного каталога. 
	
	Поле "Automatic rescan" включает режим автоматического сканирования 
    при изменении файлов(подкаталогов) выбранного каталога. 

	Поле "Enable datafile" включает режим автоматического сохранения и 
    последующей загрузки данных о текущих файлах, что значительно ускоряет
    работу программы при частой обработке большого количества изображений
    коллекции.

	Поле "Change first number after renaming" включает режим изменения 
    значения поля "First" после нумерации на следующий по порядку номер
    (см. "Переименование файлов").

	Поле "Detailed log file" включает режим подробного протоколирования
    выполняемых программой действий.


ПРЕОБРАЗОВАНИЕ ИЗОБРАЖЕНИЙ

    Поле "Convert images" включает режим преобразования изображений. 

    Поле "Format" задает необходимый формат результирующих файлов. В данной 
версии программы поддерживаются только "jpg", "bmp" и "png" форматы. 
   
    Поле "Quality" задает степень сжатия JPEG формата. Крайнее левое
положение указателя соответствует большей степени сжатия (наихудшему
качеству) результирующего файла.

    Поле "Pack" задает степень сжатия PNG формата. Крайнее левое
положение указателя соответствует большей степени сжатия результирующего 
файла.

    Поле "Replace destination files" включает режим замены результирующего
файла, если файл с таким именем уже существует.

    Поле "Delete source files" включает режим удаления исходный файлов при
преобразовании формата изображений.

    Поле "Replace color" включает режим изменения цветовой гаммы 
изображения.

    Поля "Flip horizontal" и "Flip vertical" включает режим перевертывания
изображения относительно вертикальной и горизонтальной осей соответственно.

    Поле "Rotate" включает режим поворота изображения относительно центра.

    Поле "Angle" задает угол поворота и направление поворота.

    Поле "Resize" включает режим изменения размеров изображения при повороте.

    Кнопка "BGround" задает цвет дополнения изображения до прямоугольной
формы.


СОЗДАНИЕ "THUMBNAILS"

    Поле "Create thumbnails" включает режим создания thumbnail-файлов 
(в том же формате, что и исходные изображения).

    Поле "Mark" устанавливает строку символов, добавляемую к имени
thumbnail-файла в начале или в конце, по которой определяется различие имен 
файла основного изображения и файла уменьшенной копии. Наличие thumbnail-файла 
без файла основного изображения считается ошибкой.
    Внимание! Если ваши исходные файлы содержат в имени файла (в начале или 
перед расширением) значение заданное в поле "Mark", то программа будет считать 
их thumbnail-файлами со всеми вытекающими последствиями.

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

    Поле "Quality" задает степень сжатия JPEG формата. Крайнее левое
положение указателя соответствует большей степени сжатия (наихудшему
качеству) результирующего thumbnail-файла.

    Поле "Pack" задает степень сжатия PNG формата. Крайнее левое
положение указателя соответствует большей степени сжатия результирующего 
thumbnail-файла.

    Поле "Custom size" устанавливает режим ручного задания необходимых
высоты и ширины изображения в полях "Width" и "Height" соответственно. 
При этом значение заданное в поле "Scale" игнорируется. 
    Если в поле "Width" или в поле "Height" задано значение "0", то 
значение поля вычисляется автоматически с учетом сохранения пропорций.
Внимание! Программой не учитываются размеры добавляемого текста и рамки
задаваемые в панели "Include in thumbnail". 

    Значения "Cut" и "Fill" определяют алгоритм преобразования до заданных 
размеров. В первом случае, изображение уменьшается и обрезается по одной из 
сторон до заданного размера, во втором случае уменьшается и дополняется 
фоновым цветом по одной из сторон до заданного размера. 
    Значение "Adjust" аналогично "Fill", но без дополнения фоновым цветом;
т.е. thumbnail-изображение с сохранением пропорций вписывается в прямоугольник 
заданных размеров.

    Внимание! Программа не может создать thumbnail-изображение больших 
размеров чем основное изображение.


    Кнопка "Align" задает выравнивание thumbnail-изображения. 

    Кнопка "Color" задает цвет заполнения для режима "Fill".

    Поле "Include in thumbnail" включает режим добавления строки текста в
thumbnail-файл снизу от изображения и\или рамки вокруг изображения.

    Поле "Image size" включает в добавляемый текст размер исходного
изображения (в пикселях) в виде "WWWxHHH", где WWW - ширина, HHH - высота
изображения.

    Поле "File size" включает в добавляемый текст размер файла исходного
изображения в килобайтах(мегабайтах) в виде "NNk"("N.NM"). 

    Кнопки "Font" и "BGround" вызывают формы задания формата шрифта и
цвета фона добавляемого текста.

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


    Поле "Border" включает режим добавления рамки вокруг изображения.

    Поле "Width" задает ширину рамки в пикселях.

    Поле "Mode" задает формат заливки.

    Кнопка "Color" задает цвет рамки.


ПЕРЕИМЕНОВАНИЕ ФАЙЛОВ

    Поле "Rename files" включает режим переименования выбранных файлов.
Исходные изображения переименовываются вместе с их уменьшенными копиями.
В случае, когда не все исходные файлы имеют уменьшенные копии, выводится 
предупреждающее сообщение. Наличие thumbnail-файла без файла основного 
изображения считается ошибкой.
    
    Принимается, что имя файла состоит из трех частей: 
   
    <префикс><номер><постфикс> 
 
    Если имя файла не содержит номера, то все имя файла считается префиксом.
Если имя файла содержит несколько числовых значений, то номером файла
считается первое от начала имени значение или первое от конца имени
(при установке поля "Find file number from the end" в форме настроек).	     	

    Поле "Mode" управляет режимом переименования файлов:

        Значение "Rename files" задает режим переименования без нумерации
    файлов. Т.е. изменяются значения префикса и постфикса имени, а номер 
    остается неизменным. 

        Значение "Numerate files" задает режим переименования c нумерацией
    файлов. Т.е. изменяются значения как префикса и постфикса, так и номера. 

        Значение "Undo last renaming" задает режим восстановления старых
    имен обрабатываемых файлов (до последнего переименования). 

        Значение "Exchange of names" задает режим инвертирования имен 
    выбранного списка файлов. Т.е. первый по списку меняется именем с 
    последним, второй с предпоследним и т.д.

    Внимание! 
        Если выключена опция "Enable datafile", то после смены каталога, 
    смены формата файлов или выхода из программы, откат последнего 
    переименования станет невозможным.
        При включенной опции "Recursive subdirectories" режимы переименования
    "Exchange of names" и "Numerate files" могут привести к очень неожиданным
    результатам :-). Будте осторожны!
        При переименовании, для сохранения старых значений префикса и
    постфикса необходимо в полях "Prefix" и "Postfix" задавать параметр: "%0".
        Не допускается наличие цифровых символов в окончании префикса и 
    в начале постфикса.


    Поля "Order" и "Decrease" задают порядок нумерации файлов.

    Поле "Prefix" задает строку символов, добавляемую к имени файла
перед номером. Для данного поля определены следующие значения подстановки:

    %0 - подставляется старое значение префикса(постфикса);
    %1 - подставляется размер изображения в виде "WWWxHHH"; 
    %2 - подставляется размер файла в виде "NNk";
    %3 - подставляется наименование подкаталога данного файла.

    Внимание! Дублирование(повтор) параметров не допускается.


    Поле "Digits" задаёт необходимое количество цифр в имени файла, до
которого номер файла будет дополнен нулями слева.

    Поле "First" задаёт начальный номер в последовательности имён-номеров
файлов.

    Поле "Step" задаёт шаг последовательности имён-номеров файлов.

    Поле "Postfix" задает строку символов, добавляемую к имени файла
в окончании. Для данного поля определены такие же значения подстановки, как
и для поля "Prefix".

    Поле "Update file time" включает режим установки времени изменения
обрабатываемых файлов в последовательности соответствующей положению в 
списке (порядку возрастания их номеров при нумерации).

    Поле "Set readonly attribute" управляет режимами установки или снятия 
атрибута "readonly" у обрабатываемых файлов.


ПРОВЕРКА КОЛЛЕКЦИИ

    Поле "Collection check" включает режим проверки коллекции.

    Поле "Find duplicate images" задает режим поиска одинаковых 
изображений, не зависимо от масштаба, горизонтальной инверсии, цветовой 
гаммы и наличия рамок (в разумных пределах:-)). При нахождении одинаковых 
изображений выдается предупреждающее сообщение. Все найденные одинаковые 
изображения выдеяются в списке файлов красным цветом.
    
    Поле "Likeness" задает степень подобия изображений (83%..100%).

    Поле "Invert images" задает режим дополнительного сравнения с учетом
возможной горизонтальной инверсии изображений. 
    Поле "Skip borders" задает режим дополнительного сравнения с учетом
наличия рамок (возможного смещения изображения относительно центра).
    Поле "Update filetime" задает режим установки одинаковых даты и времени 
изменения файла для всех дублирующихся изображений.


    Поле "Create csv-file" задает режим создания CSV-файла "jbooster.csv"
(в текущем каталоге) с описанием файлов коллекции, согласно заданным полям.




                          АВТОМАТИЧЕСКИЙ РЕЖИМ

    Все заданные в полях значения при выходе из программы сохраняются в 
файле инициализации и восстанавливаются при последующем запуске программы. 
По умолчанию данный файл имеет наименование "jbooster.ini" и располагается
в директории модуля программы. При необходимости указать свой файл 
инициализации, путь и имя файла задаются первым параметром в командной
строке.
    Если вторым параметром в командной строке задано значение "auto",
то программа выполнится в автоматическом режиме (без вывода на экран),
согласно установкам "ini" файла. При этом формируется протокол работы
программы в файле "jbooster.log" и устанавливается код возврата, равный
количеству сообщений об ошибках или "#7FFFFFFF" - при ошибке открытия
файла протокола.
                        
             
                              ДОПОЛНЕНИЕ
                                     
    К программе прилагается файл примера HTML страницы (jBooster.htm) для
просмотра через WEB вашей коллекции изображений:

    1. Копируем несколько (желательно более 10) ваших файлов в отдельный
каталог.

    2. Выполняем jBooster для скопированных файлов в режимах "Numerate"
(First: 0, Digits: 0) и "Create thumbnails".

    3. Копируем файл "jBooster.htm" в каталог с полученными файлами и
открываем его из Internet Explorer.

    4. Убеждаемся, что все вроде бы работает.

    5. ... простор для полета мысли и применения дизайнерских
способностей.

    Внимание! Пример корректно работает только совместно с Internet
Explorer 4+ или Netscape Navigator 6.2, т.к. Netscape Navigator 4 и Opera 6 
не меняют размеры картинки при смене исходного файла. Для корректной работы 
во всех браузерах следует использовать режим ручного(custom) задания размера 
thumbnail-файлов или же формировать html-страницу с помощью 
функции "document.write". 
    
    Более сложный пример, работающий и в IE4+ и NN4+, реализован на 
странице: http://personal.primorye.ru/collection

    
                                     
                          ЛИЦЕНЗИОННОЕ СОГЛАШЕНИЕ

    Программа распространяется свободно. Ни одно частное лицо или 
организация не может брать плату за распространение без письменного 
разрешения автора.

    Пользователи имеют право использовать данную версию программы в любых
целях бесплатно.

    Пользователи имеют право изменять исходный текст программы по своему 
усмотрению. В этом случае в описании программы обязательна ссылка на 
исходный программный продукт.
    
    Программа поставляется по принципу "as is". Никаких гарантий не
прилагается и не предусматривается.  Вы используете это программное
обеспечение на свой риск. Автор не будет отвечать ни за какие потери или
искажения данных, любую упущенную выгоду в процессе использования или
неправильного использования этого программного обеспечения.


Благодарю за использование.
Просьба об ошибках замеченных в работе программы сообщать по e-mail:
pulsar@mail.primorye.ru


