Ссылка CGDataConsumer

CGDataConsumerRef непрозрачный тип абстрагирует задачу записи данных и избавляет от необходимости приложения управлять данными через необработанный буфер памяти. Можно использовать потребительские объекты данных записать изображение или данные PDF и все, за исключением CGDataConsumerCreateWithCFData, доступны в OS X v10.0 или позже.

Если Ваше выполнение приложения в OS X v10.4 или позже, необходимо использовать объекты CGImageDestination, а не потребителей данных. Посмотрите Ссылку CGImageDestination.

Функции

Создание потребителей данных


    
    CGDataConsumerCreate (_: _:)
    CGDataConsumerCreate

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

Объявление

Swift

func CGDataConsumerCreate(_ info: UnsafeMutablePointer<Void>, _ callbacks: UnsafePointer<CGDataConsumerCallbacks>) -> CGDataConsumer!

Objective C

CGDataConsumerRef CGDataConsumerCreate ( void *info, const CGDataConsumerCallbacks *callbacks );

Параметры


      info

Указатель на данные любого типа или NULL. Когда Кварц вызывает функции, указанные в callbacks параметр, это передает этот указатель как info параметр.


      callbacks

Указатель на a CGDataConsumerCallbacks структура, указывающая функции обратного вызова, которые Вы реализуете, чтобы скопировать данные, отправленные потребителю и обработать потребительское управление основной памятью. Для полного описания посмотрите CGDataConsumerCallbacks.

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

Новый потребительский объект данных. Вы ответственны за выпуск этого объектного использования CGDataConsumerRelease.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

CGDataConsumerCreateWithURL (_:) CGDataConsumerCreateWithURL

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

Объявление

Swift

func CGDataConsumerCreateWithURL(_ url: CFURL!) -> CGDataConsumer!

Objective C

CGDataConsumerRef CGDataConsumerCreateWithURL ( CFURLRef url );

Параметры

url

Объект CFURL, указывающий адресат данных.

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

Новый потребительский объект данных. Вы ответственны за выпуск этого объектного использования CGDataConsumerRelease.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGDataConsumerCreateWithCFData(_ data: CFMutableData!) -> CGDataConsumer!

Objective C

CGDataConsumerRef CGDataConsumerCreateWithCFData ( CFMutableDataRef data );

Параметры

data

CFData возражают для записи в.

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

Новый потребительский объект данных. Вы ответственны за выпуск этого объектного использования CGDataConsumerRelease.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Получение ID CFType

CGDataConsumerGetTypeID () CGDataConsumerGetTypeID

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

Объявление

Swift

func CGDataConsumerGetTypeID() -> CFTypeID

Objective C

CFTypeID CGDataConsumerGetTypeID ( void );

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

Базовый идентификатор Основы для непрозрачного типа CGDataConsumerRef.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Сохранение и выпуск потребителей данных

CGDataConsumerRelease CGDataConsumerRelease

Декременты сохранить количество потребителя данных.

Объявление

Objective C

void CGDataConsumerRelease ( CGDataConsumerRef consumer );

Параметры

consumer

Потребитель данных для выпуска.

Обсуждение

Эта функция эквивалентна CFRelease, за исключением того, что это не вызывает ошибку если consumer параметр NULL.

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

Objective C

@import CoreGraphics;

Доступность

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

Инкременты сохранить количество потребителя данных.

Объявление

Objective C

CGDataConsumerRef CGDataConsumerRetain ( CGDataConsumerRef consumer );

Параметры

consumer

Потребитель данных для сохранения.

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

Тот же потребитель данных Вы передали в как consumer параметр.

Обсуждение

Эта функция эквивалентна CFRetain, за исключением того, что это не вызывает ошибку если consumer параметр NULL.

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

Objective C

@import CoreGraphics;

Доступность

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

Обратные вызовы

Разные обратные вызовы CGDataConsumer


    
    CGDataConsumerPutBytesCallback
    CGDataConsumerPutBytesCallback

Данные копий от Предоставленного кварц буфера в потребителя данных.

Объявление

Swift

typealias CGDataConsumerPutBytesCallback = CFunctionPointer<((UnsafeMutablePointer<Void>, UnsafePointer<Void>, UInt) -> UInt)>

Objective C

size_t (*CGDataConsumerPutBytesCallback) ( void *info, const void *buffer, size_t count );

Параметры

`info`	Универсальный указатель на частные данные совместно используется среди Ваших функций обратного вызова. Это - указатель, предоставленный `CGDataConsumerCreate`.
`buffer`	Предоставленный кварц буфер, с которого Вы копируете конкретное количество байтов.
`count`	Число байтов для копирования.

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

Число байтов скопировано. Если больше данных не может быть записано в потребителя, необходимо возвратиться 0.

Обсуждение

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

Для получения информации о том, как связать Вашу функцию обратного вызова с потребителем данных, посмотрите CGDataConsumerCreate и CGDataConsumerCallbacks.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGDataConsumerReleaseInfoCallback
    CGDataConsumerReleaseInfoCallback

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

Объявление

Swift

typealias CGDataConsumerReleaseInfoCallback = CFunctionPointer<((UnsafeMutablePointer<Void>) -> Void)>

Objective C

void (*CGDataConsumerReleaseInfoCallback) ( void *info );

Параметры


      info

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

Обсуждение

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

Для получения информации о том, как связать Вашу функцию обратного вызова с потребителем данных, посмотрите CGDataConsumerCreate и CGDataConsumerCallbacks.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Типы данных


      
      CGDataConsumerCallbacks

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

Объявление

Swift

struct CGDataConsumerCallbacks { var putBytes: CGDataConsumerPutBytesCallback var releaseConsumer: CGDataConsumerReleaseInfoCallback }

Objective C

struct CGDataConsumerCallbacks { CGDataConsumerPutBytesCallback putBytes; CGDataConsumerReleaseInfoCallback releaseConsumer; }; typedef struct CGDataConsumerCallbacks CGDataConsumerCallbacks;

Поля

`putBytes`	Указатель на функцию, копирующую данные в потребителя данных. Для получения дополнительной информации посмотрите `CGDataConsumerPutBytesCallback`.
`releaseConsumer`	Указатель на функцию, обрабатывающую очистку для потребителя данных, или `NULL`. Для получения дополнительной информации посмотрите `CGDataConsumerReleaseInfoCallback`

Обсуждение

Функции, указанные CGDataConsumerCallbacks структура ответственна за копирование данных, которые Кварц отправляет Вашему потребителю и для обработки потребительского управления основной памятью. Вы предоставляете a CGDataConsumerCallbacks структура к функции CGDataConsumerCreate создать потребителя данных.

Доступность

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

CGDataConsumerRef CGDataConsumerRef

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

Объявление

Swift

typealias CGDataConsumerRef = CGDataConsumer

Objective C

typedef struct CGDataConsumer *CGDataConsumerRef;

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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