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

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

Разработчик

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

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

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

CIImage

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


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


Swift

import CoreImage

Objective C

@import CoreImage;

Доступность


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

CIImage класс представляет изображение. Базовые изображения Изображения являются неизменными. Вы используете CIImage объекты в сочетании с другими Базовыми классами Изображения — такой как CIFilter, CIContext, CIVector, и CIColor— использовать в своих интересах встроенные Базовые фильтры Изображения при обработке изображений. Можно создать CIImage объекты с данными, снабженными от множества источников, включая Кварц 2D изображения, Базовые буферы Видеоизображения (CVImageBufferRef), ОСНОВАННЫЕ НА URL объекты, и NSData объекты.

Несмотря на то, что a CIImage объекту связали данные изображения с ним, это не изображение. Можно думать о a CIImage возразите как изображение «рецепт». A CIImage объект имеет всю информацию, необходимую для создания изображения, но Базовое Изображение фактически не представляет изображение, пока этому не говорят сделать так. Этот метод «отложенных вычислений» позволяет Базовому Изображению работать максимально эффективно.

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

Базовое Изображение также обеспечивает методы автокорректировки, анализирующие изображение для общих недостатков и возврата ряд фильтров для исправления тех недостатков. Фильтры задаются со значениями для улучшения качества изображения путем изменения значений для скинтонов, насыщенности, контраста и теней и для удаления красного глаза или других артефактов, вызванных флэш-памятью. (См. “Getting Autoadjustment Filters”.)

Для обсуждения всех методов можно использовать для создания CIImage объекты на iOS и OS X, см. Базовое Руководство по программированию Изображения.

  • Создает и возвращает пустой объект изображения.

    Объявление

    Swift

    class func emptyImage() -> CIImage!

    Objective C

    + (CIImage *)emptyImage

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

    Объект изображения.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Объявление

    Objective C

    + (CIImage *)imageWithColor:(CIColor *)color

    Параметры

    color

    Цветовой объект.

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

    Объект изображения, инициализированный с цветом, представленным CIColor объект.

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

    Objective C

    @import CoreImage;

    Доступность

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

    См. также

    – initWithColor:

  • Создает и возвращает объект изображения из растровых данных.

    Объявление

    Objective C

    + (CIImage *)imageWithBitmapData:(NSData *)d bytesPerRow:(size_t)bpr size:(CGSize)size format:(CIFormat)f colorSpace:(CGColorSpaceRef)cs

    Параметры

    d

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

    bpr

    Число байтов на строку.

    size

    Размерности изображения.

    f

    Формат и размер каждого пикселя. Необходимо предоставить постоянный формат пикселя. Посмотрите “Pixel Formats”.

    cs

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

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

    Объект изображения.

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

    Objective C

    @import CoreImage;

    Доступность

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

  • Создает и возвращает объект изображения из Кварца 2D изображение.

    Объявление

    Objective C

    + (CIImage *)imageWithCGImage:(CGImageRef)image

    Параметры

    image

    Кварц 2D изображение (CGImageRef) объект. Для получения дополнительной информации посмотрите Кварц 2D Руководство по программированию и Ссылка CGImage.

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

    Объект изображения инициализировал с содержанием Кварца 2D изображение.

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

    Objective C

    @import CoreImage;

    Доступность

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

  • Создает и возвращает объект изображения из Кварца 2D изображение с помощью указанных опций.

    Объявление

    Objective C

    + (CIImage *)imageWithCGImage:(CGImageRef)image options:(NSDictionary *)d

    Параметры

    image

    Кварц 2D изображение (CGImageRef) объект. Для получения дополнительной информации посмотрите Кварц 2D Руководство по программированию и Ссылка CGImage.

    d

    Словарь, указывающий параметры изображения. (См. “Image Dictionary Keys”.)

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

    Объект изображения инициализировал с содержанием Кварца 2D изображение и указанные опции.

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

    Objective C

    @import CoreImage;

    Доступность

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

  • Создает и возвращает объект изображения из содержания файла.

    Объявление

    Objective C

    + (CIImage *)imageWithContentsOfURL:(NSURL *)url

    Параметры

    url

    Расположение файла.

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

    Объект изображения инициализируется с содержанием файла.

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

    Objective C

    @import CoreImage;

    Доступность

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

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

    Объявление

    Objective C

    + (CIImage *)imageWithContentsOfURL:(NSURL *)url options:(NSDictionary *)d

    Параметры

    url

    Расположение файла.

    d

    Словарь, указывающий параметры изображения. (См. “Image Dictionary Keys”.)

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

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

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

    Objective C

    @import CoreImage;

    Доступность

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

  • Создает и возвращает объект изображения из содержания CVPixelBuffer объект.

    Объявление

    Objective C

    + (CIImage *)imageWithCVPixelBuffer:(CVPixelBufferRef)buffer

    Параметры

    buffer

    A CVPixelBuffer объект.

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

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

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

    Objective C

    @import CoreImage;

    Доступность

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

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

    Объявление

    Objective C

    + (CIImage *)imageWithCVPixelBuffer:(CVPixelBufferRef)buffer options:(NSDictionary *)dict

    Параметры

    buffer

    A CVPixelBuffer объект.

    dict

    Словарь, указывающий параметры изображения. (См. “Image Dictionary Keys”.)

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

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

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

    Objective C

    @import CoreImage;

    Доступность

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

  • Создает и возвращает объект изображения, инициализированный с предоставленными данными изображения.

    Объявление

    Objective C

    + (CIImage *)imageWithData:(NSData *)data

    Параметры

    data

    Объект данных, содержащий содержание файла образа (такое как TIFF, GIF, JPG, или безотносительно системных поддержек). Данные изображения должны быть предварительно умножены.

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

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

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

    Objective C

    @import CoreImage;

    Доступность

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

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

    Объявление

    Objective C

    + (CIImage *)imageWithData:(NSData *)data options:(NSDictionary *)d

    Параметры

    data

    Указатель на данные изображения. Данные должны быть предварительно умножены

    d

    Словарь, указывающий параметры изображения. (См. “Image Dictionary Keys”.)

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

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

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

    Objective C

    @import CoreImage;

    Доступность

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

  • Создает и возвращает объект изображения, инициализированный с данными, снабженными текстурой OpenGL.

    Объявление

    Objective C

    + (CIImage *)imageWithTexture:(unsigned int)name size:(CGSize)size flipped:(BOOL)flag colorSpace:(CGColorSpaceRef)cs

    Параметры

    name

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

    size

    Размерности текстуры.

    flag

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

    cs

    Цветовое пространство, в котором определяется изображение. Если colorSpace значение nil, изображение не является соответствующим цветом. Передача nil для изображений, не содержащих цветные данные (такие как повышение отображается, карты вектора нормали, и выбрал функциональные таблицы).

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

    Объект изображения инициализируется с данными текстуры.

    Обсуждение

    При использовании текстуры для создания a CIImage объект, текстура должна быть допустимой в Базовом контексте Изображения (CIContext) то, что Вы рисуете CIImage объект в. Это означает, что одно из следующего должно быть истиной:

    • Текстура должна быть создана с помощью CGLContext возразите что CIContext основывается.

    • Контекст, в котором создавалась текстура, должен быть совместно использован с CGLContext то, что CIContext основывается.

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

    Базовое Изображение игнорирует фильтрацию текстуры и режимы обертки (GL_TEXTURE_FILTER и GL_TEXTURE_WRAP) то, что Вы устанавливаете через OpenGL. Фильтр и режимы обертки переопределяются тем, что объект CISampler указывает при применении фильтра к CIImage объект.

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

    Objective C

    @import CoreImage;

    Доступность

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

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

    Объявление

    Swift

    func imageByApplyingFilter(_ filterName: String!, withInputParameters params: [NSObject : AnyObject]!) -> CIImage!

    Objective C

    - (CIImage *)imageByApplyingFilter:(NSString *)filterName withInputParameters:(NSDictionary *)params

    Параметры

    filterName

    Имя фильтра для применения, как используется при создании a CIFilter экземпляр с filterWithName: метод.

    params

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

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

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

    Обсуждение

    Вызов этого метода эквивалентен следующей последовательности шагов:

    1. Создание a CIFilter экземпляр

    2. Установка исходного изображения как фильтр inputImage параметр

    3. Установка остающихся параметров фильтра от params словарь

    4. Получение outputImage объект от фильтра

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Возвращает новое изображение, представляющее исходное изображение после применения аффинного преобразования.

    Объявление

    Swift

    func imageByApplyingTransform(_ matrix: CGAffineTransform) -> CIImage!

    Objective C

    - (CIImage *)imageByApplyingTransform:(CGAffineTransform)matrix

    Параметры

    matrix

    Аффинное преобразование.

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

    Объект преобразованного изображения.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

    См. также

    – imageByCroppingToRect:

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

    Объявление

    Swift

    func imageByCroppingToRect(_ r: CGRect) -> CIImage!

    Objective C

    - (CIImage *)imageByCroppingToRect:(CGRect)r

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

    Объект изображения, обрезанный к указанному прямоугольнику.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Возвращает новое изображение, создаваемое путем преобразования исходного изображения к указанной ориентации EXIF.

    Объявление

    Swift

    func imageByApplyingOrientation(_ orientation: Int32) -> CIImage!

    Objective C

    - (CIImage *)imageByApplyingOrientation:(int)orientation

    Параметры

    orientation

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

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

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

    Обсуждение

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Объявление

    Swift

    func imageByClampingToExtent() -> CIImage!

    Objective C

    - (CIImage *)imageByClampingToExtent

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Объявление

    Swift

    func imageByCompositingOverImage(_ dest: CIImage!) -> CIImage!

    Objective C

    - (CIImage *)imageByCompositingOverImage:(CIImage *)dest

    Параметры

    dest

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

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

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

    Обсуждение

    Вызов этого метода эквивалентен использованию CISourceOverCompositing фильтр. Для использования других операций составления композита и режимов наложения создайте a CIFilter объект с помощью одного из встроенных фильтров от CICategoryCompositeOperation категория. Для получения дополнительной информации посмотрите Базовую Ссылку Фильтра Изображения.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Инициализирует изображение с указанным цветом.

    Объявление

    Swift

    init!(color color: CIColor!)

    Objective C

    - (id)initWithColor:(CIColor *)color

    Параметры

    color

    Цветовой объект.

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

    См. также

    + imageWithColor:

  • Инициализирует объект изображения с растровыми данными.

    Объявление

    Swift

    init!(bitmapData d: NSData!, bytesPerRow bpr: Int, size size: CGSize, format f: CIFormat, colorSpace c: CGColorSpace!)

    Objective C

    - (id)initWithBitmapData:(NSData *)d bytesPerRow:(size_t)bpr size:(CGSize)size format:(CIFormat)f colorSpace:(CGColorSpaceRef)c

    Параметры

    d

    Растровые данные для использования для изображения. Данные, которыми Вы снабжаете, должны быть предварительно умножены.

    bpr

    Число байтов на строку.

    size

    Размер данных изображения.

    f

    Постоянный формат пикселя. Посмотрите “Pixel Formats”.

    c

    Цветовое пространство, что изображение определяется в и должно быть Кварцем 2D цветовое пространство (CGColorSpaceRef). Передача nil для изображений, не содержащих цветные данные (такие как повышение отображается, карты вектора нормали, и выбрал функциональные таблицы).

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Инициализирует объект изображения с Кварцем 2D изображение.

    Объявление

    Swift

    init!(CGImage image: CGImage!)

    Objective C

    - (id)initWithCGImage:(CGImageRef)image

    Параметры

    image

    Кварц 2D изображение (CGImageRef) объект. Для получения дополнительной информации посмотрите Кварц 2D Руководство по программированию и Ссылка CGImage.

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Инициализирует объект изображения с Кварцем 2D изображение, с помощью указанных опций.

    Объявление

    Swift

    init!(CGImage image: CGImage!, options d: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithCGImage:(CGImageRef)image options:(NSDictionary *)d

    Параметры

    image

    Кварц 2D изображение (CGImageRef) объект. Для получения дополнительной информации посмотрите Кварц 2D Руководство по программированию и Ссылка CGImage.

    d

    Словарь, указывающий параметры изображения. (См. “Image Dictionary Keys”.)

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Инициализирует объект изображения с указанным объектом изображения UIKit.

    Объявление

    Swift

    init!(image image: UIImage!)

    Objective C

    - (instancetype)initWithImage:(UIImage *)image

    Параметры

    image

    Изображение, содержащее исходные данные.

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • Инициализирует объект изображения с указанным объектом изображения UIKit, с помощью указанных опций.

    Объявление

    Swift

    init!(image image: UIImage!, options options: [NSObject : AnyObject]!)

    Objective C

    - (instancetype)initWithImage:(UIImage *)image options:(NSDictionary *)options

    Параметры

    image

    Изображение, содержащее исходные данные.

    options

    Словарь, содержащий опции для создания объекта изображения. Можно предоставить такие опции как формат пикселя и цветовое пространство. Посмотрите “Image Dictionary Keys”.

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • Инициализирует объект изображения путем чтения изображения из URL.

    Объявление

    Swift

    init!(contentsOfURL url: NSURL!)

    Objective C

    - (id)initWithContentsOfURL:(NSURL *)url

    Параметры

    url

    Расположение файла образа для чтения.

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Инициализирует объект изображения путем чтения изображения из URL, использования указанных опций.

    Объявление

    Swift

    init!(contentsOfURL url: NSURL!, options d: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithContentsOfURL:(NSURL *)url options:(NSDictionary *)d

    Параметры

    url

    Расположение файла образа для чтения.

    d

    Словарь, указывающий параметры изображения. (См. “Image Dictionary Keys”.)

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Инициализирует объект изображения от содержания CVPixelBuffer объект.

    Объявление

    Swift

    init!(CVPixelBuffer buffer: CVPixelBuffer!)

    Objective C

    - (id)initWithCVPixelBuffer:(CVPixelBufferRef)buffer

    Параметры

    buffer

    A CVPixelBuffer объект.

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Инициализирует объект изображения от содержания CVPixelBuffer объект с помощью указанных опций.

    Объявление

    Swift

    init!(CVPixelBuffer buffer: CVPixelBuffer!, options dict: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithCVPixelBuffer:(CVPixelBufferRef)buffer options:(NSDictionary *)dict

    Параметры

    buffer

    A CVPixelBuffer объект.

    dict

    Словарь, содержащий опции для создания объекта изображения. (См. “Image Dictionary Keys”.) Формат пикселя предоставляется CVPixelBuffer объект.

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Инициализирует объект изображения с предоставленными данными изображения.

    Объявление

    Swift

    init!(data data: NSData!)

    Objective C

    - (id)initWithData:(NSData *)data

    Параметры

    data

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

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Объявление

    Swift

    init!(data data: NSData!, options d: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithData:(NSData *)data options:(NSDictionary *)d

    Параметры

    data

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

    d

    Словарь, указывающий параметры изображения. (См. “Image Dictionary Keys”.)

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Инициализирует объект изображения с данными, снабженными текстурой OpenGL.

    Объявление

    Swift

    init!(texture name: UInt32, size size: CGSize, flipped flag: Bool, colorSpace cs: CGColorSpace!)

    Objective C

    - (id)initWithTexture:(unsigned int)name size:(CGSize)size flipped:(BOOL)flag colorSpace:(CGColorSpaceRef)cs

    Параметры

    name

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

    size

    Размерности текстуры.

    flag

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

    cs

    Цветовое пространство, в котором определяется изображение. Это должно быть Кварцевым цветовым пространством (CGColorSpaceRef). Если colorSpace значение nil, изображение не является соответствующим цветом. Передача nil для изображений, не содержащих цветные данные (такие как повышение отображается, карты вектора нормали, и выбрал функциональные таблицы).

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

    Инициализированный объект изображения или nil если не мог бы быть инициализирован объект.

    Обсуждение

    При использовании текстуры для создания a CIImage объект, текстура должна быть допустимой в Базовом контексте Изображения (CIContext) то, что Вы рисуете CIImage объект в. Это означает, что одно из следующего должно быть истиной:

    • Текстура должна быть создана с помощью CGLContext возразите что CIContext основывается.

    • Контекст, в котором создавалась текстура, должен быть совместно использован с CGLContext то, что CIContextосновывается.

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

    Базовое Изображение игнорирует фильтрацию текстуры и режимы обертки (GL_TEXTURE_FILTER и GL_TEXTURE_WRAP) то, что Вы устанавливаете через OpenGL. Фильтр и режимы обертки переопределяются тем, что объект CISampler указывает при применении фильтра к CIImage объект.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Объявление

    Swift

    func extent() -> CGRect

    Objective C

    - (CGRect)extent

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

    - (NSDictionary *)properties

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

    NSDictionary объект, содержащий метаданные изображения.

    Обсуждение

    Если CIImage объект является выводом фильтра (или цепочка фильтра), этот метод возвращает метаданные из исходного входного изображения фильтра.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Объявление

    Swift

    func imageTransformForOrientation(_ orientation: Int32) -> CGAffineTransform

    Objective C

    - (CGAffineTransform)imageTransformForOrientation:(int)orientation

    Параметры

    orientation

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

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

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

    Обсуждение

    Этот метод решает, что трансформация должна была соответствовать указанную ориентацию, но не применяет ту трансформацию к изображению. Для применения трансформации (возможно после конкатенации его с другими трансформациями) используйте imageByApplyingTransform: метод или CIAffineTransform фильтр. Чтобы определить и применить трансформацию на единственном шаге, используйте imageByApplyingOrientation: метод.

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Возвраты все возможные автоматически выбранные и сконфигурированные фильтры для корректировки изображения.

    Объявление

    Swift

    func autoAdjustmentFilters() -> [AnyObject]!

    Objective C

    - (NSArray *)autoAdjustmentFilters

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Объявление

    Swift

    func autoAdjustmentFiltersWithOptions(_ options: [NSObject : AnyObject]!) -> [AnyObject]!

    Objective C

    - (NSArray *)autoAdjustmentFiltersWithOptions:(NSDictionary *)options

    Параметры

    options

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

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

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

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

    Объявление

    Swift

    func regionOfInterestForImage(_ im: CIImage!, inRect r: CGRect) -> CGRect

    Objective C

    - (CGRect)regionOfInterestForImage:(CIImage *)im inRect:(CGRect)r

    Параметры

    im

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

    r

    Прямоугольник в координатном пространстве изображения.

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

    Прямоугольник в координатном пространстве входного изображения ( im параметр).

    Обсуждение

    Область интереса является прямоугольником, содержащим пиксельные данные в исходном изображении ( im параметр) необходимый для создания соответствующего прямоугольника в выходном изображении. Если изображение не является выводом фильтра (или цепочки или графика нескольких CIFilter объекты), или изображение в im параметр не является вводом к тому фильтру, прямоугольник возвратился, совпадает с этим в r параметр.

    Например,

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

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

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

Типы данных

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

    Объявление

    Swift

    typealias CIFormat = Int32

    Objective C

    typedef int CIFormat;

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

    Objective C

    @import CoreImage;

    Swift

    import CoreImage

    Доступность

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

  • Форматы пикселя данных изображения.

    Объявление

    Swift

    var kCIFormatARGB8: CIFormat var kCIFormatBGRA8: CIFormat var kCIFormatRGBA8: CIFormat

    Objective C

    extern CIFormat kCIFormatARGB8; extern CIFormat kCIFormatBGRA8; extern CIFormat kCIFormatRGBA8;

    Константы

    • kCIFormatARGB8

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

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

    • kCIFormatBGRA8

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

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

    • kCIFormatRGBA8

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

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

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

    Объявление

    Swift

    let kCIImageColorSpace: String let kCIImageProperties: String

    Objective C

    extern NSString *kCIImageColorSpace; extern NSString *kCIImageProperties;

    Константы

    • kCIImageColorSpace

      Ключ для цветового пространства.

      Для получения дополнительной информации об этом типе данных посмотрите Ссылку CGColorSpace. Обычно Вы используете эту опцию, когда необходимо загрузить повышение, маску, вектор нормали или данные датчика RAW непосредственно от файла без цвета, исправляющего ее. Эта константа указывает для переопределения Базового Изображения, по умолчанию, предполагающего, что данные находятся в GenericRGB.

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

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

    • kCIImageProperties

      Ключ для свойств метаданных изображения.

      Значение, которое Вы предоставляете для этого ключа словаря, должно быть a CGColorSpaceRef тип данных. Если значение для этого ключа не предоставляется, изображение colorSpace словарь заполняется автоматически путем вызова CGImageSourceCopyPropertiesAtIndex. Чтобы гарантировать, что изображение не имеет никаких свойств метаданных, устанавливает значение этого ключа к [NSNull null].

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

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

    Объявление

    Swift

    let kCIImageAutoAdjustEnhance: String let kCIImageAutoAdjustRedEye: String let kCIImageAutoAdjustFeatures: String let kCIImageAutoAdjustCrop: String let kCIImageAutoAdjustLevel: String

    Objective C

    NSString *kCIImageAutoAdjustEnhance; NSString *kCIImageAutoAdjustRedEye; NSString *kCIImageAutoAdjustFeatures; NSString *kCIImageAutoAdjustCrop; NSString *kCIImageAutoAdjustLevel;

    Константы

    • kCIImageAutoAdjustEnhance

      Ключ раньше указывал, возвратить ли фильтры улучшения.

      Значение, связанное с этим ключом, является a CFBoolean значение. Предоставление false указать для не возврата фильтров улучшения. Если Вы не указываете эту опцию, Базовое Изображение предполагает, что его значение true.

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

    • kCIImageAutoAdjustRedEye

      Ключ раньше указывал, возвратить ли красный глазной фильтр.

      Значение, связанное с этим ключом, является a CFBoolean значение. Предоставление false указать для не возврата красного глазного фильтра. Если Вы не указываете эту опцию, Базовое Изображение предполагает, что его значение true.

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

    • kCIImageAutoAdjustFeatures

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

      Присваиваемое значение является массивом CIFeature объекты. Если Вы не предоставляете массив, Базовое Изображение ищет функции с помощью CIDetector класс.

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

    • kCIImageAutoAdjustCrop

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

      Значение, связанное с этим ключом, является a CFBoolean значение. Если true, возвращенные фильтры включают работу, которую обрезки изображение вокруг функций указали с kCIImageAutoAdjustFeatures опция (или любые функции обнаружил в изображении, если та опция не присутствует). Предоставление false указать для не возврата фильтра обрезки. Если Вы не указываете эту опцию, Базовое Изображение предполагает, что его значение false.

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

    • kCIImageAutoAdjustLevel

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

      Значение, связанное с этим ключом, является a CFBoolean значение. Если true, Базовое Изображение анализирует изображение, чтобы определить, получило ли бы это преимущества от вращения — например, альбомная фотография, в которой горизонт не является горизонталью — и возвращает фильтр для выполнения того вращения. Предоставление false указать для не возврата фильтра вращения. Если Вы не указываете эту опцию, Базовое Изображение предполагает, что его значение false.

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