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

Чтение эффектов из папки нужно включить в настройках, для каждого поколения эффектов (ZDL и ZD2) отдельно.
Так же нужно выбрать папки, в которых программа будет искать файлы эффектов.

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

Параметры "Заменять номер типа" и "Заменять индекс 0XC" нужны для работы эффектов с некоторыми моделями. По совместимости эффектов можно посмотреть в таблице.



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

Как происходит чтение эффектов из папки

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

- Для всех моделей имя файла в устройстве имеет ограничение в 12 символов, из них 4 символа - это расширение, имя ограничено 8 символами. Если имя больше 8 символов, то программа перед записью его обрезает. Может быть ситуация, что после обрезания имени файла у некоторых эффектов имена будут совпадать, в таком случае педаль зависает при загрузке. Проверку на совпадение имен планируется добавить в следующих версиях программы.

- Для эффектов ZD2 все параметры, кроме описания на русском языке, извлекаются из самого файла. Дополнительные файлы (.ZIC и .ZIR) нужно поместить в папку с файлом эффекта. Имена дополнительных файлов должны совпадать с именем файла эффекта.

- Для эффектов ZDL большая часть параметров извлекается из самого файла. Для записи эффекта в педаль этого достаточно.
Также можно поместить JSON файл с некоторыми параметрами, имя JSON файла должно совпадать с именем файла эффекта. Любой из параметров не является обязательным и может быть не указан в файле.

JSON файл может содержать следующие параметры:
"name" - название эффекта
"inDeviceFileName" - имя файла в педали
"iconFile" - иконка эффекта для программы, имя может отличаться от имени эффекта
"descriptionEng" - описание на английском языке
"descriptionRus" - описание на русском языке
"dependencies" - массив файлов зависимостей, может иметь значения из списка ["CMN_DRV.ZDL","CMN_BASS.ZDL"]. Нужно указывать, если эффект не работает без этих общих файлов.

Пример JSON файла:

{
    "name": "RainSel",
    "inDeviceFileName": "RAINSEL.ZDL",
    "iconFile": "Rain.png",
    "descriptionEng": "Text",
    "descriptionRus": "Текст",
    "dependencies": ["CMN_DRV.ZDL","CMN_BASS.ZDL"]
}

- Для ZDL эффектов иконка в программе считывается из png файла с таким же именем в той же папке, или из файла иконки, который указан в JSON файле.

- Для ZD2 файлов иконка в программе считывается из ZIC файла, из png файла с таким же именем в той же папке, из самого файла эффекта. Обратите внимание, что есть оригинальные эффекты, файлы которых содержат пустые или неверны иконки (от других эффектов), часто встречается для файлов эффектов из моделей, которые используют ZIC и SVG иконки.

Лог чтения эффектов

Если в настройках включена опция "Запись журнала отладки", то в логе можно посмотреть ошибки и параметры чтения эффектов. Файл лога лежит в папке с документами\Zoom Effect Manager\logs\

Пример журнала отладки:

12:14:14 - ------------------------------------------
12:14:14 - Start reading effects ZDL from folder
12:14:14 - ------------------------------------------
12:14:14 - Start reading file C:/zem/zdl_effects/OTT.ZDL
12:14:14 - Name: OTT
12:14:14 - Effect index: 16777626
12:14:14 - Effect IndexHex: 0x0100019a
12:14:14 - Type Number: 1
12:14:14 - Type: Dynamics
12:14:14 - Version: 1.00
12:14:14 - In device file name: OTT.ZDL
12:14:14 - Byte size: 10366
12:14:14 - Page size: 3
12:14:14 - Icon file not found
12:14:14 - Json not found
12:14:14 - Effect added
12:14:14 - Completed reading file

12:14:14 - ------------------------------------------
12:14:14 - Start reading effects ZD2 from folder
12:14:14 - ------------------------------------------
12:14:14 - Start reading file C:/zem/zd2_effects/160_COMP.ZD2
12:14:14 - Name: 160 Comp
12:14:14 - Effect index: 16777288
12:14:14 - IndexHex: 0x01000048
12:14:14 - Type: Dynamics
12:14:14 - Type Number: 1
12:14:14 - Version: 1.00
12:14:14 - Description: This compressor is in the style of the dbx 160A
12:14:14 - In device file name: 160_COMP.ZD2
12:14:14 - Byte size: 15907
12:14:14 - Page size: 4
12:14:14 - ZIC file not found
12:14:14 - Icon reading from file completed
12:14:14 - ZIR file not found
12:14:14 - Effect added
12:14:14 - Completed reading file