FxParameterSettingAPI_v3

FxParameterSettingAPI_v3 протокол определяет методы, которые хост-приложение обеспечивает для установки значений параметров плагина.

Это - версия 3 FxParameterSettingAPI протокол. Этот протокол был представлен в FxPlug SDK 2.0.

Плагин, которому не нужна новая функциональность, найденная в версии 3, должен просто соответствовать протоколу версии 1 или 2. Это гарантирует совместимость более старыми сменными узлами, которые не могли бы поддерживать версию 3.

Наследование

Не применимый

Соответствует

FxParameterSettingAPI_v2

Оператор импорта

Не применимый не применимый

Установка пользовательских значений параметров


    
    setCustomParameterValue:toParm:atTime:
    - setCustomParameterValue:toParm:atTime:

Требуемый

Установите значение пользовательского параметра в установленный срок. (требуемый)

Объявление

Objective C

- (BOOL)setCustomParameterValue:(id <NSCoding>)value toParm:(UInt32)parmId atTime:(double)time

Параметры

`value`	Объектное значение в данном `time`.
`parmId`	Уникальный идентификатор параметра для установки значения для.
`time`	Время, в которое можно установить значение параметра.

Возвращаемое значение

YEStrue если значение установлено успешно; иначе NOfalse.

Обсуждение

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

value объект является непрозрачным объектом, содержащим пользовательские данные, что плагину нужен документ хост-приложения хранилищу. Вы отправляете это сообщение в хост-приложение для установки непрозрачного значения.

В зависимости от хост-приложения временная стоимость может быть относительно запуска временной шкалы или к запуску клипа. См. Тип Timebase для получения дополнительной информации.

См. также

– getCustomParameterValue:fromParm:atTime: (Протокол FxParameterRetrieval_v3)


    
    setPathID:toParm:atTime:
    - setPathID:toParm:atTime:

Требуемый

Устанавливает Значение идентификатора пути для пользовательского параметра. (требуемый)

Объявление

Objective C

- (BOOL)setPathID:(FxPathID)pathID toParm:(UInt32)parmId atTime:(double)time

Параметры

`pathID`	Указанный путь ID для параметра.
`parmId`	Уникальный идентификатор параметра для установки значения для.
`time`	Время, в которое можно установить значение параметра.

Возвращаемое значение

YEStrue если путь ID установлен успешно; иначе NOfalse.