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

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

Разработчик

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

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

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

CIDetector

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

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

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

Swift

import CoreImage

Objective C

@import CoreImage;

Доступность

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

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

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

Создание объекта детектора
  • 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 CoreImage;

    Swift

    import CoreImage

    Доступность

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

Используя объект детектора найти функции
  • featuresInImage (_:) - featuresInImage:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    image

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

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Swift

    import CoreImage

    Доступность

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

Константы
  • Типы детектора

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

    Объявление

    Swift

    let CIDetectorTypeFace: String let CIDetectorTypeRectangle: String let CIDetectorTypeQRCode: String

    Objective C

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

    Константы

    • CIDetectorTypeFace

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

      Для лучшей точности и производительности в обнаружении поверхности, используйте CIDetectorImageOrientation ключ для указания ориентации изображения при использовании featuresInImage:options: метод.

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

    • CIDetectorTypeRectangle

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

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

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

    • CIDetectorTypeQRCode

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

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

  • Ключи конфигурации детектора

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

    Объявление

    Swift

    let CIDetectorAccuracy: String let CIDetectorTracking: String let CIDetectorMinFeatureSize: String

    Objective C

    NSString* const CIDetectorAccuracy;

    Константы

    • CIDetectorAccuracy

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

      Значение, связанное с ключом, должно быть одним из значений, найденных в “Detector Accuracy Options”.

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

    • CIDetectorTracking

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

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

    • CIDetectorMinFeatureSize

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

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

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

  • Опции точности детектора

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

    Объявление

    Swift

    let CIDetectorAccuracyLow: String let CIDetectorAccuracyHigh: String

    Objective C

    NSString* const CIDetectorAccuracyLow; NSString* const CIDetectorAccuracyHigh;

    Константы

    • CIDetectorAccuracyLow

      Указывает, что детектор должен выбрать методы, которые ниже в точности, но могут быть обработаны более быстро.

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

    • CIDetectorAccuracyHigh

      Указывает, что детектор должен выбрать методы, которые выше в точности, даже если требуется больше времени обработки.

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

  • Ключи выявления признаков

    Ключи, используемые в словаре опций для featuresInImage:options:.

    Объявление

    Swift

    let CIDetectorImageOrientation: String let CIDetectorEyeBlink: String let CIDetectorSmile: String let CIDetectorFocalLength: String let CIDetectorAspectRatio: String

    Objective C

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

    Константы

    • CIDetectorImageOrientation

      Опция для ориентации дисплея изображения, функции которого Вы хотите обнаружить.

      Значение этого ключа NSNumber возразите, чье значение является целым числом между 1 и 8. TIFF и спецификации EXIF определяют эти значения для указания, где пиксельный источник координаты (0,0) из изображения должен появиться, когда это выведено на экран. Значение по умолчанию 1, указание, что источник находится в верхнем левом углу изображения. Для получения дальнейшей информации посмотрите kCGImagePropertyOrientation.

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

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

    • CIDetectorEyeBlink

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

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

    • CIDetectorSmile

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

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

    • CIDetectorFocalLength

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

      Значение этого ключа NSNumber возразите, чье значение является числом с плавающей точкой между-1.0 и 1.0. Используйте эту опцию с CIDetectorTypeRectangle тип детектора для подстраивания точности детектора.

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

    • CIDetectorAspectRatio

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

      Значение этого ключа NSNumber возразите, чье значение является положительным числом с плавающей точкой. Используйте эту опцию с CIDetectorTypeRectangle тип детектора для подстраивания точности детектора. Например, чтобы более точно найти визитную карточку (3.5 x 2 дюйма) в изображении укажите форматное соотношение 1.75 (3.5 / 2).

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