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

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

Разработчик

Фото ссылка платформы ссылка класса PHImageRequestOptions

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

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

PHImageRequestOptions

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

Соответствует

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

Swift

import Photos

Objective C

@import Photos;

Доступность

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

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

Планирование запроса изображения
  • synchronous Свойство

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

    Объявление

    Swift

    var synchronous: Bool

    Objective C

    @property(nonatomic, assign, getter=isSynchronous) BOOL synchronous

    Обсуждение

    Если NOfalse (значение по умолчанию), requestImageForAsset:targetSize:contentMode:options:resultHandler: метод сразу возвращается. В зависимости от deliveryMode свойство, фотографии могут вызвать Ваш resultHandler блок перед возвратами метода, в некоторое более позднее время или обоих.

    Если YEStrue, requestImageForAsset:targetSize:contentMode:options:resultHandler: метод блокирует вызывающий поток, пока данные изображения не готовы, или ошибка происходит. Фотографии вызывают Ваш блок обработчика результата точно один раз.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Указание опций запроса изображения
  • version Свойство

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

    Объявление

    Swift

    var version: PHImageRequestOptionsVersion

    Objective C

    @property(nonatomic, assign) PHImageRequestOptionsVersion version

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • deliveryMode Свойство

    Требуемое качество изображения и приоритет поставки.

    Объявление

    Swift

    var deliveryMode: PHImageRequestOptionsDeliveryMode

    Objective C

    @property(nonatomic, assign) PHImageRequestOptionsDeliveryMode deliveryMode

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • resizeMode Свойство

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

    Объявление

    Swift

    var resizeMode: PHImageRequestOptionsResizeMode

    Objective C

    @property(nonatomic, assign) PHImageRequestOptionsResizeMode resizeMode

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • normalizedCropRect Свойство

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

    Объявление

    Swift

    var normalizedCropRect: CGRect

    Objective C

    @property(nonatomic, assign) CGRect normalizedCropRect

    Обсуждение

    Для запроса кадрированного изображения укажите прямоугольник обрезки в координатном пространстве модуля относительно изображения. В этой системе координат, точке {0.0,0.0} относится к верхнему левому углу изображения и точке {1.0,1.0} относится к противоположному углу независимо от форматного соотношения изображения.

    Это свойство значения по умолчанию к CGRectZero, который не указывает обрезки.

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Выборка Данных изображения от iCloud
  • networkAccessAllowed Свойство

    Булево значение, указывающее, могут ли фотографии загрузить требуемое изображение с iCloud.

    Объявление

    Swift

    var networkAccessAllowed: Bool

    Objective C

    @property(nonatomic, assign, getter=isNetworkAccessAllowed) BOOL networkAccessAllowed

    Обсуждение

    Если YEStrue, и требуемое изображение не сохранено на локальном устройстве, фотографии загружает изображение с iCloud. Чтобы быть уведомленными относительно прогресса загрузки, используйте progressHandler свойство для обеспечения блока, который фотографии периодически вызывают при загрузке изображения. Если NOfalse (значение по умолчанию), и изображение не находится на локальном устройстве, PHImageResultIsInCloudKey значение в обработчике результата info словарь указывает, что изображение не доступно, если Вы не включаете доступ к сети.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • progressHandler Свойство

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

    Объявление

    Swift

    var progressHandler: PHAssetImageProgressHandler!

    Objective C

    @property(nonatomic, copy) PHAssetImageProgressHandler progressHandler

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Типы данных

  • PHAssetImageProgressHandler

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

    Объявление

    Swift

    typealias PHAssetImageProgressHandler = (Double, NSError!, UnsafeMutablePointer<ObjCBool>, [NSObject : AnyObject]!) -> Void

    Objective C

    typedef void (^ PHAssetImageProgressHandler)(BOOL degraded, double progress, NSError *error, BOOL *stop);

    Обсуждение

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

    Блок берет следующие параметры:

    degraded

    Булево значение, указывающее, предоставляют ли фотографии временную низкокачественную версию изображения актива. Если YEStrue, Фотографии могут отправить версию полного качества изображения позже, в зависимости от значения deliveryMode свойство.

    progress

    Значение с плавающей точкой, указывающее прогресс загрузки. Значение 0.0 указывает, что загрузка только что запустилась, и значение 1.0 указывает, что загрузка завершена.

    error

    NSError объект, описывающий ошибку, произошедшую при попытке загрузить изображение, или nil если не произошли никакие ошибки.

    stop

    Указатель на булево значение. Для отмены загрузки установить *stop к YEStrue в блоке.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Константы
  • PHImageRequestOptionsVersion

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

    Объявление

    Swift

    enum PHImageRequestOptionsVersion : Int { case Current case Unadjusted case Original }

    Objective C

    typedef enum : NSInteger { PHImageRequestOptionsVersionCurrent = 0, PHImageRequestOptionsVersionUnadjusted, PHImageRequestOptionsVersionOriginal, } PHImageRequestOptionsVersion;

    Константы

    • Current

      PHImageRequestOptionsVersionCurrent

      Запросите новую версию актива изображения (тот, отражающий все редактирования).

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

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

    • Unadjusted

      PHImageRequestOptionsVersionUnadjusted

      Запросите версию актива изображения без корректировок.

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

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

    • Original

      PHImageRequestOptionsVersionOriginal

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

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

      Если актив изображения содержит данные в многократных форматах, получающиеся данные изображения используют формат высшего качества. Например, для актива, содержащего и RAW и данные JPEG, фотографии возвращают Данные Необработанных.

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • PHImageRequestOptionsDeliveryMode

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

    Объявление

    Swift

    enum PHImageRequestOptionsDeliveryMode : Int { case Opportunistic case HighQualityFormat case FastFormat }

    Objective C

    typedef : NSInteger { PHImageRequestOptionsDeliveryModeOpportunistic = 0, PHImageRequestOptionsDeliveryModeHighQualityFormat = 1, PHImageRequestOptionsDeliveryModeFastFormat = 2, } PHImageRequestOptionsDeliveryMode;

    Константы

    • Opportunistic

      PHImageRequestOptionsDeliveryModeOpportunistic

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

      Фотографии могут вызвать resultHandler блок (что Вы указали в requestImageForAsset:targetSize:contentMode:options:resultHandler: метод несколько раз. Фотографии могут вызвать Ваш обработчик результата один раз для обеспечения низкокачественного изображения, подходящего для отображения временно, в то время как это подготавливает высококачественное изображение. Если низкокачественные данные изображения сразу доступны, этот первый вызов может произойти перед requestImageForAsset:targetSize:contentMode:options:resultHandler: возвраты метода. Когда высококачественное изображение готово, фотографии вызывает Ваш обработчик результата снова для обеспечения его. Если менеджер по изображению уже кэшировал требуемое изображение, фотографии вызывает Ваш обработчик результата только один раз.

      Эта опция не доступна если synchronous свойство NOfalse.

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

    • HighQualityFormat

      PHImageRequestOptionsDeliveryModeHighQualityFormat

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

      Если synchronous свойство YEStrue или при использовании requestImageDataForAsset:options:resultHandler: метод, это поведение является по умолчанию и только опцией.

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

    • FastFormat

      PHImageRequestOptionsDeliveryModeFastFormat

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

      Фотографии вызывают Ваш resultHandler блок один раз. Если высококачественное изображение не может быть загружено быстро, обработчик результата обеспечивает низкокачественное изображение. Проверьте PHImageResultIsDegradedKey введите информационный словарь для определения качества изображения, предоставленного для обработчика результата.

      Эта опция не доступна если synchronous свойство NOfalse.

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • PHImageRequestOptionsResizeMode

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

    Объявление

    Swift

    enum PHImageRequestOptionsResizeMode : Int { case None case Fast case Exact }

    Objective C

    typedef enum : NSInteger { PHImageRequestOptionsResizeModeNone = 0, PHImageRequestOptionsResizeModeFast, PHImageRequestOptionsResizeModeExact } PHImageRequestOptionsResizeMode;

    Константы

    • None

      PHImageRequestOptionsResizeModeNone

      Фотографии не изменяют размеры актива изображения.

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

    • Fast

      PHImageRequestOptionsResizeModeFast

      Фотографии эффективно изменяют размеры изображения к размеру, подобному, или немного больше, чем, целевому размеру.

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

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

    • Exact

      PHImageRequestOptionsResizeModeExact

      Фотографии изменяют размеры изображения для соответствия целевого размера точно.

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

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

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

    Обсуждение

    Укажите a targetSize параметр, когда Вы запрашиваете изображение с requestImageForAsset:targetSize:contentMode:options:resultHandler: метод.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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