Дополнения

Общие аспекты

Этот параграф можно не читать большинству пользователей. Дополнения призваны расширить возможности интерфейса (CDI) таким образом, чтобы не пришлось изменять код основной программы. Более детально механизмы взаимодействия основной программы и дополнений можно рассмотреть здесь. Пока есть возможность создания только дополнений, отвечающих за создание обложек к альбомам, загружаемых в интерфейс.
Каждый может создать свои дополнения к интерфейсу. Поскольку в механизмах взаимодействия нет никаких объектов, то использовать можно практически любой язык, позволяющий создавать динамические библиотеки (Кроме VB).

ДОПОЛНЕНИЯ ПОДДЕРЖИВАЕТ CDI ВЕРСИИ НЕ НИЖЕ 2.6.0!

Все что написано ниже касается только тех дополнений, которые создают обложки (NSFT_ASCIIDRAWER, NSFT_DRAW_ONCE, NSFT_POLYMORHIC).

В каких случаях можно использовать дополнения?

Потребность воспользоваться такого рода дополнениями может возникнуть в тот момент, когда происходит создание коллекции с помощью Auto Composer. Основное назначение этого инструмента состоит в том, чтобы систематизировать по различным критериям музыкальные файлы. Критерием может служить один из ID3v1 тэгов (Альбом, Исполнитель и т.д.). Причем, согласно общей концепции программы, результаты систематизации отображаются в виде альбомов. Иными словами, если критерием служил тэг Год, то Auto Composer объединит все файлы, имеющие один и тот же тэг год (т.е. в тэге Year mp3 файла будет написано одна и та жа строчка) в один альбом, а для каждого альбома, если была разрешена такая возможность, попытается либо найти, либо создать обложку. Именно в этот момент и подключаются дополнительные модули, которые часто называются плугины (плагины, plugins), а мы их назвали Дополнения.

Как можно выбрать требуемое дополнение?

Интерфейс сам просматривает свой каталог \Plugins и отображает все доступные дополнения в диалоге Configure plugins. Для его вызова нажмите кнопку Configure в окне Auto Composer, либо используйте сочетание клавиш <Ctrl>+<с> в главном окне интерфейса. Чаще всего, подобные дополнения будут распространяться в виде отдельных *.dll файлов, которые необходимо будет самим скопировать в указанную выше папку \plugins. В отдельных случаях, возможно, потребуется записать некоторые изменения в файл settings.forme в котором интерфейс хранит некоторые общие по характеру, но разнящиеся по содержанию настройки дополнений. (Для разработчиков: в этом файле рекомендуется хранить и индивидуальные настройки каждого дополнения. Более подробно см. здесь). Внешний вид диалогового окна Configure plugins показан на рисунке ниже.

Общие настройки дополнений

К таким относятся значения полей (см. рисунок) Width, Height, Auto define, String. Первые три параметра являются общими и не хранятся отдельно для каждого дополнения. Иными словами, те значения, которые будут в них указаны будут использоваться всеми дополнениями. В отличие от них, параметр String можно изменять для каждого модуля отдельно. Теперь рассмотрим назначение каждого из этих полей.

Width, Height	Определяют ширину и высоту (в пикселях) будущей обложки. Некоторые дополнения, из-за своей внутренней структуры, не позволяют вводить эти измерения меньше какого-либо числа (по крайней мере, ожидается, что в них будут указаны положительные целые числа!). Внимательно ознакомьтесь с описанием дополнения и вводите корректные данные. Помните! В результате ввода неправильных данных, интерфейс, не имеющий возможности контролировать процесс выполнения дополнением своей задачи, может аварийно завершить работу, что может привести к потери некоторых данных.
Auto define	Указывает на то, должен ли интерфейс сам определять размер будущей обложки. Следует с осторожностью использовать эту возможность, поскольку при очень большом количестве альбомов, ширина и высота обложки может стать слишком маленькой для использования дополнения. Если альбомов много, то можно порекомендовать все-таки попробовать запустить дополнение, с включенным параметром и проследить за результатом. Если после создания коллекции появилось сообщение: During process of composing some errors was occured. For mor details see errors.txt, - а в файле errors.txt есть строчка, подобно следующей: `<The Beatles>19.06.2004 22:05:31 #PLUGIN_ERROR: C:\visb5_0\my pr\interfacePF\Plugins\cvrenum.dll: Invalid picture dimensions!` то, определенно, размером слишком маленькие. В этом случае можно попробовать запустить процесс создания заново, отключив этот параметр, введя вручную значения полей Width, Height, а в свойствах самой коллекции, впоследствие, указать параметр Auto define size (окно Options,вкладка Collection).
String	С помощью этого параметра интерфейс передает дополнению необходимую информацию. Содержимое этой строки может быть разным для разных дополнений. Поэтому, прежде чем воспользоваться новым дополнением, прочитайте документацию.

Дополнительные настройки

Некоторые дополнения могут иметь, помимо указанных выше, свои индивидальные параметры. Вызвать окно диалога таких настроек можно с помощью кнопки Configure в диалоговом окне Configure plugins.