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

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

Разработчик

Ссылка платформы платформ отображает ссылку кодека для QuickTime

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

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

Ссылка кодека изображения для QuickTime

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

Функции

Функции декомпрессора базового изображения
  • ImageCodecBeginBand ImageCodecBeginBand (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecBeginBand ( ComponentInstance ci, CodecDecompressParams *params, ImageSubCodecDecompressRecord *drp, long flags );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    params

    Указатель на a CodecDecompressParams структура.

    drp

    Указатель на ImageSubCodecDecompressRecord структура.

    flags

    В настоящее время неиспользованный; набор к 0.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Ваш компонент декомпрессора изображения получает адрес целевой пиксельной карты в baseAddr поле drp параметр. Этот адрес включает корректировку к смещению. Обратите внимание на то, что, если битовая глубина пиксельной карты - меньше чем 8, Ваш компонент декомпрессора изображения должен привести в соответствие с разрядным смещением.

    codecData поле drp параметр содержит указатель на сжатые видеоданные. userDecompressRecord поле drp параметр содержит указатель на хранение для работы распаковки. Хранение выделяется декомпрессором базового изображения после того, как это вызовет ImageCodecInitialize функция. Размер хранения определяется decompressRecordSize поле ImageSubCodecDecompressCapabilities структура, возвращающаяся ImageCodecInitialize. Ваш компонент декомпрессора изображения должен использовать это хранение, чтобы хранить любую дополнительную информацию, необходимую о кадре для распаковки его.

    Изменяется Ваш компонент декомпрессора изображения делает к ImageSubCodecDecompressRecord или CodecDecompressParams структуры сохраняются декомпрессором базового изображения. Например, если Ваш компонент не должен распаковывать все данные, он может изменить указатель на данные, которые будут распакованы, который сохранен в codecData поле ImageSubCodecDecompressRecord структура.

    Специальные замечания

    Ваш компонент должен реализовать эту функцию. Кроме того, декомпрессор базового изображения никогда не вызывает ImageCodecBeginBand во время прерывания. Если Ваш компонент поддерживает асинхронную запланированную распаковку, он может получить больше чем один ImageCodecBeginBand вызовите прежде, чем получить ImageCodecDrawBand вызвать.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDisposeMemory ImageCodecDisposeMemory (OS X v10.9)

    Располагает выделенную кодеку память.

    Объявление

    Objective C

    ComponentResult ImageCodecDisposeMemory ( ComponentInstance ci, Ptr data );

    Параметры

    ci

    Компонентный экземпляр компрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    data

    Указатель на ранее выделенный блок памяти.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Ваш компонент получает ImageCodecDisposeMemory запросите каждый раз, когда приложение вызывает CDSequenceDisposeMemory.

    Специальные замечания

    Когда экземпляр кодека закрывается, он должен гарантировать, что все блоки, выделенные тем экземпляром, расположены и вызывают ICMMemoryDisposedProc.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDITLEvent ImageCodecDITLEvent (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecDITLEvent ( ComponentInstance ci, DialogRef d, short itemOffset, const EventRecord *theEvent, short *itemHit, Boolean *handled );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий Ваше соединение с компонентом кодека изображения.

    d

    Диалоговая ссылка, идентифицирующая диалоговое окно настроек.

    itemOffset

    Смещение к первому элементу Вашей панели в диалоговом окне.

    theEvent

    Указатель на EventRecord структура. Эта структура содержит информацию, идентифицирующую природу события.

    itemHit

    Указатель на поле, которое должно получить номер изделия в случаях, где Ваш компонент обрабатывает событие. Число возвратилось, абсолют, не относительное число, таким образом, оно должно быть смещено itemOffset параметр обрабатывается.

    handled

    Указатель на булево значение. Установите это булево значение в TRUE при обработке события; установите его в FALSE, если Вы не делаете.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDITLInstall ImageCodecDITLInstall (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecDITLInstall ( ComponentInstance ci, DialogRef d, short itemOffset );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий Ваше соединение с компонентом кодека изображения.

    d

    Указатель на диалоговое окно, которое будет установлено.

    itemOffset

    Смещение к первому диалоговому элементу кодека Вашего изображения.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDITLItem ImageCodecDITLItem (OS X v10.9)

    Получает и обрабатывает щелчки мышью в диалоговом окне настроек кодека изображения.

    Объявление

    Objective C

    ComponentResult ImageCodecDITLItem ( ComponentInstance ci, DialogRef d, short itemOffset, short itemNum );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий Ваше соединение с компонентом кодека изображения.

    d

    Диалоговая ссылка, идентифицирующая диалоговое окно настроек.

    itemOffset

    Смещение к первому элементу Вашей панели в диалоговом окне.

    itemNum

    Номер изделия диалогового элемента выбран пользователем. Средство захвата последовательности обеспечивает абсолютный номер изделия. Это - Ваша ответственность скорректировать это значение для учета смещения к первому элементу панели в диалоговом окне.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDITLRemove ImageCodecDITLRemove (OS X v10.9)

    Удаляет панель из диалогового окна настроек кодека изображения.

    Объявление

    Objective C

    ComponentResult ImageCodecDITLRemove ( ComponentInstance ci, DialogRef d, short itemOffset );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий Ваше соединение с компонентом кодека изображения.

    d

    Диалоговый указатель, идентифицирующий диалоговое окно настроек.

    itemOffset

    Смещение к первому элементу Вашей панели в диалоговом окне.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDITLValidateInput ImageCodecDITLValidateInput (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecDITLValidateInput ( ComponentInstance ci, Boolean *ok );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий Ваше соединение с компонентом кодека изображения.

    ok

    Указатель на булево значение. Установите это значение в TRUE, если настройки в порядке; иначе, установите его в FALSE.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDrawBand ImageCodecDrawBand (OS X v10.9)

    Распаковывает полосу или кадр.

    Объявление

    Objective C

    ComponentResult ImageCodecDrawBand ( ComponentInstance ci, ImageSubCodecDecompressRecord *drp );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    drp

    Указатель на ImageSubCodecDecompressRecord структура.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Когда декомпрессор базового изображения вызывает Ваш компонент декомпрессора изображения ImageCodecDrawBand функция, Ваш компонент должен выполнить распаковку, указанную полями ImageSubCodecDecompressRecord структура. Структура включает любые изменения Ваш компонент, сделанный к нему при выполнении ImageCodecBeginBand функция. Если Ваш компонент поддерживает асинхронную запланированную распаковку, он может получить больше чем один ImageCodecBeginBand вызовите прежде, чем получить ImageCodecDrawBand вызвать.

    Специальные замечания

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEndBand ImageCodecEndBand (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecEndBand ( ComponentInstance ci, ImageSubCodecDecompressRecord *drp, OSErr result, long flags );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    drp

    Указатель на ImageSubCodecDecompressRecord структура.

    result

    Код результата.

    flags

    В настоящее время неиспользованный; набор к 0.

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

    Возвраты noErr если полоса или кадр были нарисованы успешно. Если это - какое-либо другое значение, полоса или кадр не были нарисованы. Посмотрите Error Codes.

    Обсуждение

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

    Специальные замечания

    Декомпрессор базового изображения может вызвать ImageCodecEndBand во время прерывания.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecExtractAndCombineFields ImageCodecExtractAndCombineFields (OS X v10.9)

    Выполняет деятельность на местах на видеоданных.

    Объявление

    Objective C

    ComponentResult ImageCodecExtractAndCombineFields ( ComponentInstance ci, long fieldFlags, void *data1, long dataSize1, ImageDescriptionHandle desc1, void *data2, long dataSize2, ImageDescriptionHandle desc2, void *outputData, long *outDataSize, ImageDescriptionHandle descOut );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    fieldFlags

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

    • evenField1ToEvenFieldOut

    • evenField1ToOddFieldOut

    • oddField1ToEvenFieldOut

    • oddField1ToOddFieldOut

    • evenField2ToEvenFieldOut

    • evenField2ToOddFieldOut

    • oddField2ToEvenFieldOut

    • oddField2ToOddFieldOut

    data1

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

    dataSize1

    Размер буфера data1.

    desc1

    ImageDescription структура, описывающая формат и характеристики данных в буфере data1.

    data2

    Указатель на буфер, содержащий сжатые данные изображения для второго поля ввода. Набор к NIL если требуемая работа использует только один входной кадр.

    dataSize2

    Размер буфера data2. Набор к 0, если требуемая работа использует только один входной кадр.

    desc2

    ImageDescription структура, описывающая формат и характеристики данных в буфере data2. Набор к NIL если требуемая работа использует только один входной кадр.

    outputData

    Указатель на буфер для приема получающегося кадра.

    outDataSize

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

    descOut

    Нужный формат получающихся кадров. Обычно это - тот же формат, указанный desc1 и desc2 параметрами.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

    • kImageCodecExtractAndCombineFieldsSelect =0x0015

    Специальные замечания

    Эта подпрограмма кодека реализует функциональность ImageFieldSequenceExtractCombine функция. Если Ваш кодек способен к отдельному сжатию обоих полей видеокадра, необходимо включить поддержку этой функции. Ваш кодек должен гарантировать, что понимает форматы изображения, указанные desc1 и desc2 параметрами, поскольку они могут не совпасть с собственным форматом изображения кодека. Формат изображения, указанный descOut параметр совпадет с собственным форматом изображения кодека.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecFlush ImageCodecFlush (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecFlush ( ComponentInstance ci );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Ваш компонент получает ImageCodecFlush функционируйте каждый раз, когда Программа управления сжатием изображений должна отменить дисплей всех запланированных кадров. Ваш декомпрессор должен освободить свою очередь запланированных асинхронных запросов распаковки. Для каждого запроса Ваш компонент должен вызвать ICMDecompressComplete. Обязательно установите err параметр к-1, указывая, что был отменен запрос. Кроме того, необходимо установить обоих codecCompletionSource и codecCompletionDest флаги к 1.

    Специальные замечания

    Ваш компонент ImageCodecFlush во время прерывания может быть вызвана функция. Только компоненты декомпрессора, поддерживающие запланированную асинхронную распаковку, принимают этот вызов.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetDITLForSize ImageCodecGetDITLForSize (OS X v10.9)

    Возвращает размер различных диалоговых списков элемента.

    Объявление

    Objective C

    ComponentResult ImageCodecGetDITLForSize ( ComponentInstance ci, Handle *ditl, Point *requestedSize );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий Ваше соединение с компонентом кодека изображения.

    ditl

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

    requestedSize

    Размер панели в пикселях или константы (см. ниже). Два специальных значения, kSGSmallestDITLSize и kSGLargestDITLSize, запросите самый маленький или самый большой размер списка. Если просто константы будут возвращены, средство захвата последовательности интерполирует элементы панели между двумя размерами. Кодек должен в минимальной поддержке kSGSmallestDITLSize если это реализует этот вызов. Посмотрите эти константы:

    • kSGSmallestDITLSize

    • kSGLargestDITLSize

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

    Возвраты кодека badComponentSelector для размеров это не реализует и noErr если нет никакой ошибки. Посмотрите Error Codes.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetMaxCompressionSizeWithSources ImageCodecGetMaxCompressionSizeWithSources (OS X v10.9)

    Когда приложение вызывает GetCSequenceMaxCompressionSize, уведомляет Ваш кодек.

    Объявление

    Objective C

    ComponentResult ImageCodecGetMaxCompressionSizeWithSources ( ComponentInstance ci, PixMapHandle src, const Rect *srcRect, short depth, CodecQ quality, CDSequenceDataSourcePtr sourceData, long *size );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    src

    Дескриптор к исходному изображению. Исходное изображение сохранено в a PixMap структура. Приложения используют информацию о размере, которую Вы возвращаете для выделения буферов больше чем для одного изображения. Следовательно, Ваш компрессор не должен рассматривать содержание изображения при определении максимального сжатого размера. Скорее необходимо рассмотреть только уровень качества, пиксельную глубину и размер изображения. Этот параметр может также быть установлен на NIL. В этом случае приложение не предоставило исходное изображение; Ваш компонент должен использовать other параметры для определения характеристик изображения, которое будет сжато.

    srcRect

    Указатель на a Rect структура, определяющая часть исходного изображения для сжатия.

    depth

    Глубина, на которой должно быть сжато изображение. Значения 1, 2, 4, 8, 16, 24, и 32 указывают число бит на пиксель для цветных изображений. Значения 33, 34, 36, и 40 указывают 1-разрядную, 2-разрядную, 4-разрядную, и 8-разрядную шкалу полутонов, соответственно, для полутоновых изображений.

    quality

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

    sourceData

    Указатель на a CDSequenceDataSource структура, содержащая связанный список всех источников данных. Поскольку каждый источник данных содержит ссылку на следующий источник данных, кодек может получить доступ ко всем источникам данных от этой структуры.

    size

    Указатель на поле для получения максимального размера, в байтах, сжатого изображения.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetSettings ImageCodecGetSettings (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecGetSettings ( ComponentInstance ci, Handle settings );

    Параметры

    ci

    Компонентный экземпляр компрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    settings

    Дескриптор, которого кодек должен изменить размеры и заполнить с текущими внутренними настройками. Если нет никаких текущих внутренних настроек, не изменяют размеры его к 0. Не избавляйтесь от этого дескриптора.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    ImageCodecGetSettings возвращает текущие внутренние настройки кодека. Если нет никаких текущих настроек, или настройки совпадают со значениями по умолчанию, кодек может установить дескриптор в NIL.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecHitTestData ImageCodecHitTestData (OS X v10.9)

    Когда приложение вызывает PtInDSequenceData, уведомляет Ваш кодек.

    Объявление

    Objective C

    ComponentResult ImageCodecHitTestData ( ComponentInstance ci, ImageDescriptionHandle desc, void *data, Size dataSize, Point where, Boolean *hit );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    desc

    ImageDescriptionHandle для данных изображения, на которые указывают data параметр.

    data

    Указатель на сжатые данные в формате, указанном desc параметр.

    dataSize

    Size из сжатых данных, именуемых data параметр.

    where

    QuickDraw Point структура (0,0) базировалась в верхнем левом углу изображения.

    hit

    Указатель на булево значение. Значение должно быть установлено в TRUE если точка, указанная where параметр содержится в сжатых данных изображения, указанных data параметр или FALSE, если указанная точка находится в пределах пустой части изображения.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    ImageCodecHitTestData позволяет вызывающему приложению выполнять тестирование хита на сжатых данных.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecInitialize ImageCodecInitialize (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecInitialize ( ComponentInstance ci, ImageSubCodecDecompressCapabilities *cap );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    cap

    По возврату, ImageSubCodecDecompressCapabilities структура, содержащая возможности компонента декомпрессора изображения. Эта структура содержит два поля. canAsync поле указывает, может ли Ваш компонент поддерживать асинхронные операции распаковки. decompressRecordSize поле указывает размер структуры записи распаковки для Вашего компонента.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Ваш компонент должен реализовать эту функцию.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecIsImageDescriptionEquivalent ImageCodecIsImageDescriptionEquivalent (OS X v10.9)

    Сравнивает описания изображения.

    Объявление

    Objective C

    ComponentResult ImageCodecIsImageDescriptionEquivalent ( ComponentInstance ci, ImageDescriptionHandle newDesc, Boolean *equivalent );

    Параметры

    ci

    Компонентный экземпляр компрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    newDesc

    Дескриптор к ImageDescription структура, описывающая сжатое изображение.

    equivalent

    Указатель на булево значение. Если структура обеспечила в newDesc параметр эквивалентен ImageDescription структура, использующаяся в настоящее время последовательностью изображений, это значение установлено в TRUE. Если они не эквивалентны, и поэтому новая последовательность изображений должна быть создана для отображения изображения с помощью нового ImageDescription структура, это значение установлено в FALSE.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

    Специальные замечания

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecMergeFloatingImageOntoWindow ImageCodecMergeFloatingImageOntoWindow (OS X v10.9)

    Рисует текущее содержание плавающего изображения.

    Объявление

    Objective C

    ComponentResult ImageCodecMergeFloatingImageOntoWindow ( ComponentInstance ci, UInt32 flags );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий Ваше соединение с компонентом кодека изображения.

    flags

    В настоящее время не реализованный.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecNewImageBufferMemory ImageCodecNewImageBufferMemory (OS X v10.9)

    Просит кодек выделять память для внеэкранного буфера пикселей не-RGB.

    Объявление

    Objective C

    ComponentResult ImageCodecNewImageBufferMemory ( ComponentInstance ci, CodecDecompressParams *params, long flags, ICMMemoryDisposedUPP memoryGoneProc, void *refCon );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    params

    Указатель на структуру параметров распаковки.

    flags

    В настоящее время этот параметр всегда устанавливается на 0.

    memoryGoneProc

    Указатель на ICMMemoryDisposedProc обратный вызов, который вызовут перед избавлением от памяти, выделенной кодеком.

    refCon

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

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

    Специальные замечания

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecNewMemory ImageCodecNewMemory (OS X v10.9)

    Запросы выделенная кодеку память.

    Объявление

    Objective C

    ComponentResult ImageCodecNewMemory ( ComponentInstance ci, Ptr *data, Size dataSize, long dataUse, ICMMemoryDisposedUPP memoryGoneProc, void *refCon );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    data

    Возвращает указатель на выделенную память.

    dataSize

    Желаемый размер буфера данных.

    dataUse

    Константа (см. ниже), который указывает, как должна использоваться память. Например, память может использоваться, чтобы хранить сжатые данные, прежде чем это будет выведено на экран, данные плоскости маски или распакованные данные. Если нет никакого преимущества к хранению определенного вида данных в памяти кодека, кодек должен отказаться от запроса на выделение памяти. Посмотрите эти константы:

    memoryGoneProc

    Указатель на ICMMemoryDisposedProc обратный вызов, который вызовут перед избавлением от памяти, выделенной кодеком.

    refCon

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

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки. Если Ваш кодек в настоящее время не имеет свободной памяти для данных кадра сжатия, но будет скоро, можно возвратиться codecNoMemoryPleaseWaitErr указать этот факт.

    Обсуждение

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

    Специальные замечания

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecPreflight ImageCodecPreflight (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecPreflight ( ComponentInstance ci, CodecDecompressParams *params );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    params

    Указатель на a CodecDecompressParams структура.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Ваш кодек реагирует на этот вызов путем возврата информации о ее возможностях в a CodecCapabilities структура. Программа управления сжатием изображений создает структуру параметров распаковки, и Ваш компонент декомпрессора изображения требуется только обеспечить значения для wantedDestinationPixelSize и wantedDestinationPixelTypes поля структуры. Ваш компонент декомпрессора изображения может также изменить другие поля при необходимости. Например, если это может масштабировать изображения, это должно установить codecCapabilityCanScale флаг в capabilities поле структуры.

    Специальные замечания

    Ваш компонент должен реализовать эту функцию.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecQueueStarting ImageCodecQueueStarting (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecQueueStarting ( ComponentInstance ci );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

    Специальные замечания

    Во время прерывания декомпрессор базового изображения никогда не вызывает эту функцию.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecQueueStopping ImageCodecQueueStopping (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecQueueStopping ( ComponentInstance ci );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

    Специальные замечания

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecRemoveFloatingImage ImageCodecRemoveFloatingImage (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecRemoveFloatingImage ( ComponentInstance ci, UInt32 flags );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий Ваше соединение с компонентом кодека изображения.

    flags

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecRequestSettings ImageCodecRequestSettings (OS X v10.9)

    Выводит на экран диалоговое окно, содержащее специфичные для кодека настройки сжатия.

    Объявление

    Objective C

    ComponentResult ImageCodecRequestSettings ( ComponentInstance ci, Handle settings, Rect *rp, ModalFilterUPP filterProc );

    Параметры

    ci

    Компонентный экземпляр компрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    settings

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

    rp

    Указатель на a Rect структура, дающая координаты стандартного диалогового окна сжатия в глобальных координатах экрана. Кодек может использовать это для расположения его диалогового окна в ту же область экрана.

    filterProc

    Указатель на a ModalFilterProc обратный вызов, который кодек должен или передать Mac OS ModalDialog функция или вызов в начале диалогового процесса кодека. Этот обратный вызов дает вызывающему приложению и стандартному диалоговому окну сжатия шанс обработать события обновления.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecSetSettings ImageCodecSetSettings (OS X v10.9)

    Устанавливает настройки дополнительного диалогового окна кодека изображения.

    Объявление

    Objective C

    ComponentResult ImageCodecSetSettings ( ComponentInstance ci, Handle settings );

    Параметры

    ci

    Компонентный экземпляр компрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    settings

    Дескриптор к внутренним настройкам, первоначально возвращенным также ImageCodecRequestSettings или ImageCodecGetSettings. Кодек должен установить свои внутренние настройки для соответствия тех из дескриптора настроек. Поскольку кодеку не принадлежит дескриптор, он не должен избавляться от него и должен скопировать только его содержание, не сам дескриптор. Если дескриптор настроек передал, пусто, кодек должен устанавливать свои внутренние настройки в состояние по умолчанию.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecSetTimeCode ImageCodecSetTimeCode (OS X v10.9)

    Устанавливает временной код для следующего кадра, который должен быть распакован.

    Объявление

    Objective C

    ComponentResult ImageCodecSetTimeCode ( ComponentInstance ci, void *timeCodeFormat, void *timeCodeTime );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    timeCodeFormat

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

    timeCodeTime

    Указатель на a TimeCodeRecord структура. Эта структура содержит временную стоимость для следующего кадра в текущей последовательности.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Ваш компонент принимает этот вызов каждый раз, когда приложение вызывает SetDSequenceTimeCode. Та функция позволяет приложению устанавливать временной код для кадра, который должен быть распакован. Информация временного кода, которую Вы получаете, применяется к следующему кадру, который будет распакован, и предоставлена декомпрессору ImageCodecBandDecompress.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecSourceChanged ImageCodecSourceChanged (OS X v10.9)

    Уведомляет Ваш кодек, что один из источников данных изменился, когда приложение вызывает CDSequenceSetSourceData или CDSequenceChangedSourceData.

    Объявление

    Objective C

    ComponentResult ImageCodecSourceChanged ( ComponentInstance ci, UInt32 majorSourceChangeSeed, UInt32 minorSourceChangeSeed, CDSequenceDataSourcePtr sourceData, long *flagsOut );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    majorSourceChangeSeed

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

    minorSourceChangeSeed

    Целочисленное значение, постепенно увеличивающееся каждый раз источник данных, добавлено или удалено, или данные, содержавшиеся в любом из изменений источников данных. Это обеспечивает путь к кодеку, чтобы знать, изменились ли доступные данные к нему.

    sourceData

    Указатель на a CDSequenceDataSource структура. Эта структура содержит связанный список всех источников данных. Поскольку каждый источник данных содержит ссылку на следующий источник данных, кодек может получить доступ ко всем источникам данных от этой структуры.

    flagsOut

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Низкоуровневые функции эффектов
  • ImageCodecCreateStandardParameterDialog ImageCodecCreateStandardParameterDialog (OS X v10.9)

    Создает диалоговое окно параметров для указанного эффекта.

    Объявление

    Objective C

    ComponentResult ImageCodecCreateStandardParameterDialog ( ComponentInstance ci, QTAtomContainer parameterDescription, QTAtomContainer parameters, QTParameterDialogOptions dialogOptions, DialogPtr existingDialog, short existingUserItem, QTParameterDialog *createdDialog );

    Параметры

    ci

    Компонентный экземпляр эффектов. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent. Создающееся диалоговое окно позволит пользователю указывать параметры этого эффекта.

    parameterDescription

    Контейнер атома описания параметра для этого эффекта. Можно получить допустимое описание параметра путем вызова ImageCodecGetParameterList. Параметр дополнительно tweenable, если определено как kAtomInterpolateIsOptional в его атоме описания параметра.

    parameters

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

    dialogOptions

    Средства управления, как параметры, содержащие данные промежуточного кадра, представлены в создаваемом диалоговом окне. Если dialogOptions содержит 0, два значения собраны для каждого параметра, который может быть вставлен промежуточные кадры, и обычная вставляющая промежуточные кадры работа будет выполняться на время эффекта, которым управляют. Для других значений. Посмотрите эти константы:

    • pdOptionsCollectOneValue

    • pdOptionsAllowOptionalInterpolations

    existingDialog

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

    existingUserItem

    Число пользовательского элемента в существующем диалоговом окне, которое должно быть заменено средствами управления от стандартного диалогового окна параметра. Необходимо только передать значение этому параметру если existingDialog параметр не NIL.

    createdDialog

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

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Это - низкоуровневая функция, которая может использоваться для создания стандартного диалогового окна параметра для указанного эффекта, позволяя пользователю установить значения параметров для эффекта. Можно дополнительно запросить, чтобы средства управления от диалогового окна были включены в диалоговом окне вызывающего приложения. Следующий пример кода показывает, как создать стандартное диалоговое окно параметра и добавить средства управления эффектами:

    • // ImageCodecCreateStandardParameterDialog coding example
    • // See "Discovering QuickTime," page 303
    • pMovableModalDialog =GetNewDialog(kExtraDialogID, NIL, (WindowRef)-1);
    • if (pMovableModalDialog !=NIL) {
    • ImageCodecCreateStandardParameterDialog(
    • compInstance,
    • qtacParameterDescription,
    • qtacEffectSample,
    • pdOptionsModelDialogBox,
    • pMovableModalDialog,
    • kExtraUserItemID,
    • &lCreatedDialogID);
    • ShowWindow(pMovableModalDialog);
    • SelectWindow(pMovableModalDialog);
    • SetPort(pMovableModalDialog);
    • }

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDismissStandardParameterDialog ImageCodecDismissStandardParameterDialog (OS X v10.9)

    Получает значения от стандартного диалогового окна параметра, создаваемого низкоуровневой функцией ImageCodecCreateStandardParameterDialog, затем закрывает диалоговое окно.

    Объявление

    Objective C

    ComponentResult ImageCodecDismissStandardParameterDialog ( ComponentInstance ci, QTParameterDialog createdDialog );

    Параметры

    ci

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent. Это должно быть экземпляром, переданным ImageCodecCreateStandardParameterDialog создать диалоговое окно.

    createdDialog

    Ссылка на диалоговое окно, создаваемое вызовом к ImageCodecCreateStandardParameterDialog.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Эта функция должна быть вызвана после ImageCodecIsStandardParameterDialogEvent функциональные возвраты codecParameterDialogConfirm или userCanceledErr, которые указывают, что пользователь отклонил диалоговое окно. Функция отклоняет диалоговое окно, освобождая любую память, выделенную во время вызова ImageCodecCreateStandardParameterDialog.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetParameterList ImageCodecGetParameterList (OS X v10.9)

    Возвращает контейнер атома описания параметра для указанного компонентного экземпляра эффекта.

    Объявление

    Objective C

    ComponentResult ImageCodecGetParameterList ( ComponentInstance ci, QTAtomContainer *parameterDescription );

    Параметры

    ci

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    parameterDescription

    Возвращенный контейнер атома для этого экземпляра компонента.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Эта функция возвращает описание параметра для эффекта, указанного экземпляром компонента ci, как дескриптор, содержащий 'atms' ресурс ID 1. Дескриптор должен быть отсоединен, если он был считан в из ресурса. Каждый параметр эффекта описан в описании параметра, с подробными данными его имени, типа, юридических значений и подсказок о том, как должен быть создан пользовательский интерфейс к параметру.

    Специальные замечания

    Вызывающее приложение ответственно за избавление от контейнера атома QT, возвращенного в parameterDescription. Приложение должно сделать это путем вызова QTDisposeAtomContainer как только это закончило использовать описание параметра.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecIsStandardParameterDialogEvent ImageCodecIsStandardParameterDialogEvent (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecIsStandardParameterDialogEvent ( ComponentInstance ci, EventRecord *pEvent, QTParameterDialog createdDialog );

    Параметры

    ci

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent. Это должно быть экземпляром, переданным ImageCodecCreateStandardParameterDialog создать диалоговое окно.

    pEvent

    Указатель на EventRecord структура.

    createdDialog

    Ссылка на диалоговое окно, создаваемое вызовом к ImageCodecCreateStandardParameterDialog.

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

    Если код ошибки возвратился, featureUnsupported, Ваше приложение должно обработать событие нормальным способом. Если это noErr, событие было обработано. Если эта функция возвращает какое-либо другое значение, ошибка произошла. Посмотрите Error Codes.

    Обсуждение

    Эта функция возвращает код ошибки, указывающий ли событие, которым указывают pEvent был обработан или нет. После вызова ImageCodecCreateStandardParameterDialog для создания стандартного диалогового окна параметра необходимо передать каждое ненулевое событие этой функции. Это обрабатывает события, связанные со стандартным диалоговым окном параметра, передавая другие события Вашему приложению для обработки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecStandardParameterDialogDoAction ImageCodecStandardParameterDialogDoAction (OS X v10.9)

    Позволяет Вам управлять поведением стандартного диалогового окна параметра, создаваемого ImageCodecCreateStandardParameterDialog.

    Объявление

    Objective C

    ComponentResult ImageCodecStandardParameterDialogDoAction ( ComponentInstance ci, QTParameterDialog createdDialog, long action, void *params );

    Параметры

    ci

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent. Это должно быть тем же экземпляром, как был передан ImageCodecCreateStandardParameterDialog создать диалоговое окно.

    createdDialog

    Ссылка на диалоговое окно, создаваемое вызовом к ImageCodecCreateStandardParameterDialog.

    action

    Селектор действия (см. ниже), который определяет, какое из доступных действий Вы хотите, чтобы функция выполнила. Посмотрите эти константы:

    • pdActionConfirmDialog

    • pdActionSetAppleMenu

    • pdActionSetEditMenu

    • pdActionGetDialogValues

    • pdActionSetPreviewUserItem

    • pdActionSetPreviewPicture

    • pdActionSetColorPickerEventProc

    • pdActionSetDialogTitle

    • pdActionGetSubPanelMenu

    • pdActionActivateSubPanel

    • pdActionConductStopAlert

    params

    (Дополнительный) параметр к action. Тип, переданный в этом параметре, зависит от значения action параметр.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Векторные компонентные функции кодека
  • CurveAddAtomToVectorStream CurveAddAtomToVectorStream (OS X v10.9)

    Добавляет атом к векторному потоку данных.

    Объявление

    Objective C

    ComponentResult CurveAddAtomToVectorStream ( ComponentInstance effect, OSType atomType, Size atomSize, void *pAtomData, Handle vectorStream );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    atomType

    Тип атома для добавления к векторному потоку данных.

    atomSize

    Размер данных для атома.

    pAtomData

    Указатель на данные для атома.

    vectorStream

    Дескриптор к векторному потоку данных, к которому можно добавить атом.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveAddPathAtomToVectorStream CurveAddPathAtomToVectorStream (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult CurveAddPathAtomToVectorStream ( ComponentInstance effect, Handle pathData, Handle vectorStream );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    pathData

    Дескриптор к данным для пути.

    vectorStream

    Дескриптор к векторному потоку данных, к которому можно добавить путь.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveAddZeroAtomToVectorStream CurveAddZeroAtomToVectorStream (OS X v10.9)

    Добавляет kCurveEndAtom к векторному потоку данных; этот атом отмечает конец векторного потока данных,

    Объявление

    Objective C

    ComponentResult CurveAddZeroAtomToVectorStream ( ComponentInstance effect, Handle vectorStream );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    vectorStream

    Дескриптор к векторному потоку данных, к которому можно добавить kCurveEndAtom атом.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Эта функция добавляет a kCurveEndAtom атом до конца указанного векторного потока данных и изменяет размеры векторного дескриптора потока данных. kCurveEndAtom атом требуется в конце векторного потока данных, и может быть только один kCurveEndAtom атом в потоке.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveCountPointsInPath CurveCountPointsInPath (OS X v10.9)

    Считает точки или вдоль одного из контуров пути или вдоль всех его контуров.

    Объявление

    Objective C

    ComponentResult CurveCountPointsInPath ( ComponentInstance effect, gxPaths *aPath, unsigned long contourIndex, unsigned long *pCount );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса.

    aPath

    Указатель на путь.

    contourIndex

    Индекс контура, который будет считаться.

    pCount

    Указатель на поле, которое должно получить число очков в контуре или пути.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveCreateVectorStream CurveCreateVectorStream (OS X v10.9)

    Создает новый поток данных пустого вектора.

    Объявление

    Objective C

    ComponentResult CurveCreateVectorStream ( ComponentInstance effect, Handle *pStream );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    pStream

    Указатель на дескриптор, который должен получить недавно создаваемый векторный поток данных.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveGetAtomDataFromVectorStream CurveGetAtomDataFromVectorStream (OS X v10.9)

    Находит первый атом указанного типа в векторном потоке данных, и получите его данные.

    Объявление

    Objective C

    ComponentResult CurveGetAtomDataFromVectorStream ( ComponentInstance effect, Handle vectorStream, long atomType, long *dataSize, Ptr *dataPtr );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    vectorStream

    Дескриптор к векторному потоку данных, от которого можно получить атом.

    atomType

    Тип атома для нахождения.

    dataSize

    Указатель на поле, которое должно получить размер данных атома.

    dataPtr

    Указатель на указатель на поле, которое должно получить данные атома.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Прежде, чем вызвать эту функцию, Ваше программное обеспечение должно заблокировать дескриптор для векторного потока данных (с Macintosh, путем вызова HLock). Это препятствует тому, чтобы дескриптор был перемещен, который мог лишить законной силы указатель на данные атома, прежде чем Ваше программное обеспечение получит данные.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveGetLength CurveGetLength (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult CurveGetLength ( ComponentInstance effect, gxPaths *target, long index, wide *wideLength );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    target

    Указатель на путь.

    index

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

    wideLength

    Указатель на поле, которое должно получить длину.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveGetNearestPathPoint CurveGetNearestPathPoint (OS X v10.9)

    Находит самую близкую точку на пути к указанной точке.

    Объявление

    Objective C

    ComponentResult CurveGetNearestPathPoint ( ComponentInstance effect, gxPaths *aPath, FixedPoint *thePoint, unsigned long *contourIndex, unsigned long *pointIndex, Fixed *theDelta );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    aPath

    Указатель на путь.

    thePoint

    Указатель на точку, для которой можно найти самую близкую точку на пути.

    contourIndex

    Указатель на поле, которое должно получить индекс контура, содержащего самую близкую точку.

    pointIndex

    Указатель на поле, которое должно получить индекс самой близкой точки.

    theDelta

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

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveGetPathPoint CurveGetPathPoint (OS X v10.9)

    Получает точку из пути и узнать, находится ли точка на кривой.

    Объявление

    Objective C

    ComponentResult CurveGetPathPoint ( ComponentInstance effect, gxPaths *aPath, unsigned long contourIndex, unsigned long pointIndex, gxPoint *thePoint, Boolean *ptIsOnPath );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    aPath

    Указатель на путь.

    contourIndex

    Индекс контура, от которого можно понять.

    pointIndex

    Индекс точки для получения.

    thePoint

    Указатель на поле, которое должно получить очко.

    ptIsOnPath

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

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveInsertPointIntoPath CurveInsertPointIntoPath (OS X v10.9)

    Добавляет новая точка к пути.

    Объявление

    Objective C

    ComponentResult CurveInsertPointIntoPath ( ComponentInstance effect, gxPoint *aPoint, Handle thePath, unsigned long contourIndex, unsigned long pointIndex, Boolean ptIsOnPath );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    aPoint

    Указатель на точку для добавления к пути.

    thePath

    Дескриптор к пути, к которому можно добавить точку.

    contourIndex

    Индекс пути очерчивает, к которому можно добавить точку.

    pointIndex

    Индекс точки для добавления.

    ptIsOnPath

    ЕСЛИ ЭТО ПРАВДА, указывает, что новая точка должна быть на пути.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Эта функция является лучшей для добавления единственной точки к пути, а не большим количествам точек.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveLengthToPoint CurveLengthToPoint (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult CurveLengthToPoint ( ComponentInstance effect, gxPaths *target, long index, Fixed length, FixedPoint *location, FixedPoint *tangent );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    target

    Указатель на путь.

    index

    Индекс пути очерчивает, от которого можно понять.

    length

    Расстояние вдоль кривой, в которой можно найти точку.

    location

    Указатель на поле, которое должно получить очко.

    tangent

    Указатель на поле, которое должно получить очко, которое является касательной к точке на указанном расстоянии.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Эта функция полезна для преобразования значения к точке, такой, создавая анимацию, следующую за кривой.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveNewPath CurveNewPath (OS X v10.9)

    Создает новый путь.

    Объявление

    Objective C

    ComponentResult CurveNewPath ( ComponentInstance effect, Handle *pPath );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    pPath

    Указатель на дескриптор, который должен получить новый путь.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Путь, создаваемый этой функцией, содержит один контур и никакие точки. Вызывающая сторона должна избавиться от дескриптора, когда это закончено с ним (с Macintosh, путем вызова DisposeHandle).

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurvePathPointToLength CurvePathPointToLength (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult CurvePathPointToLength ( ComponentInstance ci, gxPaths *aPath, Fixed startDist, Fixed endDist, FixedPoint *thePoint, Fixed *pLength );

    Параметры

    ci

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    aPath

    Указатель на путь.

    startDist

    Расстояние вдоль пути, в котором можно начать измерять длину пути.

    endDist

    Расстояние вдоль пути, в котором можно прекратить измерять длину пути.

    thePoint

    Указатель на точку; функция измеряет путь, самый близкий к этой точке.

    pLength

    Указатель на поле, которое должно получить длину указанной части пути.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Если пользователь щелкнул по указанной части кривой, можно использовать эту функцию, чтобы протестировать.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CurveSetPathPoint CurveSetPathPoint (OS X v10.9)

    Изменяет местоположение точки по пути.

    Объявление

    Objective C

    ComponentResult CurveSetPathPoint ( ComponentInstance effect, gxPaths *aPath, unsigned long contourIndex, unsigned long pointIndex, gxPoint *thePoint, Boolean ptIsOnPath );

    Параметры

    effect

    Экземпляр компонента кодека вектора QuickTime для запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов OpenComponent или OpenDefaultComponent функция.

    aPath

    Указатель на путь.

    contourIndex

    Индекс контура пути, содержащего точку для изменения.

    pointIndex

    Индекс точки для изменения.

    thePoint

    Указатель на новое значение для точки.

    ptIsOnPath

    ЕСЛИ ЭТО ПРАВДА, указывает, что новая точка должна быть на пути.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Эта функция редактирует существующее расположение точки в пути. Функция, которую Вы вызываете для отправки интерполированного значения в дорожку получения, определяется как универсальная процедура в системах, поддерживающих Macintosh Code Fragment Manager (CFM), или определяется как процедура данных для систем не-CFM. С Macintosh, TweenerDataUPP указатель функции указывает функцию компонентные вызовы промежуточного кадра со значением, сгенерированным работой промежуточного кадра. Компонент промежуточного кадра вызывает эту функцию от своей реализации TweenerDoTween функция. Вы вызываете эту функцию путем вызова функции, указанной в записи промежуточного кадра dataProc поле.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Поддержка функций
  • DisposeImageCodecDrawBandCompleteUPP DisposeImageCodecDrawBandCompleteUPP (OS X v10.9)

    Избавляется от указателя ImageCodecDrawBandCompleteUPP.

    Объявление

    Objective C

    void DisposeImageCodecDrawBandCompleteUPP ( ImageCodecDrawBandCompleteUPP userUPP );

    Параметры

    userUPP

    ImageCodecDrawBandCompleteUPP указатель. Посмотрите Universal Procedure Pointers.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • DisposeImageCodecMPDrawBandUPP DisposeImageCodecMPDrawBandUPP (OS X v10.9)

    Избавляется от указателя ImageCodecMPDrawBandUPP.

    Объявление

    Objective C

    void DisposeImageCodecMPDrawBandUPP ( ImageCodecMPDrawBandUPP userUPP );

    Параметры

    userUPP

    ImageCodecMPDrawBandUPP указатель. Посмотрите Universal Procedure Pointers.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • DisposeImageCodecTimeTriggerUPP DisposeImageCodecTimeTriggerUPP (OS X v10.9)

    Избавляется от указателя ImageCodecTimeTriggerUPP.

    Объявление

    Objective C

    void DisposeImageCodecTimeTriggerUPP ( ImageCodecTimeTriggerUPP userUPP );

    Параметры

    userUPP

    ImageCodecTimeTriggerUPP указатель. Посмотрите Universal Procedure Pointers.

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

    Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecBandCompress ImageCodecBandCompress (OS X v10.9)

    Просит Ваш компонент сжимать изображение или полосу изображения.

    Объявление

    Objective C

    ComponentResult ImageCodecBandCompress ( ComponentInstance ci, CodecCompressParams *params );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    params

    Указатель на a CodecCompressParams структура. Программа управления сжатием изображений помещает надлежащую информацию о параметре в ту структуру.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Сжимаемое изображение может быть частью последовательности.

    Специальные замечания

    Только компрессоры получают этот запрос.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecBandDecompress ImageCodecBandDecompress (OS X v10.9)

    Просит Ваш компонент распаковывать кадр.

    Объявление

    Objective C

    ComponentResult ImageCodecBandDecompress ( ComponentInstance ci, CodecDecompressParams *params );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    params

    Указатель на a CodecDecompressParams структура. Программа управления сжатием изображений помещает надлежащую информацию о параметре в ту структуру.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

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

    Если Ваш компонент устанавливает codecCanAsyncWhen флаг в предварительной распаковке, но не может поддерживать запланированную асинхронную распаковку для данного кадра, это должно возвратить код ошибки codecCantWhenErr. Если очередь Вашего компонента полна, она должна возвратить код ошибки codecCantQueueErr. Только декомпрессоры получают эти запросы.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecBeginPass ImageCodecBeginPass (OS X v10.9)

    Уведомляет компрессор, что он должен работать в многопроходном режиме и использовать данное многопроходное хранение.

    Объявление

    Objective C

    ComponentResult ImageCodecBeginPass ( ComponentInstance ci, ICMCompressionPassModeFlags passModeFlags, UInt32 flags, ICMMultiPassStorageRef multiPassStorage );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий соединение с компонентом кодека изображения.

    passModeFlags

    Указывает, как компрессор должен работать в этой передаче. Если kICMCompressionPassMode_WriteToMultiPassStorage флаг установлен, компрессор может собрать информацию интереса и сохранить его в multiPassStorage. Если kICMCompressionPassMode_ReadFromMultiPassStorage флаг установлен, компрессор может получить информацию от multiPassStorage. Если kICMCompressionPassMode_OutputEncodedFrames флаг установлен, компрессор должен закодировать или отбросить каждый кадр путем вызова ICMCompressorSessionDropFrame или ICMCompressorSessionEmitEncodedFrame. Если тот флаг не установлен, компрессор не должен вызывать эти подпрограммы.

    flags

    Зарезервированный. Проигнорируйте этот параметр.

    multiPassStorage

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

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

    Код ошибки, или noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecBusy ImageCodecBusy (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecBusy ( ComponentInstance ci, ImageSequence seq );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    seq

    Уникальный идентификатор последовательности, присвоенный CompressSequenceBegin или DecompressSequenceBegin.

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

    Если асинхронная работа происходит, Ваш компонент должен возвратить значение кода результата 1; если компонент не выполняет асинхронную работу, это должно возвратить значение кода результата 0. Можно указать ошибку путем возврата отрицательного кода результата. Посмотрите Error Codes.

    Специальные замечания

    И компрессоры и декомпрессоры могут получить этот запрос.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecCancelTrigger ImageCodecCancelTrigger (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecCancelTrigger ( ComponentInstance ci );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecCompleteFrame ImageCodecCompleteFrame (OS X v10.9)

    Направляет компрессор для окончания с исходным кадром с очередями, или испускание или отбрасывание его.

    Объявление

    Objective C

    ComponentResult ImageCodecCompleteFrame ( ComponentInstance ci, ICMCompressorSourceFrameRef sourceFrame, UInt32 flags );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий соединение с компонентом кодека изображения.

    sourceFrame

    Исходный кадр, который должен быть завершен.

    flags

    Зарезервированный; проигнорировать.

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

    Код ошибки, или noErr если нет никакой ошибки.

    Обсуждение

    Этот кадр должен не обязательно быть первым или только исходным кадром, испускаемым или отброшенным во время этого вызова, но компрессор должен вызвать также ICMCompressorSessionDropFrame или ICMCompressorSessionEmitEncodedFrame с этим кадром перед возвратом. ICM вызовет эту функцию, чтобы вынудить кадры быть закодированными по следующим причинам: (a) максимальное количество задержки кадра или максимум структурируют время задержки в compressionSessionOptions не разрешает кадрам быть поставленными в очередь; (b) клиент вызвал ICMCompressionSessionCompleteFrames.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDecodeBand ImageCodecDecodeBand (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecDecodeBand ( ComponentInstance ci, ImageSubCodecDecompressRecord *drp, unsigned long flags );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий соединение с компонентом кодека изображения.

    drp

    Указатель на ImageSubCodecDecompressRecord структура.

    flags

    Не используемый; набор к 0.

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

    Код ошибки, или noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDisposeImageGWorld ImageCodecDisposeImageGWorld (OS X v10.9)

    Избавляется от мира растровой графики, связанного с кодеком изображения.

    Объявление

    Objective C

    ComponentResult ImageCodecDisposeImageGWorld ( ComponentInstance ci, GWorldPtr theGW );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    theGW

    Указатель на a CGrafPort структура.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecDroppingFrame ImageCodecDroppingFrame (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecDroppingFrame ( ComponentInstance ci, const ImageSubCodecDecompressRecord *drp );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    drp

    Указатель на ImageSubCodecDecompressRecord структура.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEffectBegin ImageCodecEffectBegin (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecEffectBegin ( ComponentInstance effect, CodecDecompressParams *p, EffectsFrameParamsPtr ePtr );

    Параметры

    effect

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    p

    Указатель на a CodecDecompressParams структура.

    ePtr

    Указатель на a EffectsFrameParams структура.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEffectCancel ImageCodecEffectCancel (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecEffectCancel ( ComponentInstance effect, EffectsFrameParamsPtr p );

    Параметры

    effect

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    p

    Указатель на a EffectsFrameParams структура.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEffectConvertEffectSourceToFormat ImageCodecEffectConvertEffectSourceToFormat (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecEffectConvertEffectSourceToFormat ( ComponentInstance effect, EffectSourcePtr sourceToConvert, ImageDescriptionHandle requestedDesc );

    Параметры

    effect

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    sourceToConvert

    Недокументированный

    requestedDesc

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEffectDisposeSMPTEFrame ImageCodecEffectDisposeSMPTEFrame (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecEffectDisposeSMPTEFrame ( ComponentInstance effect, SMPTEFrameReference frameRef );

    Параметры

    effect

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    frameRef

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEffectGetSpeed ImageCodecEffectGetSpeed (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecEffectGetSpeed ( ComponentInstance effect, QTAtomContainer parameters, Fixed *pFPS );

    Параметры

    effect

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    parameters

    Недокументированный

    pFPS

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEffectPrepareSMPTEFrame ImageCodecEffectPrepareSMPTEFrame (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecEffectPrepareSMPTEFrame ( ComponentInstance effect, PixMapPtr destPixMap, SMPTEFrameReference *returnValue );

    Параметры

    effect

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    destPixMap

    Недокументированный

    returnValue

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEffectRenderFrame ImageCodecEffectRenderFrame (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecEffectRenderFrame ( ComponentInstance effect, EffectsFrameParamsPtr p );

    Параметры

    effect

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    p

    Указатель на EffectsFrameParams структура.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEffectRenderSMPTEFrame ImageCodecEffectRenderSMPTEFrame (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecEffectRenderSMPTEFrame ( ComponentInstance effect, PixMapPtr destPixMap, SMPTEFrameReference frameRef, Fixed effectPercentageEven, Fixed effectPercentageOdd, Rect *pSourceRect, MatrixRecord *matrixP, SMPTEWipeType effectNumber, long xRepeat, long yRepeat, SMPTEFlags flags, Fixed penWidth, long strokeValue );

    Параметры

    effect

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    destPixMap

    Недокументированный

    frameRef

    Недокументированный

    effectPercentageEven

    Недокументированный

    effectPercentageOdd

    Недокументированный

    pSourceRect

    Недокументированный

    pMatrix

    Недокументированный

    effectNumber

    Недокументированный

    xRepeat

    Недокументированный

    yRepeat

    Недокументированный

    flags

    Недокументированный

    penWidth

    Недокументированный

    strokeValue

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEffectSetup ImageCodecEffectSetup (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecEffectSetup ( ComponentInstance effect, CodecDecompressParams *p );

    Параметры

    effect

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    p

    Указатель на a CodecDecompressParams структура.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecEncodeFrame ImageCodecEncodeFrame (OS X v10.9)

    Дарит компрессору кадр для кодирования.

    Объявление

    Objective C

    ComponentResult ImageCodecEncodeFrame ( ComponentInstance ci, ICMCompressorSourceFrameRef sourceFrame, UInt32 flags );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий соединение с компонентом кодека изображения.

    sourceFrame

    Исходный кадр для кодирования.

    flags

    Зарезервированный; проигнорировать.

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

    Код ошибки, или noErr если нет никакой ошибки.

    Обсуждение

    Компрессор может сразу закодировать кадр или поставить его в очередь для более позднего кодирования. Если компрессор ставит кадр в очередь для, позже декодируют, это должно сохранить его (путем вызова ICMCompressorSourceFrameRetain) и выпустите его, когда это будет сделано с ним (путем вызова ICMCompressorSourceFrameRelease). Пиксельные буферы, как гарантируют, будут соответствовать пиксельным буферным атрибутам, возвращенным ImageCodecPrepareToCompressFrames. Во время многопроходного кодирования, если компрессор запросил kICMCompressionPassMode_NoSourceFrames флаг, пиксельными буферами исходного кадра может быть NULL. (Примечание: это заменяет ImageCodecBandCompress.)

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecFlushFrame ImageCodecFlushFrame (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecFlushFrame ( ComponentInstance ci, UInt32 flags );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    flags

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetBaseMPWorkFunction ImageCodecGetBaseMPWorkFunction (OS X v10.9)

    Получает кодек изображения обратный вызов ComponentMPWorkFunctionProc.

    Объявление

    Objective C

    ComponentResult ImageCodecGetBaseMPWorkFunction ( ComponentInstance ci, ComponentMPWorkFunctionUPP *workFunction, void **refCon, ImageCodecMPDrawBandUPP drawProc, void *drawProcRefCon );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    workFunction

    По возврату, указателю на a ComponentMPWorkFunctionProc обратный вызов.

    refCon

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

    drawProc

    ImageCodecMPDrawBandProc обратный вызов.

    drawProcRefCon

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

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetCodecInfo ImageCodecGetCodecInfo (OS X v10.9)

    Уведомляет Ваш кодек каждый раз, когда приложение вызывает GetCodecInfo.

    Объявление

    Objective C

    ComponentResult ImageCodecGetCodecInfo ( ComponentInstance ci, CodecInfo *info );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    info

    Указатель на a CodecInfo структура для обновления. Ваш компонент должен сообщить о своих возможностях путем форматирования структуры в расположении, указанном этим параметром.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    И компрессоры и декомпрессоры могут получить этот запрос.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetCompressedImageSize ImageCodecGetCompressedImageSize (OS X v10.9)

    Уведомляет Ваш кодек каждый раз, когда приложение вызывает GetCompressedImageSize.

    Объявление

    Objective C

    ComponentResult ImageCodecGetCompressedImageSize ( ComponentInstance ci, ImageDescriptionHandle desc, Ptr data, long bufferSize, ICMDataProcRecordPtr dataProc, long *dataSize );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    desc

    Дескриптор к ImageDescription структура, определяющая сжатое изображение для работы.

    data

    Указатель на сжатые данные изображения.

    bufferSize

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

    dataProc

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

    dataSize

    Указатель на поле, которое должно получить размер, в байтах, сжатого изображения.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Специальные замечания

    Только декомпрессоры получают этот запрос.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetCompressionTime ImageCodecGetCompressionTime (OS X v10.9)

    Уведомляет Ваш кодек каждый раз, когда приложение вызывает GetCompressionTime.

    Объявление

    Objective C

    ComponentResult ImageCodecGetCompressionTime ( ComponentInstance ci, PixMapHandle src, const Rect *srcRect, short depth, CodecQ *spatialQuality, CodecQ *temporalQuality, unsigned long *time );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    src

    Дескриптор к исходному изображению. Исходное изображение сохранено в a PixMap структура. Приложения могут использовать информацию времени, которую Вы возвращаете больше чем для одного изображения. Следовательно, Ваш компрессор не должен рассматривать содержание изображения при определении максимального времени сжатия. Скорее необходимо рассмотреть только уровень качества, пиксельную глубину и размер изображения. Этот параметр может также быть установлен на NIL. В этом случае приложение не предоставило исходное изображение; Ваш компонент должен использовать other параметры для определения характеристик изображения, которое будет сжато.

    srcRect

    Указатель на a Rect структура, определяющая часть исходного изображения для сжатия.

    depth

    Глубина, на которой должно быть сжато изображение. Значения 1, 2, 4, 8, 16, 24, и 32 указывают число бит на пиксель для цветных изображений. Значения 33, 34, 36, и 40 указывают 1-разрядную, 2-разрядную, 4-разрядную, и 8-разрядную шкалу полутонов, соответственно, для полутоновых изображений.

    spatialQuality

    Указатель на поле, содержащее желаемое сжатое качество изображения (см. ниже). Компрессорные установки это поле к самому близкому фактическому качеству, которого это может достигнуть. Посмотрите эти константы:

    • codecMinQuality

    • codecLowQuality

    • codecNormalQuality

    • codecHighQuality

    • codecMaxQuality

    • codecLosslessQuality

    temporalQuality

    Указатель на поле, содержащее желаемую последовательность временное качество (см. ниже). Компрессорные установки это поле к самому близкому фактическому качеству, которого это может достигнуть.

    time

    Указатель на поле для получения времени сжатия, в миллисекундах. Если Ваш компонент не может решить, что количество времени, требуемое сжимать изображение, установило это поле в 0. Проверьте, чтобы видеть если value из этого поля NIL и, если так, не пишите в расположение 0.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetDecompressLatency ImageCodecGetDecompressLatency (OS X v10.9)

    Получает видео значение задержки от указанного видеокодека.

    Объявление

    Objective C

    ComponentResult ImageCodecGetDecompressLatency ( ComponentInstance ci, TimeRecord *latency );

    Параметры

    ci

    Компонентный экземпляр видеокодека. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    latency

    Указатель на a TimeRecord структура, содержащая время задержки, требуется для того кодека.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetMaxCompressionSize ImageCodecGetMaxCompressionSize (OS X v10.9)

    Уведомляет Ваш кодек каждый раз, когда приложение вызывает GetMaxCompressionSize.

    Объявление

    Objective C

    ComponentResult ImageCodecGetMaxCompressionSize ( ComponentInstance ci, PixMapHandle src, const Rect *srcRect, short depth, CodecQ quality, long *size );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    src

    Дескриптор к исходному изображению. Исходное изображение сохранено в a PixMap структура. Приложения используют информацию о размере, которую Вы возвращаете для выделения буферов, которые могут использоваться больше чем для одного изображения. Следовательно, Ваш компрессор не должен рассматривать содержание изображения при определении максимального сжатого размера. Скорее необходимо рассмотреть только уровень качества, пиксельную глубину и размер изображения. Этот параметр может также быть установлен на NIL. В этом случае приложение не предоставило исходное изображение; Ваш компонент должен использовать other параметры для определения характеристик изображения, которое будет сжато.

    srcRect

    Указатель на a Rect структура, определяющая часть исходного изображения для сжатия.

    depth

    Глубина, на которой должно быть сжато изображение. Значения 1, 2, 4, 8, 16, 24, и 32 указывают число бит на пиксель для цветных изображений. Значения 33, 34, 36, и 40 указывают 1-разрядную, 2-разрядную, 4-разрядную, и 8-разрядную шкалу полутонов, соответственно, для полутоновых изображений.

    quality

    Желаемое сжатое качество изображения (см. ниже). Посмотрите эти константы:

    • codecMinQuality

    • codecLowQuality

    • codecNormalQuality

    • codecHighQuality

    • codecMaxQuality

    • codecLosslessQuality

    size

    Указатель на поле для получения максимального размера, в байтах, сжатого изображения.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

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

    Специальные замечания

    Только компрессоры получают этот запрос.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetParameterListHandle ImageCodecGetParameterListHandle (OS X v10.9)

    Возвращает дескриптор ресурсу Mac OS типа 'атм'.

    Объявление

    Objective C

    ComponentResult ImageCodecGetParameterListHandle ( ComponentInstance ci, Handle *parameterDescriptionHandle );

    Параметры

    ci

    Компонентный экземпляр эффекта. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    parameterDescriptionHandle

    Указатель на дескриптор к ресурсу Mac OS типа 'atms'.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Цель этой функции состоит в том, чтобы создать контейнер атома QT в ответ на вызов к ImageCodecGetParameterList. Дескриптор должен быть отсоединен, если он был считан в из ресурса. Вызывающая сторона ответственна за избавление от дескриптора.

    Специальные замечания

    Реализация этой функции в компоненте Base Effect читает в и отсоединяет Общедоступный Ресурс Компонента типа 'atms' и ID 1.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetSettingsAsText ImageCodecGetSettingsAsText (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecGetSettingsAsText ( ComponentInstance ci, Handle *text );

    Параметры

    ci

    Компонентный экземпляр компрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    text

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetSimilarity ImageCodecGetSimilarity (OS X v10.9)

    Когда приложение вызывает GetSimilarity, уведомляет Ваш кодек.

    Объявление

    Objective C

    ComponentResult ImageCodecGetSimilarity ( ComponentInstance ci, PixMapHandle src, const Rect *srcRect, ImageDescriptionHandle desc, Ptr data, Fixed *similarity );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    src

    Дескриптор к несжатому изображению. Изображение сохранено в a PixMap структура.

    srcRect

    Указатель на a Rect структура, определяющая часть изображения для сравнения со сжатым изображением.

    desc

    Дескриптор к ImageDescription структура, определяющая сжатое изображение для работы.

    data

    Указатель на сжатые данные изображения.

    similarity

    Указатель на поле, которое должно получить значение подобия. Ваш компонент устанавливает это поле для отражения относительного подобия двух изображений. Допустимые значения колеблются от 0 (ключевой кадр) к 1 (идентичный).

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Только декомпрессоры получают этот запрос.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecGetSourceDataGammaLevel ImageCodecGetSourceDataGammaLevel (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecGetSourceDataGammaLevel ( ComponentInstance ci, Fixed *sourceDataGammaLevel );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    sourceDataGammaLevel

    По возврату, собственному гамма уровню сжатых данных. Если значение 0, это - гамма уровень по умолчанию платформы.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    ICM использует информацию, возвращенную этой функцией для определения, какая гамма-коррекция необходима. Например, Apple Кодек DV возвращается 2.2.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecHitTestDataWithFlags ImageCodecHitTestDataWithFlags (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecHitTestDataWithFlags ( ComponentInstance ci, ImageDescriptionHandle desc, void *data, Size dataSize, Point where, long *hit, long hitFlags );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    desc

    Дескриптор к ImageDescription структура для данных изображения, на которые указывают data параметр.

    data

    Указатель на сжатые данные в формате, указанном desc параметр.

    dataSize

    Size из сжатых данных, именуемых data параметр.

    where

    QuickDraw Point структура (0,0) базировалась в верхнем левом углу изображения.

    hit

    Указатель на булевскую переменную. Булевская переменная должна быть установлена в TRUE если точка, указанная where параметр содержится в сжатых данных изображения, указанных data параметр.

    hitFlags

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecNewImageGWorld ImageCodecNewImageGWorld (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecNewImageGWorld ( ComponentInstance ci, CodecDecompressParams *params, GWorldPtr *newGW, long flags );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    params

    Указатель на a CodecDecompressParams структура.

    newGW

    Указатель на указатель на a CGrafPort структура.

    flags

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecPreCompress ImageCodecPreCompress (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecPreCompress ( ComponentInstance ci, CodecCompressParams *params );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    params

    Указатель на a CodecCompressParams структура. Программа управления сжатием изображений помещает надлежащую информацию о параметре в ту структуру.

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

    Посмотрите Error Codes. Ваш компонент должен возвратить код результата codecConditionErr если это не может поле запрос сжатия. Возвратиться noErr если нет никакой ошибки.

    Обсуждение

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

    Специальные замечания

    Только компрессоры принимают этот вызов.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecPreDecompress ImageCodecPreDecompress (OS X v10.9)

    Уведомляет Ваш компонент прежде, чем распаковать изображение или последовательность кадров.

    Объявление

    Objective C

    ComponentResult ImageCodecPreDecompress ( ComponentInstance ci, CodecDecompressParams *params );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    params

    Указатель на a CodecDecompressParams структура. Программа управления сжатием изображений помещает надлежащую информацию о параметре в ту структуру.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Если Ваши компонентные поддержки декомпрессора, запланированные асинхронные операции распаковки, несомненно, установят codecCanAsyncWhen отметьте к 1 в flags поле Вашего компонента CodecCapabilities структура. Если Вы устанавливаете codecCanAsyncWhen, необходимо также установить codecCanAsync. Кодекам, поддерживающим запланированную асинхронную распаковку, строго советуют также установить codecCanShieldCursor флаг.

    Если Ваш компонент декомпрессора использует вторичный аппаратный буфер для своих изображений, несомненно, установят codecHasVolatileBuffer отметьте к 1 в flags поле Вашего компонента CodecCapabilities структура. Если Ваш компонент декомпрессора используется исключительно в качестве кодека передачи и использует ImageCodecNewImageBufferMemory функция для создания внеэкранного буфера, который является действительно экранным, кодек, должна будет установить codecImageBufferIsOnScreen отметьте к 1.

    Специальные замечания

    Только декомпрессоры получают этот запрос.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecPrepareToCompressFrames ImageCodecPrepareToCompressFrames (OS X v10.9)

    Подготавливает компрессор для приема кадров.

    Объявление

    Objective C

    ComponentResult ImageCodecPrepareToCompressFrames ( ComponentInstance ci, ICMCompressorSessionRef session, ICMCompressionSessionOptionsRef compressionSessionOptions, ImageDescriptionHandle imageDescription, void *reserved, CFDictionaryRef *compressorPixelBufferAttributesOut );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий соединение с компонентом кодека изображения.

    session

    Ссылка сеанса компрессора. Компрессор должен сохранить это в своих глобальных переменных; этому будет нужен он при призывании обратно ICM (например, для вызова ICMEncodedFrameCreateMutable и ICMCompressorSessionEmitEncodedFrame). Это не тип CF. Не вызывать CFRetain или CFRelease на нем.

    compressionSessionOptions

    Опции сеанса от клиента. Компрессор должен сохранить это и использовать настройки для руководства сжатия.

    imageDescription

    Описание изображения. Компрессор может добавить расширения описания изображения.

    reserved

    Зарезервированный для будущего использования. Проигнорируйте этот параметр.

    compressorPixelBufferAttributesOut

    Компрессор должен создать пиксельный буферный словарь атрибутов и набор compressorPixelBufferAttributesOut к нему. ICM выпустит его.

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

    Код ошибки, или noErr если нет никакой ошибки.

    Обсуждение

    Компрессор должен записать сеанс и сохранить compressionSessionOptions для использования в более поздних вызовах. Компрессор может изменить imageDescription в этой точке. Компрессор должен создать и возвратить пиксельные буферные атрибуты, которые выпустит ICM. (Примечание: это заменяет ImageCodecPreCompress.)

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecProcessBetweenPasses ImageCodecProcessBetweenPasses (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecProcessBetweenPasses ( ComponentInstance ci, ICMMultiPassStorageRef multiPassStorage, Boolean *interpassProcessingDoneOut, ICMCompressionPassModeFlags *requestedNextPassModeFlagsOut );

    Параметры

    ci

    Экземпляр компонента, идентифицирующий соединение с компонентом кодека изображения.

    multiPassStorage

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

    interpassProcessingDoneOut

    Точки к булевской переменной. Установите это в FALSE, если Вы хотите Ваш ImageCodecProcessBetweenPasses функция, которую вызовут снова для выполнения большего количества обработки, TRUE, если нет.

    requestedNextPassModeFlagsOut

    Набор *requestedNextPassModeFlagsOut указать тип передачи, которая должна быть выполнена затем: Для рекомендации повторной аналитической передачи установите его в kICMCompressionPassMode_ReadFromMultiPassStorage| kICMCompressionPassMode_WriteToMultiPassStorage. Для рекомендации заключительной передачи кодирования установите его в kICMCompressionPassMode_ReadFromMultiPassStorage | kICMCompressionPassMode_OutputEncodedFrames. Если буферы исходного кадра не необходимы для рекомендуемой передачи (например, потому что все требуемые данные были скопированы в многопроходное хранение), набор kICMCompressionPassMode_NoSourceFrames.

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

    Код ошибки, или noErr если нет никакой ошибки.

    Обсуждение

    Эта функция будет неоднократно вызываться, пока она не возвратит TRUE в *interpassProcessingDoneOut. Компрессор может читать и записать в multiPassStorage. Компрессор должен указать, какой тип передачи он предпочел бы выполнять затем путем установки *requestedNextPassTypeOut.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecRequestGammaLevel ImageCodecRequestGammaLevel (OS X v10.9)

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

    Объявление

    Objective C

    ComponentResult ImageCodecRequestGammaLevel ( ComponentInstance ci, Fixed srcGammaLevel, Fixed dstGammaLevel, long *codecCanMatch );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    srcGammaLevel

    Гамма уровень для преобразования из.

    dstGammaLevel

    Гамма уровень для преобразования в.

    codecCanMatch

    Указатель на значение, указывающее если преобразование из srcGammaLevel к dstGammaLevel поддерживается.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Эта функция говорит кодек, что - гамма исходного буфера и целевой пиксельной карты то, так, чтобы кодек мог попытаться преобразовать между двумя гаммами при распаковке. Надлежащее гамма преобразование выполняется путем нормализации исходных данных к черным точкам и белых точек к от 0 до 1 и повышения результата отношением srcGammaLevel разделенный на dstGammaLevel. Самое точное исправление сделано в пространстве RGB, но визуальное приближение может быть сделано путем повышения одного только luma компонента.

    Специальные замечания

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

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecScheduleFrame ImageCodecScheduleFrame (OS X v10.9)

    Недокументированный

    Объявление

    Objective C

    ComponentResult ImageCodecScheduleFrame ( ComponentInstance ci, const ImageSubCodecDecompressRecord *drp, ImageCodecTimeTriggerUPP triggerProc, void *triggerProcRefCon );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    drp

    Указатель на ImageSubCodecDecompressRecord структура.

    triggerProc

    ImageCodecTimeTriggerProc обратный вызов.

    triggerProcRefCon

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

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecSetTimeBase ImageCodecSetTimeBase (OS X v10.9)

    Устанавливает основу времени для компонента кодека изображения.

    Объявление

    Objective C

    ComponentResult ImageCodecSetTimeBase ( ComponentInstance ci, void *base );

    Параметры

    ci

    Компонентный экземпляр кодека изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    base

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

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecTrimImage ImageCodecTrimImage (OS X v10.9)

    Уведомляет Ваш компонент каждый раз, когда приложение вызывает TrimImage.

    Объявление

    Objective C

    ComponentResult ImageCodecTrimImage ( ComponentInstance ci, ImageDescriptionHandle Desc, Ptr inData, long inBufferSize, ICMDataProcRecordPtr dataProc, Ptr outData, long outBufferSize, ICMFlushProcRecordPtr flushProc, Rect *trimRect, ICMProgressProcRecordPtr progressProc );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    Desc

    Дескриптор к ImageDescription структура, описывающая сжатое изображение. Ваш компонент обновляет эту структуру для обращения к измененному изображению.

    inData

    Указатель на сжатые данные изображения. Если все сжатое изображение не может быть сохранено в этом расположении, приложение может обеспечить функцию загрузки данных; см. описание dataProc параметр к этой функции для подробных данных. Это - 32-разрядный чистый адрес.

    inBufferSize

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

    dataProc

    Указатель на ICMDataProcRecord структура. Если приложение не обеспечивало функцию загрузки данных, этот параметр NIL. В этом случае все изображение должно быть в памяти в расположении, указанном inData параметр. Когда приложение вызывает, если поток данных не все в памяти GetCompressedImageSize, Ваш компонент может вызвать прикладную функцию, загружающую более сжатые данные.

    outData

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

    outBufferSize

    Размер буфера, который будет использоваться разгружающей данные функцией, указанной flushProc параметр. Если приложение не указывало разгружающую данные функцию, этот параметр NIL.

    flushProc

    Указатель на ICMFlushProcRecord структура. Если приложение не обеспечивало разгружающую данные функцию, этот параметр NIL. В этом случае Ваш компонент пишет все сжатое изображение в ячейку памяти, указанную outData параметр. Если существует недостаточно памяти для хранения сжатого изображения, компонент может вызвать прикладную функцию, разгружающую некоторые сжатые данные.

    trimRect

    Указатель на a Rect структура, определяющая желаемые размеры изображения. Ваш компонент корректирует значения структуры так, чтобы они обратились к тому же прямоугольнику в получающемся изображении. Это необходимо каждый раз, когда данные удалены с начала изображения.

    progressProc

    Указатель на ICMProgressProcRecord структура. Во время работы Ваш компонент должен иногда вызывать прикладную функцию для создания отчетов о ее прогрессе. Если приложение не обеспечивало функцию прогресса, этот параметр NIL.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ImageCodecValidateParameters ImageCodecValidateParameters (OS X v10.9)

    Проверяет параметры эффекта.

    Объявление

    Objective C

    ComponentResult ImageCodecValidateParameters ( ComponentInstance ci, QTAtomContainer parameters, QTParameterValidationOptions validationFlags, StringPtr errorString );

    Параметры

    ci

    Компонентный экземпляр декомпрессора изображения. Ваше программное обеспечение получает эту ссылку из OpenComponent или OpenDefaultComponent.

    parameters

    Контейнер атома, содержащий effect параметры, которые будут проверены.

    validationFlags

    Константы (см. ниже), та проверка управления. Посмотрите эти константы:

    • kParameterValidationNoFlags

    • kParameterValidationFinalValidation

    errorString

    Недокументированный

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • NewImageCodecDrawBandCompleteUPP NewImageCodecDrawBandCompleteUPP (OS X v10.9)

    Выделяет Универсальный Указатель Процедуры для обратного вызова ImageCodecDrawBandCompleteProc.

    Объявление

    Objective C

    ImageCodecDrawBandCompleteUPP NewImageCodecDrawBandCompleteUPP ( ImageCodecDrawBandCompleteProcPtr userRoutine );

    Параметры

    userRoutine

    Указатель на Вашу определенную с помощью приложения функцию.

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

    Новый UPP; посмотрите Universal Procedure Pointers.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • NewImageCodecMPDrawBandUPP NewImageCodecMPDrawBandUPP (OS X v10.9)

    Выделяет Универсальный Указатель Процедуры для обратного вызова ImageCodecMPDrawBandProc.

    Объявление

    Objective C

    ImageCodecMPDrawBandUPP NewImageCodecMPDrawBandUPP ( ImageCodecMPDrawBandProcPtr userRoutine );

    Параметры

    userRoutine

    Указатель на Вашу определенную с помощью приложения функцию.

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

    Новый UPP; посмотрите Universal Procedure Pointers.

    Обсуждение

    Эта функция используется с системами PowerPC Macintosh. Посмотрите Внутренний Macintosh: Системное программное обеспечение PowerPC.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • NewImageCodecTimeTriggerUPP NewImageCodecTimeTriggerUPP (OS X v10.9)

    Выделяет Универсальный Указатель Процедуры для обратного вызова ImageCodecTimeTriggerProc.

    Объявление

    Objective C

    ImageCodecTimeTriggerUPP NewImageCodecTimeTriggerUPP ( ImageCodecTimeTriggerProcPtr userRoutine );

    Параметры

    userRoutine

    Указатель на Вашу определенную с помощью приложения функцию.

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

    Новый UPP; посмотрите Universal Procedure Pointers.

    Обсуждение

    Эта функция используется с системами PowerPC Macintosh. Посмотрите Внутренний Macintosh: Системное программное обеспечение PowerPC.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • QTPhotoDefineHuffmanTable QTPhotoDefineHuffmanTable (OS X v10.9)

    Определяет таблицу Huffman.

    Объявление

    Objective C

    ComponentResult QTPhotoDefineHuffmanTable ( ComponentInstance codec, short componentNumber, Boolean isDC, unsigned char *lengthCounts, unsigned char *values );

    Параметры

    codec

    Идентифицирует Ваше соединение с компонентом компрессора изображения.

    componentNumber

    Указывает компонент цвета. Если 0, накрывают на стол Huffman яркости. Если 1, накрывают на стол Huffman цветности.

    isDC

    ЕСЛИ ЭТО ПРАВДА, на стол DC Huffman накрывают. Если FALSE, накрывают на стол AC Huffman.

    lengthCounts

    Указатель на массив 16 количеств длины.

    values

    Указатель на массив значений Хафмана.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Эта функция позволяет Вам определить таблицу Huffman, которая будет использоваться в будущих операциях сжатия JPEG. Обычно компоненты компрессора изображения JPEG используют таблицы Huffman по умолчанию, как указано в разделах K.3 через K.6 спецификации JPEG. Можно использовать эту функцию для переопределения таблиц по умолчанию.

    Специальные замечания

    Этот вызов поддерживается только фотографией JPEG и Движение компрессоры JPEG. Только опытные программисты должны будут использовать эту функцию.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • QTPhotoDefineQuantizationTable QTPhotoDefineQuantizationTable (OS X v10.9)

    Указывает пользовательскую таблицу квантования.

    Объявление

    Objective C

    ComponentResult QTPhotoDefineQuantizationTable ( ComponentInstance codec, short componentNumber, unsigned char *table );

    Параметры

    codec

    Идентифицирует Ваше соединение с компонентом компрессора изображения.

    componentNumber

    Если 0, накрывают на стол квантования яркости. Если 1, накрывают на стол квантования цветности.

    table

    Указатель на массив 64 значений квантования.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    По умолчанию компрессоры JPEG выбирают таблицы квантования на основе качественных настроек. Эта функция позволяет Вам переопределить эти таблицы с таблицами Вашего собственного выбора.

    Специальные замечания

    Этот вызов только поддерживается фотографией JPEG и Движение компрессоры JPEG. Только опытные программисты должны будут использовать эту функцию.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • QTPhotoSetRestartInterval QTPhotoSetRestartInterval (OS X v10.9)

    Указывает интервал перезапуска для использования в будущих операциях сжатия JPEG.

    Объявление

    Objective C

    ComponentResult QTPhotoSetRestartInterval ( ComponentInstance codec, unsigned short restartInterval );

    Параметры

    codec

    Идентифицирует Ваше соединение с компонентом компрессора изображения.

    restartInterval

    Новый интервал перезапуска. Передайте 0, чтобы сказать компрессору не вставлять маркеры перезапуска в поток данных.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    По умолчанию компоненты компрессора JPEG не вставляют маркеры перезапуска в сжатый поток данных, если «не оптимизируют для потоковой передачи» установки, выбран.

    Специальные замечания

    Этот вызов поддерживается только фотографией JPEG и Движение компрессоры JPEG. Только опытные программисты должны будут использовать эту функцию.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • QTPhotoSetSampling QTPhotoSetSampling (OS X v10.9)

    Указывает отношение субдискретизации цветности для использования в будущих операциях сжатия JPEG.

    Объявление

    Objective C

    ComponentResult QTPhotoSetSampling ( ComponentInstance codec, short yH, short yV, short cbH, short cbV, short crH, short crV );

    Параметры

    codec

    Идентифицирует Ваше соединение с компонентом компрессора изображения.

    yH

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

    yV

    Число вертикальной яркости блокирует, чтобы вставить каждый макроблок.

    cbH

    Число горизонтальной цветности синие блоки, чтобы вставить каждый макроблок.

    cbV

    Число вертикальной цветности синие блоки, чтобы вставить каждый макроблок.

    crH

    Число горизонтальной цветности красные блоки, чтобы вставить каждый макроблок.

    crV

    Число вертикальной цветности красные блоки, чтобы вставить каждый макроблок.

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

    Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    По умолчанию фотография компрессор JPEG использует 4:1:1 субдискретизация цветности и Движение использование компрессоров JPEG 4:2:2 субдискретизация цветности для большинства качественных настроек. Для codecLosslessQuality, оба компрессора отключают субдискретизацию цветности. В настоящее время единственные поддерживаемые отношения субдискретизации не ни один (передайте 1,1,1,1,1,1), 4:2:2 (передают 2,1,1,1,1,1), и 4:1:1 (передают 2,2,1,1,1,1).

    Специальные замечания

    Этот вызов поддерживается только фотографией JPEG и Движение компрессоры JPEG. Только опытные программисты должны будут использовать эту функцию.

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

    Objective C

    @import QuickTime;

    Доступность

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

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

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

Разные обратные вызовы кодека изображения
  • ComponentMPWorkFunctionProc ComponentMPWorkFunctionProc

    Недокументированный

    Объявление

    Objective C

    typedef ComponentResult (*ComponentMPWorkFunctionProcPtr) (void *globalRefCon, ComponentMPWorkFunctionHeaderRecordPtr header);

    Параметры

    globalRefCon

    Недокументированный

    header

    Указатель на a ComponentMPWorkFunctionHeaderRecord структура.

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

    Посмотрите Error Codes. Ваш обратный вызов должен возвратиться noErr если нет никакой ошибки.

  • ImageCodecMPDrawBandProc ImageCodecMPDrawBandProc

    Недокументированный

    Объявление

    Objective C

    typedef ComponentResult (*ImageCodecMPDrawBandProcPtr) (void *refcon, ImageSubCodecDecompressRecord *drp);

    Параметры

    refcon

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

    drp

    Указатель на ImageSubCodecDecompressRecord структура.

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

    Посмотрите Error Codes. Ваш обратный вызов должен возвратиться noErr если нет никакой ошибки.

  • ImageCodecTimeTriggerProc ImageCodecTimeTriggerProc

    Недокументированный

    Объявление

    Objective C

    typedef void (*ImageCodecTimeTriggerProcPtr) (void *refcon);

    Параметры

    refcon

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

Типы данных

  • CDSequenceDataSource

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

    Объявление

    Objective C

    struct CDSequenceDataSource { long recordSize; void * next; ImageSequence seqID; ImageSequenceDataSource sourceID; OSType sourceType; long sourceInputNumber; void * dataPtr; Handle dataDescription; long changeSeed; ICMConvertDataFormatUPP transferProc; void * transferRefcon; long dataSize; QHdrPtr dataQueue; void * originalDataPtr; long originalDataSize; Handle originalDataDescription; long originalDataDescriptionSeed; };

    Поля

    recordSize

    Размер этой структуры.

    next

    Указатель на следующую исходную запись. Если это NIL, больше нет записей.

    seqID

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

    sourceID

    Исходная ссылка, идентифицирующая этот источник.

    sourceType

    Четыре кода символа, описывающие, как будет использоваться ввод. Это значение передается этому параметру CDSequenceNewDataSource когда создается источник.

    sourceInputNumber

    Значение передается этому параметру CDSequenceNewDataSource когда создается источник.

    dataPtr

    Указатель на фактические исходные данные.

    dataDescription

    Дескриптор к структуре данных, описывающей формат данных. Это часто - дескриптор к ImageDescription структура.

    changeSeed

    Целое число, постепенно увеличивающееся каждый раз dataPtr поле изменяется или те данные что dataPtr поле указывает на изменения. Путем запоминания value из этого поля и по сравнению со значением в следующий раз, когда компонент декомпрессора или компрессора вызывают, компонент может определить, присутствуют ли новые данные.

    transferProc

    Зарезервированный.

    transferRefcon

    Зарезервированный.

    dataSize

    Размер данных, на которые указывают dataPtr поле.

    dataQueue

    Указатель на a QHdr структура, содержащая очередь CDSequenceDataSourceQueueEntry структуры.

    originalDataPtr

    Исходное значение dataPtr.

    originalDataSize

    Исходное значение dataSize.

    originalDataDescription

    Исходное значение dataDescription.

    originalDataDescriptionSeed

    Исходное значение changeSeed.

    Обсуждение

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

    См. также ImageCodecGetMaxCompressionSizeWithSources и ImageCodecSourceChanged.

  • CDSequenceDataSourcePtr CDSequenceDataSourcePtr

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Objective C

    typedef CDSequenceDataSource * CDSequenceDataSourcePtr;

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

    Objective C

    @import QuickTime;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • CodecCompressParams

    Содержит параметры, управляющие работой сжатия.

    Объявление

    Objective C

    struct CodecCompressParams { ImageSequence sequenceID; ImageDescriptionHandle imageDescription; Ptr data; long bufferSize; long frameNumber; long startLine; long stopLine; long conditionFlags; CodecFlags callerFlags; CodecCapabilities * capabilities; ICMProgressProcRecord progressProcRecord; ICMCompletionProcRecord completionProcRecord; ICMFlushProcRecord flushProcRecord; PixMap srcPixMap; PixMap prevPixMap; CodecQ spatialQuality; CodecQ temporalQuality; Fixed similarity; DataRateParamsPtr dataRateParams; long reserved; UInt16 majorSourceChangeSeed; UInt16 minorSourceChangeSeed; CDSequenceDataSourcePtr sourceData; long preferredPacketSizeInBytes; long requestedBufferWidth; long requestedBufferHeight; OSType wantedSourcePixelType; long compressedDataSize; UInt32 taskWeight; OSType taskName; };

    Поля

    sequenceID

    Содержит уникальный идентификатор последовательности. Если изображение, которое будет сжато, является частью последовательности, это поле содержит идентификатор последовательности, присвоенный CompressSequenceBegin. Если изображение не является частью последовательности, это поле установлено в 0.

    imageDescription

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

    data

    Точки к расположению для получения сжатых данных изображения. Это - 32-разрядный чистый адрес. Если нет достаточной памяти для хранения сжатого изображения, приложение может принять решение записать сжатые данные в массовое хранение во время работы сжатия. flushProcRecord поле идентифицирует разгружающую данные функцию, которую приложение обеспечивает с этой целью. Это поле используется только ImageCodecBandCompress.

    bufferSize

    Содержит размер буфера, указанного data поле. Ваш компонент устанавливает значение bufferSize поле к числу байтов сжатых данных, записанных в буфер. Ваш компонент не должен возвращать больше данных, чем буфер может содержать; это должно возвратить ненулевой код результата вместо этого. Это поле используется только ImageCodecBandCompress.

    frameNumber

    Содержит идентификатор кадра. Указывает относительное число кадра в последовательности. Программа управления сжатием изображений постепенно увеличивает это значение для каждого кадра в последовательности. Это поле используется только ImageCodecBandCompress.

    startLine

    Содержит стартовую строку для полосы. Это поле указывает стартовый номер строки для полосы, которая будет сжата. Номер строки относится к пиксельной строке в изображении, запускающемся с вершины изображения. Первая строка является номером строки 0. Это поле используется только ImageCodecBandCompress.

    stopLine

    Содержит конечную строку для полосы. Это поле указывает конечный номер строки для полосы, которая будет сжата. Номер строки относится к пиксельной строке в изображении, запускающемся с вершины изображения. Первая строка в изображении является номером строки 0. Полоса изображения включает строку, указанную этим полем. Так, для определения полосы, содержащей одну строку пикселей наверху изображения Вы устанавливаете startLine поле к 0 и stopLine поле к 1.

    conditionFlags

    Содержит флаги (см. ниже), которые идентифицируют условие, при котором вызвали Ваш компонент. Это поле используется только ImageCodecBandCompress. Кроме того, эти поля содержат информацию о мерах, принятых Вашим компонентом. Посмотрите эти константы:

    • codecConditionFirstBand

    • codecConditionLastBand

    • codecConditionCodecChangedMask

    callerFlags

    Флаги, обеспечивающие дальнейшую управляющую информацию. Это поле используется только ImageCodecBandCompress. Посмотрите эти константы:

    • codecFlagUpdatePrevious

    • codecFlagWasCompressed

    • codecFlagUpdatePreviousComp

    • codecFlagLiveGrab

    capabilities

    Точки к структуре возможности компрессора. Программа управления сжатием изображений использует это поле для определения возможностей компонента компрессора. Это поле используется только ImageCodecPreCompress.

    progressProcRecord

    Содержит ICMProgressProcRecord структура. Во время работы сжатия Ваш компрессор может иногда вызывать функцию, которую приложение обеспечивает для создания отчетов о прогрессе. Это поле содержит структуру, идентифицирующую функцию прогресса. Если progressProc поле в этой структуре установлено в NIL, приложение не предоставило функцию прогресса. Это поле используется только ImageCodecBandCompress.

    completionProcRecord

    Содержит ICMCompletionProcRecord структура. Эта структура управляет, выполняете ли Вы сжатие асинхронно. Если completionProc поле в этой структуре установлено в NIL, выполните сжатие синхронно. Если это поле не NIL, это указывает функцию завершения приложения. Выполните сжатие асинхронно и вызовите ту функцию завершения, когда будет закончен Ваш компонент. Если completionProc поле в этой структуре имеет значение-1, выполните работу асинхронно, но не вызывайте функцию завершения приложения. Это поле используется только ImageCodecBandCompress.

    flushProcRecord

    Содержит ICMFlushProcRecord структура. Если существует недостаточно памяти для хранения сжатого изображения, приложение может обеспечить функцию, разгружающую некоторые сжатые данные. Это поле содержит структуру, идентифицирующую ту разгружающую данные функцию. Если приложение не обеспечивало разгружающую данные функцию, flushProc поле в этой структуре установлено в NIL. В этом случае Ваш компонент пишет все сжатое изображение в ячейку памяти, указанную data поле. Разгружающая данные функциональная структура используется только ImageCodecBandCompress.

    srcPixMap

    Точки к изображению, которое будет сжато. Изображение должно быть сохранено в структуре пиксельной карты. Содержание этой пиксельной карты отличается от стандартной пиксельной карты двумя способами. Во-первых, rowBytes поле является полным 16-разрядным значением; старший бит не обязательно установлен в 1. Во-вторых, baseAddr поле должно содержать 32-разрядный чистый адрес. Это поле используется только ImageCodecBandCompress.

    prevPixMap

    Точки к пиксельной карте, содержащей предыдущее изображение. Если изображение, которое будет сжато, является частью последовательности, временно сжимающейся, это поле определяет предыдущее изображение для временного сжатия. Ваш компонент должен тогда использовать это предыдущее изображение в качестве основания сравнения для изображения, которое будет сжато. Если temporalQuality поле установлено в 0, не выполняйте временное сжатие. Если codecFlagUpdatePrevious флаг или codecFlagUpdatePreviousComp флаг в flags поле установлено в 1, обновите предыдущее изображение в конце работы сжатия. Содержание этой пиксельной карты отличается от стандартной пиксельной карты двумя способами. Во-первых, rowBytes поле является полным 16-разрядным значением; старший бит не обязательно установлен в 1. Во-вторых, baseAddr поле должно содержать 32-разрядный чистый адрес. Это поле используется только ImageCodecBandCompress.

    spatialQuality

    Указывает желаемое сжатое качество изображения. Это поле используется только ImageCodecBandCompress.

    temporalQuality

    Указывает желаемую последовательность временное качество. Это поле управляет уровнем сжатия желания приложения относительно информации в последовательных кадрах в последовательности. Если это поле установлено в 0, не выполняйте временное сжатие на этом кадре. Это поле используется только ImageCodecBandCompress.

    similarity

    Указывает относительное подобие между кадром, просто сжатым и предыдущим кадром при выполнении временного сжатия. Значение фиксированной точки, диапазоны от 0 (0x00000000), указывая ключевой кадр, к 255 (0x00FF0000), указывая идентичный кадр, который может быть отброшен без ущерба. Если плохое видео следовало бы из отбрасывания кадра, компрессор должен ограничить подобие 254 (0x00FE0000). Если его подобие его предшественнику является очень низким (значение 1 или 2, например), Программа управления сжатием изображений может запросить компрессор повторно сжать кадр как ключевой кадр. Программа управления сжатием изображений не сделает этого, если флаг codecFlagLiveGrab будет установлен, или если предоставляется асинхронное завершение proc. Это поле используется только ImageCodecBandCompress.

    dataRateParams

    Точки к параметрам, используемым при выполнении ограничения скорости передачи данных.

    reserved

    Зарезервированный.

    majorSourceChangeSeed

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

    minorSourceChangeSeed

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

    sourceData

    Содержит указатель на a CDSequenceDataSource структура. Эта структура содержит связанный список всех источников данных. Поскольку каждый источник данных содержит ссылку на следующий источник данных, кодек может получить доступ ко всем источникам данных от этого поля.

    preferredPacketSizeInBytes

    Указывает предпочтительный размер пакета для данных.

    requestedBufferWidth

    Указывает ширину буфера изображения для использования, в пикселях. Для этого значения, которое будет использоваться, codecWantsSpecialScaling флаг в CodecCapabilities структура должна быть установлена.

    requestedBufferHeight

    Указывает высоту буфера изображения для использования, в пикселях. Для этого значения, которое будет использоваться, codecWantsSpecialScaling флаг в CodecCapabilities структура должна быть установлена.

    wantedSourcePixelType

    Недокументированный

    compressedDataSize

    Размер сжатого изображения, в байтах. Если это поле является ненулевым, оно переопределяет dataSize поле ImageDescription структура. Это обеспечивает более безопасный путь к асинхронным компрессорам для возврата размера сжатых данных кадра, потому что dataSize поле ImageDescription может быть сослан разблокированным дескриптором.

    taskWeight

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

    taskName

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

    Обсуждение

    Компоненты компрессора принимают параметры, управляющие работой сжатия в форме CodecCompressParams структура. Эта структура используется ImageCodecBandCompress и ImageCodecPreCompress.

    См. также ImageCodecBandCompress и ImageCodecPreCompress.

  • CodecDecompressParams

    Блок основного параметра, передающийся декомпрессору.

    Объявление

    Objective C

    struct CodecDecompressParams { ImageSequence sequenceID; ImageDescriptionHandle imageDescription; Ptr data; long bufferSize; long frameNumber; long startLine; long stopLine; long conditionFlags; CodecFlags callerFlags; CodecCapabilities * capabilities; ICMProgressProcRecord progressProcRecord; ICMCompletionProcRecord completionProcRecord; ICMDataProcRecord dataProcRecord; CGrafPtr port; PixMap dstPixMap; BitMapPtr maskBits; PixMapPtr mattePixMap; Rect srcRect; MatrixRecord * matrix; CodecQ accuracy; short transferMode; ICMFrameTimePtr frameTime; long reserved[1]; SInt8 matrixFlags; SInt8 matrixType; Rect dstRect; UInt16 majorSourceChangeSeed; UInt16 minorSourceChangeSeed; CDSequenceDataSourcePtr sourceData; RgnHandle maskRegion; OSType ** wantedDestinationPixelTypes; long screenFloodMethod; long screenFloodValue; short preferredOffscreenPixelSize; ICMFrameTimeInfoPtr syncFrameTime; Boolean needUpdateOnTimeChange; Boolean enableBlackLining; Boolean needUpdateOnSourceChange; Boolean pad; long unused; CGrafPtr finalDestinationPort; long requestedBufferWidth; long requestedBufferHeight; Rect displayableAreaOfRequestedBuffer; Boolean requestedSingleField; Boolean needUpdateOnNextIdle; Boolean pad2[2]; fixed bufferGammaLevel; UInt32 taskWeight; OSType taskName; };

    Поля

    sequenceID

    Содержит уникальный идентификатор последовательности. Если изображение, которое будет распаковано, является частью последовательности, это поле содержит идентификатор последовательности, присвоенный DecompressSequenceBegin. Если изображение не является частью последовательности, это поле установлено в 0.

    imageDescription

    Содержит дескриптор к ImageDescription это описывает изображение, которое будет распаковано.

    data

    Точки к сжатым данным изображения. Это должно быть 32-разрядным чистым адресом. bufferSize поле указывает размер этого буфера данных. Если все сжатое изображение не умещается в памяти, приложение должно обеспечить функцию загрузки данных, идентифицированную dataProc поле структуры функции загрузки данных, сохраненной в dataProcRecord поле. Это поле используется только ImageCodecBandDecompress.

    bufferSize

    Указывает размер буфера данных изображения. Это поле используется только ImageCodecBandDecompress.

    frameNumber

    Содержит идентификатор кадра. Указывает относительное число кадра в последовательности. Программа управления сжатием изображений постепенно увеличивает это значение для каждого кадра в последовательности. Это поле используется только ImageCodecBandDecompress.

    startLine

    Указывает стартовую строку для полосы. Номер строки относится к пиксельной строке в изображении, запускающемся с вершины изображения. Первая строка в изображении является номером строки 0. Это поле используется только ImageCodecBandDecompress.

    stopLine

    Указывает конечную строку для полосы. Номер строки относится к пиксельной строке в изображении, запускающемся с вершины изображения. Первая строка является номером строки 0. Полоса изображения включает строку, указанную этим полем. Так, для определения полосы, содержащей одну строку пикселей наверху изображения Вы устанавливаете startLine поле к 0 и stopLine поле к 1. Это поле используется только ImageCodecBandDecompress.

    conditionFlags

    Содержит флаги (см. ниже), которые идентифицируют условие, при котором Ваш компонент вызвали (для сохранения компонента некоторая работа). Флаги в этом поле передаются компоненту ImageCodecBandCompress и ImageCodecPreDecompress когда условия изменяются, для сохранения его некоторая работа. Кроме того, эти поля содержат информацию о мерах, принятых Вашим компонентом. Посмотрите эти константы:

    • codecConditionFirstBand

    • codecConditionLastBand

    • codecConditionFirstFrame

    • codecConditionNewDepth

    • codecConditionNewTransform

    • codecConditionNewSrcRect

    • codecConditionNewMatte

    • codecConditionNewTransferMode

    • codecConditionNewClut

    • codecConditionNewAccuracy

    • codecConditionNewDestination

    • codecConditionCodecChangedMask

    • codecConditionFirstScreen

    • codecConditionDoCursor

    • codecConditionCatchUpDiff

    • codecConditionMaskMayBeChanged

    • codecConditionToBuffer

    callerFlags

    Содержит флаги (см. ниже), которые обеспечивают дальнейшую управляющую информацию. Это поле используется только ImageCodecBandCompress. Посмотрите эти константы:

    • codecFlagUpdatePrevious

    • codecFlagWasCompressed

    • codecFlagUpdatePreviousComp

    • codecFlagLiveGrab

    capabilities

    Точки к a CodecCapabilities структура. Программа управления сжатием изображений использует этот параметр для определения возможностей компонента декомпрессора. Это поле используется только ImageCodecPreDecompress.

    progressProcRecord

    Содержит a ICMProgressProcRecord структура. Во время работы распаковки Ваш декомпрессор может иногда вызывать функцию, которую приложение обеспечивает для создания отчетов о прогрессе. Это поле содержит структуру, идентифицирующую функцию прогресса. Если progressProc поле этой структуры установлено в NIL, приложение не обеспечивало функцию прогресса. Это поле используется только ImageCodecBandDecompress.

    completionProcRecord

    Содержит ICMCompletionProcRecord структура. Это поле управляет, выполняете ли Вы распаковку асинхронно. Если completionProc поле в этой структуре установлено в NIL, выполните распаковку синхронно. Если это поле не NIL, это указывает функцию завершения приложения. Выполните распаковку асинхронно и вызовите ту функцию завершения, когда будет закончен Ваш компонент. Если это поле имеет значение-1, выполните работу асинхронно, но не вызывайте функцию завершения приложения. Это поле используется только ImageCodecBandDecompress.

    dataProcRecord

    Содержит ICMDataProcRecord структура. Если поток данных не все в памяти, Ваш компонент может вызвать прикладную функцию, загружающую более сжатые данные. Это поле содержит структуру, идентифицирующую ту функцию загрузки данных. Если приложение не обеспечивало функцию загрузки данных, dataProc поле в этой структуре установлено в NIL. В этом случае все изображение должно быть в памяти в расположении, указанном data поле. Это поле используется только ImageCodecBandDecompress.

    port

    Точки к порту цветных изображений, получающему распакованное изображение.

    dstPixMap

    Точки к пиксельной карте, где распакованное изображение должно быть выведено на экран. GDevice глобальная переменная установлена в целевое графическое устройство. Содержание этой пиксельной карты отличается от стандартной пиксельной карты двумя способами. Во-первых, rowBytes поле является полным 16-разрядным значением; старший бит не обязательно установлен в 1. Во-вторых, baseAddr поле должно содержать 32-разрядный чистый адрес.

    maskBits

    Содержит маску обновления. Если Ваш компонент может замаскировать данные результата, используйте эту маску для указания который пиксели в целевой пиксельной карте обновить. Ваш компонент указывает, может ли он замаскировать с codecCanMask флаг в flags поле CodecCapabilities структура, именуемая capabilities поле. Это поле обновляется в ответ на ImageCodecPreDecompress запрос. Если маска не изменилась начиная с последнего ImageCodecBandDecompress запрос, codecConditionCodecChangedMask флаг в conditionFlags поле установлено в 0. Это поле используется только ImageCodecBandDecompress.

    mattePixMap

    Точки к пиксельной карте, содержащей матовое стекло смешения. Матовое стекло может быть определено в любой поддерживаемой пиксельной глубине; матовая глубина не должна соответствовать источнику или целевым глубинам. Матовое стекло должно быть в системе координат исходного изображения. Если приложение не хочет применять матовое стекло смешения, это поле установлено в NIL. Содержание этой пиксельной карты отличается от стандартной пиксельной карты двумя способами. Во-первых, rowBytes поле является полным 16-разрядным значением; старший бит не обязательно установлен в 1. Во-вторых, baseAddr поле должно содержать 32-разрядный чистый адрес. Это поле используется только ImageCodecBandDecompress.

    srcRect

    Точки к прямоугольнику, определяющему часть изображения для распаковки. Этот прямоугольник должен лечь в граничном прямоугольнике сжатого изображения, определяющегося width и поля высоты структуры описания изображения, именуемой imageDescription поле.

    matrix

    Точки к матричной структуре, указывающей, как преобразовать изображение во время распаковки.

    accuracy

    Постоянный (см. ниже), который указывает точность, желаемую в распакованном изображении. Значения для этого параметра находятся в том же масштабе как качество сжатия; посмотрите CompressImage. Посмотрите эти константы:

    • codecMinQuality

    • codecLowQuality

    • codecNormalQuality

    • codecHighQuality

    • codecMaxQuality

    • codecLosslessQuality

    transferMode

    Указывает режим передачи QuickDraw для работы; посмотрите Graphics Transfer Modes.

    frameTime

    Содержит указатель на ICMFrameTimeRecord структура. Эта структура содержит информацию времени кадра для запланированных асинхронных операций распаковки.

    matrixFlags

    Флаг (см. ниже), указание матрицы преобразования. Набор к 0 ни для какой трансформации. Посмотрите эти константы:

    • matrixFlagScale2x

    • matrixFlagScale1x

    • matrixFlagScaleHalf

    matrixType

    Содержит тип матрицы преобразования, как возвращено GetMatrixType.

    dstRect

    Целевой прямоугольник. Это - результат преобразования исходного прямоугольника ( srcRect параметр) матрицей преобразования ( matrix параметр).

    majorSourceChangeSeed

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

    minorSourceChangeSeed

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

    sourceData

    Содержит указатель на a CDSequenceDataSource структура. Эта структура содержит связанный список всех источников данных. Поскольку каждый источник данных содержит ссылку на следующий источник данных, кодек может получить доступ ко всем источникам данных от этого поля.

    maskRegion

    Если maskRegion поле не NIL, это содержит область QuickDraw, которая эквивалентна битовому массиву, содержавшемуся в maskBits поле. Для некоторых кодеков, с помощью области QuickDraw может быть более удобным, чем битовый массив маски.

    wantedDestinationPixelTypes

    Заполненный кодеком во время выполнения ImageCodecPreDecompress. Содержит дескриптор к завершенному нулем списку пикселей не-RGB, к которым может распаковать кодек. Набор отпуска к NIL если кодек не поддерживает пиксельные пробелы не-RGB. ICM копирует эту структуру данных, таким образом, это до кодека для избавления от него позже. Так как вызов перед распаковкой можно часто вызывать, предложено, чтобы кодеки выделили этот дескриптор во время Открытой функции и избавились от него во время Близкой функции.

    screenFloodMethod

    Константа (см. ниже) для кодеков, требующих лавинной рассылки ключевого цвета. Посмотрите эти константы:

    • kScreenFloodMethodNone

    • kScreenFloodMethodKeyColor

    • kScreenFloodMethodAlpha

    screenFloodValue

    Если screenFloodMethod kScreenFloodMethodKeyColor, содержит индекс цвета, который должен использоваться для лавинной рассылки области изображения на экране, когда происходит обновление. Это допустимо и для индексированных и для прямых экранных устройств (например, для устройств с 16 битовыми глубинами, она должна содержать 5-5-5 значений RGB). Если screenFloodMethod kScreenFloodMethodAlpha, содержит значение, которым должен быть лавинно разослан альфа-канал.

    preferredOffscreenPixelSize

    Должно быть заполнено в ImageCodecPreDecompress с предпочтительной глубиной внеэкранного буфера должен, ICM должны создать тот. Не гарантируется, что внеэкранный буфер будет фактически иметь эту глубину. Кодек все еще, несомненно, должен будет указать, к каким глубинам он может распаковать при помощи capabilities поле. Кодек мог бы использовать это поле, если бы, если было способно к распаковке к нескольким глубинам, но быстрее распаковывал к определенной глубине.

    syncFrameTime

    Указатель на ICMFrameTimeInfo структура. Эта структура содержит информацию синхронизации о дисплее кадра.

    needUpdateOnTimeChange

    Недокументированный

    enableBlackLining

    ЕСЛИ ЭТО ПРАВДА, указывает, что клиент запросил blacklining (выводящий на экран любую строку изображения). Blacklining увеличивает скорость воспроизведения фильма при уменьшении качества изображения.

    needUpdateOnSourceChange

    Недокументированный

    pad

    Неиспользованный.

    unused

    Неиспользованный.

    finalDestinationPort

    Недокументированный

    requestedBufferWidth

    Указывает ширину буфера изображения для использования, в пикселях. Для этого значения, которое будет использоваться, codecWantsSpecialScaling флаг в CodecCapabilities должен быть установлен.

    requestedBufferHeight

    Указывает высоту буфера изображения для использования, в пикселях. Для этого значения, которое будет использоваться, codecWantsSpecialScaling флаг в CodecCapabilities должен быть установлен.

    displayableAreaOfRequestedBuffer

    Это поле может использоваться, чтобы препятствовать тому, чтобы части требуемого буфера были выведены на экран. Когда codecWantsSpecialScaling флаг установлен, этот прямоугольник может быть заполнен в указать, какая часть ширины и высоты требуемого буфера должна использоваться. Буферный прямоугольник, создаваемый требуемым буфером, всегда базируется в (0,0), таким образом, эта система координат также используется displayableAreaOfRequestedBuffer. Если это поле не заполнено в, значение по умолчанию (0,0,0,0) используется, и весь буфер выведен на экран. Используйте это поле при испытании граничных проблем с изображениями FlashPix.

    requestedSingleField

    Недокументированный

    needUpdateOnNextIdle

    Недокументированный

    pad2

    Неиспользованный.

    bufferGammaLevel

    Гамма уровень буфера данных.

    taskWeight

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

    taskName

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

    Обсуждение

    Программа управления сжатием изображений создает структуру параметров распаковки, и Ваш компонент декомпрессора изображения требуется только обеспечить значения для wantedDestinationPixelSize и wantedDestinationPixelTypes поля структуры. Ваш компонент декомпрессора изображения может также изменить другие поля при необходимости. Например, если это может масштабировать изображения, это должно установить codecCapabilityCanScale флаг в capabilities поле структуры.

    См. также ImageCodecBandDecompress, ImageCodecBeginBand, ImageCodecEffectBegin, ImageCodecEffectSetup, ImageCodecNewImageBufferMemory, ImageCodecNewImageGWorld, ImageCodecPreDecompress, и ImageCodecPreflight.

  • ComponentMPWorkFunctionUPP ComponentMPWorkFunctionUPP

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Swift

    typealias ComponentMPWorkFunctionUPP = ComponentMPWorkFunctionProcPtr

    Objective C

    typedef STACK_UPP_TYPE(ComponentMPWorkFunctionProcPtr) ComponentMPWorkFunctionUPP;

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • EffectsFrameParams

    Содержит информацию о текущем кадре эффекта видео.

    Объявление

    Objective C

    struct EffectsFrameParams { ICMFrameTimeRecord frameTime; long effectDuration; Boolean doAsync; unsigned char pad[3]; EffectSourcePtr source; void * refCon; };

    Поля

    frameTime

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

    effectDuration

    Продолжительность единственного кадра эффекта.

    doAsync

    Если эффект может обработать асинхронно, это поле содержит TRUE.

    pad

    Неиспользованный.

    source

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

    refCon

    Указатель на хранение для этого инстанцирования эффекта.

    Обсуждение

    См. также ImageCodecEffectBegin, ImageCodecEffectCancel, и ImageCodecEffectRenderFrame.

  • EffectsFrameParamsPtr EffectsFrameParamsPtr

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Objective C

    typedef EffectsFrameParams * EffectsFrameParamsPtr;

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

    Objective C

    @import QuickTime;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • EffectSource

    Предоставляет данные для структуры EffectsFrameParams.

    Объявление

    Objective C

    struct EffectSource { long effectType; Ptr data; SourceData source; EffectSourcePtr next;

    Поля

    effectType

    Тип эффекта или эффекта по умолчанию вводит постоянный (см. ниже). Войти kEffectRawSource если источник является необработанными данными программы управления сжатием изображений. Посмотрите эти константы:

    • kEffectRawSource

    • kEffectGenericType

    data

    Указатель на данные дорожки для эффекта.

    source

    Сам источник.

    next

    Указатель на следующий источник во входной цепочке.

    lastTranslatedFrameTime

    Время кадра запуска последнего преобразованного кадра; это значение может быть-1.

    lastFrameDuration

    Продолжительность последнего преобразованного кадра; это значение может быть 0.

    lastFrameTimeScale

    Масштаб времени этого исходного кадра; это поле имеет значение только если lastTranslatedFrameTime и lastFrameDuration поля допустимы.

    Обсуждение

    См. также ImageCodecEffectConvertEffectSourceToFormat.

  • EffectSourcePtr EffectSourcePtr

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Objective C

    typedef EffectSource * EffectSourcePtr;

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

    Objective C

    @import QuickTime;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • gxPaths

    Инкапсулирует геометрию разнообразного пути.

    Объявление

    Objective C

    struct gxPaths { long contours; gxPath contour[1]; };

    Поля

    contours

    Число контуров пути.

    contour

    Контуры пути; посмотрите gxPath.

    Обсуждение

    Поле контуров указывает общее количество контуров (другими словами, общее количество отдельных трактов), и contour поле является массивом, содержащим конфигурации пути. С тех пор a gxPaths структура имеет переменную длину, и каждый элемент в нем имеет тип long, можно определить геометрию пути как массив значений длинного целого.

    См. также CurveCountPointsInPath, CurveGetLength, CurveGetNearestPathPoint, CurveGetPathPoint, CurveLengthToPoint, CurvePathPointToLength, и CurveSetPathPoint.

  • gxPoint

    Определяет точку в векторной графике.

    Объявление

    Objective C

    struct gxPoint { Fixed x; Fixed y; };

    Поля

    x

    Горизонтальное расстояние. Большие значения x поле указывает расстояния далее вправо.

    y

    Вертикальное расстояние. Большие значения y поле указывает расстояния далее вниз.

    Обсуждение

    Расположение источника зависит от контекста, где Вы используете точку; например, это мог бы быть верхний левый угол порта представления. Заметьте что x и y поля имеют тип Fixed. QuickDraw GX позволяет Вам указывать дробные положения координат.

    См. также CurveGetPathPoint, CurveInsertPointIntoPath, и CurveSetPathPoint.

  • ImageCodecMPDrawBandUPP ImageCodecMPDrawBandUPP

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Objective C

    typedef STACK_UPP_TYPE(ImageCodecMPDrawBandProcPtr) ImageCodecMPDrawBandUPP;

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

    Objective C

    @import QuickTime;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • ImageCodecTimeTriggerUPP ImageCodecTimeTriggerUPP

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Objective C

    typedef STACK_UPP_TYPE(ImageCodecTimeTriggerProcPtr) ImageCodecTimeTriggerUPP;

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

    Objective C

    @import QuickTime;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • ImageSubCodecDecompressCapabilities

    Возвращенный компонентом декомпрессора изображения в ответ на ImageCodecInitialize.

    Объявление

    Objective C

    struct ImageSubCodecDecompressCapabilities { long recordSize; long decompressRecordSize; Boolean canAsync; UInt8 pad0;

    Поля

    recordSize

    Размер этой структуры в байтах.

    decompressRecordSize

    Размер ImageSubCodecDecompressRecord структура, которой требует Ваш компонент декомпрессора изображения. Эта структура используется для передачи информации от ImageCodecBeginBand к ImageCodecDrawBand и ImageCodecEndBand.

    canAsync

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

    pad0

    Неиспользованный.

    Обсуждение

    Первый вызов функции, который Ваш компонент декомпрессора изображения получает от декомпрессора базового изображения, всегда является вызовом к ImageCodecInitialize. В ответ на этот вызов Ваш компонент декомпрессора изображения возвращается ImageSubCodecDecompressCapabilities структура, указывающая ее возможности.

    См. также ImageCodecInitialize.

  • ImageSubCodecDecompressRecord

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

    Объявление

    Objective C

    struct ImageSubCodecDecompressRecord { Ptr baseAddr; long rowBytes; Ptr codecData; ICMProgressProcRecord progressProcRecord; ICMDataProcRecord dataProcRecord; void * userDecompressRecord; UInt8 frameType; UInt8 pad[3]; long priv[2]; };

    Поля

    baseAddr

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

    rowBytes

    Смещение в байтах от одной строки целевой пиксельной карты к следующему. Значение rowBytes поле должно быть меньше, чем 0x4000.

    codecData

    Указатель на данные, которые будут распакованы.

    progressProcRecord

    ICMProgressProcRecord структура, указывающая функцию прогресса. Эта функция сообщает относительно прогресса работы распаковки. Если нет никакой функции прогресса, Программа управления сжатием изображений устанавливает progressProc поле в ICMProgressProcRecord структура к NIL.

    dataProcRecord

    ICMDataProcRecord структура, указывающая функцию загрузки данных. Если данные, которые будут распакованы, не являются всем в памяти, Ваш компонент может вызвать эту функцию для загрузки большего количества данных. Если нет никакой функции загрузки данных, Программа управления сжатием изображений устанавливает dataProc поле в ICMDataProcRecord структура к NIL, и все изображение должно быть в памяти в расположении, указанном codecData поле ImageSubCodecDecompressRecord структура.

    userDecompressRecord

    Указатель на хранение для работы распаковки. Хранение выделяется декомпрессором базового изображения после того, как это вызовет ImageCodecInitialize. Размер хранения определяется decompressRecordSize поле ImageSubCodecDecompressCapabilities структура, возвращающаяся ImageCodecInitialize. Ваш компонент декомпрессора изображения должен использовать это хранение, чтобы хранить любую дополнительную информацию, необходимую о кадре для распаковки его.

    frameType

    Константа (см. ниже), который указывает frame ввести. Посмотрите эти константы:

    • kCodecFrameTypeUnknown

    • kCodecFrameTypeKey

    • kCodecFrameTypeDifference

    • kCodecFrameTypeDroppableDifference

    pad

    Неиспользованный.

    priv

    Частный к QuickTime; не использовать.

    Обсуждение

    См. также ImageCodecBeginBand, ImageCodecDrawBand, ImageCodecEndBand, ImageCodecMPDrawBandProc.

  • QTParameterValidationOptions QTParameterValidationOptions

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Objective C

    typedef long QTParameterValidationOptions;

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

    Objective C

    @import QuickTime;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • SMPTEFlags SMPTEFlags

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Objective C

    typedef long SMPTEFlags;

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

    Objective C

    @import QuickTime;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • SMPTEFrameReference SMPTEFrameReference

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Objective C

    typedef long SMPTEFrameReference;

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

    Objective C

    @import QuickTime;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • SMPTEWipeType SMPTEWipeType

    Представляет тип, используемый Кодеком Изображения API.

    Объявление

    Objective C

    typedef unsigned long SMPTEWipeType;

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

    Objective C

    @import QuickTime;

    Доступность

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

    Не доступный 64-разрядным приложениям.

Константы

  • Свойства кодека

    Константы, представляющие свойства кодеков.

    Объявление

    Objective C

    enum { /* The minimum data size for spooling in or out data */ codecMinimumDataSize = 32768L }; enum { codecConditionFirstBand = 1L << 0, codecConditionLastBand = 1L << 1, codecConditionFirstFrame = 1L << 2, codecConditionNewDepth = 1L << 3, codecConditionNewTransform = 1L << 4, codecConditionNewSrcRect = 1L << 5, codecConditionNewMask = 1L << 6, codecConditionNewMatte = 1L << 7, codecConditionNewTransferMode = 1L << 8, codecConditionNewClut = 1L << 9, codecConditionNewAccuracy = 1L << 10, codecConditionNewDestination = 1L << 11, codecConditionFirstScreen = 1L << 12, codecConditionDoCursor = 1L << 13, codecConditionCatchUpDiff = 1L << 14, codecConditionMaskMayBeChanged = 1L << 15, codecConditionToBuffer = 1L << 16, codecConditionCodecChangedMask = 1L << 31 }; enum { codecInfoResourceType = 'cdci', /* codec info resource type */ codecInterfaceVersion = 2 /* high word returned in component GetVersion */ }; enum { codecSuggestedBufferSentinel = 'sent' /* codec public resource containing suggested data pattern to put past end of data buffer */ }; enum { codecUsesOverlaySurface = 1L << 0, /* codec uses overlay surface */ codecImageBufferIsOverlaySurface = 1L << 1, /* codec image buffer is overlay surface, the bits in the buffer are on the screen */ codecSrcMustBeImageBuffer = 1L << 2, /* codec can only source data from an image buffer */ codecImageBufferIsInAGPMemory = 1L << 4, /* codec image buffer is in AGP space, byte writes are OK */ codecImageBufferIsInPCIMemory = 1L << 5, /* codec image buffer is across a PCI bus; byte writes are bad */ codecImageBufferMemoryFlagsValid = 1L << 6, /* set by ImageCodecNewImageBufferMemory/NewImageGWorld to indicate that it set the AGP/PCI flags (supported in QuickTime 6.0 and later ) */ codecDrawsHigherQualityScaled = 1L << 7, /* codec will draw higher-quality image if it performs scaling (eg, wipe effect with border ) */ codecSupportsOutOfOrderDisplayTimes = 1L << 8, /* codec supports frames queued in one order for display in a different order, eg, IPB content */ codecSupportsScheduledBackwardsPlaybackWithDifferenceFrames = 1L << 9 /* codec can use additional buffers to minimise redecoding during backwards playback */ };

    Константы

    • codecConditionFirstBand

      codecConditionFirstBand

      Входной флаг, указывающий, является ли это первой полосой в кадре. Если этот флаг установлен в 1, то Ваш компонент вызывают впервые для текущего кадра.

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

      Не доступный 64-разрядным приложениям.

    • codecConditionLastBand

      codecConditionLastBand

      Входной флаг, указывающий, является ли это последней полосой в кадре. Если этот флаг установлен в 1, то Ваш компонент вызывают в последний раз для текущего кадра. Если codecConditionFirstBand флаг также установлен в 1, это - единственное время, Программа управления сжатием изображений вызывает Ваш компонент для текущего кадра.

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

      Не доступный 64-разрядным приложениям.

    • codecConditionFirstFrame

      codecConditionFirstFrame

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

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

      Не доступный 64-разрядным приложениям.

    • codecConditionNewDepth

      codecConditionNewDepth

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

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

      Не доступный 64-разрядным приложениям.

    • codecConditionNewTransform

      codecConditionNewTransform

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

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

      Не доступный 64-разрядным приложениям.

    • codecConditionNewSrcRect

      codecConditionNewSrcRect

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

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

      Не доступный 64-разрядным приложениям.

    • codecConditionNewMatte

      codecConditionNewMatte

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

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

      Не доступный 64-разрядным приложениям.

    • codecConditionNewTransferMode

      codecConditionNewTransferMode

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

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

      Не доступный 64-разрядным приложениям.

    • codecConditionNewClut

      codecConditionNewClut

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

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

      Не доступный 64-разрядным приложениям.

    • codecConditionNewAccuracy

      codecConditionNewAccuracy

      Входной флаг, указывающий к компоненту что accuracy параметр изменился для этой последовательности.

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

      Не доступный 64-разрядным приложениям.

    • codecConditionNewDestination

      codecConditionNewDestination

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

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

      Не доступный 64-разрядным приложениям.

    • codecConditionFirstScreen

      codecConditionFirstScreen

      Когда кодек распаковывает изображение на первый из многократных экранов, указывает. Т.е. если распакованное изображение пересекает многократные экраны, то кодек может смотреть на этот флаг, чтобы определить, является ли это первым разом, когда изображение распаковывается для каждого из экранов, на которые это распаковывается. Кодек, зависящий от maskBits поле этой структуры, являющейся допустимым RgnHandle на ImageCodecPreDecompress потребности знать, что в этом случае это не в состоянии отсечь изображения, так как дескриптор области только передается для первого из экранов; отсечение было бы неправильным для последующего экрана для того изображения.

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

      Не доступный 64-разрядным приложениям.

    • codecConditionDoCursor

      codecConditionDoCursor

      Набор к 1, если компонент декомпрессора должен экранировать и не экранировать курсор для текущей работы распаковки. Этот флаг должен быть установлен, только если кодек указал свою возможность обработать экранирование курсора путем установки codecCanShieldCursor флаг в capabilities поле во время ImageCodecPreDecompress.

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

      Не доступный 64-разрядным приложениям.

    • codecConditionCatchUpDiff

      codecConditionCatchUpDiff

      Указывает, является ли текущий кадр кадром «захвата». Установите этот флаг в 1, если текущий кадр является кадром захвата. Обратите внимание на то, что необходимо также установить codecFlagCatchUpDiff отметьте к 1. Это может быть полезно для декомпрессоров, которые могут отбросить кадры, когда отстает воспроизведение.

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

      Не доступный 64-разрядным приложениям.

    • codecConditionMaskMayBeChanged

      codecConditionMaskMayBeChanged

      Программа управления сжатием изображений всегда включала поддержку декомпрессоров, которые могли обеспечить немного маски пикселей, фактически нарисованных, когда был распакован определенный кадр. Если декомпрессор может обеспечить немного маски пикселей, изменившихся, Программа управления сжатием изображений передает экрану только фактически изменившиеся пиксели. QuickTime 2.1 расширил эту возможность путем добавления этого нового флага условия. Декомпрессор должен записать маску обратно, только если установлен этот флаг. Этот флаг используется только ImageCodecFlush.

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

      Не доступный 64-разрядным приложениям.

    • codecConditionToBuffer

      codecConditionToBuffer

      Набор к 1, если текущая работа распаковки распаковывает во внеэкранный буфер.

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

      Не доступный 64-разрядным приложениям.

    • codecConditionCodecChangedMask

      codecConditionCodecChangedMask

      Выходной флаг, указывающий, что компонент изменил биты маски. Если некоторые пиксели изображения не должны быть записаны в экран, установлены в 0 соответствующие биты в маске, определенной, если Ваш компонент декомпрессора изображения может замаскировать распакованные изображения и maskBits поле в структуре параметра распаковки. Кроме того, установите этот флаг в 1. Иначе, установите этот флаг в 0.

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

      Не доступный 64-разрядным приложениям.

    • codecInfoResourceType

      codecInfoResourceType

      Информационный тип ресурса кодека.

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

      Не доступный 64-разрядным приложениям.

    • codecInterfaceVersion

      codecInterfaceVersion

      Высокое слово возвратилось в компоненте GetVersion.

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

      Не доступный 64-разрядным приложениям.

    • codecSuggestedBufferSentinel

      codecSuggestedBufferSentinel

      Ресурс общественности кодека, содержащий, предложил, чтобы образец данных поместил прошлый конец буфера данных.

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

      Не доступный 64-разрядным приложениям.

    • codecUsesOverlaySurface

      codecUsesOverlaySurface

      Недокументированный

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

      Не доступный 64-разрядным приложениям.

    • codecImageBufferIsOverlaySurface

      codecImageBufferIsOverlaySurface

      Указывает, что буфер изображения кодека является поверхностью наложения; биты в буфере появляются на экране.

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

      Не доступный 64-разрядным приложениям.

    • codecSrcMustBeImageBuffer

      codecSrcMustBeImageBuffer

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

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

      Не доступный 64-разрядным приложениям.

    • codecImageBufferIsInAGPMemory

      codecImageBufferIsInAGPMemory

      Указывает, что буфер изображения кодека находится в адресном пространстве AGP и принимает побайтовые записи.

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

      Не доступный 64-разрядным приложениям.

    • codecImageBufferIsInPCIMemory

      codecImageBufferIsInPCIMemory

      Буфер изображения кодека через шину PCI; побайтовые записи плохи.

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

      Не доступный 64-разрядным приложениям.

    • codecImageBufferMemoryFlagsValid

      codecImageBufferMemoryFlagsValid

      Установленный ImageCodecNewImageBufferMemory или NewImageGWorld указать что codecImageBufferIsInAGPMemory и codecImageBufferIsInPCIPMemory флаги были установлены правильно.

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

      Не доступный 64-разрядным приложениям.

    • codecDrawsHigherQualityScaled

      codecDrawsHigherQualityScaled

      Указывает, что кодек нарисует более высокое качественное изображение, если он выполнит масштабирование; например, в то время как получение a вытирает эффект границей.

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

      Не доступный 64-разрядным приложениям.

    • codecSupportsOutOfOrderDisplayTimes

      codecSupportsOutOfOrderDisplayTimes

      Кадры поддержки кодеков, поставленные в очередь в одном порядке на дисплей в различном порядке, например содержание IPB.

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

      Не доступный 64-разрядным приложениям.

  • Значения ImageSubCodecDecompressRecord

    Константы передали ImageSubCodecDecompressRecord.

    Объявление

    Objective C

    enum { kCodecFrameTypeUnknown = 0, kCodecFrameTypeKey = 1, kCodecFrameTypeDifference = 2, kCodecFrameTypeDroppableDifference = 3 };

    Константы

    • kCodecFrameTypeUnknown

      kCodecFrameTypeUnknown

      Тип кадра неизвестен.

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

      Не доступный 64-разрядным приложениям.

    • kCodecFrameTypeKey

      kCodecFrameTypeKey

      Это - ключевой кадр.

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

      Не доступный 64-разрядным приложениям.

    • kCodecFrameTypeDifference

      kCodecFrameTypeDifference

      Это - кадр различия.

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

      Не доступный 64-разрядным приложениям.

  • Значения EffectSource

    Константы передали EffectSource.

    Объявление

    Objective C

    enum { kEffectRawSource = 0, /* the source is raw image data */ kEffectGenericType = 'geff' /* generic effect for combining others */ };

    Константы

    • kEffectRawSource

      kEffectRawSource

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

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

      Не доступный 64-разрядным приложениям.

  • Значения ImageCodecValidateParameters

    Константы передали ImageCodecValidateParameters.

    Объявление

    Objective C

    enum { kParameterValidationNoFlags = 0x00000000, kParameterValidationFinalValidation = 0x00000001 };

  • Значения CodecDecompressParams

    Константы передали CodecDecompressParams.

    Объявление

    Objective C

    enum { kScreenFloodMethodNone = 0, kScreenFloodMethodKeyColor = 1, kScreenFloodMethodAlpha = 2 }; enum { matrixFlagScale2x = 1L << 7, matrixFlagScale1x = 1L << 6, matrixFlagScaleHalf = 1L << 5 };

    Константы

    • kScreenFloodMethodNone

      kScreenFloodMethodNone

      Никакой метод; значение 0.

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

      Не доступный 64-разрядным приложениям.

    • kScreenFloodMethodKeyColor

      kScreenFloodMethodKeyColor

      Метод ключевого цвета; значение равняется 1.

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

      Не доступный 64-разрядным приложениям.

    • kScreenFloodMethodAlpha

      kScreenFloodMethodAlpha

      Метод альфа-канала; значение равняется 2.

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

      Не доступный 64-разрядным приложениям.

    • matrixFlagScale2x

      matrixFlagScale2x

      Двойной масштаб; значение 1L<<7.

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

      Не доступный 64-разрядным приложениям.

    • matrixFlagScale1x

      matrixFlagScale1x

      Единственный масштаб; значение 1L<<6.

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

      Не доступный 64-разрядным приложениям.