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

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

Разработчик

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

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

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

CIFilter

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

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

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

Swift

import CoreImage

Objective C

@import CoreImage;

Доступность

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

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.

Создание фильтра
  • 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 CoreImage;

    Swift

    import CoreImage

    Доступность

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

    См. также

    + 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 CoreImage;

    Swift

    import CoreImage

    Доступность

    Доступный в iOS 8.0 и позже.

    См. также

    + filterWithName:

  • + 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 CoreImage;

    Доступность

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

    См. также

    + filterWithName:
    + filterWithName:withInputParameters:

Доступ к зарегистрированным фильтрам
  • 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 CoreImage;

    Swift

    import CoreImage

    Доступность

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

    См. также

    + filterNamesInCategory:

  • filterNamesInCategory (_:) + filterNamesInCategory:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    category

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

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

    См. также

    + filterNamesInCategories:

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

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

    Объявление

    Swift

    func name() -> String!

    Objective C

    - (NSString *)name

    Обсуждение

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

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

    Объявление

    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 CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • inputKeys () - inputKeys

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

    Объявление

    Swift

    func inputKeys() -> [AnyObject]!

    Objective C

    - (NSArray *)inputKeys

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • outputKeys () - outputKeys

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

    Объявление

    Swift

    func outputKeys() -> [AnyObject]!

    Objective C

    - (NSArray *)outputKeys

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • outputImage Свойство

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

    Объявление

    Swift

    var outputImage: CIImage! { get }

    Objective C

    @property(readonly, nonatomic) CIImage *outputImage

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

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

    Объявление

    Swift

    func setDefaults()

    Objective C

    - (void)setDefaults

    Обсуждение

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

Сериализация и десериализация фильтров
  • 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 CoreImage;

    Swift

    import CoreImage

    Доступность

    Доступный в iOS 6.0 и позже.

  • 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 CoreImage;

    Swift

    import CoreImage

    Доступность

    Доступный в iOS 6.0 и позже.

Новые методы

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

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

    Объявление

    Swift

    let kCIAttributeFilterName: String let kCIAttributeFilterDisplayName: String let kCIAttributeFilterCategories: String let kCIAttributeClass: String let kCIAttributeType: String let kCIAttributeMin: String let kCIAttributeMax: String let kCIAttributeSliderMin: String let kCIAttributeSliderMax: String let kCIAttributeDefault: String let kCIAttributeIdentity: String let kCIAttributeName: String let kCIAttributeDisplayName: String

    Objective C

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

    Константы

    • kCIAttributeFilterName

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

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

    • kCIAttributeFilterDisplayName

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

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

    • kCIAttributeFilterCategories

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

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

    • kCIAttributeClass

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

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

    • kCIAttributeType

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

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

    • kCIAttributeMin

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

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

    • kCIAttributeMax

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

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

    • kCIAttributeSliderMin

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

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

    • kCIAttributeSliderMax

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

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

    • kCIAttributeDefault

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

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

    • kCIAttributeIdentity

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

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

    • kCIAttributeName

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

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

    • kCIAttributeDisplayName

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

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

    Обсуждение

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

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

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

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

    Объявление

    Swift

    let kCIAttributeTypeTime: String let kCIAttributeTypeScalar: String let kCIAttributeTypeDistance: String let kCIAttributeTypeAngle: String let kCIAttributeTypeBoolean: String let kCIAttributeTypeInteger: String let kCIAttributeTypeCount: String

    Objective C

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

    Константы

    • kCIAttributeTypeTime

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

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

    • kCIAttributeTypeScalar

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

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

    • kCIAttributeTypeDistance

      Расстояние.

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

    • kCIAttributeTypeAngle

      Угол.

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

    • kCIAttributeTypeBoolean

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

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

    • kCIAttributeTypeInteger

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

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

    • kCIAttributeTypeCount

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

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

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

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

    Объявление

    Swift

    let kCIAttributeTypePosition: String let kCIAttributeTypeOffset: String let kCIAttributeTypePosition3: String let kCIAttributeTypeRectangle: String

    Objective C

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

    Константы

    • kCIAttributeTypePosition

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

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

    • kCIAttributeTypeOffset

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

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

    • kCIAttributeTypePosition3

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

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

    • kCIAttributeTypeRectangle

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

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

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

    Типы цвета.

    Объявление

    Swift

    let kCIAttributeTypeColor: String

    Objective C

    NSString *kCIAttributeTypeColor;

    Константы

    • kCIAttributeTypeColor

      Базовый цвет изображения (CIColor объект), который указывает красные, зеленые, и синие значения компонентов.

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

  • Ключи атрибута изображения

    Типы изображения

    Объявление

    Swift

    let kCIAttributeTypeImage: String let kCIAttributeTypeTransform: String

    Objective C

    NSString *kCIAttributeTypeImage; NSString *kCIAttributeTypeTransform;

    Константы

    • kCIAttributeTypeImage

      A CIImage объект.

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

    • kCIAttributeTypeTransform

      CGAffineTransform связан с атрибутом.

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

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

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

    Объявление

    Swift

    let kCICategoryDistortionEffect: String let kCICategoryGeometryAdjustment: String let kCICategoryCompositeOperation: String let kCICategoryHalftoneEffect: String let kCICategoryColorAdjustment: String let kCICategoryColorEffect: String let kCICategoryTransition: String let kCICategoryTileEffect: String let kCICategoryGenerator: String let kCICategoryReduction: String let kCICategoryGradient: String let kCICategoryStylize: String let kCICategorySharpen: String let kCICategoryBlur: String let kCICategoryVideo: String let kCICategoryStillImage: String let kCICategoryInterlaced: String let kCICategoryNonSquarePixels: String let kCICategoryHighDynamicRange: String let kCICategoryBuiltIn: String

    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;

    Константы

    • kCICategoryDistortionEffect

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

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

    • kCICategoryGeometryAdjustment

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

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

    • kCICategoryCompositeOperation

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

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

    • kCICategoryHalftoneEffect

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

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

    • kCICategoryColorAdjustment

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

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

    • kCICategoryColorEffect

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

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

    • kCICategoryTransition

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

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

    • kCICategoryTileEffect

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

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

    • kCICategoryGenerator

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

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

    • kCICategoryReduction

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

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

    • kCICategoryGradient

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

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

    • kCICategoryStylize

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

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

    • kCICategorySharpen

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

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

    • kCICategoryBlur

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

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

    • kCICategoryVideo

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

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

    • kCICategoryStillImage

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

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

    • kCICategoryInterlaced

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

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

    • kCICategoryNonSquarePixels

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

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

    • kCICategoryHighDynamicRange

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

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

    • kCICategoryBuiltIn

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

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

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

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

    Объявление

    Swift

    let kCIOutputImageKey: String let kCIInputBackgroundImageKey: String let kCIInputImageKey: String let kCIInputTimeKey: String let kCIInputTransformKey: String let kCIInputScaleKey: String let kCIInputAspectRatioKey: String let kCIInputCenterKey: String let kCIInputRadiusKey: String let kCIInputAngleKey: String let kCIInputWidthKey: String let kCIInputSharpnessKey: String let kCIInputIntensityKey: String let kCIInputEVKey: String let kCIInputSaturationKey: String let kCIInputColorKey: String let kCIInputBrightnessKey: String let kCIInputContrastKey: String let kCIInputMaskImageKey: String let kCIInputTargetImageKey: String let kCIInputExtentKey: String let kCIInputVersionKey: String

    Objective C

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

    Константы

    • kCIOutputImageKey

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

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

    • kCIInputBackgroundImageKey

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

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

    • kCIInputImageKey

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

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

    • kCIInputTimeKey

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

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

    • kCIInputTransformKey

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

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

    • kCIInputScaleKey

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

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

    • kCIInputAspectRatioKey

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

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

    • kCIInputCenterKey

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

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

    • kCIInputRadiusKey

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

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

    • kCIInputAngleKey

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

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

    • kCIInputWidthKey

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

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

    • kCIInputSharpnessKey

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

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

    • kCIInputIntensityKey

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

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

    • kCIInputEVKey

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

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

    • kCIInputSaturationKey

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

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

    • kCIInputColorKey

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

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

    • kCIInputBrightnessKey

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

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

    • kCIInputContrastKey

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

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

    • kCIInputMaskImageKey

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

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

    • kCIInputTargetImageKey

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

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

    • kCIInputExtentKey

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

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

    • kCIInputVersionKey

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

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

    Обсуждение

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