Ссылка CGPSConverter

CGPSConverterRef непрозрачный тип, используемый для преобразования данных PostScript в данные PDF. Данными PostScript снабжает провайдер данных и пишут в потребителя данных. При создании объекта преобразователя PostScript можно предоставить функции обратного вызова для Кварца для вызова на различных этапах процесса преобразования,

Функции

Разные функции CGPSConverter

CGPSConverterAbort (_:) CGPSConverterAbort

Говорит преобразователю PostScript прерывать преобразование в следующей доступной возможности.

Объявление

Swift

func CGPSConverterAbort(_ converter: CGPSConverter!) -> Bool

Objective C

bool CGPSConverterAbort ( CGPSConverterRef converter );

Параметры

converter

Преобразователь PostScript.

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

Булево значение, указывающее, преобразовывает ли преобразователь в настоящее время данные (true если это).

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGPSConverterCreate (_: _: _:)
    CGPSConverterCreate

Создает новый преобразователь PostScript.

Объявление

Swift

func CGPSConverterCreate(_ info: UnsafeMutablePointer<Void>, _ callbacks: UnsafePointer<CGPSConverterCallbacks>, _ options: CFDictionary!) -> CGPSConverter!

Objective C

CGPSConverterRef CGPSConverterCreate ( void *info, const CGPSConverterCallbacks *callbacks, CFDictionaryRef options );

Параметры

`info`	Указатель на данные, которые будут переданы обратным вызовам.
`callbacks`	Указатель на структуру обратных вызовов преобразователя PostScript, указывающую обратные вызовы, которые будут использоваться во время процесса преобразования.
`options`	Этот параметр должен быть `NULL`; это резервируется для будущего расширения API.

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

Новый преобразователь PostScript, или NULL если не мог бы быть создан преобразователь. Вы ответственны за выпуск этого объекта.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGPSConverterConvert (_: _: _: _:)
    CGPSConverterConvert

Использует преобразователь PostScript для преобразования данных PostScript в данные PDF.

Объявление

Swift

func CGPSConverterConvert(_ converter: CGPSConverter!, _ provider: CGDataProvider!, _ consumer: CGDataConsumer!, _ options: CFDictionary!) -> Bool

Objective C

bool CGPSConverterConvert ( CGPSConverterRef converter, CGDataProviderRef provider, CGDataConsumerRef consumer, CFDictionaryRef options );

Параметры

`converter`	Преобразователь PostScript.
`provider`	Кварцевый провайдер данных, снабжающий данными PostScript.
`consumer`	Кварцевый провайдер данных, который получит получающиеся данные PDF.
`options`	Этот параметр должен быть `NULL`; это резервируется для будущего расширения API.

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

Булево значение, указывающее, завершилось ли преобразование PostScript успешно (true если это сделало).

Обсуждение

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

Важный

Несмотря на то, что CGPSConverterConvert ориентировано на многопотоковое исполнение (это использует блокировки для предотвращения больше чем одного преобразования за один раз в том же процессе), это не ориентировано на многопотоковое исполнение относительно Менеджера ресурсов. Если Ваше приложение использует Менеджер ресурсов на отдельном потоке, необходимо или использовать блокировки для предотвращения CGPSConverterConvert от выполнения во время Вашего использования Менеджера ресурсов или необходимо выполнить преобразования с помощью преобразователя Сценария Сообщения в отдельном процессе.

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

CGPSConverterIsConverting (_:) CGPSConverterIsConverting

Проверки, преобразовывает ли преобразователь в настоящее время данные.

Объявление

Swift

func CGPSConverterIsConverting(_ converter: CGPSConverter!) -> Bool

Objective C

bool CGPSConverterIsConverting ( CGPSConverterRef converter );

Параметры

converter

Преобразователь PostScript.

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

Возвраты true это указывает, происходит ли преобразование.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGPSConverterGetTypeID() -> CFTypeID

Objective C

CFTypeID CGPSConverterGetTypeID ( void );

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

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


    
    CGPSConverterBeginDocumentCallback
    CGPSConverterBeginDocumentCallback

Выполняет пользовательские задачи в начале процесса преобразования PostScript.

Объявление

Swift

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

Objective C

typedef void (*CGPSConverterBeginDocumentCallback)(void *info);

Параметры


      info

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGPSConverterEndDocumentCallback
    CGPSConverterEndDocumentCallback

Выполняет пользовательские задачи в конце процесса преобразования PostScript.

Объявление

Swift

typealias CGPSConverterEndDocumentCallback = CFunctionPointer<((UnsafeMutablePointer<Void>, Bool) -> Void)>

Objective C

typedef void (*CGPSConverterEndDocumentCallback)(void *info, bool success);

Параметры

`info`	Универсальный указатель на частные данные совместно используется среди Ваших функций обратного вызова. Это - тот же указатель, к которому Вы предоставили `CGPSConverterCreate`.
`success`	Булево значение, указывающее, завершилось ли преобразование PostScript успешно (`true` если это сделало).

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Выполнение пользовательских задач на уровне страницы


    
    CGPSConverterBeginPageCallback
    CGPSConverterBeginPageCallback

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

Объявление

Swift

typealias CGPSConverterBeginPageCallback = CFunctionPointer<((UnsafeMutablePointer<Void>, UInt, CFDictionary!) -> Void)>

Objective C

typedef void (*CGPSConverterBeginPageCallback)(void *info, size_t pageNumber, CFDictionaryRef pageInfo);

Параметры

`info`	Универсальный указатель на частные данные совместно используется среди Ваших функций обратного вызова. Это - тот же указатель, к которому Вы предоставили `CGPSConverterCreate`.
`pageNumber`	Текущий номер страницы. Номера страниц запускаются в `1`.
`pageInfo`	Словарь, содержащий контекстную информацию о странице. Этот параметр резервируется для будущего расширения API и в настоящее время не использован.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGPSConverterEndPageCallback
    CGPSConverterEndPageCallback

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

Объявление

Swift

typealias CGPSConverterEndPageCallback = CFunctionPointer<((UnsafeMutablePointer<Void>, UInt, CFDictionary!) -> Void)>

Objective C

typedef void (*CGPSConverterEndPageCallback)(void *info, size_t pageNumber, CFDictionaryRef pageInfo);

Параметры

`info`	Универсальный указатель на частные данные совместно используется среди Ваших функций обратного вызова. Это - тот же указатель, к которому Вы предоставили `CGPSConverterCreate`.
`pageNumber`	Текущий номер страницы. Номера страниц запускаются в `1`.
`pageInfo`	Словарь, содержащий контекстную информацию о странице. Этот параметр резервируется для будущего расширения API и в настоящее время не использован.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Создание отчетов о прогрессе и сообщениях


    
    CGPSConverterProgressCallback
    CGPSConverterProgressCallback

Отчеты развиваются периодически во время процесса преобразования PostScript.

Объявление

Swift

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

Objective C

typedef void (*CGPSConverterProgressCallback)(void *info);

Параметры


      info

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGPSConverterMessageCallback
    CGPSConverterMessageCallback

Сообщения передач сгенерированы во время процесса преобразования PostScript.

Объявление

Swift

typealias CGPSConverterMessageCallback = CFunctionPointer<((UnsafeMutablePointer<Void>, CFString!) -> Void)>

Objective C

typedef void (*CGPSConverterMessageCallback)(void *info, CFStringRef message);

Параметры

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

Обсуждение

Существует несколько видов сообщения, которое могло бы быть отправлено во время процесса преобразования. Наиболее вероятными являются сообщения замены шрифтов и любые сообщения, что сам код PostScript генерирует. Любой PostScript обменивается сообщениями записанный в stdout направляются посредством этого обратного вызова — обычно они отлаживают или сообщения о состоянии и, несмотря на то, что редкий, могут быть полезными в отладке. Кроме того, если документ уродлив, могут быть сообщения об ошибках.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Выполнение пользовательских задач очистки


    
    CGPSConverterReleaseInfoCallback
    CGPSConverterReleaseInfoCallback

Когда преобразователь PostScript выпущен, выполняет пользовательские задачи.

Объявление

Swift

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

Objective C

typedef void (*CGPSConverterReleaseInfoCallback)(void *info);

Параметры


      info

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Типы данных

CGPSConverterRef CGPSConverterRef

Непрозрачный тип данных раньше преобразовывал данные PostScript в данные PDF.

Объявление

Swift

typealias CGPSConverterRef = CGPSConverter

Objective C

typedef struct CGPSConverter *CGPSConverterRef;

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


      
      CGPSConverterCallbacks

Структура для содержания обратных вызовов обеспечила при создании объекта преобразователя PostScript.

Объявление

Swift

struct CGPSConverterCallbacks { var version: UInt32 var beginDocument: CGPSConverterBeginDocumentCallback var endDocument: CGPSConverterEndDocumentCallback var beginPage: CGPSConverterBeginPageCallback var endPage: CGPSConverterEndPageCallback var noteProgress: CGPSConverterProgressCallback var noteMessage: CGPSConverterMessageCallback var releaseInfo: CGPSConverterReleaseInfoCallback }

Objective C

struct CGPSConverterCallbacks { unsigned int version; CGPSConverterBeginDocumentCallback beginDocument; CGPSConverterEndDocumentCallback endDocument; CGPSConverterBeginPageCallback beginPage; CGPSConverterEndPageCallback endPage; CGPSConverterProgressCallback noteProgress; CGPSConverterMessageCallback noteMessage; CGPSConverterReleaseInfoCallback releaseInfo; }; typedef struct CGPSConverterCallbacks CGPSConverterCallbacks;

Поля

`version`	Номер версии структуры передал в в качестве параметра функциям создания преобразователя. Структура, определенная ниже, является версией `0`.
`beginDocument`	Обратный вызов, вызванный в начале преобразования документа PostScript, или `NULL`.
`endDocument`	Обратный вызов, вызванный в конце преобразования документа PostScript, или `NULL`.
`beginPage`	Обратный вызов, вызванный в начале преобразования каждой страницы в документе PostScript, или `NULL`.
`endPage`	Обратный вызов, вызванный в конце преобразования каждой страницы в документе PostScript, или `NULL`.
`noteProgress`	Обратный вызов вызывал периодически во время преобразования, чтобы указать, что преобразование продолжается, или `NULL`.
`noteMessage`	Обратный вызов вызвал для передачи любых сообщений, которые могли бы закончиться во время преобразования, или `NULL`.
`releaseInfo`	Когда преобразователь освобожден, или, обратный вызов вызвал `NULL`.

Доступность

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