Фрагмент содержимого файла readme.txt из комплекта файлов библиотеки:
Библиотека включает заголовочные файлы ESTKUI.jsxinc и ESTKUIcolors.jsxinc для использования в JS скриптах, описывающие константы и графические ресурсы, используемые в библиотеках ESTK (v3.8.0.12 СS6). Совместно с библиотекой распространяются соответствующие файлы ресурсов, расположенные в папке resources.
Б Ы С Т Р Ы Й С Т А Р Т:
-----------------------------------------------
Для начала работы с библиотекой необходимо проделать следующие шаги:
1) Для корректной работы библиотеки расположите папку resources со всеми содержащимися в ней подпапками в папке скриптов InDesign (для Windows эта папка расположена по адресу /c/Program Files (x86)/Adobe/Adobe InDesign CS6/Scripts/Scripts Panel/). Если вы хотите поместить папку ресурсов в другое расположение – сделайте это и установите соответствующие значение библиотечной переменной ESTKUI.iconsFolder, объявленной в заголовочном файле ESTKUI.jsxinc . Корректное значение можно прописать либо в самом заголовочном файле, либо динамически менять его в теле Вашего скрипта;
2) Расположите заголовочные файлы ESTKUI.jsxinc и ESTKUIcolors.jsxinc в любом удобном для Вас месте и включите их в свой скрипт директивой #include (описание работы с директивами см. в JavaScript Tools Guide на http://www.adobe.com/devnet/scripting. ).
-----------------------------------------------
Для отображения диалога, содержащего каталог ресурсов, представленных в рамках библиотеки ESTKUI:
- Установите билиотеку, согласно инструкции по быстрому старту
- Создайте в ESTK новый скрипт и включите в него строки:
-----------------------------------------------
В файле ESTKUI.jsxinc можно найти подробное описание всех функций и ресурсов, входящие в библиотеку. Следующая информацияя также включена в заголовок файла ESTKUI.jsxinc:
Библиотека включает заголовочные файлы ESTKUI.jsxinc и ESTKUIcolors.jsxinc для использования в JS скриптах, описывающие константы и графические ресурсы, используемые в библиотеках ESTK (v3.8.0.12 СS6). Совместно с библиотекой распространяются соответствующие файлы ресурсов, расположенные в папке resources.
Б Ы С Т Р Ы Й С Т А Р Т:
-----------------------------------------------
Для начала работы с библиотекой необходимо проделать следующие шаги:
1) Для корректной работы библиотеки расположите папку resources со всеми содержащимися в ней подпапками в папке скриптов InDesign (для Windows эта папка расположена по адресу /c/Program Files (x86)/Adobe/Adobe InDesign CS6/Scripts/Scripts Panel/). Если вы хотите поместить папку ресурсов в другое расположение – сделайте это и установите соответствующие значение библиотечной переменной ESTKUI.iconsFolder, объявленной в заголовочном файле ESTKUI.jsxinc . Корректное значение можно прописать либо в самом заголовочном файле, либо динамически менять его в теле Вашего скрипта;
2) Расположите заголовочные файлы ESTKUI.jsxinc и ESTKUIcolors.jsxinc в любом удобном для Вас месте и включите их в свой скрипт директивой #include (описание работы с директивами см. в JavaScript Tools Guide на http://www.adobe.com/devnet/scripting. ).
-----------------------------------------------
Для отображения диалога, содержащего каталог ресурсов, представленных в рамках библиотеки ESTKUI:
- Установите билиотеку, согласно инструкции по быстрому старту
- Создайте в ESTK новый скрипт и включите в него строки:
Код:
#include "ESTKUI.jsxinc"
ESTKUI.showDialog(); // Альтернативный вариант: ESTKUI.showDialog("dialog");
В файле ESTKUI.jsxinc можно найти подробное описание всех функций и ресурсов, входящие в библиотеку. Следующая информацияя также включена в заголовок файла ESTKUI.jsxinc:
Код:
* Состав библиотеки:
* ESTKUI.jsxinc - данный файл, содержит константы графических ресурсов ESTK и набор функций для удобства работы с ними.
* ESTKUIcolors.jsxinc - цвета в формате Array [ R, B, G, A] для использования в ScriptUI (сформирован автоматически на основе ESTKUI.COLORS с помощью createESTKUIcolors() )
* readme.txt - текстовый файл, содержащий инструкции по быстрому старту с библиотекой.
*
* Ресурсы, представленные в библиотеке:
* ESTKUI.ALLICONS - массив содержащий все допустимые имена констант ESTK (ESTKUI.ENUMERATION, ESTKUI.CLASS и т.д.)
* ESTKUI.COLORS - стандартные значения различных цветов и оттенков
*
* Функции, предсталенные в библиотеке:
* ESTKUI.getRGB (color, opacity)
* ESTKUI.isValidExtension (name)
* ESTKUI.makeValidName (name)
* ESTKUI.loadImage (ESTKUIname, folder)
* ESTKUI.imagetojsx (ESTKUIname, folder)
* ESTKUI.createImage (resString)
*
* Внутренние глобальные переменные, предназначенные для настройки библиотеки:
* ESTKUI.iconsFolder { string } - очень важная переменная, перед использованием любой из вышеперечисленных функций, стоит убедиться, что она
* содержит правильный путь к папке (\resources), содержащей файлы ресурсов
* ESTKUI.scriptFolder { string } - содержит путь к папке, в которой находится данный скрипт (определяется автоматически)
* ESTKUI.defaultExt { string } - расширение (по умолчанию ".png") для ресурсных графических файлов, используется в ESTKUI.loadImage() и ESTKUI.imagetojsx()
* ESTKUI.lasterror { string } - текстовая переменная, в которую функции ESTKUI могут писать диагностические сообщения (выводятся в JavaSxript Console)
*
* Дополнительно:
* \resources - папка с ресурсами
* \resources\colors - набор графических файлов .jpg, с примерами цвета из ESTKUI.COLORS
* \resources\icons - набор графических файлов .png, представляющие графические ресурсы, описанные соответствующими константами ESTK
* \resources\other - набор файлов, которые я ещё не разобрал или не нашёл им соответствий в библиотеках adobe