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 *)dbytesPerRow:(size_t)bprsize:(CGSize)sizeformat:(CIFormat)fcolorSpace:(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)imageoptions:(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 *)urloptions:(NSDictionary *)dПараметры
urlРасположение файла.
dСловарь, указывающий параметры изображения. (См.
“Image Dictionary Keys”.)Возвращаемое значение
Объект изображения, инициализированный с содержанием файла и установленный с указанными опциями.
Оператор импорта
Objective C
@import CoreImage;Доступность
Доступный в iOS 5.0 и позже.
-
Создает и возвращает объект изображения из содержания
CVPixelBufferобъект.Объявление
Objective C
+ (CIImage *)imageWithCVPixelBuffer:(CVPixelBufferRef)bufferПараметры
bufferA
CVPixelBufferобъект.Возвращаемое значение
Объект изображения, инициализированный с содержанием изображения, буферизует объект.
Оператор импорта
Objective C
@import CoreImage;Доступность
Доступный в iOS 5.0 и позже.
-
Создает и возвращает объект изображения из содержания
CVPixelBufferобъект, с помощью указанных опций.Объявление
Objective C
+ (CIImage *)imageWithCVPixelBuffer:(CVPixelBufferRef)bufferoptions:(NSDictionary *)dictПараметры
bufferA
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 *)dataoptions:(NSDictionary *)dПараметры
dataУказатель на данные изображения. Данные должны быть предварительно умножены
dСловарь, указывающий параметры изображения. (См.
“Image Dictionary Keys”.)Возвращаемое значение
Объект изображения, инициализированный с данными, которыми снабжают, и установленный с указанными опциями.
Оператор импорта
Objective C
@import CoreImage;Доступность
Доступный в iOS 5.0 и позже.
См. также
-
Создает и возвращает объект изображения, инициализированный с данными, снабженными текстурой OpenGL.
Объявление
Objective C
+ (CIImage *)imageWithTexture:(unsigned int)namesize:(CGSize)sizeflipped:(BOOL)flagcolorSpace:(CGColorSpaceRef)csПараметры
nameТекстура OpenGL. Поскольку
CIImageобъекты являются неизменными, текстура должна остаться неизменной для жизни объекта изображения. Посмотрите обсуждение для получения дополнительной информации.sizeРазмерности текстуры.
flagYEStrueдля имения Базового Изображения зеркально отражают координаты текстуры вертикально для преобразования между 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 *)filterNamewithInputParameters:(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!(bitmapDatad: NSData!, bytesPerRowbpr: Int, sizesize: CGSize, formatf: CIFormat, colorSpacec: CGColorSpace!)Objective C
- (id)initWithBitmapData:(NSData *)dbytesPerRow:(size_t)bprsize:(CGSize)sizeformat:(CIFormat)fcolorSpace:(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!(CGImageimage: CGImage!, optionsd: [NSObject : AnyObject]!)Objective C
- (id)initWithCGImage:(CGImageRef)imageoptions:(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!(imageimage: 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 *)imageoptions:(NSDictionary *)optionsПараметры
imageИзображение, содержащее исходные данные.
optionsСловарь, содержащий опции для создания объекта изображения. Можно предоставить такие опции как формат пикселя и цветовое пространство. Посмотрите
“Image Dictionary Keys”.Возвращаемое значение
Инициализированный объект изображения или
nilесли не мог бы быть инициализирован объект.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
Инициализирует объект изображения путем чтения изображения из URL.
Объявление
Swift
init!(contentsOfURLurl: 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 *)urloptions:(NSDictionary *)dПараметры
urlРасположение файла образа для чтения.
dСловарь, указывающий параметры изображения. (См.
“Image Dictionary Keys”.)Возвращаемое значение
Инициализированный объект изображения или
nilесли не мог бы быть инициализирован объект.Оператор импорта
Objective C
@import CoreImage;Swift
import CoreImageДоступность
Доступный в iOS 5.0 и позже.
-
Инициализирует объект изображения от содержания
CVPixelBufferобъект.Объявление
Swift
init!(CVPixelBufferbuffer: CVPixelBuffer!)Objective C
- (id)initWithCVPixelBuffer:(CVPixelBufferRef)bufferПараметры
bufferA
CVPixelBufferобъект.Возвращаемое значение
Инициализированный объект изображения или
nilесли не мог бы быть инициализирован объект.Оператор импорта
Objective C
@import CoreImage;Swift
import CoreImageДоступность
Доступный в iOS 5.0 и позже.
-
Инициализирует объект изображения от содержания
CVPixelBufferобъект с помощью указанных опций.Объявление
Swift
init!(CVPixelBufferbuffer: CVPixelBuffer!, optionsdict: [NSObject : AnyObject]!)Objective C
- (id)initWithCVPixelBuffer:(CVPixelBufferRef)bufferoptions:(NSDictionary *)dictПараметры
bufferA
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 *)dataoptions:(NSDictionary *)dПараметры
dataДанные изображения. Данные, которыми Вы снабжаете, должны быть предварительно умножены.
dСловарь, указывающий параметры изображения. (См.
“Image Dictionary Keys”.)Возвращаемое значение
Инициализированный объект изображения или
nilесли не мог бы быть инициализирован объект.Оператор импорта
Objective C
@import CoreImage;Swift
import CoreImageДоступность
Доступный в iOS 5.0 и позже.
См. также
-
Инициализирует объект изображения с данными, снабженными текстурой OpenGL.
Объявление
Swift
init!(texturename: UInt32, sizesize: CGSize, flippedflag: Bool, colorSpacecs: CGColorSpace!)Objective C
- (id)initWithTexture:(unsigned int)namesize:(CGSize)sizeflipped:(BOOL)flagcolorSpace:(CGColorSpaceRef)csПараметры
nameТекстура OpenGL. Поскольку
CIImageобъекты являются неизменными, текстура должна остаться неизменной для жизни объекта изображения. Посмотрите обсуждение для получения дополнительной информации.sizeРазмерности текстуры.
flagYEStrueдля имения Базового Изображения зеркально отражают координаты текстуры вертикально для преобразования между 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 = Int32Objective 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;Константы
-
kCIFormatARGB832 бита на пиксель, формат пикселя фиксированной точки, в котором альфа-значение предшествует красным, зеленым и синим компонентам цвета.
Доступный в iOS 6.0 и позже.
-
kCIFormatBGRA832 бита на пиксель, формат пикселя фиксированной точки, в котором синие, зеленые, и красные компоненты цвета предшествуют альфа-значению.
Доступный в iOS 5.0 и позже.
-
kCIFormatRGBA832 бита на пиксель, формат пикселя фиксированной точки, в котором красные, зеленые, и синие компоненты цвета предшествуют альфа-значению.
Доступный в 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: StringObjective 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 и позже.
-
