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

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

Разработчик

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

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

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

CIImage

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

import QuartzCore

Objective C

@import QuartzCore;

Доступность

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

Создание изображения
  • emptyImage () + emptyImage

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

    Объявление

    Swift

    class func emptyImage() -> CIImage!

    Objective C

    + (CIImage *)emptyImage

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • imageWithColor: + imageWithColor:

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

    Объявление

    Objective C

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

    Параметры

    color

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    – initWithColor:

  • imageWithBitmapData:bytesPerRow:size:format:colorSpace: + imageWithBitmapData:bytesPerRow:size:format:colorSpace:

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

    Объявление

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

    Доступность

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

    См. также

    – initWithBitmapData:bytesPerRow:size:format:colorSpace:

  • imageWithCGImage: + imageWithCGImage:

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

    Объявление

    Objective C

    + (CIImage *)imageWithCGImage:(CGImageRef)image

    Параметры

    image

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithCGImage:options:
    – initWithCGImage:

  • imageWithCGImage:options: + imageWithCGImage:options:

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

    Объявление

    Objective C

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

    Параметры

    image

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

    d

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithCGImage:
    – initWithCGImage:options:

  • imageWithCGLayer: + imageWithCGLayer:

    Создает и возвращает объект изображения из содержания, предоставленного a CGLayer объект.

    Объявление

    Objective C

    + (CIImage *)imageWithCGLayer:(CGLayerRef)layer

    Параметры

    layer

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithCGLayer:options:
    – initWithCGLayer:

  • imageWithCGLayer:options: + imageWithCGLayer:options:

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

    Объявление

    Objective C

    + (CIImage *)imageWithCGLayer:(CGLayerRef)layer options:(NSDictionary *)d

    Параметры

    layer

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

    d

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithCGLayer:
    – initWithCGLayer:options:

  • imageWithContentsOfURL: + imageWithContentsOfURL:

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

    Объявление

    Objective C

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

    Параметры

    url

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithContentsOfURL:options:
    – initWithContentsOfURL:

  • imageWithContentsOfURL:options: + imageWithContentsOfURL:options:

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

    Объявление

    Objective C

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

    Параметры

    url

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

    d

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithContentsOfURL:
    – initWithContentsOfURL:options:

  • imageWithCVImageBuffer: + imageWithCVImageBuffer:

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

    Объявление

    Objective C

    + (CIImage *)imageWithCVImageBuffer:(CVImageBufferRef)imageBuffer

    Параметры

    imageBuffer

    A CVImageBuffer объект. Для получения дополнительной информации см. Базовое Видео Руководство по программированию и Базовый Набор Ссылки на видеоролик.

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithCVImageBuffer:options:
    – initWithCVImageBuffer:

  • imageWithCVImageBuffer:options: + imageWithCVImageBuffer:options:

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

    Объявление

    Objective C

    + (CIImage *)imageWithCVImageBuffer:(CVImageBufferRef)imageBuffer options:(NSDictionary *)dict

    Параметры

    imageBuffer

    A CVImageBuffer объект. Для получения дополнительной информации см. Базовое Видео Руководство по программированию и Базовый Набор Ссылки на видеоролик.

    dict

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithCVImageBuffer:
    – initWithCVImageBuffer:options:

  • imageWithData: + imageWithData:

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

    Объявление

    Objective C

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

    Параметры

    data

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithData:options:
    – initWithData:

  • imageWithData:options: + imageWithData:options:

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

    Объявление

    Objective C

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

    Параметры

    data

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

    d

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithData:
    – initWithData:options:

  • imageWithImageProvider:size:: format:colorSpace:options: + imageWithImageProvider:size:: format:colorSpace:options:

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

    Объявление

    Objective C

    + (CIImage *)imageWithImageProvider:(id)p size:(size_t)width :(size_t)height format:(CIFormat)f colorSpace:(CGColorSpaceRef)cs options:(NSDictionary *)dict

    Параметры

    p

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

    width

    Ширина изображения.

    height

    Высота изображения.

    f

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

    cs

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

    dict

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    – initWithImageProvider:size:: format:colorSpace:options:

  • imageWithTexture:size:flipped:colorSpace: + imageWithTexture:size:flipped:colorSpace:

    Создает и возвращает объект изображения, инициализированный с данными, снабженными текстурой 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 QuartzCore;

    Доступность

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

    См. также

    – initWithTexture:size:flipped:colorSpace:

  • imageWithTexture:size:flipped:options: + imageWithTexture:size:flipped:options:

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

    Объявление

    Objective C

    + (CIImage *)imageWithTexture:(unsigned int)name size:(CGSize)size flipped:(BOOL)flag options:(NSDictionary *)options

    Параметры

    name

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

    size

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

    flag

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

    options

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

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

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

    Обсуждение

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

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

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    – initWithTexture:size:flipped:options:

  • imageWithIOSurface: + imageWithIOSurface:

    Создает и возвращает изображение из содержания IOSurface.

    Объявление

    Objective C

    + (CIImage *)imageWithIOSurface:(IOSurfaceRef)surface

    Параметры

    surface

    Объект IOSurface.

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

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

    Обсуждение

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

  • imageWithIOSurface:options: + imageWithIOSurface:options:

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

    Объявление

    Objective C

    + (CIImage *)imageWithIOSurface:(IOSurfaceRef)surface options:(NSDictionary *)options

    Параметры

    surface

    Объект IOSurface.

    options

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

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

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

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + imageWithIOSurface:

Создание изображения путем изменения существующего изображения
  • imageByApplyingFilter (_: withInputParameters:) - imageByApplyingFilter:withInputParameters:

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

    Объявление

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

    Swift

    import QuartzCore

    Доступность

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

  • imageByApplyingTransform (_:) - imageByApplyingTransform:

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

    Объявление

    Swift

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

    Objective C

    - (CIImage *)imageByApplyingTransform:(CGAffineTransform)matrix

    Параметры

    matrix

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – imageByCroppingToRect:

  • imageByCroppingToRect (_:) - imageByCroppingToRect:

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

    Объявление

    Swift

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

    Objective C

    - (CIImage *)imageByCroppingToRect:(CGRect)r

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – imageByApplyingTransform:

  • imageByApplyingOrientation (_:) - imageByApplyingOrientation:

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

    Объявление

    Swift

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

    Objective C

    - (CIImage *)imageByApplyingOrientation:(int)orientation

    Параметры

    orientation

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • imageByClampingToExtent () - imageByClampingToExtent

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

    Объявление

    Swift

    func imageByClampingToExtent() -> CIImage!

    Objective C

    - (CIImage *)imageByClampingToExtent

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • imageByCompositingOverImage (_:) - imageByCompositingOverImage:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    dest

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

Инициализация изображения
  • init (цвет:) - initWithColor:

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

    Объявление

    Swift

    init!(color color: CIColor!)

    Objective C

    - (id)initWithColor:(CIColor *)color

    Параметры

    color

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    + imageWithColor:

  • init (bitmapData:bytesPerRow:size:format:colorSpace:) - initWithBitmapData:bytesPerRow:size:format:colorSpace:

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

    Объявление

    Swift

    init!(bitmapData d: NSData!, bytesPerRow bpr: UInt, 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 QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    + imageWithBitmapData:bytesPerRow:size:format:colorSpace:

  • init (CGImage:) - initWithCGImage:

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

    Объявление

    Swift

    init!(CGImage image: CGImage!)

    Objective C

    - (id)initWithCGImage:(CGImageRef)image

    Параметры

    image

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithCGImage:options:
    + imageWithCGImage:

  • init (CGImage:options:) - initWithCGImage:options:

    Инициализирует объект изображения с Кварцем 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 QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithCGImage:
    + imageWithCGImage:options:

  • init (bitmapImageRep:) - initWithBitmapImageRep:

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

    Объявление

    Swift

    init?(bitmapImageRep bitmapImageRep: NSBitmapImageRep)

    Objective C

    - (instancetype)initWithBitmapImageRep:(NSBitmapImageRep *)bitmapImageRep

    Параметры

    bitmapImageRep

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (CGLayer:) - initWithCGLayer:

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

    Объявление

    Swift

    init!(CGLayer layer: CGLayer!)

    Objective C

    - (id)initWithCGLayer:(CGLayerRef)layer

    Параметры

    layer

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithCGLayer:options:
    + imageWithCGLayer:

  • init (CGLayer:options:) - initWithCGLayer:options:

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

    Объявление

    Swift

    init!(CGLayer layer: CGLayer!, options d: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithCGLayer:(CGLayerRef)layer options:(NSDictionary *)d

    Параметры

    layer

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

    d

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithCGLayer:
    + imageWithCGLayer:options:

  • init (contentsOfURL:) - initWithContentsOfURL:

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

    Объявление

    Swift

    init!(contentsOfURL url: NSURL!)

    Objective C

    - (id)initWithContentsOfURL:(NSURL *)url

    Параметры

    url

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithContentsOfURL:options:
    + imageWithContentsOfURL:

  • init (contentsOfURL:options:) - initWithContentsOfURL:options:

    Инициализирует объект изображения путем чтения изображения из 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 QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithContentsOfURL:
    + imageWithContentsOfURL:options:

  • init (CVImageBuffer:) - initWithCVImageBuffer:

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

    Объявление

    Swift

    init!(CVImageBuffer imageBuffer: CVImageBuffer!)

    Objective C

    - (id)initWithCVImageBuffer:(CVImageBufferRef)imageBuffer

    Параметры

    imageBuffer

    A CVImageBuffer объект в поддерживаемом постоянном формате пикселя. Для получения дополнительной информации см. Базовое Видео Руководство по программированию и Базовый Набор Ссылки на видеоролик.

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

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

    Обсуждение

    imageBuffer параметр должен быть в одном из следующих форматов:

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithCVImageBuffer:options:
    + imageWithCVImageBuffer:

  • init (CVImageBuffer:options:) - initWithCVImageBuffer:options:

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

    Объявление

    Swift

    init!(CVImageBuffer imageBuffer: CVImageBuffer!, options dict: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithCVImageBuffer:(CVImageBufferRef)imageBuffer options:(NSDictionary *)dict

    Параметры

    imageBuffer

    A CVImageBuffer объект в поддерживаемом постоянном формате пикселя. Для получения дополнительной информации см. Базовое Видео Руководство по программированию и Базовый Набор Ссылки на видеоролик.

    dict

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

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

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

    Обсуждение

    imageBuffer параметр должен быть в одном из следующих форматов:

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithCVImageBuffer:
    + imageWithCVImageBuffer:options:

  • init (данные:) - initWithData:

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

    Объявление

    Swift

    init!(data data: NSData!)

    Objective C

    - (id)initWithData:(NSData *)data

    Параметры

    data

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithData:options:
    + imageWithData:

  • init (data:options:) - initWithData:options:

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

    Объявление

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

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – initWithData:
    + imageWithData:options:

  • init (imageProvider:size:_:format:colorSpace:options:) - initWithImageProvider:size:: format:colorSpace:options:

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

    Объявление

    Swift

    init!(imageProvider p: AnyObject!, size width : UInt, _ height: UInt, format f: CIFormat, colorSpace cs: CGColorSpace!, options dict: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithImageProvider:(id)p size:(size_t)width :(size_t)height format:(CIFormat)f colorSpace:(CGColorSpaceRef)cs options:(NSDictionary *)dict

    Параметры

    p

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

    width

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

    height

    Высота данных изображения.

    f

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

    cs

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

    dict

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    + imageWithImageProvider:size:: format:colorSpace:options:

  • init (texture:size:flipped:colorSpace:) - initWithTexture:size:flipped:colorSpace:

    Инициализирует объект изображения с данными, снабженными текстурой 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 QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    + imageWithTexture:size:flipped:colorSpace:

  • init (texture:size:flipped:options:) - initWithTexture:size:flipped:options:

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

    Объявление

    Swift

    init!(texture name: UInt32, size size: CGSize, flipped flag: Bool, options options: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithTexture:(unsigned int)name size:(CGSize)size flipped:(BOOL)flag options:(NSDictionary *)options

    Параметры

    name

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

    size

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

    flag

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

    options

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

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

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

    Обсуждение

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

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

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    + imageWithTexture:size:flipped:options:

  • init (IOSurface:) - initWithIOSurface:

    Инициализирует изображение с содержанием IOSurface.

    Объявление

    Swift

    init!(IOSurface surface: IOSurface!)

    Objective C

    - (id)initWithIOSurface:(IOSurfaceRef)surface

    Параметры

    surface

    Объект IOSurface.

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

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

    Обсуждение

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • init (IOSurface:options:) - initWithIOSurface:options:

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

    Объявление

    Swift

    init!(IOSurface surface: IOSurface!, options options: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithIOSurface:(IOSurfaceRef)surface options:(NSDictionary *)options

    Параметры

    surface

    Объект IOSurface.

    options

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • init (IOSurface:plane:format:options:) - initWithIOSurface:plane:format:options:

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

    Объявление

    Swift

    init!(IOSurface surface: IOSurface!, plane plane: UInt, format format: CIFormat, options options: [NSObject : AnyObject]!)

    Objective C

    - (id)initWithIOSurface:(IOSurfaceRef)surface plane:(size_t)plane format:(CIFormat)format options:(NSDictionary *)options

    Параметры

    surface

    Объект IOSurface.

    plane

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

    format

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

    options

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

Получение данных изображения
  • определение () - определение

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

    Объявление

    Swift

    func definition() -> CIFilterShape!

    Objective C

    - (CIFilterShape *)definition

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

    Объект фигуры фильтра.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – степень

  • степень () - степень

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

    Объявление

    Swift

    func extent() -> CGRect

    Objective C

    - (CGRect)extent

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – определение

  • свойства () - свойства

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

    Объявление

    Swift

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

    Objective C

    - (NSDictionary *)properties

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

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

    Обсуждение

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • URL () - URL

    Возвращает URL, из которого было загружено изображение.

    Объявление

    Swift

    func url() -> NSURL!

    Objective C

    - (NSURL *)url

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

    NSURL объект, ссылающийся на расположение изображение, был загружен из.

    Обсуждение

    Возвраты nil если не может быть определен URL. URL Только доступен, если объект изображения создавался с URL (как initWithContentsOfURL: метод и связанные методы).

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • цветовое пространство () - цветовое пространство

    Возвращает цветовое пространство изображения.

    Объявление

    Swift

    func colorSpace() -> Unmanaged<CGColorSpace>!

    Objective C

    - (CGColorSpaceRef)colorSpace

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

    A CGColorSpaceRef объект, описывающий цветовое пространство изображения.

    Обсуждение

    Возвраты nil если не может быть определено цветовое пространство изображения.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • imageTransformForOrientation (_:) - imageTransformForOrientation:

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

    Объявление

    Swift

    func imageTransformForOrientation(_ orientation: Int32) -> CGAffineTransform

    Objective C

    - (CGAffineTransform)imageTransformForOrientation:(int)orientation

    Параметры

    orientation

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

Рисование изображений
  • drawAtPoint (_: fromRect:operation:fraction:) - drawAtPoint:fromRect:operation:fraction:

    Рисует все или часть изображения в указанной точке в текущей системе координат.

    Объявление

    Swift

    func drawAtPoint(_ point: NSPoint, fromRect srcRect: NSRect, operation op: NSCompositingOperation, fraction delta: CGFloat)

    Objective C

    - (void)drawAtPoint:(NSPoint)point fromRect:(NSRect)srcRect operation:(NSCompositingOperation)op fraction:(CGFloat)delta

    Параметры

    point

    Расположение в текущей системе координат, в которой можно нарисовать изображение.

    srcRect

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

    op

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

    delta

    Непрозрачность изображения, указанного как значение от 0.0 к 1.0. Указание значения 0.0 рисует изображение как полностью прозрачное в то время как значение 1.0 рисует изображение как полностью непрозрачное. Значения, больше, чем 1.0 интерпретируются как 1.0.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • drawInRect (_: fromRect:operation:fraction:) - drawInRect:fromRect:operation:fraction:

    Рисует все или часть изображения в указанном прямоугольнике в текущей системе координат

    Объявление

    Swift

    func drawInRect(_ dstRect: NSRect, fromRect srcRect: NSRect, operation op: NSCompositingOperation, fraction delta: CGFloat)

    Objective C

    - (void)drawInRect:(NSRect)dstRect fromRect:(NSRect)srcRect operation:(NSCompositingOperation)op fraction:(CGFloat)delta

    Параметры

    dstRect

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

    srcRect

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

    op

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

    delta

    Непрозрачность изображения, указанного как значение от 0.0 к 1.0. Указание значения 0.0 рисует изображение как полностью прозрачное в то время как значение 1.0 рисует изображение как полностью непрозрачное. Значения, больше, чем 1.0 интерпретируются как 1.0.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Получение фильтров автокорректировки
  • autoAdjustmentFilters () - autoAdjustmentFilters

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

    Объявление

    Swift

    func autoAdjustmentFilters() -> [AnyObject]!

    Objective C

    - (NSArray *)autoAdjustmentFilters

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • autoAdjustmentFiltersWithOptions (_:) - autoAdjustmentFiltersWithOptions:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    options

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

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

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

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

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

Типы данных

  • CIFormat CIFormat

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

    Объявление

    Swift

    typealias CIFormat = Int32

    Objective C

    typedef int CIFormat;

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

Константы
  • Форматы пикселя

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

    Объявление

    Swift

    var kCIFormatARGB8: CIFormat var kCIFormatRGBA16: CIFormat var kCIFormatRGBAf: CIFormat var kCIFormatRGBAh: CIFormat

    Objective C

    extern CIFormat kCIFormatARGB8; extern CIFormat kCIFormatRGBA16; extern CIFormat kCIFormatRGBAf; extern CIFormat kCIFormatRGBAh;

    Константы

    • kCIFormatARGB8

      kCIFormatARGB8

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

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

    • kCIFormatRGBA16

      kCIFormatRGBA16

      64 бита на пиксель, формат пикселя фиксированной точки.

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

    • kCIFormatRGBAf

      kCIFormatRGBAf

      128 бит на пиксель, формат пикселя с плавающей точкой.

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

    • kCIFormatRGBAh

      kCIFormatRGBAh

      64 бита на пиксель, формат пикселя с плавающей точкой.

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

  • Ключи словаря изображения

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

    Объявление

    Swift

    var kCIImageColorSpace: NSString! var kCIImageProperties: NSString! var kCIImageTextureTarget: NSString! var kCIImageTextureFormat: NSString!

    Objective C

    extern NSString *kCIImageColorSpace; extern NSString *kCIImageProperties; extern NSString *kCIImageTextureTarget; extern NSString *kCIImageTextureFormat;

    Константы

    • kCIImageColorSpace

      kCIImageColorSpace

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

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

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

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

    • kCIImageProperties

      kCIImageProperties

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

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

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

    • kCIImageTextureTarget

      kCIImageTextureTarget

      Ключ для OpenGL текстурирует цель.

      Значение для этого ключа должно быть NSNumber объект, содержащий поддерживаемый OpenGL, текстурирует целевую константу, также GL_TEXTURE_2D или GL_TEXTURE_RECTANGLE_ARB. Можно только использовать этот ключ при инициализации изображения с помощью initWithTexture:size:flipped:options: метод.

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

    • kCIImageTextureFormat

      kCIImageTextureFormat

      Ключ для формата текстур OpenGL.

      Значение для этого ключа должно быть NSNumber объект, содержащий Базовый постоянный формат Пикселя изображения. (См. Форматы пикселя.) Можно только использовать этот ключ при инициализации изображения с помощью initWithTexture:size:flipped:options: метод.

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

  • Ключи автокорректировки

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

    Объявление

    Swift

    var kCIImageAutoAdjustEnhance: NSString! var kCIImageAutoAdjustRedEye: NSString! var kCIImageAutoAdjustFeatures: NSString! var kCIImageAutoAdjustCrop: NSString! var kCIImageAutoAdjustLevel: NSString!

    Objective C

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

    Константы

    • kCIImageAutoAdjustEnhance

      kCIImageAutoAdjustEnhance

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

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

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

    • kCIImageAutoAdjustRedEye

      kCIImageAutoAdjustRedEye

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

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

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

    • kCIImageAutoAdjustFeatures

      kCIImageAutoAdjustFeatures

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

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

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

    • kCIImageAutoAdjustCrop

      kCIImageAutoAdjustCrop

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

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

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

    • kCIImageAutoAdjustLevel

      kCIImageAutoAdjustLevel

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

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

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