CIDetector

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

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

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

NSObject
CIDetector

NSObject
CIDetector

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

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

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

Swift

import QuartzCore

Objective C

@import QuartzCore;

Доступность

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

Создание объекта детектора


    
    init (ofType:context:options:)
    + detectorOfType:context:options:

Создает и возвращает сконфигурированный детектор.

Объявление

Swift

init!(ofType type: String!, context context: CIContext!, options options: [NSObject : AnyObject]!) -> CIDetector

Objective C

+ (CIDetector *)detectorOfType:(NSString *)type context:(CIContext *)context options:(NSDictionary *)options

Параметры

`type`	Строка, указывающая вид детектора, Вы интересуетесь. Посмотрите `“Detector Types”`.
`context`	Базовый контекст Изображения, который детектор может использовать при анализе изображения.
`options`	Словарь, содержащий подробные данные о том, как Вы хотите, чтобы был сконфигурирован детектор. Посмотрите `“Detector Configuration Keys”`.

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

Сконфигурированный детектор.

Обсуждение

A CIDetector объект может потенциально создать и содержать существенное количество ресурсов. Где возможно, снова используйте то же CIDetector экземпляр. Кроме того, при обработке изображений с объектом детектора приложение выполняет лучше если CIContext используемый для инициализации детектора тот же контекст, используемый для обработки CIImage объекты.

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

Objective C

@import QuartzCore;

Swift

import QuartzCore

Доступность

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

Используя объект детектора найти функции

featuresInImage (_:) - featuresInImage:

Поиски функций в изображении.

Объявление

Swift

func featuresInImage(_ image: CIImage!) -> [AnyObject]!

Objective C

- (NSArray *)featuresInImage:(CIImage *)image

Параметры

image

Изображение Вы хотите исследовать.

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

Массив CIFeature объекты. Каждый объект представляет функцию, обнаруженную в изображении.

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

Objective C

@import QuartzCore;

Swift

import QuartzCore

Доступность

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


    
    featuresInImage (_: опции:)
    - featuresInImage:options:

Поиски функций в изображении на основе указанной ориентации изображения.

Объявление

Swift

func featuresInImage(_ image: CIImage!, options options: [NSObject : AnyObject]!) -> [AnyObject]!

Objective C

- (NSArray *)featuresInImage:(CIImage *)image options:(NSDictionary *)options

Параметры

`image`	Изображение Вы хотите исследовать.
`options`	Словарь, указывающий опции выявления признаков. Посмотрите `“Feature Detection Keys”` для позволенных ключей и их возможных значений.

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

Массив CIFeature объекты. Каждый объект представляет функцию, обнаруженную в изображении.

Обсуждение

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

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

Objective C

@import QuartzCore;

Swift

import QuartzCore

Доступность

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

Константы

Типы детектора
Строки раньше объявляли детектор, для которого Вам интересно.

Объявление

Swift

let CIDetectorTypeFace: NSString! let CIDetectorTypeRectangle: NSString! let CIDetectorTypeQRCode: NSString!

Objective C

NSString* const CIDetectorTypeFace *NSString const CIDetectorTypeRectangle NSString* const CIDetectorTypeQRCode

Константы
- CIDetectorTypeFace
  
  CIDetectorTypeFace
  
  Детектор, ищущий поверхности в неподвижном изображении или видео, возвращаясь CIFaceFeature объекты, предоставляющие информацию об обнаруженных поверхностях.
  
  Для лучшей точности и производительности в обнаружении поверхности, используйте CIDetectorImageOrientation ключ для указания ориентации изображения при использовании featuresInImage:options: метод.
  
  Доступный в OS X v10.7 и позже.
- CIDetectorTypeRectangle
  
  CIDetectorTypeRectangle
  
  Детектор, ищущий прямоугольные области в неподвижном изображении или видео, возвращаясь CIRectangleFeature объекты, предоставляющие информацию об обнаруженных областях.
  
  Прямоугольный детектор находит области, которые, вероятно, будут представлять прямоугольные объекты, появляющиеся в перспективе в изображении, таком как бумаги или книги, замеченные на рабочем столе.
  
  Доступный в OS X v10.10 и позже.
- CIDetectorTypeQRCode
  
  CIDetectorTypeQRCode
  
  Детектор, ищущий Быстрые коды Ответа (тип двухмерного штрихкода) в неподвижном изображении или видео, возвращаясь CIQRCodeFeature объекты, предоставляющие информацию об обнаруженных штрихкодах.
  
  Доступный в OS X v10.10 и позже.
Ключи конфигурации детектора
Ключи, используемые в словаре опций для конфигурирования детектора.

Объявление

Swift

let CIDetectorAccuracy: NSString! let CIDetectorTracking: NSString! let CIDetectorMinFeatureSize: NSString!

Objective C

NSString* const CIDetectorAccuracy;

Константы
- CIDetectorAccuracy
  
  CIDetectorAccuracy
  
  Ключ раньше указывал желаемую точность для детектора.
  
  Значение, связанное с ключом, должно быть одним из значений, найденных в “Detector Accuracy Options”.
  
  Доступный в OS X v10.7 и позже.
- CIDetectorTracking
  
  CIDetectorTracking
  
  Ключ раньше включал или отключал отслеживание поверхности для детектора. Используйте эту опцию, когда Вы захотите отследить поверхности через кадры в видео.
  
  Доступный в OS X v10.8 и позже.
- CIDetectorMinFeatureSize
  
  CIDetectorMinFeatureSize
  
  Ключ раньше указывал минимальный размер, который детектор распознает как функция.
  
  Значение для этого ключа NSNumber объект в пределах от 0,0 до 1,0, который представляет часть незначительной размерности изображения.
  
  Доступный в OS X v10.8 и позже.
Опции точности детектора
Опции значения раньше указывали желаемую точность детектора.

Объявление

Swift

let CIDetectorAccuracyLow: NSString! let CIDetectorAccuracyHigh: NSString!

Objective C

NSString* const CIDetectorAccuracyLow; NSString* const CIDetectorAccuracyHigh;

Константы
- CIDetectorAccuracyLow
  
  CIDetectorAccuracyLow
  
  Указывает, что детектор должен выбрать методы, которые ниже в точности, но могут быть обработаны более быстро.
  
  Доступный в OS X v10.7 и позже.
- CIDetectorAccuracyHigh
  
  CIDetectorAccuracyHigh
  
  Указывает, что детектор должен выбрать методы, которые выше в точности, даже если требуется больше времени обработки.
  
  Доступный в OS X v10.7 и позже.
Ключи выявления признаков
Ключи, используемые в словаре опций для featuresInImage:options:.

Объявление

Swift

let CIDetectorImageOrientation: NSString! let CIDetectorEyeBlink: NSString! let CIDetectorSmile: NSString! let CIDetectorFocalLength: NSString! let CIDetectorAspectRatio: NSString!

Objective C

NSString* const CIDetectorImageOrientation; NSString* const CIDetectorEyeBlink; NSString* const CIDetectorSmile; NSString* const CIDetectorFocalLength; NSString* const CIDetectorAspectRatio;

Константы
- CIDetectorImageOrientation
  
  CIDetectorImageOrientation
  
  Опция для ориентации дисплея изображения, функции которого Вы хотите обнаружить.
  
  Значение этого ключа NSNumber возразите, чье значение является целым числом между 1 и 8. TIFF и спецификации EXIF определяют эти значения для указания, где пиксельный источник координаты (0,0) из изображения должен появиться, когда это выведено на экран. Значение по умолчанию 1, указание, что источник находится в верхнем левом углу изображения. Для получения дальнейшей информации посмотрите kCGImagePropertyOrientation.
  
  Базовое Изображение обнаруживает только поверхности чьи соответствия ориентации то из изображения. Если Вы хотите обнаружить поверхности в различной ориентации, необходимо обеспечить значение для этого ключа.
  
  Доступный в OS X v10.8 и позже.
- CIDetectorEyeBlink
  
  CIDetectorEyeBlink
  
  Опция для того, выполнит ли Базовое Изображение дополнительную обработку для распознавания закрытых глаз в обнаруженных поверхностях.
  
  Доступный в OS X v10.9 и позже.
- CIDetectorSmile
  
  CIDetectorSmile
  
  Опция для того, выполнит ли Базовое Изображение дополнительную обработку для распознавания улыбок в обнаруженных поверхностях.
  
  Доступный в OS X v10.9 и позже.
- CIDetectorFocalLength
  
  CIDetectorFocalLength
  
  Опция, идентифицирующая фокусное расстояние, используемое в получении изображений, которые будут обработаны детектором.
  
  Значение этого ключа NSNumber возразите, чье значение является числом с плавающей точкой между-1.0 и 1.0. Используйте эту опцию с CIDetectorTypeRectangle тип детектора для подстраивания точности детектора.
  
  Доступный в OS X v10.10 и позже.
- CIDetectorAspectRatio
  
  CIDetectorAspectRatio
  
  Опция, указывающая форматное соотношение (ширина, разделенная на высоту) прямоугольников для поиска.
  
  Значение этого ключа NSNumber возразите, чье значение является положительным числом с плавающей точкой. Используйте эту опцию с CIDetectorTypeRectangle тип детектора для подстраивания точности детектора. Например, чтобы более точно найти визитную карточку (3.5 x 2 дюйма) в изображении укажите форматное соотношение 1.75 (3.5 / 2).
  
  Доступный в OS X v10.10 и позже.