Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы QuartzCore ссылка класса CIFilter

Опции
Развертывание Target:

На этой странице
Язык:

CIFilter

CIFilter класс производит a CIImage возразите, как выведено. Как правило, фильтр берет одно или более изображений, как введено. Некоторые фильтры, однако, генерируют изображение на основе других типов входных параметров. Параметры a CIFilter объект установлен и получен с помощью пар ключ/значение.

Вы используете CIFilter объект в сочетании с другими Базовыми классами Изображения, такой как CIImage, CIContext, и CIColor, использовать в своих интересах встроенные Базовые фильтры Изображения при обработке изображений, создании генераторов фильтра или записи пользовательских фильтров.

CIFilter объекты, не являются непостоянными. A CIFilter объект не может быть совместно использован безопасно среди потоков. Если его собственное, приложение многопоточно, каждый поток необходимо создать CIFilter объект. Иначе, Ваше приложение могло неожиданно вести себя.

Для получения быстрого обзора того, как установить и использовать Базовые фильтры Изображения см. Базовое Руководство по программированию Изображения.

Разделение на подклассы примечаний

Можно разделить на подклассы CIFilter для создания пользовательских эффектов фильтра:

  • Путем объединения в цепочку вместе двух или больше встроенных Базовых фильтров Изображения (iOS и OS X)

  • При помощи ядра обработки изображений, которое Вы пишете (только OS X)

См. Базовое Руководство по программированию Изображения для подробных данных.

Методы для переопределения

Независимо от того, обеспечивает ли Ваш подкласс свой эффект путем объединения в цепочку фильтров или реализации его собственного ядра, Вы должны:

  • Объявите любые входные параметры как свойства, имена которых снабжаются префиксом input, такой как inputImage.

  • Переопределите setDefaults методы для обеспечения значений по умолчанию для любых входных параметров Вы объявили.

  • Реализуйте outputImage метод для создания нового CIImage с эффектом Вашего фильтра.

Специальные замечания

CIFilter класс автоматически управляет входными параметрами при архивации, копируя и освобождая фильтры. Поэтому Ваш подкласс должен повиноваться следующим инструкциям для обеспечения правильного поведения:

  • Сохраните входные параметры в переменных экземпляра, имена которых снабжаются префиксом input.

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

    @synthesize inputMyParameter;

  • При использовании подсчета ссылки на руководство не выпускайте входные переменные экземпляра параметра в Вашем dealloc реализация метода. dealloc реализация в CIFilter класс использует кодирование значения ключа для автоматически наборов значения всех входных параметров к nil.

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

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

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

Swift

import QuartzCore

Objective C

@import QuartzCore;

Доступность

Доступный в OS X v10.4 и позже.

Создание фильтра
  • init (имя:) + filterWithName:

    Создает a CIFilter объект для определенного вида фильтра.

    Объявление

    Swift

    init!(name name: String!) -> CIFilter

    Objective C

    + (CIFilter *)filterWithName:(NSString *)name

    Параметры

    name

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

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

    A CIFilter возразите, чьи входные значения не определены.

    Обсуждение

    В OS X после создания фильтра с этим методом необходимо вызвать setDefaults или установленные параметры индивидуально путем вызова setValue:forKey:. В iOS параметры фильтра автоматически устанавливаются на значения по умолчанию.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    + filterWithName:withInputParameters:
    + filterWithName:keysAndValues:

  • init (name:withInputParameters:) + filterWithName:withInputParameters:

    Создает a CIFilter объект для определенного вида фильтра и инициализирует входные значения.

    Объявление

    Swift

    init!(name name: String!, withInputParameters params: [NSObject : AnyObject]!) -> CIFilter

    Objective C

    + (CIFilter *)filterWithName:(NSString *)name withInputParameters:(NSDictionary *)params

    Параметры

    name

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

    params

    Список пар ключ/значение для установки как входные значения в фильтр. Каждый ключ является константой, указывающей имя входного параметра для фильтра, и соответствующее значение является значением для того параметра. Посмотрите Базовую Ссылку Фильтра Изображения для встроенных фильтров и их позволенных параметров.

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

    A CIFilter возразите, чьи входные значения инициализируются.

    Обсуждение

    Используйте этот метод, чтобы быстро создать и сконфигурировать a CIFilter экземпляр, как в примере ниже.

    • CIFilter *f = [CIFilter filterWithName: @"CIColorControls"
    • withInputParameters: @{
    • @"inputImage" : inImage,
    • @"inputSaturation" : @0.5,
    • @"inputBrightness" : @1.2,
    • @"inputContrast" : @1.3
    • }];

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.10 и позже.

    См. также

    + filterWithName:

  • filterWithName:keysAndValues: + filterWithName:keysAndValues:

    Создает a CIFilter объект для определенного вида фильтра и инициализирует входные значения с a nil- завершенный список параметров.

    Объявление

    Objective C

    + (CIFilter *)filterWithName:(NSString *)name keysAndValues:(id)key0, ...

    Параметры

    name

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

    key0,...

    Список пар ключ/значение для установки как входные значения в фильтр. Каждый ключ является константой, которая указывает имя входного значения для установки и должна сопровождаться значением. Вы сигнализируете конец списка путем передачи a nil значение.

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

    A CIFilter возразите, чьи входные значения инициализируются.

    Обсуждение

    Как со всеми принимающими методами Objective C nil- завершенные списки аргументов, для предотвращения непреднамеренного поведения, которое необходимо взять, заботятся для не передачи a nil значение перед намеченным концом списка аргументов. Можно избежать таких проблем при помощи filterWithName:withInputParameters: метод для создания фильтра, выражая список параметров как литерал словаря.

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

    Objective C

    @import QuartzCore;

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    + filterWithName:
    + filterWithName:withInputParameters:

Создание фильтра от изображения RAW
  • init (imageData:options:) + filterWithImageData:options:

    Возвраты a CIFilter объект, инициализированный с данными изображения RAW, предоставленными методу.

    Объявление

    Swift

    init!(imageData data: NSData!, options options: [NSObject : AnyObject]!) -> CIFilter

    Objective C

    + (CIFilter *)filterWithImageData:(NSData *)data options:(NSDictionary *)options

    Параметры

    data

    Данные изображения RAW для инициализации объекта с.

    options

    Словарь опций. Можно передать любой из ключей, определенных в “RAW Image Options” вместе с надлежащим значением. Необходимо обеспечить исходный ключ подсказки идентификатора типа (kCGImageSourceTypeIdentifierHint) и значение типа соответствующего источника, чтобы помочь декодеру определить тип файла. Иначе возможно получить неправильные результаты. Посмотрите Обсуждение для примера

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

    A CIFilter объект.

    Обсуждение

    После вызова этого метода, CIFilter возразите возвращает a CIImage объект, должным образом обрабатывающийся подобный изображениям, полученным с помощью outputImage ключ.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    + filterWithImageURL:options:

  • init (imageURL:options:) + filterWithImageURL:options:

    Возвраты a CIFilter объект инициализируется с данными от файла образа RAW.

    Объявление

    Swift

    init!(imageURL url: NSURL!, options options: [NSObject : AnyObject]!) -> CIFilter

    Objective C

    + (CIFilter *)filterWithImageURL:(NSURL *)url options:(NSDictionary *)options

    Параметры

    url

    Расположение файла образа RAW.

    options

    Словарь опций. Можно передать любой из ключей, определенных в “RAW Image Options”.

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

    A CIFilter объект.

    Обсуждение

    После вызова этого метода, CIFilter возразите возвращает a CIImage объект, должным образом обрабатывающийся подобный изображениям, полученным с помощью outputImage ключ.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    + filterWithImageData:options:

Доступ к зарегистрированным фильтрам
  • filterNamesInCategories (_:) + filterNamesInCategories:

    Возвращает массив всех опубликованных имен фильтра, соответствующих все указанные категории.

    Объявление

    Swift

    class func filterNamesInCategories(_ categories: [AnyObject]!) -> [AnyObject]!

    Objective C

    + (NSArray *)filterNamesInCategories:(NSArray *)categories

    Параметры

    categories

    Один или больше ключей категории фильтра определяется в Ключах Категории Фильтра. Передача nil получить все просачивается все категории.

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

    Массив, содержащий все опубликованные имена фильтра, соответствующие все категории, указанные categories параметр.

    Обсуждение

    При передаче больше чем одной категории фильтра этот метод возвращает пересечение фильтров в категориях. Например, если Вы передаете категории kCICategoryBuiltIn и kCICategoryColorAdjustment, Вы получаете все фильтры, которые являются элементами и категорий встроенной и настройки цвета. Но если Вы передаете в kCICategoryGenerator и kCICategoryStylize, Вы не доберетесь, любые фильтры возвратились к Вам, потому что нет никаких фильтров, которые являются элементами обоих генератор и стилизовали категории. Если Вы хотите получить, все стилизовали и фильтры генератора, необходимо вызвать filterNamesInCategories: метод для каждой категории отдельно и затем объединяет результаты.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    + filterNamesInCategory:

  • filterNamesInCategory (_:) + filterNamesInCategory:

    Возвращает массив всех опубликованных имен фильтра в указанной категории.

    Объявление

    Swift

    class func filterNamesInCategory(_ category: String!) -> [AnyObject]!

    Objective C

    + (NSArray *)filterNamesInCategory:(NSString *)category

    Параметры

    category

    Строковый объект, указывающий одну из категорий фильтра, определенных в Ключах Категории Фильтра.

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

    Массив, содержащий все опубликованные имена фильтра в категории.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    + filterNamesInCategories:

Регистрация фильтра
  • registerFilterName (_: constructor:classAttributes:) + registerFilterName:constructor:classAttributes:

    Публикует пользовательский фильтр, не упаковывающийся как модуль изображения.

    Объявление

    Swift

    class func registerFilterName(_ name: String!, constructor anObject: CIFilterConstructor!, classAttributes attributes: [NSObject : AnyObject]!)

    Objective C

    + (void)registerFilterName:(NSString *)name constructor:(id<CIFilterConstructor>)anObject classAttributes:(NSDictionary *)attributes

    Параметры

    name

    Строковый объект, указывающий имя фильтра, который Вы хотите опубликовать.

    anObject

    Объект конструктора, реализующий filterWithName метод.

    attributes

    Словарь, содержащий имя дисплея класса и атрибуты категорий фильтра вместе с надлежащим значением для каждого, приписывает. Т.е. kCIAttributeFilterDisplayName атрибут и строка, указывающая имя дисплея, и kCIAttributeFilterCategories и массив, указывающий категории, которым принадлежит фильтр (такой как kCICategoryStillImage и kCICategoryDistortionEffect). Все другие атрибуты для фильтра должны быть возвращены пользовательским attributes реализация метода фильтром.

    Обсуждение

    В большинстве случаев Вы не должны использовать этот метод, потому что предпочтительный способ зарегистрировать пользовательский фильтр, который Вы пишете, состоит в том, чтобы упаковать его как модуль изображения. Вы не должны использовать этот метод для фильтра, упакованного как модуль изображения, потому что Вы регистрируете свой фильтр с помощью CIPlugInRegistration протокол. (См. Базовое Руководство по программированию Изображения для дополнительных подробных данных.)

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

Получение параметров фильтра и атрибутов
  • имя имя Свойство

    Имя связалось с фильтром.

    Объявление

    Swift

    var name: String!

    Objective C

    @property(copy) NSString *name

    Обсуждение

    Когда фильтр присоединен к Базовому Слою анимации, Вы используете имя фильтра для построения ключевых путей к его атрибутам. Например, если a CALayer объект имеет присоединенный CIFilter экземпляр, имя которого myExposureFilter, можно обратиться к атрибутам фильтра с помощью ключевого пути такой как filters.myExposureFilter.inputEV. Анимации уровня могут также получить доступ к атрибутам фильтра через эти ключевые пути.

    Значение по умолчанию для этого свойства nil.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • атрибуты () - атрибуты

    Возвращает словарь пар ключ/значение, описывающих фильтр.

    Объявление

    Swift

    func attributes() -> [NSObject : AnyObject]!

    Objective C

    - (NSDictionary *)attributes

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

    Словарь, содержащий ключ для каждого параметра ввода и вывода для фильтра. Каждый ключ является словарем, содержащим все атрибуты параметра ввода или вывода.

    Обсуждение

    Например, словарь атрибутов для CIColorControls фильтр содержит следующую информацию:

    • CIColorControls:
    • {
    • CIAttributeFilterCategories = (
    • CICategoryColorAdjustment,
    • CICategoryVideo,
    • CICategoryStillImage,
    • CICategoryInterlaced,
    • CICategoryNonSquarePixels,
    • CICategoryBuiltIn
    • );
    • CIAttributeFilterDisplayName = "Color Controls";
    • CIAttributeFilterName = CIColorControls;
    • inputBrightness = {
    • CIAttributeClass = NSNumber;
    • CIAttributeDefault = 0;
    • CIAttributeIdentity = 0;
    • CIAttributeMin = -1;
    • CIAttributeSliderMax = 1;
    • CIAttributeSliderMin = -1;
    • CIAttributeType = CIAttributeTypeScalar;
    • };
    • inputContrast = {
    • CIAttributeClass = NSNumber;
    • CIAttributeDefault = 1;
    • CIAttributeIdentity = 1;
    • CIAttributeMin = 0.25;
    • CIAttributeSliderMax = 4;
    • CIAttributeSliderMin = 0.25;
    • CIAttributeType = CIAttributeTypeScalar;
    • };
    • inputImage = {CIAttributeClass = CIImage; };
    • inputSaturation = {
    • CIAttributeClass = NSNumber;
    • CIAttributeDefault = 1;
    • CIAttributeIdentity = 1;
    • CIAttributeMin = 0;
    • CIAttributeSliderMax = 3;
    • CIAttributeSliderMin = 0;
    • CIAttributeType = CIAttributeTypeScalar;
    • };
    • outputImage = {CIAttributeClass = CIImage; };
    • }

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

  • inputKeys () - inputKeys

    Возвращает массив, содержащий имена входных параметров к фильтру.

    Объявление

    Swift

    func inputKeys() -> [AnyObject]!

    Objective C

    - (NSArray *)inputKeys

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

    Массив, содержащий имена всех входных параметров к фильтру.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

  • outputKeys () - outputKeys

    Возвращает массив, содержащий имена выходных параметров для фильтра.

    Объявление

    Swift

    func outputKeys() -> [AnyObject]!

    Objective C

    - (NSArray *)outputKeys

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

    Массив, содержащий имена всех выходных параметров от фильтра.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

  • outputImage outputImage Свойство

    Возвраты a CIImage объект, инкапсулирующий операции, сконфигурированные в фильтре. (только для чтения)

    Объявление

    Swift

    var outputImage: CIImage! { get }

    Objective C

    @property(readonly, nonatomic) CIImage *outputImage

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.10 и позже.

Установка значений по умолчанию
  • setDefaults () - setDefaults

    Наборы все входные значения для фильтра к значениям по умолчанию.

    Объявление

    Swift

    func setDefaults()

    Objective C

    - (void)setDefaults

    Обсуждение

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

Применение фильтра
  • применяйтесь (_: arguments:options:) - apply:arguments:options:

    Производит a CIImage объект путем применения параметров ядру функционирует и использования опций управлять, как оценена функция ядра.

    Объявление

    Swift

    func apply(_ k: CIKernel!, arguments args: [AnyObject]!, options dict: [NSObject : AnyObject]!) -> CIImage!

    Objective C

    - (CIImage *)apply:(CIKernel *)k arguments:(NSArray *)args options:(NSDictionary *)dict

    Параметры

    k

    A CIKernel объект, содержащий функцию ядра.

    args

    Параметры, которые являются типом, совместимым с функциональной подписью функции ядра.

    dict

    Словарь, содержащий опции (пары ключ/значение), чтобы управлять, как оценена функция ядра.

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

    CIImage объект производится фильтром.

    Обсуждение

    При реализации пользовательского фильтра этот метод нужно вызвать из outputImage метод для применения ядра функционирует к CIImage объект. Можно передать любой из ключей, определенных в “Options for Applying a Filter”, вместе с надлежащими значениями, в словарь опций.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    – применяйтесь:

  • применяйтесь: - применяйтесь:

    Производит a CIImage объект путем применения функции ядра.

    Объявление

    Objective C

    - (CIImage *)apply:(CIKernel *)k,

    Параметры

    k

    A CIKernel объект, содержащий функцию ядра.

    Список параметров для предоставления к функции ядра. Переданные аргументы должны быть совместимы с типом с функциональной подписью функции ядра. Список параметров должен быть завершен nil объект.

    Обсуждение

    При реализации пользовательского фильтра этот метод нужно вызвать из outputImage метод для применения ядра функционирует к CIImage объект. Например, если функция ядра имеет эту подпись:

    • kernel vec4 brightenEffect (sampler src, float k)

    Вы предоставили бы два параметра после k параметр apply:k, .. метод. В этом случае первым параметром должен быть сэмплер и второе значение с плавающей точкой. Для получения дополнительной информации о ядрах посмотрите Базовую Ссылку Языка Ядра Изображения.

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

    Objective C

    @import QuartzCore;

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    – apply:arguments:options:

Получение локализованной информации для зарегистрированных фильтров
  • localizedNameForFilterName (_:) + localizedNameForFilterName:

    Возвращает локализованное имя для указанного имени фильтра.

    Объявление

    Swift

    class func localizedNameForFilterName(_ filterName: String!) -> String!

    Objective C

    + (NSString *)localizedNameForFilterName:(NSString *)filterName

    Параметры

    filterName

    Имя фильтра.

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

    Локализованное имя для фильтра.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

  • localizedNameForCategory (_:) + localizedNameForCategory:

    Возвращает локализованное имя для указанной категории фильтра.

    Объявление

    Swift

    class func localizedNameForCategory(_ category: String!) -> String!

    Objective C

    + (NSString *)localizedNameForCategory:(NSString *)category

    Параметры

    category

    Категория фильтра.

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

    Локализованное имя для категории фильтра.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.4 и позже.

  • localizedDescriptionForFilterName (_:) + localizedDescriptionForFilterName:

    Возвращает локализованное описание фильтра для дисплея в пользовательском интерфейсе.

    Объявление

    Swift

    class func localizedDescriptionForFilterName(_ filterName: String!) -> String!

    Objective C

    + (NSString *)localizedDescriptionForFilterName:(NSString *)filterName

    Параметры

    filterName

    Имя фильтра.

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

    Локализованное описание фильтра.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • localizedReferenceDocumentationForFilterName (_:) + localizedReferenceDocumentationForFilterName:

    Возвращает расположение локализованной справочной документации, описывающей фильтр.

    Объявление

    Swift

    class func localizedReferenceDocumentationForFilterName(_ filterName: String!) -> NSURL!

    Objective C

    + (NSURL *)localizedReferenceDocumentationForFilterName:(NSString *)filterName

    Параметры

    filterName

    Имя фильтра.

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

    URL, указывающий расположение локализованной документации, или nil если фильтр не обеспечивает локализованную справочную документацию.

    Обсуждение

    URL может быть локальным файлом или удаленным документом о веб-сервере. Поскольку могли возвратиться фильтры, создаваемые до OS X v10.5 nil, необходимо быть, удостоверяются, что код обрабатывает этот случай корректно.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.5 и позже.

Используя фильтры с базовой анимацией
  • включенный включенный Свойство

    Булево значение, определяющее, включен ли фильтр. Animatable.

    Объявление

    Swift

    var enabled: Bool

    Objective C

    @property(getter=isEnabled) BOOL enabled

    Обсуждение

    Когда это свойство установлено в, фильтр применяется к его вводу YEStrue (значение по умолчанию).

    Используйте это свойство в сочетании с name свойство при присоединении фильтров к Базовым Слоям анимации и доступе или анимации свойств фильтра посредством анимаций значения ключа.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.5 и позже.

Создание представления конфигурации для фильтра
  • viewForUIConfiguration (_: excludedKeys:) - viewForUIConfiguration:excludedKeys:

    Возвращает представление фильтра для фильтра.

    Объявление

    Swift

    func viewForUIConfiguration(_ inUIConfiguration: [NSObject : AnyObject]!, excludedKeys inKeys: [AnyObject]!) -> IKFilterUIView!

    Objective C

    - (IKFilterUIView *)viewForUIConfiguration:(NSDictionary *)inUIConfiguration excludedKeys:(NSArray *)inKeys

    Параметры

    inUIConfiguration

    Словарь, содержащий значения для IKUISizeFlavor и kCIUIParameterSet ключи. Для позволенных значений для IKUISizeFlavor ключ, посмотрите Опции Пользовательского интерфейса. Для позволенных значений для kCIUIParameterSet ключ, посмотрите Опции Управления пользовательским интерфейсом.

    inKeys

    Массив входных ключей, для которых Вы не хотите обеспечивать пользовательский интерфейс. Передача nil если Вы хотите, чтобы все входные ключи были представлены в пользовательском интерфейсе.

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

    IKFilterUIView объект.

    Обсуждение

    Вызов этого метода для получения представления для фильтра вызывает CIFilter класс для вызова provideViewForUIConfiguration:excludedKeys: метод. Если Вы переопределяете provideViewForUIConfiguration:excludedKeys: пользовательский интерфейс создается Вашим подклассом фильтра. Иначе, Базовое Изображение автоматически генерирует пользовательский интерфейс на основе ключей фильтра и атрибутов.

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

    Когда Вы запрашиваете пользовательский интерфейс на набор параметра, все ключи для того набора и ниже включены. Например, усовершенствованный набор состоит из всех параметров в основных, промежуточных и усовершенствованных наборах. Набор разработки должен содержать параметры, которые или экспериментальны или для отладки целей. Необходимо использовать их только во время разработки фильтров и клиентских приложений, а не в поставляющем продукте.

    Средства управления в представлении используют привязку для установки значений фильтра. Посмотрите, что Привязка Какао Программирует Темы, если Вы незнакомы с привязкой.

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

    Objective C

    @import Quartz;

    Swift

    import Quartz

    Доступность

    Доступный в OS X v10.5 и позже.

Сериализация и десериализация фильтров
  • serializedXMPFromFilters (_: inputImageExtent:) + serializedXMPFromFilters:inputImageExtent:

    Сериализирует параметры фильтра в форму XMP, подходящую для встраивания в изображение.

    Объявление

    Swift

    class func serializedXMPFromFilters(_ filters: [AnyObject]!, inputImageExtent extent: CGRect) -> NSData!

    Objective C

    + (NSData *)serializedXMPFromFilters:(NSArray *)filters inputImageExtent:(CGRect)extent

    Параметры

    filters

    Массив фильтров для сериализации. Посмотрите Обсуждение для фильтров, которые могут быть сериализированы.

    extent

    Степень ввода отображает к фильтру.

    Обсуждение

    В это время единственные классы фильтров, которые могут быть сериализированы с помощью этого метода, CIAffineTransform, CICrop и фильтры, возвращенные CIImage методы autoAdjustmentFilters и autoAdjustmentFiltersWithOptions:. Параметры других классов фильтра не будут сериализированы.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.9 и позже.

  • filterArrayFromSerializedXMP (_: inputImageExtent:error:) + filterArrayFromSerializedXMP:inputImageExtent:error:

    Возвращает массив объектов фильтра, десериализованных от данных XMP.

    Объявление

    Swift

    class func filterArrayFromSerializedXMP(_ xmpData: NSData!, inputImageExtent extent: CGRect, error outError: NSErrorPointer) -> [AnyObject]!

    Objective C

    + (NSArray *)filterArrayFromSerializedXMP:(NSData *)xmpData inputImageExtent:(CGRect)extent error:(NSError **)outError

    Параметры

    xmpData

    Данные XMP, создаваемые ранее путем вызова serializedXMPFromFilters:inputImageExtent:.

    extent

    Степень изображения, из которого были извлечены данные XMP.

    outError

    Адрес NSError объект для получения ошибок, иначе nil.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

    Доступный в OS X v10.9 и позже.

Новые методы

Константы
  • Ключи атрибута фильтра

    Атрибуты для фильтра и его параметров.

    Объявление

    Swift

    var kCIAttributeFilterName: NSString! var kCIAttributeFilterDisplayName: NSString! var kCIAttributeDescription: NSString! var kCIAttributeReferenceDocumentation: NSString! var kCIAttributeFilterCategories: NSString! var kCIAttributeClass: NSString! var kCIAttributeType: NSString! var kCIAttributeMin: NSString! var kCIAttributeMax: NSString! var kCIAttributeSliderMin: NSString! var kCIAttributeSliderMax: NSString! var kCIAttributeDefault: NSString! var kCIAttributeIdentity: NSString! var kCIAttributeName: NSString! var kCIAttributeDisplayName: NSString!

    Objective C

    NSString *kCIAttributeFilterName; NSString *kCIAttributeFilterDisplayName; NSString *kCIAttributeDescription; NSString *kCIAttributeReferenceDocumentation; NSString *kCIAttributeFilterCategories; NSString *kCIAttributeClass; NSString *kCIAttributeType; NSString *kCIAttributeMin; NSString *kCIAttributeMax; NSString *kCIAttributeSliderMin; NSString *kCIAttributeSliderMax; NSString *kCIAttributeDefault; NSString *kCIAttributeIdentity; NSString *kCIAttributeName; NSString *kCIAttributeDisplayName;

    Константы

    • kCIAttributeFilterName

      kCIAttributeFilterName

      Имя фильтра, указанное как NSString объект.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeFilterDisplayName

      kCIAttributeFilterDisplayName

      Локализованная версия имени фильтра, выведенного на экран в пользовательском интерфейсе.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeDescription

      kCIAttributeDescription

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

      Доступный в OS X v10.5 и позже.

    • kCIAttributeReferenceDocumentation

      kCIAttributeReferenceDocumentation

      Локализованная справочная документация для фильтра. Ссылка должна предоставить разработчикам технические детали.

      Доступный в OS X v10.5 и позже.

    • kCIAttributeFilterCategories

      kCIAttributeFilterCategories

      Массив ключей категории фильтра, указывающий все категории, в которых фильтр является элементом.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeClass

      kCIAttributeClass

      Имя класса фильтра.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeType

      kCIAttributeType

      Один из типов атрибута описан в Атрибутах Типа данных.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeMin

      kCIAttributeMin

      Минимальное значение для параметра фильтра, указанного как значение с плавающей точкой.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeMax

      kCIAttributeMax

      Максимальное значение для параметра фильтра, указанного как значение с плавающей точкой.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeSliderMin

      kCIAttributeSliderMin

      Минимальное значение, указанное как значение с плавающей точкой, для использования для ползунка, управляющего входными значениями для параметра фильтра.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeSliderMax

      kCIAttributeSliderMax

      Максимальное значение, указанное как значение с плавающей точкой, для использования для ползунка, управляющего входными значениями для параметра фильтра.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeDefault

      kCIAttributeDefault

      Значение по умолчанию, указанное как значение с плавающей точкой, для параметра фильтра.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeIdentity

      kCIAttributeIdentity

      Если предоставлено как значение для параметра, параметр не имеет никакого эффекта на входное изображение.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeName

      kCIAttributeName

      Имя атрибута.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeDisplayName

      kCIAttributeDisplayName

      Локализованное имя дисплея атрибута.

      Доступный в OS X v10.4 и позже.

    Обсуждение

    Ключи атрибута используются для словаря атрибута фильтра. Большинство записей в словаре атрибута является дополнительным. Атрибут kCIAttributeFilterName обязательно. Для параметра, атрибута kCIAttributeClass обязательно, потому что это указывает имя класса фильтра.

    Параметр типа NSNumber не обязательно нуждается в атрибутах kCIAttributeMin и kCIAttributeMax. Когда параметр не имеет никаких верхних или нижних границ, эти атрибуты не присутствуют. Например, Гауссов фильтр размытия имеет параметр радиуса с минимумом 0 но никакое максимальное значение, чтобы указать, что все неотрицательные значения допустимы.

  • Атрибуты типа данных

    Типы числовых данных.

    Объявление

    Swift

    var kCIAttributeTypeTime: NSString! var kCIAttributeTypeScalar: NSString! var kCIAttributeTypeDistance: NSString! var kCIAttributeTypeAngle: NSString! var kCIAttributeTypeBoolean: NSString! var kCIAttributeTypeInteger: NSString! var kCIAttributeTypeCount: NSString!

    Objective C

    NSString *kCIAttributeTypeTime; NSString *kCIAttributeTypeScalar; NSString *kCIAttributeTypeDistance; NSString *kCIAttributeTypeAngle; NSString *kCIAttributeTypeBoolean; NSString *kCIAttributeTypeInteger; NSString *kCIAttributeTypeCount;

    Константы

    • kCIAttributeTypeTime

      kCIAttributeTypeTime

      Параметрическое время для переходов, указанных как значение с плавающей точкой в диапазоне 0.0 к 1.0.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeTypeScalar

      kCIAttributeTypeScalar

      Скалярное значение.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeTypeDistance

      kCIAttributeTypeDistance

      Расстояние.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeTypeAngle

      kCIAttributeTypeAngle

      Угол.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeTypeBoolean

      kCIAttributeTypeBoolean

      Булево значение.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeTypeInteger

      kCIAttributeTypeInteger

      Целочисленное значение.

      Доступный в OS X v10.5 и позже.

    • kCIAttributeTypeCount

      kCIAttributeTypeCount

      Положительное целочисленное значение.

      Доступный в OS X v10.5 и позже.

  • Векторные атрибуты количества

    Векторные типы данных.

    Объявление

    Swift

    var kCIAttributeTypePosition: NSString! var kCIAttributeTypeOffset: NSString! var kCIAttributeTypePosition3: NSString! var kCIAttributeTypeRectangle: NSString!

    Objective C

    NSString *kCIAttributeTypePosition; NSString *kCIAttributeTypeOffset; NSString *kCIAttributeTypePosition3; NSString *kCIAttributeTypeRectangle

    Константы

    • kCIAttributeTypePosition

      kCIAttributeTypePosition

      Двумерное расположение в рабочем координатном пространстве. (Тип вектора с 2 элементами.)

      Доступный в OS X v10.4 и позже.

    • kCIAttributeTypeOffset

      kCIAttributeTypeOffset

      Смещение. (Тип вектора с 2 элементами.)

      Доступный в OS X v10.4 и позже.

    • kCIAttributeTypePosition3

      kCIAttributeTypePosition3

      Трехмерное расположение в рабочем координатном пространстве. (Тип вектора с 3 элементами.)

      Доступный в OS X v10.4 и позже.

    • kCIAttributeTypeRectangle

      kCIAttributeTypeRectangle

      Базовый вектор Изображения, указывающий значения x и y прямоугольного источника и ширину (w) и высота (h) прямоугольника. Вектор принимает форму [x, y, w, h]. (Тип вектора с 4 элементами.)

      Доступный в OS X v10.4 и позже.

  • Ключи атрибута цвета

    Типы цвета.

    Объявление

    Swift

    var kCIAttributeTypeOpaqueColor: NSString! var kCIAttributeTypeGradient: NSString!

    Objective C

    NSString *kCIAttributeTypeOpaqueColor; NSString *kCIAttributeTypeGradient;

    Константы

    • kCIAttributeTypeOpaqueColor

      kCIAttributeTypeOpaqueColor

      Базовый цвет изображения (CIColor объект), который указывает красные, зеленые, и синие значения компонентов. Используйте этот ключ для цветов без альфа-компонента. Если ключ не существует, Базовое Изображение принимает цвет с альфой.

      Доступный в OS X v10.4 и позже.

    • kCIAttributeTypeGradient

      kCIAttributeTypeGradient

      N-1 изображение градиента раньше описывало шкалу цветов.

      Доступный в OS X v10.4 и позже.

  • Ключи категории фильтра

    Категории фильтров.

    Объявление

    Swift

    var kCICategoryDistortionEffect: NSString! var kCICategoryGeometryAdjustment: NSString! var kCICategoryCompositeOperation: NSString! var kCICategoryHalftoneEffect: NSString! var kCICategoryColorAdjustment: NSString! var kCICategoryColorEffect: NSString! var kCICategoryTransition: NSString! var kCICategoryTileEffect: NSString! var kCICategoryGenerator: NSString! var kCICategoryReduction: NSString! var kCICategoryGradient: NSString! var kCICategoryStylize: NSString! var kCICategorySharpen: NSString! var kCICategoryBlur: NSString! var kCICategoryVideo: NSString! var kCICategoryStillImage: NSString! var kCICategoryInterlaced: NSString! var kCICategoryNonSquarePixels: NSString! var kCICategoryHighDynamicRange: NSString! var kCICategoryBuiltIn: NSString! var kCICategoryFilterGenerator: NSString!

    Objective C

    NSString *kCICategoryDistortionEffect; NSString *kCICategoryGeometryAdjustment; NSString *kCICategoryCompositeOperation; NSString *kCICategoryHalftoneEffect; NSString *kCICategoryColorAdjustment; NSString *kCICategoryColorEffect; NSString *kCICategoryTransition; NSString *kCICategoryTileEffect; NSString *kCICategoryGenerator; NSString *kCICategoryReduction; NSString *kCICategoryGradient; NSString *kCICategoryStylize; NSString *kCICategorySharpen; NSString *kCICategoryBlur; NSString *kCICategoryVideo; NSString *kCICategoryStillImage; NSString *kCICategoryInterlaced; NSString *kCICategoryNonSquarePixels; NSString *kCICategoryHighDynamicRange ; NSString *kCICategoryBuiltIn; NSString *kCICategoryFilterGenerator;

    Константы

    • kCICategoryDistortionEffect

      kCICategoryDistortionEffect

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

      Доступный в OS X v10.4 и позже.

    • kCICategoryGeometryAdjustment

      kCICategoryGeometryAdjustment

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

      Доступный в OS X v10.4 и позже.

    • kCICategoryCompositeOperation

      kCICategoryCompositeOperation

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

      Доступный в OS X v10.4 и позже.

    • kCICategoryHalftoneEffect

      kCICategoryHalftoneEffect

      Фильтр, моделирующий множество полутоновых экранов, для имитации полутонового процесса, используемого в печатных СМИ. Вывод этих фильтров имеет знакомый «газетный» вид различных растров. Фильтры обычно называют в честь образца, создаваемого виртуальным полутоновым экраном, таким как круговой экран, или заштриховали экран.

      Доступный в OS X v10.4 и позже.

    • kCICategoryColorAdjustment

      kCICategoryColorAdjustment

      Фильтр, изменяющий значения цвета. Фильтры цветокоррекции используются, чтобы устранить цветовые оттенки, скорректировать оттенок, и корректную яркость и контраст. Фильтры цветокоррекции не выполняют управление цветом; ColorSync выполняет управление цветом. Можно использовать Кварц, 2D для указания цветового пространства, связанного с изображением. Для получения дополнительной информации см. Обзор управления цветом и Кварц 2D Руководство по программированию.

      Доступный в OS X v10.4 и позже.

    • kCICategoryColorEffect

      kCICategoryColorEffect

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

      Доступный в OS X v10.4 и позже.

    • kCICategoryTransition

      kCICategoryTransition

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

      Доступный в OS X v10.4 и позже.

    • kCICategoryTileEffect

      kCICategoryTileEffect

      Фильтр, обычно применяющий эффект к изображению и затем создающий уменьшенные варианты изображения (мозаики), тогда размечающиеся для создания образца, это бесконечно в степени.

      Доступный в OS X v10.4 и позже.

    • kCICategoryGenerator

      kCICategoryGenerator

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

      Доступный в OS X v10.4 и позже.

    • kCICategoryReduction

      kCICategoryReduction

      Фильтр, сокращающий данные изображения. Эти фильтры используются для решения проблем анализа изображения.

      Доступный в OS X v10.5 и позже.

    • kCICategoryGradient

      kCICategoryGradient

      Фильтр, генерирующий заливку, цвет которой варьируется гладко. Точно то, как цвет варьируется, зависит от типа градиента — линейный, радиальный, или Гауссов.

      Доступный в OS X v10.4 и позже.

    • kCICategoryStylize

      kCICategoryStylize

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

      Доступный в OS X v10.4 и позже.

    • kCICategorySharpen

      kCICategorySharpen

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

      Доступный в OS X v10.4 и позже.

    • kCICategoryBlur

      kCICategoryBlur

      Фильтр, смягчающий изображения, уменьшая контраст между краями в изображении. Примеры фильтров размытия являются Гауссовой размытостью и масштабируют размытость.

      Доступный в OS X v10.4 и позже.

    • kCICategoryVideo

      kCICategoryVideo

      Фильтр, работающий над видеоизображениями.

      Доступный в OS X v10.4 и позже.

    • kCICategoryStillImage

      kCICategoryStillImage

      Фильтр, работающий над неподвижными изображениями.

      Доступный в OS X v10.4 и позже.

    • kCICategoryInterlaced

      kCICategoryInterlaced

      Фильтр, работающий над чересстрочными изображениями.

      Доступный в OS X v10.4 и позже.

    • kCICategoryNonSquarePixels

      kCICategoryNonSquarePixels

      Фильтр, работающий над неквадратными пикселями.

      Доступный в OS X v10.4 и позже.

    • kCICategoryHighDynamicRange

      kCICategoryHighDynamicRange

      Фильтр, работающий над пикселями расширенного динамического диапазона.

      Доступный в OS X v10.4 и позже.

    • kCICategoryBuiltIn

      kCICategoryBuiltIn

      Фильтр, предоставленный Базовым Изображением. Это отличает встроенные фильтры от сменных фильтров.

      Доступный в OS X v10.4 и позже.

    • kCICategoryFilterGenerator

      kCICategoryFilterGenerator

      Фильтр, создаваемый путем объединения в цепочку нескольких фильтров вместе и затем упакованный как a CIFilterGenerator объект.

      Доступный в OS X v10.5 и позже.

  • Опции для применения фильтра

    Опции, управляющие применением пользовательского Базового фильтра Изображения.

    Объявление

    Swift

    var kCIApplyOptionExtent: NSString! var kCIApplyOptionDefinition: NSString! var kCIApplyOptionUserInfo: NSString! var kCIApplyOptionColorSpace: NSString!

    Objective C

    NSString *kCIApplyOptionExtent; NSString *kCIApplyOptionDefinition; NSString *kCIApplyOptionUserInfo; NSString *kCIApplyOptionColorSpace;

    Константы

    • kCIApplyOptionExtent

      kCIApplyOptionExtent

      Размер произведенного изображения. Присваиваемое значение является массивом с четырьмя элементами (NSArray) это указывает x-значение прямоугольного источника, y-значение прямоугольного источника, и ширину и высоту.

      Доступный в OS X v10.4 и позже.

    • kCIApplyOptionDefinition

      kCIApplyOptionDefinition

      Домен определения (DOD) произведенного изображения. Присваиваемое значение является или Базовой формой фильтра Изображения или массивом с четырьмя элементами (NSArray) это указывает прямоугольник.

      Доступный в OS X v10.4 и позже.

    • kCIApplyOptionUserInfo

      kCIApplyOptionUserInfo

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

      Доступный в OS X v10.4 и позже.

    • kCIApplyOptionColorSpace

      kCIApplyOptionColorSpace

      Цветовое пространство произведенного изображения. Присваиваемым значением должен быть RGB CGColorSpaceRef объект. Если не указанный, вывод ядра находится в рабочем цветовом пространстве Базового контекста Изображения, используемого для рендеринга изображения.

      Доступный в OS X v10.4 и позже.

    Обсуждение

    Используйте эти константы только при создании пользовательского фильтра, для которого Вы пишете ядро. Для получения дополнительной информации см. Базовое Руководство по программированию Изображения. Пример при создании пользовательского фильтра показывает, как использовать эти опции.

  • Опции управления пользовательским интерфейсом

    Наборы средств управления для различных пользовательских сценариев.

    Объявление

    Swift

    var kCIUIParameterSet: NSString! var kCIUISetBasic: NSString! var kCIUISetIntermediate: NSString! var kCIUISetAdvanced: NSString! var kCIUISetDevelopment: NSString!

    Objective C

    NSString *kCIUIParameterSet; NSString *kCIUISetBasic; NSString *kCIUISetIntermediate; NSString *kCIUISetAdvanced; NSString *kCIUISetDevelopment;

    Константы

    • kCIUIParameterSet

      kCIUIParameterSet

      Набор входных параметров для использования. Присваиваемое значение может быть kCIUISetBasic, kCIUISetIntermediate, kCIUISetAdvanced, или kCIUISetDevelopment.

      Доступный в OS X v10.5 и позже.

    • kCIUISetBasic

      kCIUISetBasic

      Средства управления, которые являются подходящими для сценария рядового пользователя, т.е. минимума настроек для управления фильтром.

      Доступный в OS X v10.5 и позже.

    • kCIUISetIntermediate

      kCIUISetIntermediate

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

      Доступный в OS X v10.5 и позже.

    • kCIUISetAdvanced

      kCIUISetAdvanced

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

      Доступный в OS X v10.5 и позже.

    • kCIUISetDevelopment

      kCIUISetDevelopment

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

      Доступный в OS X v10.5 и позже.

    Обсуждение

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

  • Опции пользовательского интерфейса

    Ключи или значения для размера входного параметра управляют для представления фильтра.

    Объявление

    Swift

    var IKUISizeFlavor: NSString! var IKUISizeMini: NSString! var IKUISizeSmall: NSString! var IKUISizeRegular: NSString! var IKUImaxSize: NSString! var IKUIFlavorAllowFallback: NSString!

    Objective C

    NSString *IKUISizeFlavor; NSString *IKUISizeMini; NSString *IKUISizeSmall; NSString *IKUISizeRegular; NSString *IKUImaxSize; NSString *IKUIFlavorAllowFallback;

    Константы

    • IKUISizeFlavor

      IKUISizeFlavor

      Ключ для размера средств управления в представлении фильтра. Присваиваемое значение может быть IKUISizeMini, IKUISizeSmall, или IKUISizeRegular.

      Доступный в OS X v10.5 и позже.

    • IKUISizeMini

      IKUISizeMini

      Средства управления, размер которых NSMiniControlSize.

      Доступный в OS X v10.5 и позже.

    • IKUISizeSmall

      IKUISizeSmall

      Средства управления, размер которых NSSmallControlSize.

      Доступный в OS X v10.5 и позже.

    • IKUISizeRegular

      IKUISizeRegular

      Средства управления, размер которых NSRegularControlSize.

      Доступный в OS X v10.5 и позже.

    • IKUImaxSize

      IKUImaxSize

      Средства управления, размерности которых являются максимумом, допустимым для представления фильтра. Ширина или высота 0 указывает, что не ограничивается та размерность представления. Если размер, который требуют, будет слишком маленьким, то фильтр, как ожидают, возвратит представление как можно меньше. Это до клиента, чтобы проверить, что возвращенное представление вписывается в контекст.

      Доступный в OS X v10.5 и позже.

    • IKUIFlavorAllowFallback

      IKUIFlavorAllowFallback

      Средства управления заменой другого размера. Присваиваемое значение является булевым значением. Если фильтр не может обеспечить представление для требуемого размера, и нейтрализация позволяется, фильтр может использовать средства управления различного размера.

      Доступный в OS X v10.5 и позже.

  • Ключи параметра фильтра

    Ключи для входных параметров к фильтрам.

    Объявление

    Swift

    var kCIOutputImageKey: NSString! var kCIInputBackgroundImageKey: NSString! var kCIInputImageKey: NSString! var kCIInputTimeKey: NSString! var kCIInputTransformKey: NSString! var kCIInputScaleKey: NSString! var kCIInputAspectRatioKey: NSString! var kCIInputCenterKey: NSString! var kCIInputRadiusKey: NSString! var kCIInputAngleKey: NSString! var kCIInputRefractionKey: NSString! var kCIInputWidthKey: NSString! var kCIInputSharpnessKey: NSString! var kCIInputIntensityKey: NSString! var kCIInputEVKey: NSString! var kCIInputSaturationKey: NSString! var kCIInputColorKey: NSString! var kCIInputBrightnessKey: NSString! var kCIInputContrastKey: NSString! var kCIInputGradientImageKey: NSString! var kCIInputMaskImageKey: NSString! var kCIInputShadingImageKey: NSString! var kCIInputTargetImageKey: NSString! var kCIInputExtentKey: NSString!

    Objective C

    NSString *kCIOutputImageKey; NSString *kCIInputBackgroundImageKey; NSString *kCIInputImageKey; NSString *kCIInputTimeKey; NSString *kCIInputTransformKey; NSString *kCIInputScaleKey; NSString *kCIInputAspectRatioKey; NSString *kCIInputCenterKey; NSString *kCIInputRadiusKey; NSString *kCIInputAngleKey; NSString *kCIInputRefractionKey; NSString *kCIInputWidthKey; NSString *kCIInputSharpnessKey; NSString *kCIInputIntensityKey; NSString *kCIInputEVKey; NSString *kCIInputSaturationKey; NSString *kCIInputColorKey; NSString *kCIInputBrightnessKey; NSString *kCIInputContrastKey; NSString *kCIInputGradientImageKey; NSString *kCIInputMaskImageKey; NSString *kCIInputShadingImageKey; NSString *kCIInputTargetImageKey; NSString *kCIInputExtentKey;

    Константы

    • kCIOutputImageKey

      kCIOutputImageKey

      Ключ для CIImage объект производится фильтром.

      Доступный в OS X v10.5 и позже. Доступный в iOS 5.0 и позже.

    • kCIInputBackgroundImageKey

      kCIInputBackgroundImageKey

      Ключ для CIImage возразите для использования в качестве фонового изображения.

      Доступный в OS X v10.5 и позже. Доступный в iOS 5.0 и позже.

    • kCIInputImageKey

      kCIInputImageKey

      Ключ для CIImage возразите для использования в качестве входного изображения. Для фильтров, также использующих фоновое изображение, этот ключ относится к изображению переднего раздела.

      Доступный в OS X v10.5 и позже. Доступный в iOS 5.0 и позже.

    • kCIInputTimeKey

      kCIInputTimeKey

      Ключ для z скалярного значения (NSNumber) это указывает время.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputTransformKey

      kCIInputTransformKey

      Ключ для NSAffineTransform объект, указывающий трансформацию для применения.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputScaleKey

      kCIInputScaleKey

      Ключ для скалярного значения (NSNumber) это указывает сумму эффекта.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputAspectRatioKey

      kCIInputAspectRatioKey

      Ключ для скалярного значения (NSNumber) это указывает отношение.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputCenterKey

      kCIInputCenterKey

      Ключ для a CIVector объект, указывающий центр области, как x и y - координаты, чтобы быть отфильтрованным.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputRadiusKey

      kCIInputRadiusKey

      Ключ для скалярного значения (NSNumber) это указывает, что это указывает расстояние от центра эффекта.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputAngleKey

      kCIInputAngleKey

      Ключ для скалярного значения (NSNumber) это указывает угол.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputRefractionKey

      kCIInputRefractionKey

      Ключ для скалярного значения (NSNumber) это указывает индекс преломления материала (такого как стекло) используемый в эффекте.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputWidthKey

      kCIInputWidthKey

      Ключ для скалярного значения (NSNumber) это указывает ширину эффекта.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputSharpnessKey

      kCIInputSharpnessKey

      Ключ для скалярного значения (NSNumber) это указывает сумму увеличения резкости для применения.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputIntensityKey

      kCIInputIntensityKey

      Ключ для скалярного значения (NSNumber) это указывает значение интенсивности.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputEVKey

      kCIInputEVKey

      Ключ для скалярного значения (NSNumber) это указывает, каким количеством F-остановок, более ярких или более темных, изображение должно быть.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputSaturationKey

      kCIInputSaturationKey

      Ключ для скалярного значения (NSNumber) это указывает сумму для корректировки насыщенности.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputColorKey

      kCIInputColorKey

      Ключ для a CIColor объект, указывающий значение цвета.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputBrightnessKey

      kCIInputBrightnessKey

      Ключ для скалярного значения (NSNumber) это указывает уровень яркости.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputContrastKey

      kCIInputContrastKey

      Ключ для скалярного значения (NSNumber) это указывает контрастный уровень.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputGradientImageKey

      kCIInputGradientImageKey

      Ключ для a CIImage объект, указывающий карту среды с альфой. Как правило, это изображение содержит выделение и тень.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputMaskImageKey

      kCIInputMaskImageKey

      Ключ для a CIImage возразите для использования в качестве маски.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputShadingImageKey

      kCIInputShadingImageKey

      Ключ для a CIImage объект, указывающий карту среды с альфа-значениями. Обычно это изображение содержит выделение и тень.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputTargetImageKey

      kCIInputTargetImageKey

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

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIInputExtentKey

      kCIInputExtentKey

      Ключ для a CIVector объект, указывающий прямоугольник, определяющий степень эффекта.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    Обсуждение

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

  • Параметры изображения RAW

    Опции для создания a CIFilter объект от данных изображения RAW.

    Объявление

    Swift

    let kCIInputDecoderVersionKey: NSString! let kCISupportedDecoderVersionsKey: NSString! let kCIInputBoostKey: NSString! let kCIInputNeutralChromaticityXKey: NSString! let kCIInputNeutralChromaticityYKey: NSString! let kCIInputNeutralTemperatureKey: NSString! let kCIInputNeutralTintKey: NSString! let kCIInputNeutralLocationKey: NSString! let kCIInputScaleFactorKey: NSString! let kCIInputAllowDraftModeKey: NSString! let kCIInputIgnoreImageOrientationKey: NSString! let kCIInputImageOrientationKey: NSString! let kCIInputEnableSharpeningKey: NSString! let kCIInputEnableChromaticNoiseTrackingKey: NSString! let kCIInputNoiseReductionAmountKey: NSString! let kCIInputEnableVendorLensCorrectionKey: NSString! let kCIInputLuminanceNoiseReductionAmountKey: NSString! let kCIInputColorNoiseReductionAmountKey: NSString! let kCIInputNoiseReductionSharpnessAmountKey: NSString! let kCIInputNoiseReductionContrastAmountKey: NSString! let kCIInputNoiseReductionDetailAmountKey: NSString! let kCIInputBoostShadowAmountKey: NSString! let kCIInputBiasKey: NSString! let kCIInputLinearSpaceFilter: NSString! let kCIOutputNativeSizeKey: NSString! let kCIActiveKeys: NSString!

    Objective C

    NSString * const kCIInputDecoderVersionKey; NSString * const kCISupportedDecoderVersionsKey; NSString * const kCIInputBoostKey; NSString * const kCIInputNeutralChromaticityXKey; NSString * const kCIInputNeutralChromaticityYKey; NSString * const kCIInputNeutralTemperatureKey; NSString * const kCIInputNeutralTintKey; NSString * const kCIInputNeutralLocation; NSString * const kCIInputScaleFactorKey; NSString * const kCIInputAllowDraftModeKey; NSString * const kCIInputIgnoreImageOrientationKey; NSString * const kCIInputImageOrientationKey; NSString * const kCIInputEnableSharpeningKey; NSString * const kCIInputEnableChromaticNoiseTrackingKey; NSString * const kCIInputNoiseReductionAmountKey; NSString * const kCIInputEnableVendorLensCorrectionKey; NSString * const kCIInputLuminanceNoiseReductionAmountKey; NSString * const kCIInputColorNoiseReductionAmountKey; NSString * const kCIInputNoiseReductionSharpnessAmountKey; NSString * const kCIInputNoiseReductionContrastAmountKey; NSString * const kCIInputNoiseReductionDetailAmountKey; NSString * const kCIInputBoostShadowAmountKey; NSString * const kCIInputBiasKey; NSString * const kCIInputLinearSpaceFilter; NSString * const kCIOutputNativeSizeKey; NSString * const kCIActiveKeys;

    Константы

    • kCIInputDecoderVersionKey

      kCIInputDecoderVersionKey

      Ключ для номера версии метода, который будет использоваться для декодирования. Недавно инициализированные объектные значения по умолчанию к новейшей доступной версии декодера для данного типа изображения. Можно запросить альтернативную, более старую версию поддержать совместимость с более старыми выпусками. Должно быть одно из значений, перечисленных для kCISupportedDecoderVersionsKey ключ, иначе a nil выходное изображение сгенерировано. Присваиваемое значение должно быть NSNumber объект, указывающий целочисленное значение в диапазоне 0 к текущей версии декодера. Когда Вы запрашиваете определенную версию декодера, Базовое Изображение производит изображение, которое является визуально тем же через различные версии операционной системы. Базовое Изображение, однако, не гарантирует, что те же биты производятся через различные версии операционной системы. Поэтому округляющееся поведение арифметики с плавающей точкой может варьироваться вследствие различий в компиляторах или аппаратных средствах. Если изображением, используемым для инициализации, не является RAW, Обратите внимание на то, что эта опция не имеет никакого эффекта.

      Доступный в OS X v10.5 и позже.

    • kCISupportedDecoderVersionsKey

      kCISupportedDecoderVersionsKey

      Ключ для поддерживаемых версий декодера. Присваиваемое значение NSArray объект, содержащий все поддерживаемые версии декодера для данного типа изображения, сортированного во все более и более более новом порядке. Каждая запись NSDictionary объект, содержащий пары ключ/значение. Все записи представляют идентификатор действительной версии, который может быть передан как kCIDecoderVersion значение для ключа kCIDecoderMethodKey. Значения версий только для чтения; попытка установить это значение повышает исключение. В настоящее время единственный определенный ключ @"version" который имеет как его значение NSString это, уникально описывая данную версию декодера. Эта строка не могла бы подойти для экрана интерфейса пользователя..

      Доступный в OS X v10.5 и позже.

    • kCIInputBoostKey

      kCIInputBoostKey

      Ключ для сумма повышения для применения к изображению. Присваиваемое значение является значением с плавающей точкой, упакованным как NSNumber объект. Значение должно быть в диапазоне 0...1. Значение 0 не указывает повышения, т.е. линейного ответа. Значение по умолчанию 1, который указывает полное повышение.

      Доступный в OS X v10.5 и позже.

    • kCIInputNeutralChromaticityXKey

      kCIInputNeutralChromaticityXKey

      X значение цветности. Присваиваемое значение является значением с плавающей точкой, упакованным как NSNumber объект. Можно запросить это значение для получения текущего значения x для нейтрального x, y.

      Доступный в OS X v10.5 и позже.

    • kCIInputNeutralChromaticityYKey

      kCIInputNeutralChromaticityYKey

      Y значение цветности. Присваиваемое значение является значением с плавающей точкой, упакованным как NSNumber объект. Можно запросить это значение для получения текущего значения y для нейтрального x, y.

      Доступный в OS X v10.5 и позже.

    • kCIInputNeutralTemperatureKey

      kCIInputNeutralTemperatureKey

      Ключ для нейтральной температуры. Присваиваемое значение является значением с плавающей точкой, упакованным как NSNumber объект. Можно запросить это значение для получения текущего температурного значения.

      Доступный в OS X v10.5 и позже.

    • kCIInputNeutralTintKey

      kCIInputNeutralTintKey

      Ключ для нейтрального оттенка. Присваиваемое значение является значением с плавающей точкой, упакованным как NSNumber объект. Используйте этот ключ, чтобы установить или выбрать значения оттенка и температура. Можно запросить это значение для получения текущего значения оттенка.

      Доступный в OS X v10.5 и позже.

    • kCIInputNeutralLocationKey

      kCIInputNeutralLocationKey

      Ключ для нейтральной позиции. Используйте этот ключ для установки расположения в геометрических координатах неповернутого выходного изображения, которое должно использоваться в качестве нейтрального. Вы не можете запросить это значение; это не определено для чтения. Присваиваемое значение является с двумя элементами CIVector объект, указывающий расположение (x, y).

      Доступный в OS X v10.5 и позже.

    • kCIInputScaleFactorKey

      kCIInputScaleFactorKey

      Ключ для масштабного коэффициента. Присваиваемое значение является значением с плавающей точкой, упакованным как NSNumber объект, указывающий желаемый масштабный коэффициент, в котором будет нарисовано изображение. Установка этого значения может значительно улучшить производительность получения. Значение 1 идентификационные данные. В некоторых случаях, если Вы изменяете масштабный коэффициент и включаете черновой режим, производительность может уменьшиться. Посмотрите kCIInputAllowDraftModeKey.

      Доступный в OS X v10.5 и позже.

    • kCIInputAllowDraftModeKey

      kCIInputAllowDraftModeKey

      Ключ для разрешения чернового режима. Присваиваемое значение является булевым значением, упакованным как NSNumber объект. Если изображение должно быть нарисовано без чернового режима в более позднее время, потому что, изменив значение от, лучше не использовать черновой режим YEStrue к NOfalse дорогая работа. Если дополнительный масштабный коэффициент меньше, чем определенное значение, дополнительно устанавливая черновой режим может улучшить скорость декодирования изображения без какой-либо заметной потери качества. Если масштабный коэффициент не ниже этого порога, Однако включение чернового режима не имеет никакого эффекта.

      Доступный в OS X v10.5 и позже.

    • kCIInputIgnoreImageOrientationKey

      kCIInputIgnoreImageOrientationKey

      Ключ для указания, проигнорировать ли ориентацию изображения. Присваиваемое значение является булевым значением, упакованным как NSNumber объект. Значение по умолчанию NOfalse. Изображение обычно загружается в его надлежащей ориентации, пока связанные метаданные записывают свою ориентацию. Для особых целей Вы могли бы хотеть загрузить изображение в его физической ориентации. Точное значение «физической ориентации” зависит от определенного изображения.

      Доступный в OS X v10.5 и позже.

    • kCIInputImageOrientationKey

      kCIInputImageOrientationKey

      Ключ для ориентации изображения. Присваиваемое значение является целочисленным значением, упакованным как NSNumber объект. Допустимые значения находятся в диапазоне 1...8 и следуйте за спецификацией EXIF. Значение игнорируется когда kCIIgnoreImageOrientationKey флаг установлен. Можно изменить ориентацию изображения путем переопределения этого значения. Путем изменения этого значения можно легко повернуть изображение в инкрементах на 90 градусов.

      Доступный в OS X v10.5 и позже.

    • kCIInputEnableSharpeningKey

      kCIInputEnableSharpeningKey

      Ключ для состояния увеличения резкости. Присваиваемое значение должно быть NSNumber объект, указывающий a BOOL значение (YEStrue или NOfalse). Значение по умолчанию YEStrue. Если изображением, используемым для инициализации, не является RAW, эта опция не имеет никакого эффекта.

      Доступный в OS X v10.5 и позже.

    • kCIInputEnableChromaticNoiseTrackingKey

      kCIInputEnableChromaticNoiseTrackingKey

      Ключ для прогрессивного цветного отслеживания шума (на основе ISO и выдержка). Присваиваемое значение должно быть NSNumber объект, указывающий a BOOL значение (YEStrue или NOfalse). Значение по умолчанию YEStrue. Если изображением, используемым для инициализации, не является RAW, эта опция не имеет никакого эффекта.

      Доступный в OS X v10.5 и позже.

    • kCIInputNoiseReductionAmountKey

      kCIInputNoiseReductionAmountKey

      Ключ для суммы для сокращения шума в изображении. Присваиваемое значение должно быть NSNumber объект, указывающий значение с плавающей точкой между 0.0 и 1.0. Если изображением, используемым для инициализации, не является RAW, значение не имеет никакого эффекта.

      Доступный в OS X v10.7 и позже. Не доступный в iOS.

    • kCIInputEnableVendorLensCorrectionKey

      kCIInputEnableVendorLensCorrectionKey

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

      Значение для этого ключа является a NSNumber объект, содержащий булево значение. Если это значение YEStrue, или если эта опция не указана, но изображение содержит метаданные для параметров искажения линзы, Базовое Изображение исправляет для искажения линзы.

      Доступный в OS X v10.10 и позже.

    • kCIInputLuminanceNoiseReductionAmountKey

      kCIInputLuminanceNoiseReductionAmountKey

      Ключ для сокращения уровня шума для применения к данным яркости в изображении.

      Значение для этого ключа является a NSNumber объект, содержащий значение между 0.0 и 1.0.

      Доступный в OS X v10.10 и позже.

    • kCIInputColorNoiseReductionAmountKey

      kCIInputColorNoiseReductionAmountKey

      Ключ для сокращения уровня шума для применения к цветным данным в изображении.

      Значение для этого ключа является a NSNumber объект, содержащий значение между 0.0 и 1.0.

      Доступный в OS X v10.10 и позже.

    • kCIInputNoiseReductionSharpnessAmountKey

      kCIInputNoiseReductionSharpnessAmountKey

      Ключ для суммы улучшения резкости для применения во время шумоподавления.

      Значение для этого ключа является a NSNumber объект, содержащий значение между 0.0 и 1.0.

      Доступный в OS X v10.10 и позже.

    • kCIInputNoiseReductionContrastAmountKey

      kCIInputNoiseReductionContrastAmountKey

      Ключ для суммы контрастного улучшения для применения во время шумоподавления.

      Значение для этого ключа является a NSNumber объект, содержащий значение между 0.0 и 1.0.

      Доступный в OS X v10.10 и позже.

    • kCIInputNoiseReductionDetailAmountKey

      kCIInputNoiseReductionDetailAmountKey

      Ключ для суммы подробного улучшения для применения во время шумоподавления.

      Значение для этого ключа является a NSNumber объект, содержащий значение между 0.0 и 1.0.

      Доступный в OS X v10.10 и позже.

    • kCIInputBoostShadowAmountKey

      kCIInputBoostShadowAmountKey

      Ключ для суммы для повышения зон молчания изображения. Присваиваемое значение должно быть NSNumber объект, указывающий значение с плавающей точкой. Если изображением, используемым для инициализации, не является RAW, значение не имеет никакого эффекта.

      Доступный в OS X v10.5 и позже.

    • kCIInputBiasKey

      kCIInputBiasKey

      Ключ для простого значения смещения для использования вместе с корректировкой воздействия (kCIInputEVKey). Присваиваемое значение должно быть NSNumber объект, указывающий значение с плавающей точкой. Если изображением, используемым для инициализации, не является RAW, значение не имеет никакого эффекта.

      Доступный в OS X v10.5 и позже.

    • kCIInputLinearSpaceFilter

      kCIInputLinearSpaceFilter

      Ключ для фильтра для применения к изображению, в то время как это находится временно в линейном цветовом пространстве как часть обработки изображений RAW. Присваиваемое значение должно быть a CIFilter объект.

      Доступный в OS X v10.7 и позже. Не доступный в iOS.

    • kCIOutputNativeSizeKey

      kCIOutputNativeSizeKey

      Ключ для полного собственного размера исходного, непреобразованного изображения RAW. Присваиваемое значение является a CIVector возразите, чьи значения X и y являются шириной и высотой изображения. Этот ключ только для чтения.

      Доступный в OS X v10.5 и позже. Не доступный в iOS.

    • kCIActiveKeys

      kCIActiveKeys

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

      Доступный в OS X v10.7 и позже. Не доступный в iOS.

    Обсуждение

    Можно также использовать ключ kCIInputEVKey для изображений RAW.