Ссылка CGImageDestination

Объекты CGImageDestination, доступные в OS X v10.4 или позже, абстрагируют задачу записи данных. Место назначения изображения может представлять единственное изображение или повторные изображения. Это может содержать изображения миниатюр, а также свойства для каждого изображения.

Функции, описанные в этой ссылке, могут записать данные в три вида мест назначения: URL, a CFData объект и потребитель данных. После создания CGImageDestination возражают для соответствующего места назначения, можно добавить данные изображения и установить свойства изображения. Когда Вы закончены, добавив данные, вызываете функцию CGImageDestinationFinalize записать данные изображения и свойства к URL, CFData объект или потребитель данных.

Функции

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


    
    CGImageDestinationCreateWithDataConsumer (_: _: _: _:)
    CGImageDestinationCreateWithDataConsumer

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

Объявление

Swift

func CGImageDestinationCreateWithDataConsumer(_ consumer: CGDataConsumer!, _ type: CFString!, _ count: UInt, _ options: CFDictionary!) -> CGImageDestination!

Objective C

CGImageDestinationRef CGImageDestinationCreateWithDataConsumer ( CGDataConsumerRef consumer, CFStringRef type, size_t count, CFDictionaryRef options );

Параметры

`consumer`	Потребитель данных для записи в. Для получения информации о данных потребители видят Ссылку CGDataConsumer и Кварц 2D Руководство по программированию.
`type`	Универсальный идентификатор типа (UTI) получающегося файла образа. См. Универсальный Обзор Идентификаторов типов для списка объявленного системой и стороннего UTIs.
`count`	Число изображений (не включая изображения миниатюр), который будет содержать файл образа.
`options`	Зарезервированный для будущего использования. Передача `NULL`.

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

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

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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


    
    CGImageDestinationCreateWithData (_: _: _: _:)
    CGImageDestinationCreateWithData

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

Объявление

Swift

func CGImageDestinationCreateWithData(_ data: CFMutableData!, _ type: CFString!, _ count: UInt, _ options: CFDictionary!) -> CGImageDestination!

Objective C

CGImageDestinationRef CGImageDestinationCreateWithData ( CFMutableDataRef data, CFStringRef type, size_t count, CFDictionaryRef options );

Параметры

`data`	Объект данных записать в. Для получения дополнительной информации об объектах данных см. Ссылку CFData и Объекты данных.
`type`	Универсальный идентификатор типа (UTI) получающегося файла образа. См. Универсальный Обзор Идентификаторов типов для списка объявленного системой и стороннего UTIs.
`count`	Число изображений (не включая изображения миниатюр), который будет содержать файл образа.
`options`	Зарезервированный для будущего использования. Передача `NULL`.

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

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

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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


    
    CGImageDestinationCreateWithURL (_: _: _: _:)
    CGImageDestinationCreateWithURL

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

Объявление

Swift

func CGImageDestinationCreateWithURL(_ url: CFURL!, _ type: CFString!, _ count: UInt, _ options: CFDictionary!) -> CGImageDestination!

Objective C

CGImageDestinationRef CGImageDestinationCreateWithURL ( CFURLRef url, CFStringRef type, size_t count, CFDictionaryRef options );

Параметры

`url`	URL для записи в. Если URL уже существует, данные в этом расположении перезаписываются.
`type`	UTI (универсальный идентификатор типа) получающегося файла образа. См. Универсальный Обзор Идентификаторов типов для списка объявленного системой и стороннего UTIs.
`count`	Число изображений (не включая изображения миниатюр), который будет содержать файл образа.
`options`	Зарезервированный для будущего использования. Передача `NULL`.

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

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

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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

Добавление изображений


    
    CGImageDestinationAddImage (_: _: _:)
    CGImageDestinationAddImage

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

Объявление

Swift

func CGImageDestinationAddImage(_ idst: CGImageDestination!, _ image: CGImage!, _ properties: CFDictionary!)

Objective C

void CGImageDestinationAddImage ( CGImageDestinationRef idst, CGImageRef image, CFDictionaryRef properties );

Параметры

`idst`	Место назначения изображения
`image`	Изображение для добавления.
`properties`	Дополнительный словарь, указывающий свойства добавленного изображения. Словарь может содержать любое из свойств, описанных в `“Destination Properties”` или свойства изображения описаны в Ссылке CGImageProperties.

Обсуждение

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

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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


    
    CGImageDestinationAddImageFromSource (_: _: _: _:)
    CGImageDestinationAddImageFromSource

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

Объявление

Swift

func CGImageDestinationAddImageFromSource(_ idst: CGImageDestination!, _ isrc: CGImageSource!, _ index: UInt, _ properties: CFDictionary!)

Objective C

void CGImageDestinationAddImageFromSource ( CGImageDestinationRef idst, CGImageSourceRef isrc, size_t index, CFDictionaryRef properties );

Параметры

`idst`	Место назначения изображения.
`isrc`	Источник изображения.
`index`	Индекс, указывающий расположение изображения в источнике изображения. Индекс основан на нуле.
`properties`	Словарь, указывающий свойства, чтобы перезаписать или добавить к свойствам исходного изображения. Если ключ `properties` имеет значение `kCFNull`, соответствующее свойство в месте назначения изображения удалено. Словарь может содержать любое из свойств, описанных в `“Destination Properties”` или свойства изображения описаны в Ссылке CGImageProperties.

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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

Получение идентификаторов типов

CGImageDestinationCopyTypeIdentifiers () CGImageDestinationCopyTypeIdentifiers

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

Объявление

Swift

func CGImageDestinationCopyTypeIdentifiers() -> CFArray!

Objective C

CFArrayRef CGImageDestinationCopyTypeIdentifiers ( void );

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

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

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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

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

Объявление

Swift

func CGImageDestinationGetTypeID() -> CFTypeID

Objective C

CFTypeID CGImageDestinationGetTypeID ( void );

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

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

Обсуждение

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

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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

Установка свойств


    
    CGImageDestinationSetProperties (_: _:)
    CGImageDestinationSetProperties

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

Объявление

Swift

func CGImageDestinationSetProperties(_ idst: CGImageDestination!, _ properties: CFDictionary!)

Objective C

void CGImageDestinationSetProperties ( CGImageDestinationRef idst, CFDictionaryRef properties );

Параметры

`idst`	Место назначения изображения.
`properties`	Словарь, содержащий свойства для применения. Можно установить любое из свойств, описанных в `“Destination Properties”` или свойства изображения описаны в Ссылке CGImageProperties.

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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

Завершение места назначения изображения

CGImageDestinationFinalize (_:) CGImageDestinationFinalize

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

Объявление

Swift

func CGImageDestinationFinalize(_ idst: CGImageDestination!) -> Bool

Objective C

bool CGImageDestinationFinalize ( CGImageDestinationRef idst );

Параметры

idst

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

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

Возвраты true если успешно записано изображение; false иначе.

Обсуждение

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

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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

Типы данных

CGImageDestinationRef CGImageDestinationRef

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

Объявление

Swift

typealias CGImageDestinationRef = CGImageDestination

Objective C

typedef struct CGImageDestination *CGImageDestinationRef;

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

Objective C

@import ImageIO;

Swift

import ImageIO

Доступность

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

Константы

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

Объявление

Swift

let kCGImageDestinationLossyCompressionQuality: CFString! let kCGImageDestinationBackgroundColor: CFString!

Objective C

const CFStringRef kCGImageDestinationLossyCompressionQuality const CFStringRef kCGImageDestinationBackgroundColor

Константы
- kCGImageDestinationLossyCompressionQuality
  
  kCGImageDestinationLossyCompressionQuality
  
  Желаемое качество сжатия для использования при записи в место назначения изображения. Если настоящее, значение, связанное с этим ключом, должно быть a CFNumberRef тип данных в диапазоне 0.0 к 1.0. Значение 1.0 указывает для использования сжатия без потерь, если целевой формат поддерживает его. Значение 0,0 подразумевает для использования максимального сжатия.
  
  Доступный в OS X v10.4 и позже.
- kCGImageDestinationBackgroundColor
  
  kCGImageDestinationBackgroundColor
  
  Желаемый цвет фона для составления композита против при записи изображения, имеющего альфа-компонент к целевому формату, не поддерживающему альфу. Если настоящее, значение, связанное с этим ключом, должно быть a CGColorRef тип данных без собственного альфа-компонента. Если не существующий, и белый цвет используется, если необходим цвет фона.
  
  Доступный в OS X v10.4 и позже.