UIImage
Соответствует
-
AnyObject -
CVarArgType -
Сопоставимый -
Hashable -
NSCoding -
NSObjectProtocol -
NSSecureCoding -
Печатаемый -
UIAccessibilityIdentification -
NSObject -
NSSecureCoding
Оператор импорта
Swift
import UIKit
Objective C
@import UIKit;
Доступность
Доступный в iOS 2.0 и позже.
A UIImage объект является высокоуровневым путем к данным изображения на дисплее. Можно создать изображения из файлов из Кварцевых объектов изображения, или от необработанных данных изображения Вы получаете. UIImage класс также предлагает несколько опций для рисования изображений к текущему графическому контексту с помощью различных режимов смешивания и значений непрозрачности.
Объекты изображения являются неизменными, таким образом, Вы не можете изменить их свойства после создания. Это означает, что Вы обычно указываете свойства изображения во время инициализации или полагаетесь на метаданные изображения для обеспечения значения свойства. Это также означает, что объекты изображения самостоятельно безопасно использовать от любого потока. Путем Вы изменяетесь, свойства существующего объекта изображения должен использовать один из доступных удобных методов создать копию изображения, но с пользовательским значением Вы хотите.
Поскольку объекты изображения являются неизменными, они также не обеспечивают прямой доступ к своим данным основного изображения. Однако можно добраться NSData объект, содержащий или PNG или представление JPEG данных изображения с помощью UIImagePNGRepresentation и UIImageJPEGRepresentation функции.
Система использует объекты изображения для представления неподвижных снимков, сделанных с камерой на поддерживаемых устройствах. Чтобы сделать снимок, используйте UIImagePickerController класс. Чтобы сохранить картинку к Сохраненному фото альбому, используйте UIImageWriteToSavedPhotosAlbum функция.
Изображения и управление памятью
В ситуациях низкой памяти данные изображения могут быть очищены от a UIImage объект высвободить память в системе. Это поведение чистки влияет только на данные изображения, сохраненные внутренне UIImage возразите а не сам объект. Когда Вы пытаетесь нарисовать изображение, данные которого были очищены, объект изображения автоматически перезагружает данные от своего исходного файла. Этот дополнительный шаг загрузки, однако, может подвергнуться маленькой потере производительности.
Необходимо избежать создавать UIImage объекты, которые больше, чем 1024 x 1024 дюйма размером. Помимо большого объема памяти такое изображение использовало бы, можно столкнуться с проблемами при использовании изображения как текстура в OpenGL ES или при рисовании изображения к представлению или уровню. Это ограничение размера не применяется при выполнении основанных на коде манипуляций, таких как изменение размеров изображения, больше, чем 1024 x 1 024 пикселя путем рисования его к поддержанному битовым массивом графическому контексту. Фактически, Вы, возможно, должны изменить размеры изображения этим способом (или повредить его в несколько меньших изображений) для рисования его к одному из представлений.
Сравнение Изображений в iOS 8
Объем того, что изображение является ложью в CGImageRef а не в UIImage объект это обертывается в. С iOS 8 Вы больше не можете полагаться на равенство указателя для сравнения кэшируемых объектов UIImage, поскольку механизм кэширования может не возвратить то же UIImage объект, но будет кэшировать данные изображения отдельно. Необходимо использовать isEqual: правильно протестировать на равенство.
Активы изображения и наборы черты
Можно присвоить изображение a UIImageAsset объект с помощью наборов черты. Регистрация изображения к активу изображения обеспечивает способ собрать в группу изображения. С помощью наборов черты можно получить изображение что лучшие адаптации текущий макет. Например, можно получить различное изображение в зависимости от того, имеет ли представление компактный или регулярный класс размера.
Поддерживаемые форматы изображения
Таблица 1 перечисляет форматы файлов, которые могут быть считаны UIImage класс.
Формат |
Расширения файла |
|---|---|
|
|
|
|
|
|
|
|
Формат Windows Bitmap (DIB) |
|
|
|
|
|
|
-
init (named:inBundle:compatibleWithTraitCollection:) + imageNamed:inBundle:compatibleWithTraitCollection:Возвращает изображение в пакете, который совместим с набором черты.
Объявление
Swift
init?(namedname: String, inBundlebundle: NSBundle?, compatibleWithTraitCollectiontraitCollection: UITraitCollection?) -> UIImageObjective C
+ (UIImage *)imageNamed:(NSString *)nameinBundle:(NSBundle *)bundlecompatibleWithTraitCollection:(UITraitCollection *)traitCollectionПараметры
nameИмя изображения.
bundleПакет файл образа или каталог актива расположен в, передача
nilиспользовать основной пакет.traitCollectionЧерты, описывающие желаемое изображение для получения, передают ноль для использования черт, описывающих основной экран.
Возвращаемое значение
Изображение, что точно или лучшие соответствия желаемые черты с именем, или
nilесли не было найдено никакое подходящее изображение.Обсуждение
Этот метод смотрит в системных кэшах для объекта изображения с указанным именем и набором черты и возвратами, возражающими, существует ли это. Если соответствующий объект изображения уже не находится в кэше, этот метод определяет местоположение и загружает данные изображения из диска или актива catelog, и затем возвращает полученный объект. Вы не можете предположить, что этот метод ориентирован на многопотоковое исполнение.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 8.0 и позже.
-
Возвращает объект изображения, связанный с указанным именем файла.
Объявление
Swift
init?(namedname: String) -> UIImageObjective C
+ (UIImage *)imageNamed:(NSString *)nameПараметры
nameИмя файла. Если это - первый раз, когда изображение загружается, метод ищет изображение с указанным именем в основном пакете приложения.
Возвращаемое значение
Объект изображения для указанного файла, или
nilесли метод не мог бы найти указанное изображение.Обсуждение
Этот метод смотрит в системных кэшах для объекта изображения с указанным именем и возвратами, возражающими, существует ли это. Если соответствующий объект изображения уже не находится в кэше, этот метод определяет местоположение и загружает данные изображения из диска или актива catelog, и затем возвращает полученный объект. Вы не можете предположить, что этот метод ориентирован на многопотоковое исполнение.
Если экран устройства имеет масштаб, на устройстве рабочий iOS 4 или позже, поведение идентично
1.0. Если экран имеет масштаб2.0, этот метод сначала ищет файл образа с тем же именем файла с@2xсуффикс, добавленный к нему. Например, если имя файлаbutton, это сначала ищетbutton@2x. Если это находит 2x, это загружает то изображение и устанавливаетscaleсвойство возвращенногоUIImageобъект к2.0. Иначе, это загружает неизмененное имя файла и устанавливаетscaleсвойство к1.0. См. Руководство по программированию Приложения для iOS для получения дополнительной информации о поддержке изображений с различными масштабными коэффициентами.Специальные замечания
На iOS 4 и позже, если файл находится в формате PNG, не необходимо указать
.PNGрасширение файла. До iOS 4 необходимо указать расширение файла.Если у Вас есть файл образа, который будет только выведен на экран один раз и желание гарантировать, что это не становится добавленным к кэшу системы, необходимо вместо этого создать использование изображения
imageWithContentsOfFile:. Это сохранит Ваше изображение единственного использования из кэша образа системы, потенциально улучшая характеристики использования памяти Вашего приложения.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Создает и возвращает объект изображения путем загрузки данных изображения из файла в указанном пути.
Объявление
Objective C
+ (UIImage *)imageWithContentsOfFile:(NSString *)pathПараметры
pathВесь или частичный путь к файлу.
Возвращаемое значение
Новый объект изображения для указанного файла, или
nilесли метод не мог бы инициализировать изображение от указанного файла.Обсуждение
Этот метод не кэширует объект изображения.
Оператор импорта
Objective C
@import UIKit;Доступность
Доступный в iOS 2.0 и позже.
-
Создает и возвращает объект изображения, использующий указанные данные изображения.
Объявление
Objective C
+ (UIImage *)imageWithData:(NSData *)dataПараметры
dataДанные изображения. Это может быть данными от файла или данными, которые Вы создаете программно.
Возвращаемое значение
Новый объект изображения для указанных данных, или
nilесли метод не мог бы инициализировать изображение от указанных данных.Обсуждение
Этот метод не кэширует объект изображения.
Оператор импорта
Objective C
@import UIKit;Доступность
Доступный в iOS 2.0 и позже.
-
Создает и возвращает объект изображения, использующий указанные данные изображения и масштабный коэффициент.
Параметры
dataДанные изображения. Это может быть данными от файла или данными, которые Вы создаете программно.
scaleМасштабный коэффициент для использования при интерпретации данных изображения. Указание масштабного коэффициента 1,0 результатов в изображении, размер которого соответствует основанные на пикселе размерности изображения. Применение различного масштабного коэффициента изменяет размер изображения, как сообщается
sizeсвойство.Возвращаемое значение
Новый объект изображения для указанных данных, или
nilесли метод не мог бы инициализировать изображение от указанных данных.Обсуждение
Этот метод не кэширует объект изображения.
Оператор импорта
Objective C
@import UIKit;Доступность
Доступный в iOS 6.0 и позже.
-
Создает и возвращает объект изображения, представляющий указанное Кварцевое изображение.
Объявление
Objective C
+ (UIImage *)imageWithCGImage:(CGImageRef)cgImageПараметры
cgImageКварцевый объект изображения.
Возвращаемое значение
Новый объект изображения для указанного Кварцевого изображения, или
nilесли метод не мог бы инициализировать изображение из указанной ссылки изображения.Обсуждение
Этот метод не кэширует объект изображения. Можно использовать методы Базовой Графической платформы для создания Кварцевой ссылки изображения.
Оператор импорта
Objective C
@import UIKit;Доступность
Доступный в iOS 2.0 и позже.
-
Создает и возвращает объект изображения с указанным масштабом и факторами ориентации.
Объявление
Objective C
+ (UIImage *)imageWithCGImage:(CGImageRef)imageRefscale:(CGFloat)scaleorientation:(UIImageOrientation)orientationПараметры
imageRefКварцевый объект изображения.
scaleМасштабный коэффициент для использования при интерпретации данных изображения. Указание масштабного коэффициента 1,0 результатов в изображении, размер которого соответствует основанные на пикселе размерности изображения. Применение различного масштабного коэффициента изменяет размер изображения, как сообщается
sizeсвойство.orientationОриентация данных изображения. Можно использовать этот параметр, чтобы указать, что любые факторы вращения применились к изображению.
Возвращаемое значение
Новый объект изображения для указанного Кварцевого изображения, или
nilесли метод не мог бы инициализировать изображение из указанной ссылки изображения.Обсуждение
Этот метод не кэширует объект изображения. Можно использовать методы Базовой Графической платформы для создания Кварцевой ссылки изображения.
Оператор импорта
Objective C
@import UIKit;Доступность
Доступный в iOS 4.0 и позже.
-
Создает и возвращает объект изображения, содержащий Базовый Объект изображения.
Объявление
Objective C
+ (UIImage *)imageWithCIImage:(CIImage *)ciImageПараметры
ciImageБазовый Объект изображения для инкапсуляции.
Возвращаемое значение
Новый объект изображения.
Оператор импорта
Objective C
@import UIKit;Доступность
Доступный в iOS 5.0 и позже.
-
Создает и возвращает объект изображения на основе Базового Объекта изображения и указанных атрибутов.
Объявление
Objective C
+ (UIImage *)imageWithCIImage:(CIImage *)ciImagescale:(CGFloat)scaleorientation:(UIImageOrientation)orientationПараметры
ciImageБазовый Объект изображения для инкапсуляции.
scaleМасштабный коэффициент для использования при интерпретации данных изображения. Указание масштабного коэффициента 1,0 результатов в изображении, размер которого соответствует основанные на пикселе размерности изображения. Применение различного масштабного коэффициента изменяет размер изображения, как сообщается
sizeсвойство.orientationОриентация данных изображения. Можно использовать этот параметр, чтобы указать, что любые факторы вращения применились к изображению.
Возвращаемое значение
Новый объект изображения.
Оператор импорта
Objective C
@import UIKit;Доступность
Доступный в iOS 6.0 и позже.
-
Возвращает новую версию изображения, использующего указанные вставки выравнивания.
Объявление
Swift
func imageWithAlignmentRectInsets(_alignmentInsets: UIEdgeInsets) -> UIImageObjective C
- (UIImage *)imageWithAlignmentRectInsets:(UIEdgeInsets)alignmentInsetsПараметры
alignmentInsetsМетаданные выравнивания для применения к новому изображению.
Возвращаемое значение
Новый объект изображения.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
См. также
-
Создает и возвращает изображение с анимацией.
Объявление
Swift
class func animatedImageNamed(_name: String, durationduration: NSTimeInterval) -> UIImage!Objective C
+ (UIImage *)animatedImageNamed:(NSString *)nameduration:(NSTimeInterval)durationПараметры
nameВесь или частичный путь к файлу (суффикс санн).
durationПродолжительность анимации.
Возвращаемое значение
Новый объект изображения.
Обсуждение
Этот метод загружает серию файлов путем добавления серии чисел к основному имени файла, предоставленному в
nameпараметр. Например, еслиnameпараметр имел 'изображение' как свое содержание, этот метод попытается загрузить изображения из файлов с именами 'image0', 'image1' и т.д. полностью до ‘image1024’. Все изображения, включенные в изображение с анимацией, должны совместно использовать тот же размер и масштаб.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
Создает и возвращает изображение с анимацией из существующего набора изображений.
Объявление
Swift
class func animatedImageWithImages(_images: [AnyObject], durationduration: NSTimeInterval) -> UIImage!Objective C
+ (UIImage *)animatedImageWithImages:(NSArray *)imagesduration:(NSTimeInterval)durationПараметры
imagesМассив
UIImageобъекты.durationПродолжительность анимации.
Возвращаемое значение
Новый объект изображения.
Обсуждение
Все изображения, включенные в изображение с анимацией, должны совместно использовать тот же размер и масштаб.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
animatedResizableImageNamed (_: capInsets:duration:) + animatedResizableImageNamed:capInsets:duration:Создает и возвращает изображение с анимацией с заглушками.
Объявление
Swift
class func animatedResizableImageNamed(_name: String, capInsetscapInsets: UIEdgeInsets, durationduration: NSTimeInterval) -> UIImage!Objective C
+ (UIImage *)animatedResizableImageNamed:(NSString *)namecapInsets:(UIEdgeInsets)capInsetsduration:(NSTimeInterval)durationПараметры
nameВесь или частичный путь к файлу (суффикс санн).
capInsetsЗначения для использования для вставок прописной буквы.
durationПродолжительность анимации.
Возвращаемое значение
Новый объект изображения.
Обсуждение
Этот метод загружает серию файлов путем добавления серии чисел к основному имени файла, предоставленному в
nameпараметр. Например, еслиnameпараметр имел 'изображение' как свое содержание, этот метод попытается загрузить изображения из файлов с именами 'image0', 'image1' и т.д. полностью до ‘image1024’. Все изображения, включенные в изображение с анимацией, должны совместно использовать тот же размер и масштаб.Каждый кадр в анимации соблюдает правила для изображений изменяемого размера, создаваемых
resizableImageWithCapInsets:метод.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
stretchableImageWithLeftCapWidth (_: topCapHeight:) - stretchableImageWithLeftCapWidth:topCapHeight:(iOS 5.0)Создает и возвращает новый объект изображения с указанными значениями прописной буквы.
Оператор осуждения
Осуждаемый. Используйте
resizableImageWithCapInsets:вместо этого, указание прописной буквы вставляет таким образом, что внутренняя часть является a1x1область.Объявление
Параметры
leftCapWidthЗначение для использования для левой ширины наконечника. Указать
0если Вы хотите, чтобы все изображение было горизонтально поддающимся растягиванию. Для обсуждения того, как ненулевое значение влияет на изображение, посмотритеleftCapWidthсвойство.topCapHeightЗначение для использования для главной ширины наконечника. Указать
0если Вы хотите, чтобы все изображение было вертикально поддающимся растягиванию. Для обсуждения того, как ненулевое значение влияет на изображение, посмотритеtopCapHeightсвойство.Возвращаемое значение
Новый объект изображения с указанными значениями прописной буквы.
Обсуждение
Во время масштабирования или изменения размеров изображения, области, покрытые прописной буквой, не масштабируются или изменяются. Вместо этого область 1 пиксель шириной, не покрытая прописной буквой в каждом направлении, - то, что масштабируется или изменяется. Этот метод часто используется для создания кнопок переменной ширины, сохраняющих те же скругленные углы, но чья центральная область растет или уменьшается по мере необходимости.
Вы используете этот метод, чтобы добавить, что прописная буква оценивает изображению или изменить существующие значения прописной буквы изображения. В обоих случаях Вы возвращаете новое изображение, и исходное изображение остается нетронутым.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 5.0.
-
Создает и возвращает новый объект изображения с указанными вставками прописной буквы.
Объявление
Swift
func resizableImageWithCapInsets(_capInsets: UIEdgeInsets) -> UIImageObjective C
- (UIImage *)resizableImageWithCapInsets:(UIEdgeInsets)capInsetsПараметры
capInsetsЗначения для использования для вставок прописной буквы.
Возвращаемое значение
Новый объект изображения с указанными вставками прописной буквы.
Обсуждение
Вы используете этот метод, чтобы добавить вставки прописной буквы к изображению или изменить существующие вставки прописной буквы изображения. В обоих случаях Вы возвращаете новое изображение, и исходное изображение остается нетронутым. Например, можно использовать этот метод для создания фонового изображения для кнопки с границами и углами: когда кнопка изменена, углы изображения остаются неизменными, но границы и центр изображения расширяются для покрытия нового размера.
iOS использует различные методы рендеринга с различными показателями производительности, в зависимости от размера каждой области изменяемого размера в изображении:
Если области изменяемого размера имеют ширину или высоту 1 пикселя — т.е. горизонтально область изменяемого размера 1 пиксель шириной, вертикально область изменяемого размера 1 пиксель высотой, или центральная область изображения составляет 1 x 1 пиксель — iOS рисует изображение путем протяжения области на 1 пиксель. Этот режим обеспечивает самую быструю производительность (для ненулевых вставок прописной буквы).
Если области изменяемого размера имеют ширину или высоту, больше, чем 1 пиксель, iOS рисует изображение путем мозаичного размещения области. Этот режим обеспечивает сокращенную производительность, но может быть полезен для изображений с текстурированным (а не чистый цвет) содержание в их областях изменяемого размера.
Если все изображение изменяемого размера — т.е.
capInsetsпараметрUIEdgeInsetsZero— и его размер больше, чем 1 x 1 пиксель, iOS рисует изображение путем мозаичного размещения всего изображения. Этот режим быстрее, чем режим мозаичного размещения для ненулевых вставок прописной буквы.
К вместо этого непосредственно управлению режим изменения размеров, используйте
resizableImageWithCapInsets:resizingMode:метод.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
animatedResizableImageNamed (_: capInsets:resizingMode:duration:) + animatedResizableImageNamed:capInsets:resizingMode:duration:Создает и возвращает изображение с анимацией с заглушками и определенным режимом изменения размеров.
Объявление
Swift
class func animatedResizableImageNamed(_name: String, capInsetscapInsets: UIEdgeInsets, resizingModeresizingMode: UIImageResizingMode, durationduration: NSTimeInterval) -> UIImage!Objective C
+ (UIImage *)animatedResizableImageNamed:(NSString *)namecapInsets:(UIEdgeInsets)capInsetsresizingMode:(UIImageResizingMode)resizingModeduration:(NSTimeInterval)durationПараметры
nameВесь или частичный путь к файлу (суффикс санн).
capInsetsЗначения для использования для вставок прописной буквы.
resizingModeРежим, с которым изменена внутренняя часть изображения.
durationПродолжительность анимации.
Возвращаемое значение
Новое изображение с анимацией возражает с указанными вставками прописной буквы и режимом изменения размеров.
Обсуждение
Этот метод является точно тем же как своим дубликатом
animatedResizableImageNamed:capInsets:duration:за исключением того, что может быть явно объявлен режим изменения размеров нового объекта изображения. Так как режим изменения размеров изображенияUIImageResizingModeTileпо умолчанию этот метод должен только использоваться вместо его дубликата для создания изображения с анимацией, которое должно быть изменено сUIImageResizingModeStretchизменение размеров режима.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
Создает и возвращает новый объект изображения с указанными вставками прописной буквы и опциями.
Объявление
Swift
func resizableImageWithCapInsets(_capInsets: UIEdgeInsets, resizingModeresizingMode: UIImageResizingMode) -> UIImageObjective C
- (UIImage *)resizableImageWithCapInsets:(UIEdgeInsets)capInsetsresizingMode:(UIImageResizingMode)resizingModeПараметры
capInsetsЗначения для использования для вставок прописной буквы.
resizingModeРежим, с которым изменена внутренняя часть изображения.
Возвращаемое значение
Новый объект изображения с указанными вставками прописной буквы и режимом изменения размеров.
Обсуждение
Этот метод является точно тем же как своим дубликатом
resizableImageWithCapInsets:за исключением того, что может быть явно объявлен режим изменения размеров нового объекта изображения. Необходимо только вызвать этот метод вместо его дубликата, если Вы в частности хотите, чтобы Ваше изображение было изменено сUIImageResizingModeStretchизменение размеров режима.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
Создает и возвращает новый объект изображения с указанным режимом рендеринга.
Объявление
Swift
func imageWithRenderingMode(_renderingMode: UIImageRenderingMode) -> UIImageObjective C
- (UIImage *)imageWithRenderingMode:(UIImageRenderingMode)renderingModeПараметры
renderingModeРежим рендеринга для использования для нового изображения.
Возвращаемое значение
Новый объект изображения с указанным режимом рендеринга.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 7.0 и позже.
См. также
-
Инициализирует и возвращает объект изображения с содержанием указанного файла.
Объявление
Swift
init?(contentsOfFilepath: String)Objective C
- (instancetype)initWithContentsOfFile:(NSString *)pathПараметры
pathПуть к файлу. Этот путь должен включать расширение файла, идентифицирующее тип данных изображения.
Возвращаемое значение
Инициализированный
UIImageобъект, илиnilесли метод не мог бы найти файл или инициализировать изображение от его содержания.Обсуждение
Этот метод загружает данные изображения в память и отмечает его как purgeable. Если данные очищены и должны быть перезагружены, загрузки объекта изображения что данные снова от указанного пути.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Инициализирует и возвращает объект изображения с указанными данными.
Параметры
dataОбъект данных, содержащий данные изображения.
Возвращаемое значение
Инициализированный
UIImageобъект, илиnilесли метод не мог бы инициализировать изображение от указанных данных.Обсуждение
Данные в
dataпараметр должен быть отформатирован для соответствия формата файла одного из поддерживаемых типов изображения системы.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Инициализирует и возвращает объект изображения с указанными данными и масштабным коэффициентом.
Объявление
Swift
init?(datadata: NSData, scalescale: CGFloat)Параметры
dataОбъект данных, содержащий данные изображения.
scaleМасштабный коэффициент для принятия при интерпретации данных изображения. Применение масштабного коэффициента 1,0 результатов в изображении, размер которого соответствует основанные на пикселе размерности изображения. Применение различного масштабного коэффициента изменяет размер изображения, как сообщается
sizeсвойство.Возвращаемое значение
Инициализированный
UIImageобъект, илиnilесли метод не мог бы инициализировать изображение от указанных данных.Обсуждение
Данные в
dataпараметр должен быть отформатирован для соответствия формата файла одного из поддерживаемых типов изображения системы.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
Инициализирует и возвращает объект изображения с указанной Кварцевой ссылкой изображения.
Объявление
Swift
init?(CGImageCGImage: CGImage!)Objective C
- (instancetype)initWithCGImage:(CGImageRef)CGImageПараметры
CGImageКварцевая ссылка изображения.
Возвращаемое значение
Инициализированный
UIImageобъект, илиnilесли метод не мог бы инициализировать изображение от указанных данных.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Инициализирует и возвращает объект изображения с указанным масштабом и факторами ориентации
Объявление
Swift
init?(CGImageimageRef: CGImage!, scalescale: CGFloat, orientationorientation: UIImageOrientation)Objective C
- (instancetype)initWithCGImage:(CGImageRef)imageRefscale:(CGFloat)scaleorientation:(UIImageOrientation)orientationПараметры
imageRefКварцевый объект изображения.
scaleМасштабный коэффициент для принятия при интерпретации данных изображения. Применение масштабного коэффициента 1,0 результатов в изображении, размер которого соответствует основанные на пикселе размерности изображения. Применение различного масштабного коэффициента изменяет размер изображения, как сообщается
sizeсвойство.orientationОриентация данных изображения. Можно использовать этот параметр, чтобы указать, что любые факторы вращения применились к изображению.
Возвращаемое значение
Инициализированный
UIImageобъект, илиnilесли метод не мог бы инициализировать изображение от указанных данных.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 4.0 и позже.
-
Инициализирует и возвращает объект изображения с указанным Базовым Объектом изображения.
Объявление
Swift
init?(CIImageciImage: CIImage)Objective C
- (instancetype)initWithCIImage:(CIImage *)ciImageПараметры
ciImageБазовый Объект изображения.
Возвращаемое значение
Инициализированный
UIImageобъект, илиnilесли метод не мог бы инициализировать изображение от указанных данных.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
Инициализирует и возвращает объект изображения с указанным Базовым Объектом изображения и свойствами.
Объявление
Swift
init?(CIImageciImage: CIImage, scalescale: CGFloat, orientationorientation: UIImageOrientation)Objective C
- (instancetype)initWithCIImage:(CIImage *)ciImagescale:(CGFloat)scaleorientation:(UIImageOrientation)orientationПараметры
ciImageБазовый Объект изображения.
scaleМасштабный коэффициент для принятия при интерпретации данных изображения. Применение масштабного коэффициента 1,0 результатов в изображении, размер которого соответствует основанные на пикселе размерности изображения. Применение различного масштабного коэффициента изменяет размер изображения, как сообщается
sizeсвойство.orientationОриентация данных изображения. Можно использовать этот параметр, чтобы указать, что любые факторы вращения применились к изображению.
Возвращаемое значение
Инициализированный
UIImageобъект, илиnilесли метод не мог бы инициализировать изображение от указанных данных.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
imageOrientationСвойствоОриентация изображения получателя. (только для чтения)
Объявление
Swift
var imageOrientation: UIImageOrientation { get }Objective C
@property(nonatomic, readonly) UIImageOrientation imageOrientationОбсуждение
Ориентация изображения влияет на способ, которым данные изображения выведены на экран, когда нарисовано. По умолчанию изображения выведены на экран в ориентация. Если изображение связало метаданные (такие как информация о EXIF), однако, это свойство содержит ориентацию, обозначенную теми метаданными. Для списка возможных значений для этого свойства посмотрите UIImageOrientation.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
sizeСвойствоРазмерности изображения, принимая ориентацию во внимание. (только для чтения)
Обсуждение
В iOS 4.0 и позже, это значение отражает логический размер изображения и измеряется в точках. В iOS 3.x и ранее, это значение всегда отражает размерности изображения, измеренного в пикселях.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
scaleСвойствоМасштабный коэффициент изображения. (только для чтения)
Объявление
Swift
var scale: CGFloat { get }Objective C
@property(nonatomic, readonly) CGFloat scaleОбсуждение
При загрузке изображения из файла, имя которого включает
@2xмодификатор, масштаб установлен в2.0. Можно также указать явный масштабный коэффициент при инициализации изображения из Базового Графического изображения. Все другие изображения, как предполагается, имеют масштабный коэффициент1.0.Если Вы умножаете логический размер изображения (сохраненный в
sizeсвойство) значением в этом свойстве, Вы получаете размерности изображения в пикселях.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 4.0 и позже.
-
resizingModeСвойствоРежим изменения размеров изображения. (только для чтения)
Объявление
Swift
var resizingMode: UIImageResizingMode { get }Objective C
@property(nonatomic, readonly) UIImageResizingMode resizingModeОбсуждение
Значение по умолчанию для этого свойства
UIImageResizingModeTile. ОднакоUIImageреализует режим изменения размеров самый быстрый путь, возможный, все еще сохраняя желаемое визуальное появление. Это означает, что, если область, которая будет изменена, является областью на 1 пиксель и этим свойством, установлен вUIImageResizingModeTile, область будет расширена вместо этого, потому что эти два фактически неразличимы для области того размера, и протяжение существенно быстрее, чем мозаичное размещение. Для установки значения этого свойства необходимо вызвать такжеanimatedResizableImageNamed:capInsets:resizingMode:duration:илиresizableImageWithCapInsets:resizingMode:и укажите режим изменения размеров с помощьюresizingModeпараметр. Для списка возможных значений для этого свойства посмотрите UIImageResizingMode.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
CGImageСвойствоБазовые Кварцевые данные изображения. (только для чтения)
Объявление
Swift
var CGImage: CGImage! { get }Objective C
@property(nonatomic, readonly) CGImageRef CGImageОбсуждение
Если данные изображения были очищены из-за ограничений памяти, вызывание этого метода вынуждает те данные быть загруженными назад в память. Перезагрузка данных изображения может подвергнуться потере производительности.
Если
UIImageобъект был инициализирован с помощью aCIImageобъект, значение свойстваNULL.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
CIImageСвойствоБазовые Базовые Данные изображения. (только для чтения)
Объявление
Swift
var CIImage: CIImage? { get }Objective C
@property(nonatomic, readonly) CIImage *CIImageОбсуждение
Если
UIImageобъект был инициализирован с помощью aCGImageRef, значение свойстваnil.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
imagesСвойствоДля изображения с анимацией это свойство содержит полный массив
UIImageобъекты, составляющие анимацию. (только для чтения)Объявление
Swift
var images: [AnyObject]? { get }Objective C
@property(nonatomic, readonly) NSArray *imagesОбсуждение
Для неизображения с анимацией значение этого свойства
nil.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
durationСвойствоВозвращается временной интервал раньше выводил на экран изображение с анимацией. (только для чтения)
Объявление
Swift
var duration: NSTimeInterval { get }Objective C
@property(nonatomic, readonly) NSTimeInterval durationОбсуждение
Для неизображения с анимацией значение этого свойства
0.0.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
capInsetsСвойствоВставки заглушки. (только для чтения)
Объявление
Swift
var capInsets: UIEdgeInsets { get }Objective C
@property(nonatomic, readonly) UIEdgeInsets capInsetsОбсуждение
Заглушки указывают часть изображения, которое не должно быть изменено, когда расширяется изображение. Этот метод используется для реализации кнопок и других основанных на изображении интерфейсных элементов изменяемого размера. Когда кнопка с заглушками изменена, изменение размеров происходит только посреди кнопки в области между заглушками. Сами заглушки сохраняют свой первоначальный размер и появление.
Это свойство указывает размеры всех четырех заглушек. Средняя (поддающаяся растягиванию) часть состоит из всех пикселей, не включенных в заглушки. Эти пиксели размещаются рядом, слева направо, от начала до конца для заполнения остающегося пространства.
На изображении неизменяемого размера это свойство установлено в
UIEdgeInsetsZero; изображение не использует заглушки, и все изображение подвергается протяжению. Для создания нового изображения с ненулевым значением для этого свойства используйтеresizableImageWithCapInsets:метод. Если Ваше приложение указываетUIEdgeInsetsZeroкакcapInsetsпараметр, все изображение размещается рядом.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
Горизонтальный размер заглушки. (только для чтения)
Оператор осуждения
Используйте
capInsetsсвойство вместо этого.Объявление
Swift
var leftCapWidth: Int { get }Objective C
@property(nonatomic, readonly) NSInteger leftCapWidthОбсуждение
Заглушки указывают часть изображения, которое не должно быть изменено, когда расширяется изображение. Этот метод используется для реализации кнопок и других основанных на изображении интерфейсных элементов изменяемого размера. Когда кнопка с заглушками изменена, изменение размеров происходит только посреди кнопки в области между заглушками. Сами заглушки сохраняют свой первоначальный размер и появление.
Это свойство указывает размер левой заглушки. Средняя (поддающаяся растягиванию) часть, как предполагается, 1 пиксель шириной. Правильная заглушка поэтому вычислена путем добавления размера левой заглушки и средней части вместе и затем вычитания того значения из ширины изображения:
rightCapWidth = image.size.width - (image.leftCapWidth + 1);
По умолчанию это свойство установлено в 0, который указывает, что изображение не использует заглушки, и все изображение подвергается протяжению. Для создания нового изображения с ненулевым значением для этого свойства используйте
stretchableImageWithLeftCapWidth:topCapHeight:метод.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 5.0.
-
Вертикальный размер заглушки. (только для чтения)
Оператор осуждения
Используйте
capInsetsсвойство вместо этого.Объявление
Swift
var topCapHeight: Int { get }Objective C
@property(nonatomic, readonly) NSInteger topCapHeightОбсуждение
Заглушки указывают часть изображения, которое не должно быть изменено, когда расширяется изображение. Этот метод используется для реализации кнопок и других основанных на изображении интерфейсных элементов изменяемого размера. Когда кнопка с заглушками изменена, изменение размеров происходит только посреди кнопки в области между заглушками. Сами заглушки сохраняют свой первоначальный размер и появление.
Это свойство указывает размер верхнего края прописная буква. Средняя (поддающаяся растягиванию) часть, как предполагается, 1 пиксель шириной. Прописная буква заднего конца поэтому вычислена путем добавления размера верхнего края прописная буква и средняя часть вместе и затем вычитания того значения из высоты изображения:
bottomCapHeight = image.size.height - (image.topCapHeight + 1);
По умолчанию это свойство установлено в 0, который указывает, что изображение не использует заглушки, и все изображение подвергается протяжению. Для создания нового изображения с ненулевым значением для этого свойства используйте
stretchableImageWithLeftCapWidth:topCapHeight:метод.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 5.0.
-
alignmentRectInsetsСвойствоМетаданные выравнивания раньше располагали изображение во время расположения. (только для чтения)
Объявление
Swift
var alignmentRectInsets: UIEdgeInsets { get }Objective C
@property(nonatomic, readonly) UIEdgeInsets alignmentRectInsetsОбсуждение
Можно использовать значения вставки в качестве подсказки для указания содержимых изображения более точно. Например, если у Вас есть значок на 20 x 20 пикселей, включающий эффект свечения, Вы могли бы установить вставки в {{2, 2}, {16, 16}} для указания позиции базового значка без эффекта свечения.
Объекты, включающие изображения, могут использовать эти вставки для размещения изображения должным образом в их содержании.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
imageAssetСвойствоВозвращает ссылку на актив изображения, с которым связано изображение. (только для чтения)
Объявление
Swift
var imageAsset: UIImageAsset! { get }Objective C
@property(nonatomic, readonly) UIImageAsset *imageAssetОбсуждение
Если Вы создаете изображение из ссылки на файл, данных,
CGImageRefили если изображение анимировано, тоimageAssetбудетnil.CIImageоснованные изображения будут всегда возвращатьсяnil.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 8.0 и позже.
-
traitCollectionСвойствоВозвращает набор черты, описывающий изображение. (только для чтения)
Объявление
Swift
var traitCollection: UITraitCollection { get }Objective C
@property(nonatomic, readonly) UITraitCollection *traitCollectionОператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 8.0 и позже.
-
renderingModeСвойствоОпределяет, как представляется изображение. (только для чтения)
Объявление
Swift
var renderingMode: UIImageRenderingMode { get }Objective C
@property(nonatomic, readonly) UIImageRenderingMode renderingModeОбсуждение
Режим рендеринга значения по умолчанию
UIImageRenderingModeAutomaticОператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 7.0 и позже.
-
Рисует изображение в указанной точке в текущем контексте.
Параметры
pointТочка, в которой можно нарисовать верхний левый угол изображения.
Обсуждение
Этот метод рисует все изображение в текущем графическом контексте, уважая установку ориентации изображения. В системе координат по умолчанию изображения расположены вниз и направо от указанной точки. Этот метод отношения, которые любой преобразовывает, применился к текущему графическому контексту, как бы то ни было.
Этот метод рисует изображение в полной непрозрачности с помощью
kCGBlendModeNormalрежим смешивания.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Рисует все изображение в указанной точке с помощью пользовательских опций составления композита.
Объявление
Swift
func drawAtPoint(_point: CGPoint, blendModeblendMode: CGBlendMode, alphaalpha: CGFloat)Objective C
- (void)drawAtPoint:(CGPoint)pointblendMode:(CGBlendMode)blendModealpha:(CGFloat)alphaПараметры
pointТочка, в которой можно нарисовать верхний левый угол изображения.
blendModeРежим смешивания для использования при составлении композита изображения.
alphaЖелаемая непрозрачность изображения, указанного как значение между 0,0 и 1.0. Значение 0,0 рендеринга изображение, полностью прозрачное, в то время как 1,0 рендеринга это полностью непрозрачный. Значения, больше, чем 1,0, интерпретируются как 1,0.
Обсуждение
Этот метод рисует все изображение в текущем графическом контексте, уважая установку ориентации изображения. В системе координат по умолчанию изображения расположены вниз и направо от указанной точки. Этот метод отношения, которые любой преобразовывает, применился к текущему графическому контексту, как бы то ни было.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Рисует все изображение в указанном прямоугольнике, масштабируя его по мере необходимости для адаптации.
Параметры
rectПрямоугольник (в системе координат графического контекста), в котором можно нарисовать изображение.
Обсуждение
Этот метод рисует все изображение в текущем графическом контексте, уважая установку ориентации изображения. В системе координат по умолчанию изображения расположены вниз и направо от источника указанного прямоугольника. Этот метод отношения, которые любой преобразовывает, применился к текущему графическому контексту, как бы то ни было.
Этот метод рисует изображение в полной непрозрачности с помощью
kCGBlendModeNormalрежим смешивания.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Рисует все изображение в указанном прямоугольнике и использовании указанных опций составления композита.
Объявление
Swift
func drawInRect(_rect: CGRect, blendModeblendMode: CGBlendMode, alphaalpha: CGFloat)Objective C
- (void)drawInRect:(CGRect)rectblendMode:(CGBlendMode)blendModealpha:(CGFloat)alphaПараметры
rectПрямоугольник (в системе координат графического контекста), в котором можно нарисовать изображение.
blendModeРежим смешивания для использования при составлении композита изображения.
alphaЖелаемая непрозрачность изображения, указанного как значение между 0,0 и 1.0. Значение 0,0 рендеринга изображение, полностью прозрачное, в то время как 1,0 рендеринга это полностью непрозрачный. Значения, больше, чем 1,0, интерпретируются как 1,0.
Обсуждение
Этот метод масштабирует изображение по мере необходимости, чтобы заставить его поместиться в указанный прямоугольник. Этот метод рисует изображение в текущем графическом контексте, уважая установку ориентации изображения. В системе координат по умолчанию изображения расположены вниз и направо от источника указанного прямоугольника. Этот метод отношения, которые любой преобразовывает, применился к текущему графическому контексту, как бы то ни было.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Рисует мозаичный Кварцевый образец с помощью содержания получателя в качестве образца мозаики.
Объявление
Swift
func drawAsPatternInRect(_rect: CGRect)Objective C
- (void)drawAsPatternInRect:(CGRect)rectПараметры
rectПрямоугольник (в системе координат графического контекста), в котором можно нарисовать изображение.
Обсуждение
Этот метод использует Кварцевый образец для мозаичного размещения изображения в указанном прямоугольнике. Изображение размещается рядом без разрывов, и цвет заливки проигнорирован. В системе координат по умолчанию мозаики изображения расположены вниз и направо от источника указанного прямоугольника. Этот метод отношения, которые любой преобразовывает, применился к текущему графическому контексту, как бы то ни было.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Указывает возможные ориентации изображения.
Объявление
Swift
enum UIImageOrientation : Int { case Up case Down case Left case Right case UpMirrored case DownMirrored case LeftMirrored case RightMirrored }Objective C
typedef enum { UIImageOrientationUp, UIImageOrientationDown , // 180 deg rotation UIImageOrientationLeft , // 90 deg CW UIImageOrientationRight , // 90 deg CCW UIImageOrientationUpMirrored , // as above but image mirrored along // other axis. horizontal flip UIImageOrientationDownMirrored , // horizontal flip UIImageOrientationLeftMirrored , // vertical flip UIImageOrientationRightMirrored , // vertical flip } UIImageOrientation;Константы
-
UpUIImageOrientationUpОриентация по умолчанию изображений. Изображение составлено правая сторона, как показано здесь.
Доступный в iOS 2.0 и позже.
-
DownUIImageOrientationDownИзображение повернуто 180 градусов, как показано здесь.
Доступный в iOS 2.0 и позже.
-
LeftUIImageOrientationLeftИзображение повернуто 90 градусов по часовой стрелке, как показано здесь.
Доступный в iOS 2.0 и позже.
-
RightUIImageOrientationRightИзображение повернуто 90 градусов против часовой стрелки, как показано здесь.
Доступный в iOS 2.0 и позже.
-
UpMirroredUIImageOrientationUpMirroredИзображение нарисовано как зеркальная версия изображения, нарисованного с
UIImageOrientationUpзначение. Другими словами, изображение зеркально отражается вдоль его горизонтальной оси, как показано здесь.
Доступный в iOS 2.0 и позже.
-
DownMirroredUIImageOrientationDownMirroredИзображение нарисовано как зеркальная версия изображения, нарисованного с
UIImageOrientationDownзначение. Это - эквивалент зеркальному отражению изображения в ориентация вдоль ее горизонтальной оси и затем вращение изображения 180 градусов, как показано здесь.
Доступный в iOS 2.0 и позже.
-
LeftMirroredUIImageOrientationLeftMirroredИзображение нарисовано как зеркальная версия изображения, нарисованного с
UIImageOrientationLeftзначение. Это - эквивалент зеркальному отражению изображения в ориентация вдоль ее горизонтальной оси и затем вращение изображения 90 градусов против часовой стрелки, как показано здесь.
Доступный в iOS 2.0 и позже.
-
RightMirroredUIImageOrientationRightMirroredИзображение нарисовано как зеркальная версия изображения, нарисованного с
UIImageOrientationRightзначение. Это - эквивалент зеркальному отражению изображения в ориентация вдоль ее горизонтальной оси и затем вращение изображения 90 градусов по часовой стрелке, как показано здесь.
Доступный в iOS 2.0 и позже.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
-
Указывает возможные режимы изменения размеров для изображения.
Объявление
Swift
enum UIImageResizingMode : Int { case Tile case Stretch }Objective C
typedef enum { UIImageResizingModeTile, UIImageResizingModeStretch, } UIImageResizingMode;Константы
-
TileUIImageResizingModeTileИзображение размещается рядом, когда оно изменено. Другими словами, внутренняя область исходного изображения будет повторена для заполнения внутренней области недавно измененного изображения.
Доступный в iOS 6.0 и позже.
-
StretchUIImageResizingModeStretchИзображение расширяется, когда оно изменено. Другими словами, внутренняя область исходного изображения будет масштабироваться для заполнения внутренней области недавно измененный отображенный.
Доступный в iOS 6.0 и позже.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
-
Указывает возможные режимы рендеринга для изображения.
Объявление
Swift
enum UIImageRenderingMode : Int { case Automatic case AlwaysOriginal case AlwaysTemplate }Objective C
typedef enum : NSInteger { UIImageRenderingModeAutomatic, UIImageRenderingModeAlwaysOriginal, UIImageRenderingModeAlwaysTemplate, information } UIImageRenderingMode;Константы
-
AutomaticUIImageRenderingModeAutomaticИспользуйте режим рендеринга значения по умолчанию для контекста, где используется изображение.
Доступный в iOS 7.0 и позже.
-
AlwaysOriginalUIImageRenderingModeAlwaysOriginalВсегда рисуйте исходное изображение, не обрабатывая его как шаблон.
Доступный в iOS 7.0 и позже.
-
AlwaysTemplateUIImageRenderingModeAlwaysTemplateВсегда рисуйте изображение как шаблонное изображение, игнорируя его информацию о цвете.
Доступный в iOS 7.0 и позже.
Обсуждение
Посмотрите Шаблонные Изображения в Каталоге Пользовательского интерфейса UIKit для обсуждения шаблонных изображений.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 7.0 и позже.
-
