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

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

Разработчик

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

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

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

Ссылка CGImageDestination

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


Не применимый

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


Не применимый

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


Swift

import ImageIO

Objective C

@import ImageIO;

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

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

Функции

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

    Объявление

    Swift

    func CGImageDestinationCreateWithDataConsumer(_ consumer: CGDataConsumer!, _ type: CFString!, _ count: Int, _ 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

    Доступность

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

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

    Объявление

    Swift

    func CGImageDestinationCreateWithData(_ data: CFMutableData!, _ type: CFString!, _ count: Int, _ 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

    Доступность

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

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

    Объявление

    Swift

    func CGImageDestinationCreateWithURL(_ url: CFURL!, _ type: CFString!, _ count: Int, _ 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

    Доступность

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

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

    Объявление

    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

    Доступность

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

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

    Объявление

    Swift

    func CGImageDestinationAddImageFromSource(_ idst: CGImageDestination!, _ isrc: CGImageSource!, _ index: Int, _ 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

    Доступность

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

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

    Объявление

    Swift

    func CGImageDestinationCopyTypeIdentifiers() -> CFArray!

    Objective C

    CFArrayRef CGImageDestinationCopyTypeIdentifiers ( void );

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

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

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

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

    Объявление

    Swift

    func CGImageDestinationGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CGImageDestinationGetTypeID ( void );

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

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

    Обсуждение

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

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

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

    Объявление

    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

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

    bool CGImageDestinationFinalize ( CGImageDestinationRef idst );

    Параметры

    idst

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

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

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

    Обсуждение

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

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

Типы данных

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

    Объявление

    Swift

    typealias CGImageDestinationRef = CGImageDestination

    Objective C

    typedef struct CGImageDestination *CGImageDestinationRef;

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

    Objective C

    @import ImageIO;

    Swift

    import ImageIO

    Доступность

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

Константы

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

    Объявление

    Swift

    let kCGImageDestinationLossyCompressionQuality: CFString! let kCGImageDestinationBackgroundColor: CFString!

    Objective C

    const CFStringRef kCGImageDestinationLossyCompressionQuality const CFStringRef kCGImageDestinationBackgroundColor

    Константы

    • kCGImageDestinationLossyCompressionQuality

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

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

    • kCGImageDestinationBackgroundColor

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

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