CIImage
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSCopying
-
NSObjectProtocol
-
Печатаемый
-
NSCoding
-
NSCopying
-
NSObject
Оператор импорта
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, см. Базовое Руководство по программированию Изображения.
-
Создает и возвращает пустой объект изображения.
Возвращаемое значение
Объект изображения.
Оператор импорта
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 и позже.
См. также
-
Создает и возвращает объект изображения из растровых данных.
Объявление
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
YES
true
для имения Базового Изображения зеркально отражают координаты текстуры вертикально для преобразования между 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!, withInputParametersparams
: [NSObject : AnyObject]!) -> CIImage!Objective C
- (CIImage *)imageByApplyingFilter:(NSString *)
filterName
withInputParameters:(NSDictionary *)params
Параметры
filterName
Имя фильтра для применения, как используется при создании a
CIFilter
экземпляр сfilterWithName:
метод.params
Словарь, пары ключ/значение которого установлены как входные значения в фильтр. Каждый ключ является константой, указывающей имя входного параметра для фильтра, и соответствующее значение является значением для того параметра. Посмотрите Базовую Ссылку Фильтра Изображения для встроенных фильтров и их позволенных параметров.
Возвращаемое значение
Объект изображения, представляющий результат применения фильтра.
Обсуждение
Вызов этого метода эквивалентен следующей последовательности шагов:
Создание a
CIFilter
экземплярУстановка исходного изображения как фильтр
inputImage
параметрУстановка остающихся параметров фильтра от
params
словарьПолучение
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 и позже.
См. также
-
Возвращает новое изображение, представляющее исходное изображение после обрезки к прямоугольнику.
Объявление
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 и позже.
-
Возвращает новое изображение, создаваемое путем составления композита исходного изображения по указанному конечному изображению.
Объявление
Objective C
- (CIImage *)imageByCompositingOverImage:(CIImage *)
dest
Параметры
dest
Изображение для служения в качестве места назначения составляющей композит работы.
Возвращаемое значение
Объект изображения, представляющий результат составляющей композит работы.
Обсуждение
Вызов этого метода эквивалентен использованию
CISourceOverCompositing
фильтр. Для использования других операций составления композита и режимов наложения создайте aCIFilter
объект с помощью одного из встроенных фильтров отCICategoryCompositeOperation
категория. Для получения дополнительной информации посмотрите Базовую Ссылку Фильтра Изображения.Оператор импорта
Objective C
@import CoreImage;
Swift
import CoreImage
Доступность
Доступный в iOS 8.0 и позже.
-
Инициализирует изображение с указанным цветом.
Параметры
color
Цветовой объект.
Возвращаемое значение
Инициализированный объект изображения или
nil
если не мог бы быть инициализирован объект.Оператор импорта
Objective C
@import CoreImage;
Swift
import CoreImage
Доступность
Доступный в iOS 5.0 и позже.
См. также
-
init (bitmapData:bytesPerRow:size:format:colorSpace:) - initWithBitmapData:bytesPerRow:size:format:colorSpace:
Инициализирует объект изображения с растровыми данными.
Объявление
Swift
init!(bitmapData
d
: NSData!, bytesPerRowbpr
: Int, sizesize
: CGSize, formatf
: CIFormat, colorSpacec
: 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 изображение.
Параметры
image
Кварц 2D изображение (
CGImageRef
) объект. Для получения дополнительной информации посмотрите Кварц 2D Руководство по программированию и Ссылка CGImage.Возвращаемое значение
Инициализированный объект изображения или
nil
если не мог бы быть инициализирован объект.Оператор импорта
Objective C
@import CoreImage;
Swift
import CoreImage
Доступность
Доступный в iOS 5.0 и позже.
-
Инициализирует объект изображения с Кварцем 2D изображение, с помощью указанных опций.
Объявление
Swift
init!(CGImage
image
: CGImage!, optionsd
: [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, с помощью указанных опций.
Объявление
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, использования указанных опций.
Объявление
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!, optionsdict
: [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 и позже.
-
Инициализирует объект изображения с предоставленными данными изображения.
Параметры
data
Данные изображения. Данные, которыми Вы снабжаете, должны быть предварительно умножены.
Возвращаемое значение
Инициализированный объект изображения или
nil
если не мог бы быть инициализирован объект.Оператор импорта
Objective C
@import CoreImage;
Swift
import CoreImage
Доступность
Доступный в iOS 5.0 и позже.
См. также
-
Инициализирует объект изображения с предоставленными данными изображения, с помощью указанных опций.
Объявление
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, sizesize
: CGSize, flippedflag
: Bool, colorSpacecs
: CGColorSpace!)Objective C
- (id)initWithTexture:(unsigned int)
name
size:(CGSize)size
flipped:(BOOL)flag
colorSpace:(CGColorSpaceRef)cs
Параметры
name
Текстура OpenGL. Поскольку
CIImage
объекты являются неизменными, текстура должна остаться неизменной для жизни объекта изображения. Посмотрите обсуждение для получения дополнительной информации.size
Размерности текстуры.
flag
YES
true
для имения Базового Изображения зеркально отражают координаты текстуры вертикально для преобразования между 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 и позже.
-
Возвращает прямоугольник, указывающий степень изображения.
Возвращаемое значение
Прямоугольник, указывающий степень изображения в координатах рабочей области.
Оператор импорта
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) -> CGAffineTransformObjective 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 и позже.
-
Возвращает представляющую интерес область для цепочки фильтра, генерирующей изображение.
Объявление
Параметры
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 и позже.
-
Форматы пикселя данных изображения.
Объявление
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 и позже.
-
-
Константы, используемые в качестве ключей в словаре опций при инициализации изображения.
Объявление
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 и позже.
-