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

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

Разработчик

Ссылка платформы ApplicationServices ссылка CGImageSource

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

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

Ссылка CGImageSource

Объекты CGImageSource, доступные в OS X v10.4 или позже, абстрагируют задачу считывания данных. Источник изображения может считать данные изображения из URL, a CFData объект или потребитель данных.

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

Функции

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

    Объявление

    Swift

    func CGImageSourceCreateWithDataProvider(_ provider: CGDataProvider!, _ options: CFDictionary!) -> CGImageSource!

    Objective C

    CGImageSourceRef CGImageSourceCreateWithDataProvider ( CGDataProviderRef provider, CFDictionaryRef options );

    Параметры

    provider

    Провайдер данных для чтения из. Для получения дополнительной информации о провайдерах данных посмотрите Ссылку CGDataProvider и Кварц 2D Руководство по программированию.

    options

    Словарь, указывающий дополнительные опции создания. Посмотрите “Image Source Option Dictionary Keys” для ключей можно предоставить.

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

    Источник изображения. Вы ответственны за выпуск этого объектного использования CFRelease.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Создает источник изображения, читающий из Базового объекта данных Основы.

    Объявление

    Swift

    func CGImageSourceCreateWithData(_ data: CFData!, _ options: CFDictionary!) -> CGImageSource!

    Objective C

    CGImageSourceRef CGImageSourceCreateWithData ( CFDataRef data, CFDictionaryRef options );

    Параметры

    data

    Объект данных читать из. Для получения дополнительной информации об объектах данных см. Ссылку CFData и Объекты данных.

    options

    Словарь, указывающий дополнительные опции создания. Посмотрите “Image Source Option Dictionary Keys” для ключей можно предоставить.

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

    Источник изображения. Вы ответственны за выпуск этого объектного использования CFRelease.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

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

    Объявление

    Swift

    func CGImageSourceCreateWithURL(_ url: CFURL!, _ options: CFDictionary!) -> CGImageSource!

    Objective C

    CGImageSourceRef CGImageSourceCreateWithURL ( CFURLRef url, CFDictionaryRef options );

    Параметры

    url

    URL для чтения из.

    options

    Словарь, указывающий дополнительные опции создания. Посмотрите “Image Source Option Dictionary Keys” для ключей можно предоставить.

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

    Источник изображения. Вы ответственны за выпуск этого объектного использования CFRelease.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Создает объект CGImage для данных изображения, связанных с указанным индексом в источнике изображения.

    Объявление

    Swift

    func CGImageSourceCreateImageAtIndex(_ isrc: CGImageSource!, _ index: UInt, _ options: CFDictionary!) -> CGImage!

    Objective C

    CGImageRef CGImageSourceCreateImageAtIndex ( CGImageSourceRef isrc, size_t index, CFDictionaryRef options );

    Параметры

    isrc

    Источник изображения.

    index

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

    options

    Словарь, указывающий дополнительные опции создания. Посмотрите “Image Source Option Dictionary Keys” для ключей можно предоставить.

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

    Возвращает объект CGImage. Вы ответственны за выпуск этого объектного использования CGImageRelease.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

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

    Объявление

    Swift

    func CGImageSourceCreateThumbnailAtIndex(_ isrc: CGImageSource!, _ index: UInt, _ options: CFDictionary!) -> CGImage!

    Objective C

    CGImageRef CGImageSourceCreateThumbnailAtIndex ( CGImageSourceRef isrc, size_t index, CFDictionaryRef options );

    Параметры

    isrc

    Источник изображения.

    index

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

    options

    Словарь, указывающий дополнительные опции создания. Посмотрите “Image Source Option Dictionary Keys” для ключей можно предоставить.

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

    Объект CGImage. Вы ответственны за выпуск этого объектного использования CGImageRelease.

    Обсуждение

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

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Создайте инкрементный источник изображения.

    Объявление

    Swift

    func CGImageSourceCreateIncremental(_ options: CFDictionary!) -> CGImageSource!

    Objective C

    CGImageSourceRef CGImageSourceCreateIncremental ( CFDictionaryRef options );

    Параметры

    options

    Словарь, указывающий дополнительные опции создания. Посмотрите “Image Source Option Dictionary Keys” для ключей можно предоставить.

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

    Возвращает объект источника изображения. Вы ответственны за выпуск этого объектного использования CFRelease.

    Обсуждение

    Функция CGImageSourceCreateIncremental создает пустой контейнер источника изображения, к которому можно добавить данные позже путем вызывания функций CGImageSourceUpdateDataProvider или CGImageSourceUpdateData. Когда Вы вызываете эту функцию, Вы не предоставляете данные.

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

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Обновляет инкрементный источник изображения с новыми данными.

    Объявление

    Swift

    func CGImageSourceUpdateData(_ isrc: CGImageSource!, _ data: CFData!, _ final: Bool)

    Objective C

    void CGImageSourceUpdateData ( CGImageSourceRef isrc, CFDataRef data, bool final );

    Параметры

    isrc

    Источник изображения.

    data

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

    final

    Значение, указывающее, являются ли данные заключительным набором. Передача true если это, false иначе.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Обновляет инкрементный источник изображения с новым провайдером данных.

    Объявление

    Swift

    func CGImageSourceUpdateDataProvider(_ isrc: CGImageSource!, _ provider: CGDataProvider!, _ final: Bool)

    Objective C

    void CGImageSourceUpdateDataProvider ( CGImageSourceRef isrc, CGDataProviderRef provider, bool final );

    Параметры

    isrc

    Источник изображения.

    provider

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

    final

    Значение, указывающее, являются ли данные заключительным набором. Передача true если это, false иначе.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

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

    Объявление

    Swift

    func CGImageSourceGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CGImageSourceGetTypeID ( void );

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

    Возвращает Базовый идентификатор типа Основы для источника изображения.

    Обсуждение

    Идентификатор типа является целым числом, идентифицирующим непрозрачный тип, которому принадлежит Базовый объект Основы. Вы используете идентификаторы типов в различных контекстах, такой как тогда, когда Вы воздействуете на неоднородные наборы. Обратите внимание на то, что ID CFType отличается от универсального идентификатора типа (UTI).

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Возвращает универсальный идентификатор типа исходного контейнера.

    Объявление

    Swift

    func CGImageSourceGetType(_ isrc: CGImageSource!) -> CFString!

    Objective C

    CFStringRef CGImageSourceGetType ( CGImageSourceRef isrc );

    Параметры

    isrc

    Источник изображения.

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

    Универсальный идентификатор типа изображения.

    Обсуждение

    Универсальный идентификатор типа (UTI) исходного контейнера может отличаться от типа изображений в контейнере. Например, .icns отформатируйте встроенные поддержки JPEG2000. Тип исходного контейнера "com.apple.icns" но тип изображений JPEG2000.

    Посмотрите Универсальные Понятия Идентификатора типа для списка объявленного системой и стороннего UTIs.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

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

    Объявление

    Swift

    func CGImageSourceCopyTypeIdentifiers() -> CFArray!

    Objective C

    CFArrayRef CGImageSourceCopyTypeIdentifiers ( void );

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

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

    Обсуждение

    См. Универсальный Обзор Идентификаторов типов для списка объявленного системой и стороннего UTIs.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Возвращает число изображений (не включая миниатюры) в источнике изображения.

    Объявление

    Swift

    func CGImageSourceGetCount(_ isrc: CGImageSource!) -> UInt

    Objective C

    size_t CGImageSourceGetCount ( CGImageSourceRef isrc );

    Параметры

    isrc

    Источник изображения.

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

    Число изображений. Если источник изображения является многослойным файлом PSD, функциональными возвратами 1.

    Обсуждение

    Эта функция не извлекает уровни файла PSD.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Возвращает свойства источника изображения.

    Объявление

    Swift

    func CGImageSourceCopyProperties(_ isrc: CGImageSource!, _ options: CFDictionary!) -> CFDictionary!

    Objective C

    CFDictionaryRef CGImageSourceCopyProperties ( CGImageSourceRef isrc, CFDictionaryRef options );

    Параметры

    isrc

    Источник изображения.

    options

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

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

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

    Обсуждение

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

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Возвращает свойства изображения в указанном расположении в источнике изображения.

    Объявление

    Swift

    func CGImageSourceCopyPropertiesAtIndex(_ isrc: CGImageSource!, _ index: UInt, _ options: CFDictionary!) -> CFDictionary!

    Objective C

    CFDictionaryRef CGImageSourceCopyPropertiesAtIndex ( CGImageSourceRef isrc, size_t index, CFDictionaryRef options );

    Параметры

    isrc

    Источник изображения.

    index

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

    options

    Словарь можно использовать для запроса дополнительных опций. Посмотрите “Image Source Option Dictionary Keys” для ключей можно предоставить.

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

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

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Возвратите состояние источника изображения.

    Объявление

    Swift

    func CGImageSourceGetStatus(_ isrc: CGImageSource!) -> CGImageSourceStatus

    Objective C

    CGImageSourceStatus CGImageSourceGetStatus ( CGImageSourceRef isrc );

    Параметры

    isrc

    Источник изображения.

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

    Возвращает текущий статус источника изображения. Посмотрите “Image Source Status” для списка возможных значений.

    Обсуждение

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

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

  • Возвращает текущий статус изображения, которое является в указанном расположении в источнике изображения.

    Объявление

    Swift

    func CGImageSourceGetStatusAtIndex(_ isrc: CGImageSource!, _ index: UInt) -> CGImageSourceStatus

    Objective C

    CGImageSourceStatus CGImageSourceGetStatusAtIndex ( CGImageSourceRef isrc, size_t index );

    Параметры

    isrc

    Источник изображения.

    index

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

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

    Возвращает текущий статус изображения. Посмотрите “Image Source Status” для списка возможных значений.

    Обсуждение

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

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

Типы данных

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

    Объявление

    Swift

    typealias CGImageSourceRef = CGImageSource

    Objective C

    typedef struct CGImageSource *CGImageSourceRef;

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

Константы

  • Состояние утверждает для изображений и источников изображения.

    Объявление

    Swift

    struct CGImageSourceStatus { init(_ value: Int32) var value: Int32 }

    Objective C

    enum CGImageSourceStatus { kCGImageStatusUnexpectedEOF = -5, kCGImageStatusInvalidData = -4, kCGImageStatusUnknownType = -3, kCGImageStatusReadingHeader = -2, kCGImageStatusIncomplete = -1, kCGImageStatusComplete = 0 }; typedef enum CGImageSourceStatus CGImageSourceStatus;

    Константы

    • kCGImageStatusUnexpectedEOF

      kCGImageStatusUnexpectedEOF

      С концом файла неожиданно встретились.

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

    • kCGImageStatusInvalidData

      kCGImageStatusInvalidData

      Данные не допустимы.

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

    • kCGImageStatusUnknownType

      kCGImageStatusUnknownType

      Изображение является неизвестным типом.

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

    • kCGImageStatusReadingHeader

      kCGImageStatusReadingHeader

      В процессе чтения заголовка.

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

    • kCGImageStatusIncomplete

      kCGImageStatusIncomplete

      Работа не завершена

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

    • kCGImageStatusComplete

      kCGImageStatusComplete

      Работа завершена.

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

    Обсуждение

    Эти значения состояния возвращаются функциями CGImageSourceGetStatus и CGImageSourceGetStatusAtIndex.

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

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

    Объявление

    Swift

    let kCGImageSourceTypeIdentifierHint: CFString! let kCGImageSourceShouldAllowFloat: CFString! let kCGImageSourceShouldCache: CFString! let kCGImageSourceCreateThumbnailFromImageIfAbsent: CFString! let kCGImageSourceCreateThumbnailFromImageAlways: CFString! let kCGImageSourceThumbnailMaxPixelSize: CFString! let kCGImageSourceCreateThumbnailWithTransform: CFString!

    Objective C

    CFStringRef kCGImageSourceTypeIdentifierHint; CFStringRef kCGImageSourceShouldAllowFloat; CFStringRef kCGImageSourceShouldCache; CFStringRef kCGImageSourceCreateThumbnailFromImageIfAbsent; CFStringRef kCGImageSourceCreateThumbnailFromImageAlways; CFStringRef kCGImageSourceThumbnailMaxPixelSize; CFStringRef kCGImageSourceCreateThumbnailWithTransform

    Константы

    • kCGImageSourceTypeIdentifierHint

      kCGImageSourceTypeIdentifierHint

      Лучшее предположение универсального идентификатора типа (UTI) для формата файла источника изображения. Если указано, значение этого ключа должно быть объектом CFString. Этот ключ может быть предоставлен в словаре опций при создании объекта CGImageSource.

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

    • kCGImageSourceShouldAllowFloat

      kCGImageSourceShouldAllowFloat

      Должно ли изображение быть возвращено, поскольку CGImage возражает, что использует значения с плавающей точкой, если поддерживается форматом файла. CGImage возражает, что расширенный диапазон использования значения с плавающей точкой может потребовать, чтобы дополнительная обработка представила приятным способом. Значение этого ключа должно быть значением CFBoolean. Значение по умолчанию kCFBooleanFalse.

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

    • kCGImageSourceShouldCache

      kCGImageSourceShouldCache

      Должно ли изображение кэшироваться в декодируемой форме. Значение этого ключа должно быть значением CFBoolean. Значение по умолчанию kCFBooleanFalse в 32-разрядном, kCFBooleanTrue в 64-разрядном. Этот ключ может быть предоставлен в словаре опций, который можно передать функциям CGImageSourceCopyPropertiesAtIndex и CGImageSourceCreateImageAtIndex.

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

    • kCGImageSourceCreateThumbnailFromImageIfAbsent

      kCGImageSourceCreateThumbnailFromImageIfAbsent

      Если миниатюра не присутствует в файле источника изображения, должна ли миниатюра быть автоматически создана для изображения. Миниатюра создается из полного образа согласно пределу, указанному kCGImageSourceThumbnailMaxPixelSize. Если максимальный размер пикселя не указан, то миниатюра является размером полного образа, который в большинстве случаев не желателен. Этот ключ должен быть значением CFBoolean. Значение по умолчанию kCFBooleanFalse. Этот ключ может быть предоставлен в словаре опций, который Вы передаете функции CGImageSourceCreateThumbnailAtIndex.

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

    • kCGImageSourceCreateThumbnailFromImageAlways

      kCGImageSourceCreateThumbnailFromImageAlways

      Даже если миниатюра присутствует в файле источника изображения, должна ли миниатюра быть создана из полного образа. Миниатюра создается из полного образа согласно пределу, указанному kCGImageSourceThumbnailMaxPixelSize. Если максимальный размер пикселя не указан, то миниатюра является размером полного образа, который, вероятно, не является тем, что Вы хотите. Этот ключ должен быть значением CFBoolean. Значение по умолчанию kCFBooleanFalse. Этот ключ может быть предоставлен в словаре опций, который можно передать функции CGImageSourceCreateThumbnailAtIndex.

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

    • kCGImageSourceThumbnailMaxPixelSize

      kCGImageSourceThumbnailMaxPixelSize

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

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

    • kCGImageSourceCreateThumbnailWithTransform

      kCGImageSourceCreateThumbnailWithTransform

      Должна ли миниатюра поворачиваться и масштабироваться согласно ориентации и попиксельной пропорции полного образа. Значение этого ключа должно быть значением CFBoolean. Значение по умолчанию kCFBooleanFalse.

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

    Обсуждение

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