FxFilter

FxFilter протокол определяет методы, которые плагин фильтра должен реализовать для рендеринга вывода.

Фильтры являются типом плагина, берущего входное изображение, изменяющего его и производящего выходное изображение. Это отличается от генераторов, создающих вывод, не вводя никого, отображают, и переходы, берущие два изображения и перемещающиеся между ними.

Фильтры могут использоваться для цветных манипуляций, искажений, синхронизируя изменения, и многое другое.

FxFilter протокол происходит из FxBaseEffect протокол и добавляет несколько других методов, включая renderOutput:withInput:withInfo: метод, который является, где плагин фактически представляет свой эффект.

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

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

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

FxBaseEffect

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

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

Получение выходного типа телосложения


    
    getOutputWidth:height:withInput:withInfo:
    - getOutputWidth:height:withInput:withInfo:

Требуемый

Возвращает размер изображения, выведенного плагином. (требуемый)

Объявление

Objective C

- (BOOL)getOutputWidth:(NSUInteger *)width height:(NSUInteger *)height withInput:(FxImageInfo)inputInfo withInfo:(FxRenderInfo)renderInfo

Параметры

`width`	Возвраты, ссылкой, ширина выходного изображения.
`height`	Возвраты, ссылкой, ширина выходного изображения.
`inputInfo`	`FxImage` структура передала как входной параметр `renderOutput:withInput:withInfo:`.
`renderInfo`	`FxRenderInfo` структура передала как информационный параметр `renderOutput:withInput:withInfo:`.

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

YEStrue если выходной размер должным образом определяется и устанавливается в параметры ширины и высоты; NOfalse иначе.

Обсуждение

Этот метод позволяет хост-приложению получать размер выходного изображения, произведенного плагином. Приложение может тогда выделить и установить надлежащее выходное изображение для рендеринга.

Создание и рендеринг кадров


    
    frameSetup:inputInfo:hardware:software:
    - frameSetup:inputInfo:hardware:software:

Требуемый

Определяет тип изображения ввода и вывода, которого требует плагин. (требуемый)

Объявление

Objective C

- (BOOL)frameSetup:(FxRenderInfo)renderInfo inputInfo:(FxImageInfo)inputInfo hardware:(BOOL *)canRenderHardware software:(BOOL *)canRenderSoftware

Параметры

`renderInfo`	`FxRenderInfo` структура, определяющая запрос рендеринга.
`inputInfo`	Структура FxImageInfo, определяющая входное изображение.
`canRenderHardware`	Указывает, может ли кадр быть представлен в аппаратных средствах.
`canRenderSoftware`	Указывает, может ли кадр быть представлен в программном обеспечении.

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

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

Обсуждение

Приложение вызывает этот метод перед renderOutput:withInput:withInfo: метод.

frameCleanup - frameCleanup Требуемый

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

Объявление

Objective C

- (BOOL)frameCleanup

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

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

Обсуждение

Этот метод должен освободить любую память, выделенную во время установки кадра.


    
    renderOutput:withInput:withInfo:
    - renderOutput:withInput:withInfo:

Требуемый

Представляет выходное изображение. (требуемый)

Объявление

Objective C

- (BOOL)renderOutput:(FxImage *)output withInput:(FxImage *)inputImage withInfo:(FxRenderInfo)renderInfo

Параметры

`output`	Целевое изображение для окончательного результата.
`inputImage`	Входное изображение.
`renderInfo`	Информация о типе рендеринга приложение запрашивает.

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

YEStrue если выходное изображение правильно заполняется, и обработка успешна; NOfalse иначе.