Ссылка CGImageSource

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

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

Функции

Создание источника изображения


    
    CGImageSourceCreateWithDataProvider (_: _:)
    CGImageSourceCreateWithDataProvider

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

Объявление

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 и позже.


    
    CGImageSourceCreateWithData (_: _:)
    CGImageSourceCreateWithData

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

Объявление

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 и позже.


    
    CGImageSourceCreateWithURL (_: _:)
    CGImageSourceCreateWithURL

Создает источник изображения, читающий из расположения, указанного 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 и позже.

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


    
    CGImageSourceCreateImageAtIndex (_: _: _:)
    CGImageSourceCreateImageAtIndex

Создает объект 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 и позже.


    
    CGImageSourceCreateThumbnailAtIndex (_: _: _:)
    CGImageSourceCreateThumbnailAtIndex

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

Объявление

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 и позже.


    
    CGImageSourceCreateIncremental (_:)
    CGImageSourceCreateIncremental

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

Объявление

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 и позже.

Обновление источника изображения


    
    CGImageSourceUpdateData (_: _: _:)
    CGImageSourceUpdateData

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

Объявление

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 и позже.


    
    CGImageSourceUpdateDataProvider (_: _: _:)
    CGImageSourceUpdateDataProvider

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

Объявление

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 и позже.

Получение информации от источника изображения

CGImageSourceGetTypeID () CGImageSourceGetTypeID

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

Объявление

Swift

func CGImageSourceGetTypeID() -> CFTypeID

Objective C

CFTypeID CGImageSourceGetTypeID ( void );

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

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

Обсуждение

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

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

Доступный в версии 10.4 OS X и позже.
CGImageSourceGetType (_:) CGImageSourceGetType

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

Объявление

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 и позже.
CGImageSourceCopyTypeIdentifiers () CGImageSourceCopyTypeIdentifiers

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

Объявление

Swift

func CGImageSourceCopyTypeIdentifiers() -> CFArray!

Objective C

CFArrayRef CGImageSourceCopyTypeIdentifiers ( void );

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

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

Обсуждение

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

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

Доступный в версии 10.4 OS X и позже.
CGImageSourceGetCount (_:) CGImageSourceGetCount

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

Объявление

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 и позже.


    
    CGImageSourceCopyProperties (_: _:)
    CGImageSourceCopyProperties

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

Объявление

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 и позже.


    
    CGImageSourceCopyPropertiesAtIndex (_: _: _:)
    CGImageSourceCopyPropertiesAtIndex

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

Объявление

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 и позже.

CGImageSourceGetStatus (_:) CGImageSourceGetStatus

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

Объявление

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 и позже.


    
    CGImageSourceGetStatusAtIndex (_: _:)
    CGImageSourceGetStatusAtIndex

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

Объявление

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 и позже.

Типы данных

CGImageSourceRef CGImageSourceRef

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

Объявление

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, который Вы используете при создании источника изображения, эти константы указывают опции, которые можно установить при создании изображения из источника изображения. Каждая константа является ключом; когда Вы добавляете эту опцию к словарю опций, необходимо предоставить надлежащее значение.