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

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

Разработчик

Ссылочный фильм в формате QuickTime платформы платформ дорожка и ссылка носителей

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

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

Дорожка фильма в формате QuickTime и ссылка носителей

Дорожка и функции управления носителей помогают с конструкцией и редактированием фильмов в формате QuickTime.

Функции

Добавление выборок к структурам носителей
  • AddMediaSample AddMediaSample (OS X v10.9)

    Добавляют демонстрационные данные и описание к носители.

    Объявление

    Objective C

    OSErr AddMediaSample ( Media theMedia, Handle dataIn, long inOffset, unsigned long size, TimeValue durationPerSample, SampleDescriptionHandle sampleDescriptionH, long numberOfSamples, short sampleFlags, TimeValue *sampleTime );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    dataIn

    Дескриптор к демонстрационным данным. AddMediaSample функция добавляет эти данные к носителям, указанным параметром theMedia. Вы указываете число байтов демонстрационных данных с size параметр. Можно использовать inOffset параметр для указания байтового смещения в данные, именуемые этим дескриптором.

    inOffset

    Указывает смещение в данные, именуемые дескриптором, содержавшимся в dataIn параметр. Установите этот параметр на 0, если нет никакого смещения.

    size

    Число байтов демонстрационных данных, которые будут добавлены к media. Этот параметр указывает общее количество байтов в демонстрационных данных, которые будут добавлены к носителям, не числу байтов на выборку. Используйте numberOfSamples параметр для указания числа выборок, содержащихся в демонстрационных данных.

    durationPerSample

    Продолжительность каждой выборки, которая будет добавлена. Необходимо указать этот параметр в масштабе времени носителей. Например, если Вы добавляете звук, выбранный в 22 кГц к носители, который содержит звуковую дорожку с тем же масштабом времени, Вы установили бы durationPerSample к 1. Точно так же, если Вы добавляете видео, зарегистрированное в 10 кадрах в секунду к видео носители, который имеет масштаб времени 600, Вы установили бы этот параметр на 60 для добавления единственной выборки.

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. Некоторые структуры носителей могут потребовать демонстрационных описаний. Существуют различные описания для различных типов выборок. Например, носители, который содержит сжатое видео, требуют, чтобы Вы предоставили ImageDescription структура. Носители, который содержит звук, требуют, чтобы Вы предоставили a SoundDescription структура. Если носители не требуют a SampleDescription структура, установленная этот параметр на NIL.

    numberOfSamples

    Число выборок, содержавшихся в демонстрационных данных, которые будут добавлены к носителям. Панель инструментов Фильма рассматривает value из этого параметра, а также значения size параметр, когда это определяет размер каждой выборки, которую это добавляет к носителям. Необходимо установить value из этого параметра так, чтобы получающийся объем выборки представлял разумный компромисс между общим временем поиска данных и издержками, связанными с вводом и выводом (I/O). Необходимо также рассмотреть скорость устройства хранения данных; устройства CDROM намного медленнее, чем жесткие диски, например, и должны поэтому иметь меньший объем выборки. Для видео носители, набор объем выборки, соответствующий размеру кадра. Для звуковые носители, выберите много выборок, который соответствует между 0,5 и 1,0 секундами звука. В целом Вы не должны создавать группы звуковых выборок, которые составляют меньше чем 2 КБ в размере или больше, чем 15 КБ. Как правило, объем выборки приблизительно 8 КБ разумен для большинства устройств хранения.

    sampleFlags

    Содержит флаги (см. ниже), что управление добавить работа. Установите неиспользованные флаги в 0. Посмотрите эти константы:

    • mediaSampleNotSync

    sampleTime

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

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

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

    Обсуждение

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

    • // AddMediaSample coding example
    • // See "Discovering QuickTime," page 250
    • #define kSoundSampleDuration 1
    • #define kSyncSample 0
    • #define kTrackStart 0
    • #define kMediaStart 0
    • #define kFix1 0x00010000
    • void CreateMySoundTrack (Movie movie)
    • {
    • Track track;
    • Media media;
    • Handle hSound =NIL;
    • SoundDescriptionHandle hSoundDesc =NIL;
    • long lDataOffset;
    • long lDataSize;
    • long lNumSamples;
    • hSound =GetResource(soundListRsrc, 128);
    • if (hSound ==NIL)
    • return;
    • hSoundDesc =(SoundDescriptionHandle)NewHandle(4);
    • CreateMySoundDescription(hSound,
    • hSoundDesc,
    • &lDataOffset,
    • &lNumSamples,
    • &lDataSize);
    • track =NewMovieTrack(movie, 0, 0, kFullVolume);
    • media =NewTrackMedia(track, SoundMediaType,
    • FixRound((**hSoundDesc).sampleRate),
    • NIL, 0);
    • BeginMediaEdits(media);
    • AddMediaSample(media,
    • hSound,
    • lDataOffset, // offset in data
    • lDataSize,
    • kSoundSampleDuration, // duration of each sound
    • // sample
    • (SampleDescriptionHandle)hSoundDesc,
    • lNumSamples,
    • kSyncSample, // self-contained samples
    • NIL);
    • EndMediaEdits(media);
    • InsertMediaIntoTrack(track,
    • kTrackStart, // track start time
    • kMediaStart, // media start time
    • GetMediaDuration(media),
    • kFix1);
    • if (hSoundDesc !=NIL)
    • DisposeHandle((Handle)hSoundDesc);
    • }

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • AddMediaSampleReference AddMediaSampleReference (OS X v10.9)

    Работы с выборками, уже добавленными к файлу данных фильма.

    Объявление

    Objective C

    OSErr AddMediaSampleReference ( Media theMedia, long dataOffset, unsigned long size, TimeValue durationPerSample, SampleDescriptionHandle sampleDescriptionH, long numberOfSamples, short sampleFlags, TimeValue *sampleTime );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    dataOffset

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

    size

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

    durationPerSample

    Продолжительность каждой выборки в ссылке. Необходимо указать этот параметр в масштабе времени носителей. Например, если Вы относитесь для звучания, который был выбран в 22 кГц в носители, который содержит звуковую дорожку с тем же масштабом времени, для добавления ссылки на единственную выборку, Вы установили бы durationPerSample к 1. Точно так же, если Вы обращаетесь к видео, зарегистрированному в 10 кадрах в секунду в видео носители, который имеет масштаб времени 60, Вы установили бы этот параметр на 6 для добавления ссылки на единственную выборку.

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. Некоторые структуры носителей могут потребовать демонстрационных описаний. Существуют различные описания для различных типов выборок. Например, носители, который содержит сжатое видео, требуют, чтобы Вы предоставили ImageDescription структура. Носители, который содержит звук, требуют, чтобы Вы предоставили звуковую структуру описания. Если носители не требуют a SampleDescription структура, установленная этот параметр на NIL.

    numberOfSamples

    Число выборок содержится в ссылке. Для получения дополнительной информации посмотрите AddMediaSample. Если носители не требуют a SampleDescription структура, установленная этот параметр на NIL.

    sampleFlags

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

    • mediaSampleNotSync

    sampleTime

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • AddMediaSampleReferences AddMediaSampleReferences (OS X v10.9)

    Добавляют группы выборок к файлу данных фильма.

    Объявление

    Objective C

    OSErr AddMediaSampleReferences ( Media theMedia, SampleDescriptionHandle sampleDescriptionH, long numberOfSamples, SampleReferencePtr sampleRefs, TimeValue *sampleTime );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. Некоторые структуры носителей могут потребовать демонстрационных описаний. Существуют различные описания для различных типов выборок. Например, носители, который содержит сжатое видео, требуют, чтобы Вы предоставили ImageDescription структура. Носители, который содержит звук, требуют, чтобы Вы предоставили звуковую структуру описания. Если Вы не хотите SampleDescription структура, установленная этот параметр на NIL.

    numberOfSamples

    Число SampleReferenceRecord структуры, на которые указывают sampleRefs параметр. Каждая структура может содержать одну или более непрерывных выборок. Для получения дополнительной информации посмотрите AddMediaSample.

    sampleRefs

    Указатель на число SampleReferenceRecord структуры, указанные numberOfSamples параметр.

    sampleTime

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • BeginMediaEdits BeginMediaEdits (OS X v10.9)

    Запускает редактирующий носители сеанс.

    Объявление

    Objective C

    OSErr BeginMediaEdits ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

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

    Обсуждение

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

    • // BeginMediaEdits coding example
    • // See "Discovering QuickTime," page 89
    • void CreateMyVideoTrack (Movie movie)
    • {
    • Track track;
    • Media media;
    • Rect rect ={0, 0, 100, 320};
    • track =NewMovieTrack(movie,
    • FixRatio(rect.right, 1),
    • FixRatio(rect.bottom, 1),
    • kNoVolume);
    • media =NewTrackMedia(track,
    • VideoMediaType,
    • 600, // video time scale
    • NIL, NIL);
    • BeginMediaEdits(media);
    • MyAddVideoSamplesToMedia(media, &rect); // assemble data
    • EndMediaEdits(media);
    • InsertMediaIntoTrack(track,
    • 0, // track start time
    • 0, // media start time
    • GetMediaDuration(media),
    • kFix1); // normal speed
    • }

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • EndMediaEdits EndMediaEdits (OS X v10.9)

    Заканчивает редактирующий носители сеанс.

    Объявление

    Objective C

    OSErr EndMediaEdits ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

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

    Обсуждение

    Следующий пример кода иллюстрирует использование EndMediaEdits:

    • // EndMediaEdits coding example
    • // See "Discovering QuickTime," page 89
    • void CreateMyVideoTrack (Movie movie)
    • {
    • Track track;
    • Media media;
    • Rect rect ={0, 0, 100, 320};
    • track =NewMovieTrack(movie,
    • FixRatio(rect.right, 1),
    • FixRatio(rect.bottom, 1),
    • kNoVolume);
    • media =NewTrackMedia(track,
    • VideoMediaType,
    • 600, // video time scale
    • NIL, NIL);
    • BeginMediaEdits(media);
    • MyAddVideoSamplesToMedia(media, &rect); // assemble data
    • EndMediaEdits(media);
    • InsertMediaIntoTrack(track,
    • 0, // track start time
    • 0, // media start time
    • GetMediaDuration(media),
    • kFix1); // normal speed
    • }

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaPreferredChunkSize GetMediaPreferredChunkSize (OS X v10.9)

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

    Объявление

    Objective C

    OSErr GetMediaPreferredChunkSize ( Media theMedia, long *maxChunkSize );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    maxChunkSize

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaSample GetMediaSample (OS X v10.9)

    Возвращает выборку из файла данных фильма.

    Объявление

    Objective C

    OSErr GetMediaSample ( Media theMedia, Handle dataOut, long maxSizeToGrow, long *size, TimeValue time, TimeValue *sampleTime, TimeValue *durationPerSample, SampleDescriptionHandle sampleDescriptionH, long *sampleDescriptionIndex, long maxNumberOfSample, long *numberOfSamples, short *sampleFlags );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    dataOut

    Дескриптор. GetMediaSample функционируйте возвращает демонстрационные данные в этот дескриптор. Функция увеличивает размер этого дескриптора, при необходимости. Можно указать максимальный размер дескриптора с maxSizeToGrow параметр.

    maxSizeToGrow

    Максимальное количество байтов демонстрационных данных, которые будут возвращены. GetMediaSample функция не увеличивает дескриптор, указанный dataOut параметр к размеру, больше, чем Вы, указывает с этим параметром. Установите это значение в 0 для осуществления предела на числе байтов, которые будут возвращены.

    size

    Указатель на длинное целое. GetMediaSample функционируйте обновляет поле, именуемое size параметр с числом байтов демонстрационных данных возвратился в дескрипторе, указанном dataOut параметр. Установите этот параметр на NIL если Вы не интересуетесь этой информацией.

    time

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

    sampleTime

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

    durationPerSample

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

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. GetMediaSample функционируйте возвращает демонстрационное описание, соответствующее возвращенным демонстрационным данным. Функция изменяет размеры этого дескриптора как надлежащего. Если Вы не хотите a SampleDescription структура, установленная этот параметр на NIL.

    sampleDescriptionIndex

    Указатель на длинное целое. GetMediaSample функционируйте возвращает индексное значение SampleDescription структура, соответствующая возвращенным демонстрационным данным. Можно получить структуру путем вызова GetMediaSampleDescription и передача этого индекса в descH параметр. Если Вы не хотите эту информацию, установите этот параметр на NIL.

    maxNumberOfSamples

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

    numberOfSamples

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

    sampleFlags

    Указатель тот, на короткое целое, в который GetMediaSample флаги возвратов (см. ниже), которые описывают выборку. Неиспользованные флаги установлены в 0. Если Вы не хотите эту информацию, установите этот параметр на NIL. Посмотрите эти константы:

    • mediaSampleNotSync

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaSampleReference GetMediaSampleReference (OS X v10.9)

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

    Объявление

    Objective C

    OSErr GetMediaSampleReference ( Media theMedia, long *dataOffset, long *size, TimeValue time, TimeValue *sampleTime, TimeValue *durationPerSample, SampleDescriptionHandle sampleDescriptionH, long *sampleDescriptionIndex, long maxNumberOfSamples, long *numberOfSamples, short *sampleFlags );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    dataOffset

    Указатель на длинное целое. GetMediaSampleReference обновляет поле, именуемое этим параметром со смещением к демонстрационным данным. Этот параметр используется по-другому каждым обработчиком носителей. Например, обработчик носителей иерархической файловой системы (HFS) возвращает смещение в файл, содержащий данные носителей.

    size

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

    time

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

    sampleTime

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

    durationPerSample

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

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. GetMediaSampleReference возвращает структуру, соответствующую возвращенным демонстрационным данным. Функция изменяет размеры этого дескриптора как надлежащего. Если Вы не хотите SampleDescription структура, установленная этот параметр на NIL.

    sampleDescriptionIndex

    Указатель на длинное целое. GetMediaSampleReference возвращает индексное значение SampleDescription структура, соответствующая возвращенным демонстрационным данным. Для получения демонстрационного описания носителей передайте этот индекс в descH параметр GetMediaSampleDescription. Если Вы не хотите эту информацию, установите этот параметр на NIL.

    maxNumberOfSamples

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

    numberOfSamples

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

    sampleFlags

    Указатель тот, на короткое целое, в который GetMediaSampleReference флаги возвратов (см. ниже), которые описывают выборки, именуемые возвращенной ссылкой. Неиспользованные флаги установлены в 0. Если Вы не хотите эту информацию, установите этот параметр на NIL. Посмотрите эти константы:

    • mediaSampleNotSync

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaSampleReferences GetMediaSampleReferences (OS X v10.9)

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

    Объявление

    Objective C

    OSErr GetMediaSampleReferences ( Media theMedia, TimeValue time, TimeValue *sampleTime, SampleDescriptionHandle sampleDescriptionH, long *sampleDescriptionIndex, long maxNumberOfEntries, long *actualNumberofEntries, SampleReferencePtr sampleRefs );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    time

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

    sampleTime

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

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. GetMediaSampleReference возвращает структуру, соответствующую возвращенным демонстрационным данным. Функция изменяет размеры этого дескриптора как надлежащего. GetMediaSampleReferences только возвращает единственное демонстрационное описание. Если демонстрационное описание изменяется в носителях, GetMediaSampleReferences возвраты только столько же выборок сколько использование единственное демонстрационное описание. Необходимо вызвать его снова для получения следующей группы выборок с помощью следующего демонстрационного описания. Если Вы не хотите SampleDescription структура, установленная этот параметр на NIL.

    sampleDescriptionIndex

    Указатель на длинное целое. GetMediaSampleReferences возвращает индексное значение SampleDescription структуры, соответствующие возвращенным демонстрационным данным. Используйте этот индекс для получения демонстрационных описаний носителей с GetMediaSampleDescription. Если Вы не хотите эту информацию, установите этот параметр на NIL.

    maxNumberOfEntries

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

    actualNumberofEntries

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

    sampleRefs

    Указатель на число SampleReferenceRecord структуры, указанные в maxNumberOfEntries параметр. По возврату из этого вызова число демонстрационных контрольных записей, обозначенных значением, возвратилось в actualNumberofEntries будет заполнено в.

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetMediaDefaultDataRefIndex SetMediaDefaultDataRefIndex (OS X v10.9)

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

    Объявление

    Objective C

    OSErr SetMediaDefaultDataRefIndex ( Media theMedia, short index );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    index

    Ссылка на данные к доступу. Значения index диапазон параметра от 1 до числа ссылок на данные в носителях. Можно определить число ссылок на данные путем вызова GetMediaDataRefCount. После того, как набор, индекс ссылки на данные по умолчанию сохраняется. Установите этот параметр на 0 для возвращения к ссылке на данные носителей по умолчанию.

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetMediaPreferredChunkSize SetMediaPreferredChunkSize (OS X v10.9)

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

    Объявление

    Objective C

    OSErr SetMediaPreferredChunkSize ( Media theMedia, long maxChunkSize );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    maxChunkSize

    Максимальный размер блока, в байтах.

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Создание дорожек и структур носителей
  • DisposeMovieTrack DisposeMovieTrack (OS X v10.9)

    Удаляет дорожку из фильма.

    Объявление

    Objective C

    void DisposeMovieTrack ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

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

    Обсуждение

    Следующий фрагмент кода иллюстрирует использование DisposeMovieTrack:

    • // DisposeMovieTrack coding example
    • // See "Discovering QuickTime," page 363
    • Movie movie1;
    • TimeValue lOldDuration;
    • Movie movie2;
    • long lIndex, lOrigTrackCount, lReferenceIndex;
    • Track track, trackSprite;
    • // get the first track in original movie and position at the start
    • trackSprite =GetMovieIndTrack(movie1, 1);
    • SetMovieSelection(movie1, 0, 0);
    • // remove all tracks except video in modifier movie
    • for (lIndex =1; lIndex <=GetMovieTrackCount(movie2); lIndex++) {
    • Track track =GetMovieIndTrack(movie2, lIndex);
    • OSType dwType;
    • GetMediaHandlerDescription(GetTrackMedia(track),
    • &dwType, NIL, NIL);
    • if (dwType !=VideoMediaType) {
    • DisposeMovieTrack(track);
    • lIndex--;
    • }
    • }
    • // add the modifier track to original movie
    • lOldDuration =GetMovieDuration(movie1);
    • AddMovieSelection(movie1, movie2);
    • DisposeMovie(movie2);
    • // truncate the movie to the length of the original track
    • DeleteMovieSegment(movie1, lOldDuration,
    • GetMovieDuration(movie1) - lOldDuration);
    • // associate the modifier track with the original sprite track
    • track =GetMovieIndTrack(movie1, lOrigTrackCount + 1);
    • AddTrackReference(trackSprite, track, kTrackModifierReference,
    • &lReferenceIndex);

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • DisposeTrackMedia DisposeTrackMedia (OS X v10.9)

    Удаляет носители из дорожки.

    Объявление

    Objective C

    void DisposeTrackMedia ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • NewMovieTrack NewMovieTrack (OS X v10.9)

    Создает новую дорожку фильма, без носители.

    Объявление

    Objective C

    Track NewMovieTrack ( Movie theMovie, Fixed width, Fixed height, short trackVolume );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    width

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

    height

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

    trackVolume

    Параметр громкости дорожки как 16-разрядное число фиксированной точки. Старший разряд 8 битов указывает целочисленную часть; младший разряд 8 битов указывает дробную часть. Объем оценивает диапазон от-1.0 до 1,0. Отрицательные величины не играют звука, но сохраняют абсолютное значение параметра громкости. Установите этот параметр на kFullVolume играть трек в его полном, естественном объеме. Установите этот параметр на kNoVolume регулировать громкость к 0. Посмотрите эти константы:

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

    Идентификатор новой дорожки.

    Обсуждение

    Сразу после создания новой дорожки, необходимо вызвать NewTrackMedia создать носители для дорожки; дорожка без носители бесполезна. Следующий пример кода создает новую дорожку спрайта и носители, затем вызывает BeginMediaEdits подготавливать добавлять выборки к носителям:

    • // NewMovieTrack coding example
    • // See "Discovering QuickTime," page 349
    • #define kSpriteMediaTimeScale 600
    • track =NewMovieTrack(movie, ((long)lTrackWidth << 16),
    • ((long)lTrackHeight << 16), 0);
    • media =NewTrackMedia(track, SpriteMediaType,
    • kSpriteMediaTimeScale, NIL, 0);
    • FailOSErr(BeginMediaEdits(media));

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

    Когда Вы добавляете дорожку к фильму, Панель инструментов Фильма автоматически корректирует дисплей Rect структура фильма. Можно хотеть обнаружить эти изменения путем вызова GetMovieBox так, чтобы можно было скорректировать размер окна экрана фильма.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • NewTrackMedia NewTrackMedia (OS X v10.9)

    Создает носители для новой дорожки.

    Объявление

    Objective C

    Media NewTrackMedia ( Track theTrack, OSType mediaType, TimeScale timeScale, Handle dataRef, OSType dataRefType );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack.

    mediaType

    Тип носителей для создания; посмотрите Media Identifiers. Панель инструментов Фильма использует это значение для нахождения корректного обработчика носителей для новых носителей. Если Панель инструментов Фильма не может определить местоположение надлежащего обработчика носителей, она возвращает ошибку.

    timeScale

    Определяет систему координат времени носителей.

    dataRef

    Ссылка на данные. Этот параметр содержит дескриптор к информации, идентифицирующей файл, содержащий данные этих носителей. Тип информации, хранившей в том дескрипторе, зависит от значения dataRefType параметр. Если Вы создаете новые носители, который относится к существующим данным носителей, можно использовать GetMediaDataRef функция для получения информации о существующей ссылке на данные. Можно тогда предоставить информацию о той ссылке на эту функцию. Установите этот параметр на NIL использовать файл, связанный с фильмом или если фильм не имеет файла ролика. Например, если Вы создали использование фильма CreateMovieFile или NewMovieFromFile, Панель инструментов Фильма предполагает, что данные фильма находятся в файле, указанном в то время. Если Вы создали фильм с помощью NewMovieFromScrap или NewMovie функции, фильм не имеет файла ролика.

    dataRefType

    Тип ссылки на данные; посмотрите Data References. Если ссылка на данные является псевдонимом, необходимо установить этот параметр на rAliasType. Посмотрите Внутренний Macintosh: Файлы для получения дополнительной информации о псевдонимах и менеджере по Псевдониму.

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

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

    Обсуждение

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

    • // NewTrackMedia coding example
    • // See "Discovering QuickTime," page 349
    • #define kSpriteMediaTimeScale 600
    • track =NewMovieTrack(movie, ((long)lTrackWidth << 16),
    • ((long)lTrackHeight << 16), 0);
    • media =NewTrackMedia(track, SpriteMediaType,
    • kSpriteMediaTimeScale, NIL, 0);
    • FailOSErr(BeginMediaEdits(media));

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Определение создания фильмов и время изменения
  • GetMediaCreationTime GetMediaCreationTime (OS X v10.9)

    Возвращает дату создания и время, сохраненное в носители.

    Объявление

    Objective C

    unsigned long GetMediaCreationTime ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

    Дата создания носителей и время.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaModificationTime GetMediaModificationTime (OS X v10.9)

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

    Объявление

    Objective C

    unsigned long GetMediaModificationTime ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

    Дата и время модификации носителей.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetTrackCreationTime GetTrackCreationTime (OS X v10.9)

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

    Объявление

    Objective C

    unsigned long GetTrackCreationTime ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetTrackModificationTime GetTrackModificationTime (OS X v10.9)

    Возвращает дату и время модификации дорожки.

    Объявление

    Objective C

    unsigned long GetTrackModificationTime ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

    Дата и время модификации указанной дорожки.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Отключение фильмов и дорожек
  • GetTrackEnabled GetTrackEnabled (OS X v10.9)

    Определяет, включается ли в настоящее время дорожка.

    Объявление

    Objective C

    Boolean GetTrackEnabled ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

    TRUE, если указанная дорожка в настоящее время включается, FALSE иначе.

    Обсуждение

    Службы Movie Toolbox только включили дорожки.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetTrackEnabled SetTrackEnabled (OS X v10.9)

    Включает или отключает дорожку.

    Объявление

    Objective C

    void SetTrackEnabled ( Track theTrack, Boolean isEnabled );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    isEnabled

    Включает или отключает track. Установите этот параметр на TRUE для включения track. Установите этот параметр на FALSE для отключения дорожки.

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

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

    Обсуждение

    Службы Movie Toolbox только включили дорожки.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Редактирование дорожек
  • AddEmptyTrackToMovie AddEmptyTrackToMovie (OS X v10.9)

    Копирует дорожку из фильма в тот же фильм или в другой фильм.

    Объявление

    Objective C

    OSErr AddEmptyTrackToMovie ( Track srcTrack, Movie dstMovie, Handle dataRef, OSType dataRefType, Track *dstTrack );

    Параметры

    srcTrack

    Исходная дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    dstMovie

    Целевой фильм для этой работы. Это может быть тем же фильмом как исходная дорожка или различный фильм.

    dataRef

    Дескриптор к data ссылка. Тип информации, хранившей в дескрипторе, зависит от data ссылочный тип, указанный dataRefType.

    dataRefType

    Тип ссылки на данные; посмотрите Data References. Если ссылка на данные является псевдонимом, необходимо установить параметр на rAliasType, указание, что ссылка является псевдонимом.

    dstTrack

    Идентификатор недавно создаваемой дорожки возвращается в этом параметре. Если AddEmptyTrackToMovie сбои, получающийся идентификатор дорожки установлен в NIL.

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

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

    Обсуждение

    Эта функция возвращает недавно создаваемую, пустую дорожку. Недавно создаваемая дорожка имеет тот же тип среды и настройки дорожки как указанная дорожка. Однако никакие данные не копируются от исходной дорожки до новой дорожки. Для копирования данных от исходной дорожки до новой дорожки использовать InsertTrackSegment после вызова AddEmptyTrackToMovie.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • CopyTrackSettings CopyTrackSettings (OS X v10.9)

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

    Объявление

    Objective C

    OSErr CopyTrackSettings ( Track srcTrack, Track dstTrack );

    Параметры

    srcTrack

    Исходная дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    dstTrack

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • DeleteTrackSegment DeleteTrackSegment (OS X v10.9)

    Удаляет указанный сегмент из дорожки.

    Объявление

    Objective C

    OSErr DeleteTrackSegment ( Track theTrack, TimeValue startTime, TimeValue duration );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    startTime

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

    duration

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetTrackEditRate GetTrackEditRate (OS X v10.9)

    Возвращает уровень редактирования дорожки указанной дорожки в указанное время.

    Объявление

    Objective C

    Fixed GetTrackEditRate ( Track theTrack, TimeValue atTime );

    Параметры

    theTrack

    Идентификатор тот дорожки, для который уровень редактирования дорожки (в то время, когда поданный atTime параметр), должен быть определен.

    atTime

    Указывает временную стоимость в который уровень редактирования дорожки (дорожки, идентифицированной в параметре theTrack) должен быть определен.

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • InsertEmptyTrackSegment InsertEmptyTrackSegment (OS X v10.9)

    Добавляет пустой сегмент к дорожке.

    Объявление

    Objective C

    OSErr InsertEmptyTrackSegment ( Track dstTrack, TimeValue dstIn, TimeValue dstDuration );

    Параметры

    dstTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    dstIn

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

    dstDuration

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • InsertMediaIntoTrack InsertMediaIntoTrack (OS X v10.9)

    Вставляет ссылку на участок среды в дорожку.

    Объявление

    Objective C

    OSErr InsertMediaIntoTrack ( Track theTrack, TimeValue trackStart, TimeValue mediaTime, TimeValue mediaDuration, Fixed mediaRate );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack или GetMovieTrack.

    trackStart

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

    mediaTime

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

    mediaDuration

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

    mediaRate

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

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

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

    Обсуждение

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

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

    Вот пример использования этой функции для добавления контейнеров атома к дорожке:

    • //InsertMediaIntoTrack coding example
    • long descSize;
    • QTVRSampleDescriptionHandle qtvrSampleDesc;
    • // Create a QTVR sample description handle
    • descSize =sizeof(QTVRSampleDescription) + GetHandleSize((Handle) vrWorld)
    • - sizeof(UInt32);
    • qtvrSampleDesc =(QTVRSampleDescriptionHandle) NewHandleClear (descSize);
    • (*qtvrSampleDesc)->
    • size =descSize;
    • (*qtvrSampleDesc)->
    • type =kQTVRQTVRType;
    • // Copy the VR world atom container data into the QTVR sample description
    • BlockMove (*((Handle) vrWorld), &((*qtvrSampleDesc)->
    • data),
    • GetHandleSize((Handle) vrWorld));
    • // Now add it to the QTVR track's media
    • err =BeginMediaEdits (qtvrMedia);
    • err =AddMediaSample (qtvrMedia, (Handle) nodeInfo, 0,
    • GetHandleSize((Handle) nodeInfo), duration,
    • (SampleDescriptionHandle) qtvrSampleDesc, 1, 0, &sampleTime);
    • err =EndMediaEdits (qtvrMedia);
    • InsertMediaIntoTrack (qtvrTrack, trackTime, sampleTime, duration, 1L<<16);

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • InsertTrackSegment InsertTrackSegment (OS X v10.9)

    Данные копий в дорожку.

    Объявление

    Objective C

    OSErr InsertTrackSegment ( Track srcTrack, Track dstTrack, TimeValue srcIn, TimeValue srcDuration, TimeValue dstIn );

    Параметры

    srcTrack

    Исходная дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    dstTrack

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

    srcIn

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

    srcDuration

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

    dstIn

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

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • ScaleTrackSegment ScaleTrackSegment (OS X v10.9)

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

    Объявление

    Objective C

    OSErr ScaleTrackSegment ( Track theTrack, TimeValue startTime, TimeValue oldDuration, TimeValue newDuration );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    startTime

    Запуск сегмента. oldDuration параметр указывает продолжительность сегмента. Эта временная стоимость должна быть выражена в масштабе времени фильма, содержащего дорожку.

    oldDuration

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

    newDuration

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Улучшение производительности воспроизведения фильма
  • GetMediaShadowSync GetMediaShadowSync (OS X v10.9)

    Устаревший; больше поддерживаемый.

    Объявление

    Objective C

    OSErr GetMediaShadowSync ( Media theMedia, long frameDiffSampleNum, long *syncSampleNum );

    Параметры

    theMedia

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

    frameDiffSampleNum

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

    syncSampleNum

    Указатель на демонстрационное число теневой синхронизирующей выборки. Если носители не имеют теневой синхронизирующей выборки, 0 возвращается в syncSampleNum параметр.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetTrackDisplayMatrix GetTrackDisplayMatrix (OS X v10.9)

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

    Объявление

    Objective C

    OSErr GetTrackDisplayMatrix ( Track theTrack, MatrixRecord *matrix );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    matrix

    Указатель на матричную структуру.

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

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

    Обсуждение

    Так как информация о модификаторе передается между дорожками в MoviesTask время, информация, возвращенная этим вызовом, представляет матрицу в действительности в последнем MoviesTask вызвать.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetMediaShadowSync SetMediaShadowSync (OS X v10.9)

    Устаревший; больше поддерживаемый.

    Объявление

    Objective C

    OSErr SetMediaShadowSync ( Media theMedia, long frameDiffSampleNum, long syncSampleNum );

    Параметры

    theMedia

    Носители, в которых должна быть создана теневая синхронизация.

    frameDiffSampleNum

    Указывает выборку различия в кадре. Демонстрационное число получено из MediaTimeToSampleNum.

    syncSampleNum

    Указывает теневую синхронизирующую выборку. Демонстрационное число получено из MediaTimeToSampleNum.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Нахождение и добавление выборок
  • AddMediaSample2 AddMediaSample2 (OS X v10.9)

    Добавляют демонстрационные данные и описание к носители.

    Объявление

    Objective C

    OSErr AddMediaSample2 ( Media theMedia, const UInt8 *dataIn, ByteCount size, TimeValue64 decodeDurationPerSample, TimeValue64 displayOffset, SampleDescriptionHandle sampleDescriptionH, ItemCount numberOfSamples, MediaSampleFlags sampleFlags, TimeValue64 *sampleDecodeTimeOut );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    dataIn

    Дескриптор к демонстрационным данным. Функция добавляет эти данные к носителям, указанным theMedia. Вы указываете число байтов демонстрационных данных с size параметр.

    size

    Число байтов демонстрационных данных, которые будут добавлены к media. Этот параметр указывает общее количество байтов в демонстрационных данных, которые будут добавлены к носителям, не числу байтов на выборку. Используйте numberOfSamples параметр для указания числа выборок, содержащихся в демонстрационных данных.

    decodeDurationPerSample

    Продолжительность каждой выборки, которая будет добавлена, представляя количество времени, передающее, в то время как демонстрационные данные выводятся на экран. Необходимо указать этот параметр в масштабе времени носителей. Например, если Вы добавляете звук, выбранный в 22 кГц к носители, который содержит звуковую дорожку с тем же масштабом времени, Вы установили бы durationPerSample к 1. Точно так же, если Вы добавляете видео, зарегистрированное в 10 кадрах в секунду к видео носители, который имеет масштаб времени 600, Вы установили бы этот параметр на 60. Обратите внимание на то, что это - продолжительность на выборку, независимо от числа добавляемых выборок.

    displayOffset

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

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. Некоторые структуры носителей могут потребовать демонстрационных описаний. Существуют различные описания для различных типов выборок. Например, носители, который содержит сжатое видео, требуют, чтобы Вы предоставили ImageDescription структура. Носители, который содержит звук, требуют, чтобы Вы предоставили a SoundDescription структура. Если носители не требуют a SampleDescription структура, установленная этот параметр на NIL.

    numberOfSamples

    Число выборок, содержавшихся в демонстрационных данных, которые будут добавлены к носителям. Панель инструментов Фильма рассматривает value из этого параметра, а также значения size параметр, когда это определяет размер каждой выборки, которую это добавляет к носителям. Необходимо установить value из этого параметра так, чтобы получающийся объем выборки представлял разумный компромисс между общим временем поиска данных и издержками, связанными с вводом и выводом. Необходимо также рассмотреть скорость устройства хранения данных; устройства CDROM намного медленнее, чем жесткие диски, например, и должны поэтому иметь меньший объем выборки. Для видео носители, набор объем выборки, соответствующий размеру кадра. Для звуковые носители, выберите много выборок, который соответствует между 0,5 и 1,0 секундами звука. В целом Вы не должны создавать группы звуковых выборок, которые составляют меньше чем 2 КБ в размере или больше, чем 15 КБ. Как правило, объем выборки приблизительно 8 КБ разумен для большинства устройств хранения.

    sampleFlags

    Флаги, управляющие добавить работой; установите неиспользованные флаги в 0: mediaSampleNotSync Указывает, что выборка, которая будет добавлена, не является синхронизирующей выборкой. Установите этот флаг в 1, если выборка не является синхронизирующей выборкой; установите его в 0, если выборка является синхронизирующей выборкой. Посмотрите эти константы:

    • mediaSampleNotSync

    sampleDecodeTimeOut

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

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

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

    Обсуждение

    Ваше приложение указывает выборку и носители для работы. Эта функция обновляет носители так, чтобы она содержала демонстрационные данные. Один вызов к этой функции может добавить несколько выборок к носители. Эта функция замены AddMediaSample; это добавляет 64-разрядную поддержку и поддержку сжатия видео переупорядочения кадра (смещение дисплея).

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • ExtendMediaDecodeDurationToDisplayEndTime ExtendMediaDecodeDurationToDisplayEndTime (OS X v10.9)

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

    Объявление

    Objective C

    OSErr ExtendMediaDecodeDurationToDisplayEndTime ( Media theMedia, Boolean *mediaChanged );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    mediaChanged

    Указатель на булевскую переменную, возвращающую TRUE, если какие-либо выборки в носителях были скорректированы, FALSE иначе. Если Вы не хотите получать эту информацию, установите этот параметр в NULL.

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

    Код ошибки. Возвраты memFullErr если это не могло бы выделить память, paramErr если был недопустимый параметр, или noErr если нет никакой ошибки. Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaAdvanceDecodeTime GetMediaAdvanceDecodeTime (OS X v10.9)

    Возвращает предварительное время декодирования носители.

    Объявление

    Objective C

    TimeValue64 GetMediaAdvanceDecodeTime ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

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

    64-разрядная временная стоимость, представляющая предварительное время декодирования носителей. Если нет никаких выборок с отрицательными смещениями дисплея, предварительное время декодирования носителей является абсолютным значением самой большой величины отрицательное смещение дисплея его выборок, или 0. Это - сумма, что ось времени декодирования должна быть скорректирована перед осью времени дисплея, чтобы гарантировать, что никакая выборка не корректировалась, декодируют время, позже, чем его время дисплея. Для носителей без ненулевых смещений дисплея предварительное время декодирования 0.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaDataSizeTime64 GetMediaDataSizeTime64 (OS X v10.9)

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

    Объявление

    Objective C

    OSErr GetMediaDataSizeTime64 ( Media theMedia, TimeValue64 startDisplayTime, TimeValue64 displayDuration, SInt64 *dataSize );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    startDisplayTime

    64-разрядная временная стоимость, указывающая начальную точку сегмента в носителях, выводит на экран время.

    displayDuration

    64-разрядная временная стоимость, указывающая продолжительность сегмента в носителях, выводит на экран время.

    dataSize

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

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

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

    Обсуждение

    Единственная разница между этой функцией и GetMediaDataSize64 - то, что эта функция использует 64-разрядные временные стоимости и возвращает 64-разрядный размер.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaDecodeDuration GetMediaDecodeDuration (OS X v10.9)

    Возвращает продолжительность декодирования носители.

    Объявление

    Objective C

    TimeValue64 GetMediaDecodeDuration ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaDisplayDuration GetMediaDisplayDuration (OS X v10.9)

    Возвращает продолжительность дисплея носители.

    Объявление

    Objective C

    TimeValue64 GetMediaDisplayDuration ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

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

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

    Обсуждение

    При вставке носителей со смещениями дисплея в дорожку используйте время дисплея:

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaDisplayEndTime GetMediaDisplayEndTime (OS X v10.9)

    Возвращает время окончания дисплея носители.

    Объявление

    Objective C

    TimeValue64 GetMediaDisplayEndTime ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaDisplayStartTime GetMediaDisplayStartTime (OS X v10.9)

    Возвращает время начала дисплея носители.

    Объявление

    Objective C

    TimeValue64 GetMediaDisplayStartTime ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • MediaContainsDisplayOffsets MediaContainsDisplayOffsets (OS X v10.9)

    Тесты, содержит ли носители смещения дисплея.

    Объявление

    Objective C

    Boolean MediaContainsDisplayOffsets ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

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

    TRUE, если носители допустимо и содержит по крайней мере одну выборку с ненулевым смещением дисплея; FALSE иначе.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • MediaDecodeTimeToSampleNum MediaDecodeTimeToSampleNum (OS X v10.9)

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

    Объявление

    Objective C

    void MediaDecodeTimeToSampleNum ( Media theMedia, TimeValue64 decodeTime, SInt64 *sampleNum, TimeValue64 *sampleDecodeTime, TimeValue64 *sampleDecodeDuration );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    decodeTime

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

    sampleNum

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

    sampleDecodeTime

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

    sampleDecodeDuration

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

    Обсуждение

    Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError. Это возвращается paramErr если существует плохое значение параметра, invalidTime если sampleDecodeTime вне диапазона времени декодирования, или noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • MediaDisplayTimeToSampleNum MediaDisplayTimeToSampleNum (OS X v10.9)

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

    Объявление

    Objective C

    void MediaDisplayTimeToSampleNum ( Media theMedia, TimeValue64 displayTime, SInt64 *sampleNum, TimeValue64 *sampleDisplayTime, TimeValue64 *sampleDisplayDuration );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    displayTime

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

    sampleNum

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

    sampleDisplayTime

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

    sampleDisplayDuration

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

    Обсуждение

    Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError. Это возвращается paramErr если существует плохое значение параметра, invalidTime если sampleDisplayTime вне диапазона времени дисплея, или noErr если нет никакой ошибки.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • TrackTimeToMediaDisplayTime TrackTimeToMediaDisplayTime (OS X v10.9)

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

    Объявление

    Objective C

    TimeValue64 TrackTimeToMediaDisplayTime ( TimeValue64 value, Track theTrack );

    Параметры

    value

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

    theTrack

    Идентификатор дорожки, который Ваше приложение получает из таких функций как NewMovieTrack и GetMovieTrack.

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Высокоуровневые функции редактирования фильма
  • AddMovieSelection AddMovieSelection (OS X v10.9)

    Добавляют одна или более дорожек к фильму.

    Объявление

    Objective C

    void AddMovieSelection ( Movie theMovie, Movie src );

    Параметры

    theMovie

    Целевой фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    src

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

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

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

    Обсуждение

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

    • // AddMovieSelection coding example
    • // See "Discovering QuickTime," page 363
    • Movie movie1;
    • TimeValue lOldDuration;
    • Movie movie2;
    • long lIndex, lOrigTrackCount, lReferenceIndex;
    • Track track, trackSprite;
    • // get the first track in original movie and position at the start
    • trackSprite =GetMovieIndTrack(movie1, 1);
    • SetMovieSelection(movie1, 0, 0);
    • // remove all tracks except video in modifier movie
    • for (lIndex =1; lIndex <=GetMovieTrackCount(movie2); lIndex++) {
    • Track track =GetMovieIndTrack(movie2, lIndex);
    • OSType dwType;
    • GetMediaHandlerDescription(GetTrackMedia(track),
    • &dwType, NIL, NIL);
    • if (dwType !=VideoMediaType) {
    • DisposeMovieTrack(track);
    • lIndex--;
    • }
    • }
    • // add the modifier track to original movie
    • lOldDuration =GetMovieDuration(movie1);
    • AddMovieSelection(movie1, movie2);
    • DisposeMovie(movie2);
    • // truncate the movie to the length of the original track
    • DeleteMovieSegment(movie1, lOldDuration,
    • GetMovieDuration(movie1) - lOldDuration);
    • // associate the modifier track with the original sprite track
    • track =GetMovieIndTrack(movie1, lOrigTrackCount + 1);
    • AddTrackReference(trackSprite, track, kTrackModifierReference,
    • &lReferenceIndex);

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • ClearMovieSelection ClearMovieSelection (OS X v10.9)

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

    Объявление

    Objective C

    void ClearMovieSelection ( Movie theMovie );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • CopyMovieSelection CopyMovieSelection (OS X v10.9)

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

    Объявление

    Objective C

    Movie CopyMovieSelection ( Movie theMovie );

    Параметры

    theMovie

    Исходный фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

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

    Новый фильм.

    Обсуждение

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • CutMovieSelection CutMovieSelection (OS X v10.9)

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

    Объявление

    Objective C

    Movie CutMovieSelection ( Movie theMovie );

    Параметры

    theMovie

    Исходный фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

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

    Недавно создаваемый фильм.

    Обсуждение

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • IsScrapMovie IsScrapMovie (OS X v10.9)

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

    Объявление

    Objective C

    Component IsScrapMovie ( Track targetTrack );

    Параметры

    targetTrack

    Расположение потенциального целевого фильма отслеживает для данных по системному фрагменту.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • PasteHandleIntoMovie PasteHandleIntoMovie (OS X v10.9)

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

    Объявление

    Objective C

    OSErr PasteHandleIntoMovie ( Handle h, OSType handleType, Movie theMovie, long flags, ComponentInstance userComp );

    Параметры

    h

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

    handleType

    Тип данных дескриптора, указанного в h параметр. Если дескриптор установлен в 0, функция ищет фрагмент поле типа handleType. Если оба h параметр и handleType параметр NIL, функция использует первые доступные данные от фрагмента.

    theMovie

    Целевой фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    flags

    Флаг (см. ниже), который может далее совершенствовать условия операции вставки. Посмотрите эти константы:

    • pasteInParallel

    userComp

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

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

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

    Обсуждение

    Если Вы просто вставляете в данных от фрагмента, лучше позволять этой функции получать данные от фрагмента, вместо того, чтобы делать его сами. Таким образом функция в состоянии получить дополнительные данные из фрагмента, если необходимый (например, 'styl' ресурсы для 'TEXT'). Эта функция может вставить в текущий выбор двумя различными способами. Если выбор пуст (например, продолжительность =0), это добавляет данные с надлежащей продолжительностью. Если выбор не пуст, данные добавляются и затем масштабируются для вписывания в продолжительность выбора. Текущий выбор удален, если Вы не устанавливаете pasteInParallel флаг.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • PasteMovieSelection PasteMovieSelection (OS X v10.9)

    Помещает дорожки из одного фильма в другой фильм.

    Объявление

    Objective C

    void PasteMovieSelection ( Movie theMovie, Movie src );

    Параметры

    theMovie

    Целевой фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    src

    Исходный фильм для этой работы. PasteMovieSelection помещает дорожки из этого фильма в целевом фильме.

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • PutMovieIntoTypedHandle PutMovieIntoTypedHandle (OS X v10.9)

    Берет фильм или одноколейный путь из того фильма, и преобразовывает его в дескриптор указанного типа.

    Объявление

    Objective C

    OSErr PutMovieIntoTypedHandle ( Movie theMovie, Track targetTrack, OSType handleType, Handle publicMovie, TimeValue start, TimeValue dur, long flags, ComponentInstance userComp );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    targetTrack

    Дорожка для преобразования.

    handleType

    Тип новых данных.

    publicMovie

    Фактический дескриптор, в который можно поместить новые данные.

    start

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

    dur

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

    flags

    Условие преобразования. Установите этот параметр на 0.

    userComp

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Определение местоположения дорожек фильма и структур носителей
  • GetMediaTrack GetMediaTrack (OS X v10.9)

    Определяет дорожку, использующую указанные носители.

    Объявление

    Objective C

    Track GetMediaTrack ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

    Идентификатор дорожки дорожки, использующей указанные носители.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMovieIndTrack GetMovieIndTrack (OS X v10.9)

    Определяет идентификатор дорожки дорожки, учитывая индексное значение дорожки.

    Объявление

    Objective C

    Track GetMovieIndTrack ( Movie theMovie, long index );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    index

    Индексное значение дорожки для этой работы.

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

    Идентификатор дорожки. Если функция не может определить местоположение дорожки, она устанавливает это возвращенное значение в NIL.

    Обсуждение

    Эта функция возвращает идентификатор дорожки, который является надлежащим указанной дорожке. Индексное значение идентифицирует дорожку среди всех текущих дорожек в фильме. Индекс оценивает диапазон от 1 до числа дорожек в фильме. Следующий пример кода иллюстрирует свое использование:

    • // GetMovieIndTrack coding example
    • // See "Discovering QuickTime," page 363
    • Movie movie1;
    • TimeValue lOldDuration;
    • Movie movie2;
    • long lIndex, lOrigTrackCount, lReferenceIndex;
    • Track track, trackSprite;
    • // get the first track in original movie and position at the start
    • trackSprite =GetMovieIndTrack(movie1, 1);
    • SetMovieSelection(movie1, 0, 0);
    • // remove all tracks except video in modifier movie
    • for (lIndex =1; lIndex <=GetMovieTrackCount(movie2); lIndex++) {
    • Track track =GetMovieIndTrack(movie2, lIndex);
    • OSType dwType;
    • GetMediaHandlerDescription(GetTrackMedia(track),
    • &dwType, NIL, NIL);
    • if (dwType !=VideoMediaType) {
    • DisposeMovieTrack(track);
    • lIndex--;
    • }
    • }
    • // add the modifier track to original movie
    • lOldDuration =GetMovieDuration(movie1);
    • AddMovieSelection(movie1, movie2);
    • DisposeMovie(movie2);
    • // truncate the movie to the length of the original track
    • DeleteMovieSegment(movie1, lOldDuration,
    • GetMovieDuration(movie1) - lOldDuration);
    • // associate the modifier track with the original sprite track
    • track =GetMovieIndTrack(movie1, lOrigTrackCount + 1);
    • AddTrackReference(trackSprite, track, kTrackModifierReference,
    • &lReferenceIndex);

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMovieIndTrackType GetMovieIndTrackType (OS X v10.9)

    Поиски всех дорожек фильма, совместно использующих данный тип среды или характеристику носителей.

    Объявление

    Objective C

    Track GetMovieIndTrackType ( Movie theMovie, long index, OSType trackType, long flags );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    index

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

    trackType

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

    flags

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

    • movieTrackMediaType

    • movieTrackCharacteristic

    • movieTrackEnabledOnly

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

    Идентификатор дорожки.

    Обсуждение

    Панель инструментов возвращает идентификатор дорожки, соответствующий дорожке, встречающей Ваши критерии выбора. Если панель инструментов не может найти соответствующую дорожку в возвратах значение NIL. Обратите внимание на то, что index параметр не работает тот же путь, который является, выполняет GetMovieIndTrack. С GetMovieIndTrackType, index параметр указывает индекс в набор дорожек, встречающих Ваши другие критерии выбора. Например, для нахождения третьей дорожки поддерживающей звуковую характеристику, Вы вызвали бы функцию следующим образом:

    • theTrack =GetMovieIndTrackType (theMovie, 3, AudioMediaCharacteristic, movieTrackCharacteristic);

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMovieTrack GetMovieTrack (OS X v10.9)

    Определяет идентификатор дорожки дорожки, учитывая Значение идентификатора дорожки.

    Объявление

    Objective C

    Track GetMovieTrack ( Movie theMovie, long trackID );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    trackID

    Значение идентификатора дорожки для этой работы.

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

    Идентификатор дорожки.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMovieTrackCount GetMovieTrackCount (OS X v10.9)

    Возвращает число дорожек в фильме.

    Объявление

    Objective C

    long GetMovieTrackCount ( Movie theMovie );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

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

    Число дорожек в фильме.

    Обсуждение

    Следующий пример кода иллюстрирует использование GetMovieTrackCount:

    • // GetMovieTrackCount coding example
    • // See "Discovering QuickTime," page 363
    • Movie movie1;
    • TimeValue lOldDuration;
    • Movie movie2;
    • long lIndex, lOrigTrackCount, lReferenceIndex;
    • Track track, trackSprite;
    • // get the first track in original movie and position at the start
    • trackSprite =GetMovieIndTrack(movie1, 1);
    • SetMovieSelection(movie1, 0, 0);
    • // remove all tracks except video in modifier movie
    • for (lIndex =1; lIndex <=GetMovieTrackCount(movie2); lIndex++) {
    • Track track =GetMovieIndTrack(movie2, lIndex);
    • OSType dwType;
    • GetMediaHandlerDescription(GetTrackMedia(track),
    • &dwType, NIL, NIL);
    • if (dwType !=VideoMediaType) {
    • DisposeMovieTrack(track);
    • lIndex--;
    • }
    • }
    • // add the modifier track to original movie
    • lOldDuration =GetMovieDuration(movie1);
    • AddMovieSelection(movie1, movie2);
    • DisposeMovie(movie2);
    • // truncate the movie to the length of the original track
    • DeleteMovieSegment(movie1, lOldDuration,
    • GetMovieDuration(movie1) - lOldDuration);
    • // associate the modifier track with the original sprite track
    • track =GetMovieIndTrack(movie1, lOrigTrackCount + 1);
    • AddTrackReference(trackSprite, track, kTrackModifierReference,
    • &lReferenceIndex);

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetTrackID GetTrackID (OS X v10.9)

    Определяет уникальное Значение идентификатора дорожки дорожки.

    Объявление

    Objective C

    long GetTrackID ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

    Уникальное Значение идентификатора дорожки указанной дорожки.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetTrackMedia GetTrackMedia (OS X v10.9)

    Определяет носители, который содержит демонстрационные данные дорожки.

    Объявление

    Objective C

    Media GetTrackMedia ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetTrackMovie GetTrackMovie (OS X v10.9)

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

    Объявление

    Objective C

    Movie GetTrackMovie ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

    Идентификатор фильма, содержащего дорожку.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Низкоуровневые функции редактирования фильма
  • CopyMovieSettings CopyMovieSettings (OS X v10.9)

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

    Объявление

    Objective C

    OSErr CopyMovieSettings ( Movie srcMovie, Movie dstMovie );

    Параметры

    srcMovie

    Исходный фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    dstMovie

    Целевой фильм для этой работы. CopyMovieSettings функционируйте использует настройки из исходного фильма, указанного srcMovie параметр, для замены текущих настроек этого фильма.

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • DeleteMovieSegment DeleteMovieSegment (OS X v10.9)

    Удаляет указанный сегмент из фильма.

    Объявление

    Objective C

    OSErr DeleteMovieSegment ( Movie theMovie, TimeValue startTime, TimeValue duration );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    startTime

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

    duration

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

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

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

    Обсуждение

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

    • // DeleteMovieSegment coding example
    • // See "Discovering QuickTime," page 363
    • Movie movie1;
    • TimeValue lOldDuration;
    • Movie movie2;
    • long lIndex, lOrigTrackCount, lReferenceIndex;
    • Track track, trackSprite;
    • // get the first track in original movie and position at the start
    • trackSprite =GetMovieIndTrack(movie1, 1);
    • SetMovieSelection(movie1, 0, 0);
    • // remove all tracks except video in modifier movie
    • for (lIndex =1; lIndex <=GetMovieTrackCount(movie2); lIndex++) {
    • Track track =GetMovieIndTrack(movie2, lIndex);
    • OSType dwType;
    • GetMediaHandlerDescription(GetTrackMedia(track),
    • &dwType, NIL, NIL);
    • if (dwType !=VideoMediaType) {
    • DisposeMovieTrack(track);
    • lIndex--;
    • }
    • }
    • // add the modifier track to original movie
    • lOldDuration =GetMovieDuration(movie1);
    • AddMovieSelection(movie1, movie2);
    • DisposeMovie(movie2);
    • // truncate the movie to the length of the original track
    • DeleteMovieSegment(movie1, lOldDuration,
    • GetMovieDuration(movie1) - lOldDuration);
    • // associate the modifier track with the original sprite track
    • track =GetMovieIndTrack(movie1, lOrigTrackCount + 1);
    • AddTrackReference(trackSprite, track, kTrackModifierReference,
    • &lReferenceIndex);

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • InsertEmptyMovieSegment InsertEmptyMovieSegment (OS X v10.9)

    Добавляет пустой сегмент к фильму.

    Объявление

    Objective C

    OSErr InsertEmptyMovieSegment ( Movie dstMovie, TimeValue dstIn, TimeValue dstDuration );

    Параметры

    dstMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, или NewMovieFromHandle.

    dstIn

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

    dstDuration

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • InsertMovieSegment InsertMovieSegment (OS X v10.9)

    Часть копий одного фильма другому.

    Объявление

    Objective C

    OSErr InsertMovieSegment ( Movie srcMovie, Movie dstMovie, TimeValue srcIn, TimeValue srcDuration, TimeValue dstIn );

    Параметры

    srcMovie

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

    dstMovie

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

    srcIn

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

    srcDuration

    Продолжительность сегмента в исходном фильме. Эта временная стоимость должна быть выражена в исходном масштабе времени фильма.

    dstIn

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

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • ScaleMovieSegment ScaleMovieSegment (OS X v10.9)

    Изменяет продолжительность сегмента фильма.

    Объявление

    Objective C

    OSErr ScaleMovieSegment ( Movie theMovie, TimeValue startTime, TimeValue oldDuration, TimeValue newDuration );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, или NewMovieFromHandle.

    startTime

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

    oldDuration

    Исходная продолжительность сегмента в исходном фильме. Эта временная стоимость должна быть выражена в масштабе времени фильма.

    newDuration

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

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

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

    Обсуждение

    Панель инструментов Фильма масштабирует сегмент для размещения новой продолжительности.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Управление входными картами носителей
  • GetMediaInputMap GetMediaInputMap (OS X v10.9)

    Возвращает копию входной карты, связанной с указанные носители.

    Объявление

    Objective C

    OSErr GetMediaInputMap ( Media theMedia, QTAtomContainer *inputMap );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    inputMap

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

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

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

    Обсуждение

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

    • // GetMediaInputMap coding example
    • // See "Discovering QuickTime," page 365
    • #define kImageIndexToOverride 1
    • Movie movie1, movie2;
    • long lReferenceIndex, lImageIndexToOverride;
    • Track trackSprite;
    • QTAtomContainer qtacInputMap;
    • QTAtom lInputAtom;
    • OSType dwInputType;
    • Media mediaSprite;
    • // get the sprite media's input map
    • mediaSprite =GetTrackMedia(trackSprite);
    • GetMediaInputMap(mediaSprite, &qtacInputMap);
    • // add an atom for a modifier track
    • QTInsertChild(qtacInputMap, kParentAtomIsContainer, kTrackModifierInput,
    • lReferenceIndex, 0, 0, NIL, &lInputAtom);
    • // add a child atom to specify the input type
    • dwInputType =kTrackModifierTypeImage;
    • QTInsertChild(qtacInputMap, lInputAtom, kTrackModifierType, 1, 0,
    • sizeof(dwInputType), &dwInputType, NIL);
    • // add a second child atom to specify index of image to override
    • lImageIndexToOverride =EndianS16_NtoB(kImageIndexToOverride);
    • QTInsertChild(qtacInputMap, lInputAtom, kSpritePropertyImageIndex, 1, 0,
    • sizeof(lImageIndexToOverride), &lImageIndexToOverride, NIL);
    • // update the sprite media's input map
    • SetMediaInputMap(mediaSprite, qtacInputMap);
    • QTDisposeAtomContainer(qtacInputMap);

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetMediaInputMap SetMediaInputMap (OS X v10.9)

    Заменяет существующую входную карту носителей данной входной картой.

    Объявление

    Objective C

    OSErr SetMediaInputMap ( Media theMedia, QTAtomContainer inputMap );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    inputMap

    Ввод носителей отображается для этой работы. Если входная карта установлена в NIL, входная карта носителей сбрасывается к пустой входной карте.

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

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

    Обсуждение

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

    • // SetMediaInputMap coding example
    • QTAtomContainer inputMap;
    • QTAtom inputAtom;
    • OSType inputType;
    • Media aVideoMedia =GetTrackMedia(aVideoTrack);
    • GetMediaInputMap (aVideoMedia, &inputMap);
    • QTInsertChild(inputMap, kParentAtomIsContainer, kTrackModifierInput,
    • addedIndex, 0,0, nil, &inputAtom);
    • inputType =kTrackModifierTypeClip;
    • QTInsertChild (inputMap, inputAtom, kTrackModifierType, 1, 0,
    • sizeof(inputType), &inputType, nil);
    • SetMediaInputMap(aVideoMedia, inputMap);
    • QTDisposeAtomContainer(inputMap);

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

    Использовать QTNewAtomContainer создать пустую входную карту.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Функции фильма
  • ConvertFileToMovieFile ConvertFileToMovieFile (OS X v10.9)

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

    Объявление

    Objective C

    OSErr ConvertFileToMovieFile ( const FSSpec *inputFile, const FSSpec *outputFile, OSType creator, ScriptCode scriptTag, short *resID, long flags, ComponentInstance userComp, MovieProgressUPP proc, long refCon );

    Параметры

    inputFile

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

    outputFile

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

    creator

    Значение создателя для файла, если это - новое.

    scriptTag

    Сценарий, в котором должен быть преобразован файл ролика. Используйте постоянного менеджера по Сценарию smSystemScript использовать системный сценарий; используйте smCurrentScript постоянный для использования текущего сценария. Посмотрите Внутренний Macintosh: текст для получения дополнительной информации о сценариях и тегах script.

    resID

    Указатель на поле, которое должно получить ресурс ID файла, который будет преобразован. Если Вы не хотите получать ресурс ID, установите этот параметр на NIL.

    flags

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

    • createMovieFileDeleteCurFile

    • movieToFileOnlyExport

    • movieFileSpecValid

    • showUserSettingsDialog

    userComp

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

    proc

    Точки к Вашему обратному вызову прогресса. Для удаления функции прогресса фильма установите этот параметр на NIL. Установите этот параметр на-1 для Панели инструментов Фильма для обеспечения функции прогресса по умолчанию. Посмотрите MovieProgressProc для интерфейса Ваш обратный вызов прогресса должен поддерживать.

    refCon

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

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • ConvertMovieToFile ConvertMovieToFile (OS X v10.9)

    Берет указанный фильм (или одноколейный путь в том фильме) и преобразовывает его в указанный файл и тип, поддерживая диалоговое окно Save As.

    Объявление

    Objective C

    OSErr ConvertMovieToFile ( Movie theMovie, Track onlyTrack, FSSpec *outputFile, OSType fileType, OSType creator, ScriptCode scriptTag, short *resID, long flags, ComponentInstance userComp );

    Параметры

    theMovie

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

    onlyTrack

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

    outputFile

    Указатель на спецификацию файла для целевого файла.

    fileType

    Тип данных целевого файла для фильма указан в параметре theMovie.

    creator

    Значение создателя для выходного файла, если это - новое.

    scriptTag

    Сценарий, в который должен быть преобразован фильм, если выходной файл является новым. Используйте постоянного менеджера по Сценарию smSystemScript использовать системный сценарий; используйте smCurrentScript постоянный для использования текущего сценария. Посмотрите Внутренний Macintosh: текст для получения дополнительной информации о сценариях и тегах script.

    resID

    Указатель на поле, которое должно получить ресурс ID открытого фильма. Если Вы не хотите получать эту информацию, установите resID параметр к NIL.

    flags

    Содержит флаги (см. ниже), что управление, ли и как появляется диалоговое окно Save As. Посмотрите эти константы:

    • showUserSettingsDialog

    • movieToFileOnlyExport

    • movieFileSpecValid

    userComp

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

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

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

    Обсуждение

    Ваше управление приложениями, появляется ли диалоговое окно Save As путем установки значения flags параметр. Диалоговое окно позволяет пользователю указать имя файла и тип. Поддерживаемые типы включают стандартные фильмы в формате QuickTime, сглаженные фильмы, единственное ветвление сгладило фильмы, и любой формат, поддерживающийся данными фильма, экспортирует компонент. Следующие фрагменты кода показывают, как вызвать ConvertMovieToFile обеспечить простую возможность экспорта и как сохранить фильм в формате QuickTime только для звука как файл WAV.

    • // Providing an export capability with ConvertMovieToFile
    • err =ConvertMovieToFile (theMovie, /* identifies movie */
    • NIL, /* all tracks */
    • NIL, /* no output file */
    • 0, /* no file type */
    • 0, /* no creator */
    • -1, /* script */
    • NIL, /* no resource ID */
    • createMovieFileDeleteCurFile |
    • showUserSettingsDialog |
    • movieToFileOnlyExport,
    • 0); /* no specific component */
    • // Saving a sound-only QuickTime movie as a WAVE file
    • // See "Discovering QuickTime," page 257
    • void SndSnip_SaveSoundMovieAsWAVEFile (Movie theMovie)
    • {
    • StandardFileReply myReply;
    • // have the user select the name and location of the new WAVE file
    • StandardPutFile("\pSave sound movie file as:",
    • "\pUntitled.wav", &myReply);
    • if (!myReply.sfGood)
    • return;
    • // use the default progress procedure, if any
    • SetMovieProgressProc(theMovie, (MovieProgressUPP)-1L, 0);
    • // export the movie into a file
    • ConvertMovieToFile( theMovie, // the movie to convert
    • NIL, // all tracks in the movie
    • &myReply.sfFile, // the output file
    • kQTFileTypeWave, // the output file type
    • FOUR_CHAR_CODE('TVOD'), // the output file creator
    • smSystemScript, // the script
    • NIL, // no resource ID
    • // to be returned
    • 0L, // no flags
    • NIL); // no specific component
    • }

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Киноафиши и предварительные просмотры фильма
  • GetTrackUsage GetTrackUsage (OS X v10.9)

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

    Объявление

    Objective C

    long GetTrackUsage ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

    Track флаги использования (см. ниже). Эти флаги могут быть объединены.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetTrackUsage SetTrackUsage (OS X v10.9)

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

    Объявление

    Objective C

    void SetTrackUsage ( Track theTrack, long usage );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    usage

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

    • trackUsageInMovie

    • trackUsageInPreview

    • trackUsageInPoster

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Фильмы и Ваш цикл событий
  • PtInMovie PtInMovie (OS X v10.9)

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

    Объявление

    Objective C

    Boolean PtInMovie ( Movie theMovie, Point pt );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    pt

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

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

    Если точка находится в фильме, возвращает TRUE.

    Обсуждение

    В текущее время фильма эта функция точна.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • PtInTrack PtInTrack (OS X v10.9)

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

    Объявление

    Objective C

    Boolean PtInTrack ( Track theTrack, Point pt );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    pt

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

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

    Если точка находится в выставочном пространстве дорожки, возвращает TRUE.

    Обсуждение

    В текущее время фильма эта функция точна.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Выбор обработчиков носителей
  • GetDataHandler GetDataHandler (OS X v10.9)

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

    Объявление

    Objective C

    Component GetDataHandler ( Handle dataRef, OSType dataHandlerSubType, long flags );

    Параметры

    dataRef

    Дескриптор к data ссылка. Тип информации, хранившей в дескрипторе, зависит от data ссылочный тип, указанный dataHandlerSubType параметр.

    dataHandlerSubType

    Идентифицирует и тип ссылки на данные и, косвенно, component выделите подтипы в значении, присвоенном компонентам обработчика данных, воздействующим на ссылки на данные того типа.

    flags

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

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

    Лучший компонент обработчика данных, соответствующий параметрам, передал в.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaDataHandler GetMediaDataHandler (OS X v10.9)

    Определяет обработчик данных носителей.

    Объявление

    Objective C

    DataHandler GetMediaDataHandler ( Media theMedia, short index );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    index

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

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

    Компонентный экземпляр обработчика данных.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaDataHandlerDescription GetMediaDataHandlerDescription (OS X v10.9)

    Получает информацию об обработчике данных носителей.

    Объявление

    Objective C

    void GetMediaDataHandlerDescription ( Media theMedia, short index, OSType *dhType, Str255 creatorName, OSType *creatorManufacturer );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    index

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

    dhType

    Указатель на поле типа данных OSType. Панель инструментов Фильма возвращается data идентификатор типа обработчика. Это значение указывает тип ссылки на данные, поддерживаемой этим обработчиком данных. Это значение также соответствует component подтип указан для компонента обработчика данных. Все ссылки на данные QuickTime имеют значение типа 'alis'. Если Вы не хотите получать эту информацию, установите этот параметр на NIL.

    creatorName

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

    creatorManufacturer

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaHandler GetMediaHandler (OS X v10.9)

    Получает ссылку на компонент обработчика носителей.

    Объявление

    Objective C

    MediaHandler GetMediaHandler ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

    Компонентный экземпляр обработчика носителей.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaHandlerDescription GetMediaHandlerDescription (OS X v10.9)

    Получает информацию об обработчике носителей.

    Объявление

    Objective C

    void GetMediaHandlerDescription ( Media theMedia, OSType *mediaType, Str255 creatorName, OSType *creatorManufacturer );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    mediaType

    Указатель на поле, в котором Панель инструментов Фильма возвращается media идентификатор типа (см. ниже). Это значение указывает тип носителей, поддерживаемых этим обработчиком носителей. Это значение также соответствует component подтип указан для компонента обработчика носителей. Если Вы не хотите получать эту информацию, установите mediaType параметр к NIL. Посмотрите эти константы:

    • VideoMediaType

    • SoundMediaType

    • TextMediaType

    creatorName

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

    creatorManufacturer

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

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

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

    Обсуждение

    Следующий пример кода иллюстрирует использование GetMediaHandlerDescription:

    • // GetMediaHandlerDescription coding example
    • // See "Discovering QuickTime," page 363
    • Movie movie1;
    • TimeValue lOldDuration;
    • Movie movie2;
    • long lIndex, lOrigTrackCount, lReferenceIndex;
    • Track track, trackSprite;
    • // get the first track in original movie and position at the start
    • trackSprite =GetMovieIndTrack(movie1, 1);
    • SetMovieSelection(movie1, 0, 0);
    • // remove all tracks except video in modifier movie
    • for (lIndex =1; lIndex <=GetMovieTrackCount(movie2); lIndex++) {
    • Track track =GetMovieIndTrack(movie2, lIndex);
    • OSType dwType;
    • GetMediaHandlerDescription(GetTrackMedia(track),
    • &dwType, NIL, NIL);
    • if (dwType !=VideoMediaType) {
    • DisposeMovieTrack(track);
    • lIndex--;
    • }
    • }
    • // add the modifier track to original movie
    • lOldDuration =GetMovieDuration(movie1);
    • AddMovieSelection(movie1, movie2);
    • DisposeMovie(movie2);
    • // truncate the movie to the length of the original track
    • DeleteMovieSegment(movie1, lOldDuration,
    • GetMovieDuration(movie1) - lOldDuration);
    • // associate the modifier track with the original sprite track
    • track =GetMovieIndTrack(movie1, lOrigTrackCount + 1);
    • AddTrackReference(trackSprite, track, kTrackModifierReference,
    • &lReferenceIndex);

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetMediaDataHandler SetMediaDataHandler (OS X v10.9)

    Присваивает обработчик данных носители.

    Объявление

    Objective C

    OSErr SetMediaDataHandler ( Media theMedia, short index, DataHandlerComponent dataHandler );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    index

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

    dataHandler

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

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetMediaHandler SetMediaHandler (OS X v10.9)

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

    Объявление

    Objective C

    OSErr SetMediaHandler ( Media theMedia, MediaHandlerComponent mH );

    Параметры

    theMedia

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    mH

    Ссылка на компонент обработчика носителей. Можно получить эту ссылку из GetMediaHandler.

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Отмена для фильмов
  • DisposeMovieEditState DisposeMovieEditState (OS X v10.9)

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

    Объявление

    Objective C

    OSErr DisposeMovieEditState ( MovieEditState state );

    Параметры

    state

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

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

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

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

    Необходимо избавиться от состояний редактирования фильма перед избавлением от самого фильма.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • NewMovieEditState NewMovieEditState (OS X v10.9)

    Создает состояние редактирования.

    Объявление

    Objective C

    MovieEditState NewMovieEditState ( Movie theMovie );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

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

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • UseMovieEditState UseMovieEditState (OS X v10.9)

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

    Объявление

    Objective C

    OSErr UseMovieEditState ( Movie theMovie, MovieEditState toState );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    toState

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Отмена для дорожек
  • DisposeTrackEditState DisposeTrackEditState (OS X v10.9)

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

    Объявление

    Objective C

    OSErr DisposeTrackEditState ( TrackEditState state );

    Параметры

    state

    Состояние редактирования для этой работы. Ваше приложение получает этот идентификатор состояния редактирования при создании состояния редактирования путем вызова NewTrackEditState функция.

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

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

    Обсуждение

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

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

    Необходимо избавиться от состояний редактирования дорожки фильма перед избавлением от дорожки или фильма.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • NewTrackEditState NewTrackEditState (OS X v10.9)

    Создает новое состояние редактирования для данной дорожки.

    Объявление

    Objective C

    TrackEditState NewTrackEditState ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • UseTrackEditState UseTrackEditState (OS X v10.9)

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

    Объявление

    Objective C

    OSErr UseTrackEditState ( Track theTrack, TrackEditState state );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    state

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Работа с альтернативными дорожками
  • GetMediaLanguage GetMediaLanguage (OS X v10.9)

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

    Объявление

    Objective C

    short GetMediaLanguage ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

    Язык носителей или код области.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaQuality GetMediaQuality (OS X v10.9)

    Возвращает значение уровня качества носителей.

    Объявление

    Objective C

    short GetMediaQuality ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

    Короткое целое, биты которого указывают качественные константы (см. ниже). Больше чем один из этих битов может быть установлен в 1.

    Обсуждение

    Панель инструментов Фильма использует это качественное значение для влияния, какую дорожку фильма это выбирает для игры на данном компьютере. Это даже применяется к звуковым носителям. Младший разряд 6 битов указывают пиксельные глубины и верхние 2 бита, указывает уровни качества. Если немного установлено в 1, носители могут играться на соответствующей глубине и уровне качества.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetTrackAlternate GetTrackAlternate (OS X v10.9)

    Определяет все дорожки в альтернативной группе.

    Объявление

    Objective C

    Track GetTrackAlternate ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

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

    Идентификатор дорожки следующей дорожки в группе.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SelectMovieAlternates SelectMovieAlternates (OS X v10.9)

    Дает Панели инструментов Фильма команду сразу выбрать надлежащие дорожки.

    Объявление

    Objective C

    void SelectMovieAlternates ( Movie theMovie );

    Параметры

    theMovie

    Идентификатор фильма. Ваше приложение получает этот идентификатор из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetAutoTrackAlternatesEnabled SetAutoTrackAlternatesEnabled (OS X v10.9)

    Включает или отключает автоматический выбор дорожки Панелью инструментов Фильма.

    Объявление

    Objective C

    void SetAutoTrackAlternatesEnabled ( Movie theMovie, Boolean enable );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    enable

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetMediaLanguage SetMediaLanguage (OS X v10.9)

    Устанавливает локализованный язык носителей или код области.

    Объявление

    Objective C

    void SetMediaLanguage ( Media theMedia, short language );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    language

    Язык носителей или код области.

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

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

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetMediaQuality SetMediaQuality (OS X v10.9)

    Устанавливает значение уровня качества носителей.

    Объявление

    Objective C

    void SetMediaQuality ( Media theMedia, short quality );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    quality

    Качественное значение носителей. Качественное значение указывает пиксельные глубины, в которых могут играться носители. Это даже применяется к звуковым носителям. Младший разряд 6 битов качественного значения соответствует определенным пиксельным глубинам. Если немного установлено в 1, носители могут играться на соответствующей глубине. Больше чем один из этих битов может быть установлен в 1. Панель инструментов Фильма использует это качественное значение для определения, какую дорожку это выбирает для игры на данном компьютере Macintosh. Необходимо установить это значение только при создании новых носителей.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetTrackAlternate SetTrackAlternate (OS X v10.9)

    Добавляют дорожки к, или удалите дорожки из, альтернативные группы.

    Объявление

    Objective C

    void SetTrackAlternate ( Track theTrack, Track alternateT );

    Параметры

    theTrack

    Дорожка и группа для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack. SetTrackAlternate изменения присоединение группы этой дорожки на основе значения alternateT параметр.

    alternateT

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Работа с выборками носителей
  • GetMediaDataSize GetMediaDataSize (OS X v10.9)

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

    Объявление

    Objective C

    long GetMediaDataSize ( Media theMedia, TimeValue startTime, TimeValue duration );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    startTime

    Временная стоимость, указывающая начальную точку сегмента.

    duration

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

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

    Размер, в байтах, демонстрационных данных в определенном участке среды.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaSampleCount GetMediaSampleCount (OS X v10.9)

    Определяет число выборок в носители.

    Объявление

    Objective C

    long GetMediaSampleCount ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

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

    Число выборок в носителях.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaSampleDescription GetMediaSampleDescription (OS X v10.9)

    Получает структуру SampleDescription от носители.

    Объявление

    Objective C

    void GetMediaSampleDescription ( Media theMedia, long index, SampleDescriptionHandle descH );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    index

    Индекс SampleDescription структура для получения. Этот индекс соответствует самой структуре, не к выборкам в носителях. Индексы запускаются с 1.

    descH

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

    Обсуждение

    Панель инструментов Фильма идентифицирует демонстрационные описания носителей с индексным значением, в пределах от 1 к числу демонстрационных описаний в носителях. Демонстрационные индексы описания обеспечивают удобный способ получить доступ к каждому демонстрационному описанию в носители. Можно получить доступ к ошибочным возвратам от этой функции до GetMoviesError и GetMoviesStickyError. Посмотрите Error Codes.

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

    Формат демонстрационных описаний отличается типом среды. Демонстрационные описания для данных изображения определяются ImageDescription структуры. Демонстрационные описания для звука определяются SoundDescription структуры. Демонстрационные описания для текста определяются TextDescription структуры.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMediaSampleDescriptionCount GetMediaSampleDescriptionCount (OS X v10.9)

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

    Объявление

    Objective C

    long GetMediaSampleDescriptionCount ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

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

    Число демонстрационных описаний в носителях.

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

    Формат демонстрационных описаний отличается типом среды. Демонстрационные описания для данных изображения определяются ImageDescription структуры. Демонстрационные описания для звука определяются SoundDescription структуры. Демонстрационные описания для текста определяются TextDescription структуры.

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetMovieDataSize GetMovieDataSize (OS X v10.9)

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

    Объявление

    Objective C

    long GetMovieDataSize ( Movie theMovie, TimeValue startTime, TimeValue duration );

    Параметры

    theMovie

    Фильм для этой работы. Вы получаете этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    startTime

    Временная стоимость, указывающая начальную точку сегмента.

    duration

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • GetTrackDataSize GetTrackDataSize (OS X v10.9)

    Определяет размер, в байтах, демонстрационных данных в сегменте дорожки.

    Объявление

    Objective C

    long GetTrackDataSize ( Track theTrack, TimeValue startTime, TimeValue duration );

    Параметры

    theTrack

    Дорожка для этой работы. Вы получаете этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    startTime

    Временная стоимость, указывающая начальную точку сегмента.

    duration

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

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

    Размер, в байтах, демонстрационных данных в сегменте дорожки.

    Обсуждение

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • MediaTimeToSampleNum MediaTimeToSampleNum (OS X v10.9)

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

    Объявление

    Objective C

    void MediaTimeToSampleNum ( Media theMedia, TimeValue time, long *sampleNum, TimeValue *sampleTime, TimeValue *sampleDuration );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    time

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

    sampleNum

    Указатель на длинное целое, которое должно получить демонстрационное число. Панель инструментов Фильма возвращает демонстрационное число, идентифицирующее выборку, содержащую данные в течение времени, указанного time параметр.

    sampleTime

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

    sampleDuration

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SampleNumToMediaTime SampleNumToMediaTime (OS X v10.9)

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

    Объявление

    Objective C

    void SampleNumToMediaTime ( Media theMedia, long logicalSampleNum, TimeValue *sampleTime, TimeValue *sampleDuration );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    logicalSampleNum

    Демонстрационное число.

    sampleTime

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

    sampleDuration

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

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

  • SetMediaSampleDescription SetMediaSampleDescription (OS X v10.9)

    Изменяет содержание определенной структуры SampleDescription указанные носители.

    Объявление

    Objective C

    OSErr SetMediaSampleDescription ( Media theMedia, long index, SampleDescriptionHandle descH );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    index

    Индекс SampleDescription структура, которая будет изменена. Этот индекс соответствует SampleDescription сама структура, не выборки в носителях. Это длинное целое должно быть между 1 и самое большое SampleDescription индекс.

    descH

    Дескриптор к SampleDescription структура. Если нет никакого описания для указанного индекса, функция возвращает этот неизменный дескриптор.

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

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

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

    Objective C

    @import QuickTime;

    Доступность

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

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

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

Работа со временем носителей
  • GetMediaDuration GetMediaDuration (OS X v10.9)

    Возвращает продолжительность носители.

    Объявление

    Objective C

    TimeValue GetMediaDuration ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

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

    Продолжительность носителей.

    Обсуждение

    Следующий пример кода иллюстрирует использование GetMediaDuration:

    • // GetMediaDuration coding example
    • // See "Discovering QuickTime," page 89
    • void CreateMyVideoTrack (Movie movie)
    • {
    • Track track;
    • Media media;
    • Rect rect ={0, 0, 100, 320};
    • track =NewMovieTrack(movie,
    • FixRatio(rect.right, 1),
    • FixRatio(rect.bottom, 1),
    • kNoVolume);
    • media =NewTrackMedia(track,
    • VideoMediaType,
    • 600, // video time scale
    • NIL, NIL);
    • BeginMediaEdits(media);
    • MyAddVideoSamplesToMedia(media, &rect); // assemble data
    • EndMediaEdits(media);
    • InsertMediaIntoTrack(track,
    • 0, // track start time
    • 0, // media start time
    • GetMediaDuration(media),
    • kFix1); // normal speed
    • }

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

    Objective C

    @import QuickTime;

    Доступность

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

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

    Не доступный 64-разрядным приложениям.

  • GetMediaTimeScale GetMediaTimeScale (OS X v10.9)

    Определяет масштаб времени носителей.

    Объявление

    Objective C

    TimeScale GetMediaTimeScale ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    Возвращаемое значение

    Масштаб времени носителей.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SetMediaTimeScale SetMediaTimeScale (OS X v10.9)

    Устанавливает масштаб времени носителей.

    Объявление

    Objective C

    void SetMediaTimeScale ( Media theMedia, TimeScale timeScale );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    timeScale

    Новый масштаб времени носителей.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам от этой функции до GetMoviesError и GetMoviesStickyError. Посмотрите Error Codes.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Работа с фильмом пространственные характеристики
  • GetTrackDimensions GetTrackDimensions (OS X v10.9)

    Определяет исходный прямоугольник дорожки.

    Объявление

    Objective C

    void GetTrackDimensions ( Track theTrack, Fixed *width, Fixed *height );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    width

    Указатель на число фиксированной точки. Панель инструментов Фильма возвращает ширину, в пикселях, прямоугольника дорожки. Это значение соответствует x координате нижнего правого угла прямоугольника дорожки.

    height

    Указатель на число фиксированной точки. Панель инструментов Фильма возвращает высоту, в пикселях, прямоугольника дорожки. Это значение соответствует y координате нижнего правого угла прямоугольника дорожки.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetTrackLayer GetTrackLayer (OS X v10.9)

    Получает уровень дорожки.

    Объявление

    Objective C

    short GetTrackLayer ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    Возвращаемое значение

    Число уровня указанной дорожки. Уровни с более низкими числами появляются перед уровнями с более высокими числами.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetTrackMatrix GetTrackMatrix (OS X v10.9)

    Получает матрицу преобразования дорожки.

    Объявление

    Objective C

    void GetTrackMatrix ( Track theTrack, MatrixRecord *matrix );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    matrix

    Указатель на a MatrixRecord структура. GetTrackMatrix функционируйте возвращает матрицу дорожки в структуру, именуемую этим параметром.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SetTrackDimensions SetTrackDimensions (OS X v10.9)

    Устанавливает исходный прямоугольник дорожки.

    Объявление

    Objective C

    void SetTrackDimensions ( Track theTrack, Fixed width, Fixed height );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    width

    Число фиксированной точки, указывающее ширину, в пикселях, прямоугольника дорожки. Это значение соответствует x координате нижнего правого угла прямоугольника дорожки.

    height

    Число фиксированной точки, указывающее высоту, в пикселях, прямоугольника дорожки. Это значение соответствует y координате нижнего правого угла прямоугольника дорожки.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам от этой функции до GetMoviesError и GetMoviesStickyError. Посмотрите Error Codes.

    Обсуждение

    При изменении размерностей существующей дорожки данные носителей масштабируются для вписывания в новый прямоугольник.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SetTrackLayer SetTrackLayer (OS X v10.9)

    Устанавливает уровень дорожки.

    Объявление

    Objective C

    void SetTrackLayer ( Track theTrack, short layer );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    layer

    Число уровня дорожки. Уровни пронумерованы от-32 768 до 32,767; уровни с более низкими числами появляются перед уровнями с более высокими числами. При создании новой дорожки Панель инструментов Фильма устанавливает свой номер дорожки в 0.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам от этой функции до GetMoviesError и GetMoviesStickyError. Посмотрите Error Codes.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SetTrackMatrix SetTrackMatrix (OS X v10.9)

    Устанавливает матрицу преобразования дорожки.

    Объявление

    Objective C

    void SetTrackMatrix ( Track theTrack, const MatrixRecord *matrix );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    matrix

    Указатель на a MatrixRecord структура, содержащая новую матрицу дорожки. Если Вы устанавливаете этот параметр на NIL, Панель инструментов Фильма использует единичную матрицу.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам от этой функции до GetMoviesError и GetMoviesStickyError. Посмотрите Error Codes.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Работа с демонстрационными таблицами QuickTime
  • AddSampleTableToMedia AddSampleTableToMedia (OS X v10.9)

    Добавляет демонстрационная таблица к носители.

    Объявление

    Objective C

    OSErr AddSampleTableToMedia ( Media theMedia, QTSampleTableRef sampleTable, SInt64 startSampleNum, SInt64 numberOfSamples, TimeValue64 *sampleDecodeTimeOut );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    sampleTable

    Ссылка на непрозрачный демонстрационный объект таблицы, содержащий демонстрационные ссылки, которые будут добавлены к носителям.

    startSampleNum

    Демонстрационное число первой демонстрационной ссылки в демонстрационной таблице, которая будет добавлена к носителям. Число первой выборки равняется 1.

    numberOfSamples

    Число демонстрационных ссылок от демонстрационной таблицы, которая будет добавлена к носителям.

    sampleDecodeTimeOut

    Указатель на временную стоимость. После добавления демонстрационных ссылок на носители функция возвращает время декодирования, где первая выборка была вставлена во временную стоимость, именуемую этим параметром. Если Вы не хотите получать эту информацию, установите этот параметр в NULL.

    Возвращаемое значение

    Код ошибки. Возвраты noErr если нет никакой ошибки. Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате.

    Обсуждение

    Эта функция может возвратить эти ошибки:

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • CopyMediaMutableSampleTable CopyMediaMutableSampleTable (OS X v10.9)

    Получает информацию о демонстрационных ссылках в носители в форме демонстрационной таблицы.

    Объявление

    Objective C

    OSErr CopyMediaMutableSampleTable ( Media theMedia, TimeValue64 startDecodeTime, TimeValue64 *sampleStartDecodeTime, SInt64 maxNumberOfSamples, TimeValue64 maxDecodeDuration, QTMutableSampleTableRef *sampleTableOut );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    startDecodeTime

    64-разрядная временная стоимость, представляющая стартовое время декодирования демонстрационных ссылок, которые будут получены. Необходимо указать это значение в масштабе времени носителей.

    sampleStartDecodeTime

    Указатель на временную стоимость. Функция обновляет эту временную стоимость для указания фактического времени декодирования первой возвращенной демонстрационной ссылки. Если Вы не интересуетесь этой информацией, установите этот параметр в NULL. Возвращенное время может отличаться со времени, которое Вы указали с startDecodeTime параметр. Это произойдет время при указании падений посреди выборки.

    maxNumberOfSamples

    64-разрядное целое число со знаком, содержащее максимальное количество демонстрационных ссылок, которые будут возвращены. При установке этого параметра на 0 Панель инструментов Фильма использует значение, которое является надлежащим носителям.

    maxDecodeDuration

    64-разрядная временная стоимость, представляющая максимальную продолжительность декодирования, которая будет возвращена. Функция не возвращает выборки с большей продолжительностью декодирования, чем Вы указываете с этим параметром. При установке этого параметра на 0 Панель инструментов Фильма использует значение, которое подходяще для носителей.

    sampleTableOut

    Ссылка на непрозрачный демонстрационный объект таблицы. Когда Вы сделаны с возвращенной демонстрационной таблицей, выпускаете ее с QTSampleTableRelease.

    Возвращаемое значение

    Код ошибки. Возвраты memFullErr если это не могло бы выделить память, paramErr если был недопустимый параметр, или noErr если нет никакой ошибки. Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате.

    Обсуждение

    Для обнаружения, сколько выборок было возвращено в демонстрационной таблице вызвать QTSampleTableGetNumberOfSamples.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Работа с громкостью звука
  • GetTrackVolume GetTrackVolume (OS X v10.9)

    Возвращает текущий параметр громкости дорожки.

    Объявление

    Objective C

    short GetTrackVolume ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    Возвращаемое значение

    Текущий параметр громкости указанной дорожки. Значения возвратились в высоком и низком диапазоне слов от 0x0000 (тишина) к 0x0100 (полный объем). Можно использовать константы (см. ниже) протестировать на полный объем и никакой объем.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SetTrackVolume SetTrackVolume (OS X v10.9)

    Регулирует текущую громкость дорожки.

    Объявление

    Objective C

    void SetTrackVolume ( Track theTrack, short volume );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    volume

    Текущий параметр громкости дорожки, представленной как 16-разрядное число фиксированной точки. Старший разряд 8 битов содержит целую часть значения; младший разряд 8 битов содержит дробную часть. Объем оценивает диапазон от-1.0 до 1,0. Отрицательные величины не играют звука, но сохраняют абсолютное значение параметра громкости. Можно использовать константы (см. ниже) для полного объема и никакого объема. Посмотрите эти константы:

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам от этой функции до GetMoviesError и GetMoviesStickyError. Посмотрите Error Codes.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Работа со ссылками дорожки
  • AddTrackReference AddTrackReference (OS X v10.9)

    Добавляет новая ссылка дорожки на дорожку.

    Объявление

    Objective C

    OSErr AddTrackReference ( Track theTrack, Track refTrack, OSType refType, long *addedIndex );

    Параметры

    theTrack

    Идентифицирует дорожку для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    refTrack

    Дорожка, которая будет идентифицирована в ссылке дорожки.

    refType

    Тип ссылки.

    addedIndex

    Указатель на длинное целое. Панель инструментов возвращает индексное значение, присвоенное новой ссылке дорожки. Если Вы не хотите эту информацию, установите этот параметр на NIL.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Обсуждение

    Следующий фрагмент кода показывает как AddTrackReference может использоваться для добавления ссылки дорожки модификатора на дорожку спрайта.

    • // AddTrackReference coding example
    • // See "Discovering QuickTime," page 363
    • Movie movie1;
    • TimeValue lOldDuration;
    • Movie movie2;
    • long lIndex, lOrigTrackCount, lReferenceIndex;
    • Track track, trackSprite;
    • // get the first track in original movie and position at the start
    • trackSprite =GetMovieIndTrack(movie1, 1);
    • SetMovieSelection(movie1, 0, 0);
    • // remove all tracks except video in modifier movie
    • for (lIndex =1; lIndex <=GetMovieTrackCount(movie2); lIndex++) {
    • Track track =GetMovieIndTrack(movie2, lIndex);
    • OSType dwType;
    • GetMediaHandlerDescription(GetTrackMedia(track),
    • &dwType, NIL, NIL);
    • if (dwType !=VideoMediaType) {
    • DisposeMovieTrack(track);
    • lIndex--;
    • }
    • }
    • // add the modifier track to original movie
    • lOldDuration =GetMovieDuration(movie1);
    • AddMovieSelection(movie1, movie2);
    • DisposeMovie(movie2);
    • // truncate the movie to the length of the original track
    • DeleteMovieSegment(movie1, lOldDuration,
    • GetMovieDuration(movie1) - lOldDuration);
    • // associate the modifier track with the original sprite track
    • track =GetMovieIndTrack(movie1, lOrigTrackCount + 1);
    • AddTrackReference(trackSprite, track, kTrackModifierReference,
    • &lReferenceIndex);

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • DeleteTrackReference DeleteTrackReference (OS X v10.9)

    Удаляет ссылку дорожки из дорожки.

    Объявление

    Objective C

    OSErr DeleteTrackReference ( Track theTrack, OSType refType, long index );

    Параметры

    theTrack

    Идентифицирует дорожку для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    refType

    Тип ссылки.

    index

    Индексное значение ссылки, которая будет удалена. Вы получаете это индексное значение при создании ссылки дорожки.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Обсуждение

    Эта функция удаляет ссылку дорожки из дорожки. Если существуют дополнительные ссылки дорожки с более высокими индексными значениями, панель инструментов автоматически перенумеровывает те ссылки, постепенно уменьшая их индексные значения 1.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetNextTrackReferenceType GetNextTrackReferenceType (OS X v10.9)

    Определяет все ссылочные типы дорожки, определяющиеся для данной дорожки.

    Объявление

    Objective C

    OSType GetNextTrackReferenceType ( Track theTrack, OSType refType );

    Параметры

    theTrack

    Идентифицирует дорожку для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    refType

    Тип ссылки. Установите этот параметр на 0 для получения первого ссылочного типа дорожки. По последующим запросам используйте предыдущее значение, возвращенное этой функцией.

    Возвращаемое значение

    OSType содержание следующего значения ссылочного типа дорожки определяется для дорожки; посмотрите Data References.

    Обсуждение

    Нет никакого подразумеваемого упорядочивания значений, возвращенных этой функцией. При достижении конца ссылочных типов дорожки эта функция устанавливает возвращенное значение в 0.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetTrackReference GetTrackReference (OS X v10.9)

    Получает идентификатор дорожки, содержавшийся в существующей ссылке дорожки.

    Объявление

    Objective C

    Track GetTrackReference ( Track theTrack, OSType refType, long index );

    Параметры

    theTrack

    Идентифицирует дорожку для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    refType

    Тип ссылки; посмотрите Data References.

    index

    Индексное значение ссылки найдено. Вы получаете это индексное значение при создании ссылки дорожки.

    Возвращаемое значение

    Идентификатор дорожки для указанной дорожки. Если панель инструментов не может определить местоположение ссылочного соответствия дорожки Вашим спецификациям, это возвращает значение NIL.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetTrackReferenceCount GetTrackReferenceCount (OS X v10.9)

    Определяет, сколько ссылок дорожки данного типа существует для дорожки.

    Объявление

    Objective C

    long GetTrackReferenceCount ( Track theTrack, OSType refType );

    Параметры

    theTrack

    Идентифицирует дорожку для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    refType

    Тип ссылки; посмотрите Data References. Панель инструментов определяет число ссылок дорожки этого типа.

    Возвращаемое значение

    Длинное целое, указывающее число ссылок дорожки указанного типа в дорожке. Если нет никаких ссылок типа, Вы указали, функция возвращает значение 0.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SetTrackReference SetTrackReference (OS X v10.9)

    Изменяет существующую ссылку дорожки.

    Объявление

    Objective C

    OSErr SetTrackReference ( Track theTrack, Track refTrack, OSType refType, long index );

    Параметры

    theTrack

    Идентифицирует дорожку для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    refTrack

    Дорожка, которая будет идентифицирована в ссылке дорожки. Панель инструментов использует эту информацию для обновления существующей ссылки дорожки.

    refType

    Тип ссылки.

    index

    Индексное значение ссылки, которая будет изменена. Вы получаете это индексное значение при создании ссылки дорожки.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Обсуждение

    Можно изменить ссылку дорожки так, чтобы она идентифицировала различную дорожку в фильме.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Работа со звуком дорожки
  • GetTrackSoundLocalizationSettings GetTrackSoundLocalizationSettings (OS X v10.9)

    Возвращает дескриптор копии текущих 3D звуковых настроек для указанной дорожки.

    Объявление

    Objective C

    OSErr GetTrackSoundLocalizationSettings ( Track theTrack, Handle *settings );

    Параметры

    theTrack

    Идентифицирует дорожку для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    settings

    Дескриптор к копии текущих 3D звуковых настроек для указанной дорожки, в формате SSpLocalizationData запись. Если нет никаких 3D звуковых настроек, возвращенный дескриптор установлен в NIL.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Специальные замечания

    Вызывающая сторона этой функции ответственна за избавление от возвращенного дескриптора.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SetTrackSoundLocalizationSettings SetTrackSoundLocalizationSettings (OS X v10.9)

    Применяет 3D данные звукового эффекта к дорожке.

    Объявление

    Objective C

    OSErr SetTrackSoundLocalizationSettings ( Track theTrack, Handle settings );

    Параметры

    theTrack

    Идентифицирует дорожку для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    settings

    Дескриптор к настройкам Вы хотите применяться в формате SSpLocalizationData запись. Можно передать a NIL дескриптор, чтобы указать, что никакие 3D звуковые эффекты не должны использоваться для этой дорожки. Эта функция делает копию дескриптора переданной, таким образом, вызывающая сторона ответственна за избавление от него.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Обсуждение

    Эта функция заменяет 3D звуковые настройки для указанной дорожки с новым SSpLocalizationData запись, содержавшаяся в settings параметр. Эффект новой 3D звуковой установки сразу имеет место. Даже если дорожка или компьютер не способны к фактическому удовлетворению запросу, этот вызов всегда хранит новую переданную запись. Когда фильм сохраняется, 3D звуковые настройки сохраняются с ним.

    Следующий пример кода показывает, как установить статическую 3D звуковую установку для дорожки с помощью этой функции:

    • // SetTrackSoundLocalizationSettings coding example
    • void setTrackSoundLocalization(Track t)
    • {
    • SSpLocalizationData loc;
    • Handle h;
    • OSErr err;
    • loc.cpuLoad =0;
    • loc.medium =kSSpMedium_Air;
    • loc.humidity =0;
    • loc.roomSize =250;
    • loc.roomReflectivity =-5;
    • loc.reverbAttenuation =-5;
    • loc.sourceMode =kSSpSourceMode_Localized;
    • loc.referenceDistance =1;
    • loc.coneAngleCos =0;
    • loc.coneAttenuation =0;
    • loc.currentLocation.elevation =0;
    • loc.currentLocation.azimuth =0;
    • loc.currentLocation.distance =2;
    • loc.currentLocation.projectionAngle =0;
    • loc.currentLocation.sourceVelocity =0;
    • loc.currentLocation.listenerVelocity =0;
    • loc.reserved0 =0;
    • loc.reserved1 =0;
    • loc.reserved2 =0;
    • loc.reserved3 =0;
    • loc.virtualSourceCount =0;
    • err =PtrToHand(&loc, &h, sizeof(loc));
    • err =SetTrackSoundLocalizationSettings(t, h);
    • DisposeHandle(h);
    • }

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Работа со временем дорожки
  • GetTrackDuration GetTrackDuration (OS X v10.9)

    Возвращает продолжительность дорожки.

    Объявление

    Objective C

    TimeValue GetTrackDuration ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    Возвращаемое значение

    Продолжительность указанной дорожки, выраженной в масштабе времени фильма, содержащего дорожку.

    Обсуждение

    Продолжительность соответствует времени окончания дорожки в системе координат времени фильма (помните, что все дорожки запускаются во время фильма 0).

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetTrackOffset GetTrackOffset (OS X v10.9)

    Определяет разницу во времени между запуском дорожки и запуском фильма, содержащего дорожку.

    Объявление

    Objective C

    TimeValue GetTrackOffset ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    Возвращаемое значение

    Разница во времени между запуском указанной дорожки и запуском фильма, содержащего дорожку.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SetTrackOffset SetTrackOffset (OS X v10.9)

    Изменяет продолжительность вакуума, находящегося в начале дорожки, таким образом изменяя продолжительность всей дорожки.

    Объявление

    Objective C

    void SetTrackOffset ( Track theTrack, TimeValue movieOffsetTime );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    movieOffsetTime

    Смещение дорожки от запуска фильма, и должно быть выражено в масштабе времени фильма, содержащего дорожку.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам от этой функции до GetMoviesError и GetMoviesStickyError. Посмотрите Error Codes.

    Обсуждение

    Все дорожки в фильме используют систему координат времени фильма. Т.е. масштаб времени фильма определяет основную единицу измерения времени для каждой из дорожек фильма. Каждая дорожка начинается в начале фильма, но данные дорожки не могли бы начаться до некоторой временной стоимости кроме 0. Это прошедшее время представлено пробелом. В аудиотреке пробел переводит в тишину; в видеотреке пробел не генерирует визуального изображения. Каждая дорожка имеет свою собственную продолжительность. Эта продолжительность не должна соответствовать продолжительности фильма. Продолжительность фильма всегда равняется максимальной продолжительности всех дорожек.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • TrackTimeToMediaTime TrackTimeToMediaTime (OS X v10.9)

    Преобразовывает временную стоимость дорожки во временную стоимость, которая является надлежащей носителям дорожки, с помощью списка редактирования дорожки.

    Объявление

    Objective C

    TimeValue TrackTimeToMediaTime ( TimeValue value, Track theTrack );

    Параметры

    value

    Временная стоимость дорожки; должен быть выражен в масштабе времени фильма, содержащего дорожку.

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    Возвращаемое значение

    Временная стоимость дорожки, но в системе координат времени носителей. Если время дорожки соответствует вакууму, эта функция возвращает значение-1.

    Обсуждение

    Эта функция отображает время дорожки через список редактирования дорожки для придумывания времени носителей. Эта временная стоимость содержит временную стоимость дорожки согласно системе координат времени носителей. Если время, которое Вы указали, находится за пределами активного сегмента фильма или соответствует вакууму в дорожке, эта функция возвращает значение-1. Следовательно можно использовать его, чтобы определить, пусто ли указанное редактирование дорожки.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Работа с пользовательскими данными
  • GetMediaUserData GetMediaUserData (OS X v10.9)

    Получает доступ к пользовательскому списку данных носителей.

    Объявление

    Objective C

    UserData GetMediaUserData ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    Возвращаемое значение

    Пользовательский список данных носителей.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetTrackUserData GetTrackUserData (OS X v10.9)

    Получает доступ к пользовательскому списку данных дорожки.

    Объявление

    Objective C

    UserData GetTrackUserData ( Track theTrack );

    Параметры

    theTrack

    Дорожка для этой работы. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack.

    Возвращаемое значение

    Ссылка на пользовательские данные указанной дорожки. Если функция не могла бы определить местоположение пользовательских данных дорожки, она устанавливает это возвращенное значение в NIL.

    Обсуждение

    Эта функция возвращает ссылку на пользовательский список данных дорожки, который допустим, пока Вы не избавляетесь от дорожки. При сохранении дорожки Панель инструментов Фильма сохраняет пользовательские данные также.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Поддержка функций
  • AddClonedTrackToMovie AddClonedTrackToMovie (OS X v10.9)

    Создает клон существующей дорожки в фильме.

    Объявление

    Objective C

    OSErr AddClonedTrackToMovie ( Track srcTrack, Movie dstMovie, long flags, Track *dstTrack );

    Параметры

    sourceTrack

    Указывает дорожку, которая будет клонирована. Ваше приложение получает этот идентификатор дорожки из таких функций как NewMovieTrack и GetMovieTrack. Это - источник демонстрационной таблицы, как только создается клонированная дорожка.

    destinationMovie

    Указывает фильм, где должна быть создана клонированная дорожка. Ваше приложение получает этот идентификатор из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle. В настоящее время это должно быть фильмом, содержащим исходную дорожку.

    flags

    Флаги (см. ниже), которые определяют, как должно быть выполнено клонирование. В настоящее время необходимо передавать kQTCloneShareSamples. Посмотрите эти константы:

    • kQTCloneShareSamples

    • kQTCloneDontCopyEdits

    dstTrack

    Адрес хранения, куда возвращается ссылка на недавно созданную дорожку. Если функция перестала работать, это хранение установлено в NIL.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Специальные замечания

    Большинство разработчиков QuickTime никогда не должно должно быть вызывать эту функцию.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • AddMediaSampleFromEncodedFrame AddMediaSampleFromEncodedFrame (OS X v10.9)

    Добавляют демонстрационные данные и описание от закодированного кадра до носители.

    Объявление

    Objective C

    OSErr AddMediaSampleFromEncodedFrame ( Media theMedia, ICMEncodedFrameRef encodedFrame, TimeValue64 *sampleDecodeTimeOut );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia

    encodedFrame

    Закодированный маркер кадра, возвращенный ICMCompressionSequence.

    sampleDecodeTimeOut

    Указатель на временную стоимость. После добавления демонстрационных данных к носителям функция возвращает время декодирования, где первая выборка была вставлена во временную стоимость, именуемую этим параметром. Если Вы не хотите получать эту информацию, установите этот параметр в NULL.

    Возвращаемое значение

    Код ошибки. Возвраты noErr если нет никакой ошибки. Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате.

    Обсуждение

    Это - удобство API, чтобы упростить добавлять кадры, испускаемые новыми функциями сжатия ICM к носителям. Это может возвратить эти ошибки:

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • AddMediaSampleReferences64 AddMediaSampleReferences64 (OS X v10.9)

    Обеспечивает 64-разрядную версию AddMediaSampleReferences.

    Объявление

    Objective C

    OSErr AddMediaSampleReferences64 ( Media theMedia, SampleDescriptionHandle sampleDescriptionH, long numberOfSamples, SampleReference64Ptr sampleRefs, TimeValue *sampleTime );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. Некоторые структуры носителей могут потребовать демонстрационных описаний. Существуют различные описания для различных типов выборок. Например, носители, который содержит сжатое видео, требуют, чтобы Вы предоставили ImageDescription структура. Носители, который содержит звук, требуют, чтобы Вы предоставили звуковую структуру описания. Если Вы не хотите SampleDescription структура, установленная этот параметр на NIL.

    numberOfSamples

    Число SampleReference64Record структуры, на которые указывают sampleRefs параметр. Каждая структура может содержать одну или более непрерывных выборок. Для получения дополнительной информации посмотрите AddMediaSample.

    sampleRefs

    Указатель на число SampleReference64Record структуры, указанные numberOfSamples параметр.

    sampleTime

    Указатель на временную стоимость. После добавления ссылки на носители, AddMediaSampleReferences функционируйте возвращает время, где ссылка была вставлена, с помощью масштаба времени, именуемого этим параметром. Если Вы не хотите получать эту информацию, установите этот параметр на NIL.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Обсуждение

    Единственная разница между этой функцией и AddMediaSampleReferences это sampleRefs параметр указывает на структуры SampleReference64Record вместо SampleReferenceRecord структуры.

    Специальные замечания

    Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ConvertDataRefToMovieDataRef ConvertDataRefToMovieDataRef (OS X v10.9)

    Преобразовывает часть данных в месте хранения к формату файла ролика и хранит его в другом месте хранения, поддерживая пользовательское диалоговое окно настроек для операций импорта.

    Объявление

    Objective C

    OSErr ConvertDataRefToMovieDataRef ( Handle inputDataRef, OSType inputDataRefType, Handle outputDataRef, OSType outputDataRefType, OSType creator, long flags, ComponentInstance userComp, MovieProgressUPP proc, long refCon );

    Параметры

    inputDataRef

    Ссылка на данные, указывающая место хранения исходных данных.

    inputDataRefType

    Тип входной ссылки на данные.

    outputDataRef

    Ссылка на данные, указавшая место хранения для получения преобразованных данных.

    outputDataRefType

    Тип ссылки выходных данных.

    creator

    Тип создателя выходного места хранения.

    flags

    Флаги (см. ниже), которые управляют работой диалогового окна. Посмотрите эти константы:

    • createMovieFileDeleteCurFile

    • movieToFileOnlyExport

    • movieFileSpecValid

    • showUserSettingsDialog

    userComp

    Экземпляр компонента, который будет использоваться для преобразования данных фильма.

    proc

    Функция обратного вызова прогресса; посмотрите MovieProgressProc в QuickTime ссылка API.

    refCon

    Ссылочная константа, которая будет передана Вашему обратному вызову. Используйте этот параметр для указания на структуру данных, содержащую любую информацию функциональные потребности.

    Возвращаемое значение

    Посмотрите Error Codes в QuickTime ссылка API. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Эта функция преобразовывает часть данных в месте хранения в фильм и хранилищах в другое место хранения. И ввод и выходные места хранения указаны через ссылки на данные. Если место хранения будет в локальной файловой системе, то файл будет иметь указанного создателя. Если указано как таковой во флагах, функция выводит на экран диалоговое окно, позволяющее пользователю для выбора выходного файла и типа экспорта. Если компонент экспорта (или его экземпляр) указан в userComp, это будет использоваться для работы преобразования.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • ConvertMovieToDataRef ConvertMovieToDataRef (OS X v10.9)

    Преобразовывает указанный фильм (или одноколейный путь в фильме) в указанный формат файла и хранит его в указанном месте хранения.

    Объявление

    Objective C

    OSErr ConvertMovieToDataRef ( Movie m, Track onlyTrack, Handle dataRef, OSType dataRefType, OSType fileType, OSType creator, long flags, ComponentInstance userComp );

    Параметры

    theMovie

    Фильм для этой работы. Ваше приложение получает этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    onlyTrack

    Дорожка в исходном фильме, если Вы хотите преобразовать только одноколейный путь.

    dataRef

    Ссылка на данные, указывающая место хранения для получения преобразованных данных фильма.

    dataRefType

    Тип ссылки на данные. Эта функция в настоящее время поддерживает только ссылки на данные псевдонима.

    fileType

    Тип файла Mac OS места хранения, определяющего формат экспорта.

    creator

    Тип создателя места хранения.

    flags

    Флаги (см. ниже), которые управляют работой диалогового окна. Посмотрите эти константы:

    • showUserSettingsDialog

    • movieToFileOnlyExport

    • movieFileSpecValid

    userComp

    Экземпляр компонента, который будет использоваться для преобразования данных фильма.

    Возвращаемое значение

    Посмотрите Error Codes в QuickTime ссылка API. Возвраты noErr если нет никакой ошибки.

    Обсуждение

    Если место хранения будет в локальной файловой системе, то файл будет иметь указанный тип файла и создателя. Если указано как таковой во флагах, функция выводит на экран диалоговое окно, позволяющее пользователю выбрать выходной файл и тип экспорта. Если компонент экспорта (или его экземпляр) указан в userComp параметр, это будет использоваться для выполнения работы преобразования.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetMediaDataSize64 GetMediaDataSize64 (OS X v10.9)

    Обеспечивает 64-разрядную версию GetMediaDataSize.

    Объявление

    Objective C

    OSErr GetMediaDataSize64 ( Media theMedia, TimeValue startTime, TimeValue duration, wide *dataSize );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    startTime

    Временная стоимость, указывающая начальную точку сегмента.

    duration

    Временная стоимость, указывающая продолжительность сегмента.

    dataSize

    Размер, в байтах, демонстрационных данных в определенном участке среды.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Обсуждение

    Единственная разница между этой функцией и GetMediaDataSize это dataSize параметр возвращает 64-разрядное целое число вместо функции, возвращая 32-разрядное целое число.

    Специальные замечания

    Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetMediaSample2 GetMediaSample2 (OS X v10.9)

    Получает демонстрационные данные от медиа-файла.

    Объявление

    Objective C

    OSErr GetMediaSample2 ( Media theMedia, UInt8 *dataOut, ByteCount maxDataSize, ByteCount *size, TimeValue64 decodeTime, TimeValue64 *sampleDecodeTime, TimeValue64 *decodeDurationPerSample, TimeValue64 *displayOffset, SampleDescriptionHandle sampleDescriptionH, ItemCount *sampleDescriptionIndex, ItemCount maxNumberOfSamples, ItemCount *numberOfSamples, MediaSampleFlags *sampleFlags );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    dataOut

    Указатель на буфер для получения демонстрационных данных. Буфер должен быть достаточно большим для содержания, по крайней мере, maxDataSize байты. Если Вы не хотите получать демонстрационные данные, передайте NULL.

    maxDataSize

    Максимальное количество байтов, выделенных для содержания демонстрационных данных.

    size

    Указатель на память, куда функция возвращает число байтов демонстрационных данных, возвратился в области памяти, указанной dataOut. Установите этот параметр в NULL, если Вы не интересуетесь этой информацией.

    decodeTime

    Время начала выборки, которая будет получена во время декодирования. Необходимо указать это значение в масштабе времени носителей.

    sampleDecodeTime

    Указатель на временную стоимость во время декодирования. Функция обновляет эту временную стоимость для указывания фактического времени возвращенных демонстрационных данных. (Возвращенное время может отличаться со времени, которое Вы указали с time параметр. Это произойдет время при указании падений посреди выборки.), Если Вы не интересуетесь этой информацией, устанавливает этот параметр в NULL.

    decodeDurationPerSample

    Указатель на временную стоимость во время декодирования. Панель инструментов Фильма возвращает продолжительность каждой выборки в media. Установите этот параметр в NULL, если Вы не хотите эту информацию.

    displayOffset

    Указатель на временную стоимость. Функция обновляет эту временную стоимость для указания смещения дисплея возвращенной выборки. Эта временная стоимость выражена в масштабе времени носителей. Установите этот параметр в NULL, если Вы не хотите эту информацию.

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. Функция возвращает демонстрационное описание, соответствующее возвращенным демонстрационным данным. Функция изменяет размеры этого дескриптора как надлежащего. Если Вы не хотите a SampleDescription структура, установленная этот параметр на NIL.

    sampleDescriptionIndex

    Указатель на длинное целое. Функция возвращает индексное значение SampleDescription структура, соответствующая возвращенным демонстрационным данным. Можно получить структуру путем вызова GetMediaSampleDescription и передача этого индекса в descH параметр. Если Вы не хотите эту информацию, установите этот параметр на NIL.

    maxNumberOfSamples

    Максимальное количество выборок, которые будут возвращены. Панель инструментов Фильма не возвращает больше выборок, чем Вы указываете с этим параметром. При установке этого параметра на 0 Панель инструментов Фильма использует значение, которое подходяще для носителей и возвратов, оценивающих в поле, на которое ссылаются numberOfSamples параметр.

    numberOfSamples

    Указатель на длинное целое. Функция обновляет поле, именуемое этим параметром с числом выборок, которые это фактически возвращает. Если Вы не хотите эту информацию, установите этот параметр в NULL.

    sampleFlags

    Указатель на короткое целое, в котором функция возвращает флаги, описывающие выборку. Неиспользованные флаги установлены в 0. Если Вы не хотите эту информацию, установите этот параметр в NULL: mediaSampleNotSync Этот флаг установлен в 1, если выборка не является синхронизирующей выборкой и к 0, если выборка является синхронизирующей выборкой. Посмотрите эти константы:

    • mediaSampleNotSync

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError. Это возвращается paramErr если существует плохое значение параметра, maxSizeToGrowTooSmall если демонстрационные данные больше, чем maxDataSize, или noErr если нет никакой ошибки.

    Обсуждение

    Принимая во внимание, что GetMediaSample берет изменяемого размера Handle и a maxSizeToGrow параметр, GetMediaSample2 берет указатель и a maxDataSize параметр. Если Вы хотите считать выборку в a Handle, можно использовать следующий код:

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetMediaSampleReferences64 GetMediaSampleReferences64 (OS X v10.9)

    Обеспечивает 64-разрядную версию GetMediaSampleReferences.

    Объявление

    Objective C

    OSErr GetMediaSampleReferences64 ( Media theMedia, TimeValue time, TimeValue *sampleTime, SampleDescriptionHandle sampleDescriptionH, long *sampleDescriptionIndex, long maxNumberOfEntries, long *actualNumberofEntries, SampleReference64Ptr sampleRefs );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    time

    Время начала демонстрационных ссылок, которые будут получены. Необходимо указать это значение в масштабе времени носителей.

    sampleTime

    Указатель на временную стоимость. GetMediaSampleReferences64 обновляет эту временную стоимость для указывания фактического времени первых возвращенных демонстрационных данных. Если Вы не интересуетесь этой информацией, установите этот параметр на NIL.

    sampleDescriptionH

    Дескриптор к a SampleDescription структура. GetMediaSampleReference возвращает демонстрационное описание, соответствующее возвращенным демонстрационным данным. Функция изменяет размеры этого дескриптора как надлежащего. GetMediaSampleReferences только возвращает единственную структуру. Если демонстрационное описание изменяется в носителях, GetMediaSampleReferences возвраты только столько же выборок сколько использование единственное демонстрационное описание. Необходимо вызвать его снова для получения следующей группы выборок с помощью следующего демонстрационного описания. Если Вы не хотите SampleDescription структура, установленная этот параметр на NIL.

    sampleDescriptionIndex

    Указатель на длинное целое. GetMediaSampleReferences64 возвращает индексное значение демонстрационным описаниям, соответствующим возвращенным демонстрационным данным. Используйте этот индекс для получения демонстрационных описаний носителей с GetMediaSampleDescription. Если Вы не хотите эту информацию, установите этот параметр на NIL.

    maxNumberOfEntries

    Максимальное количество записей, которые будут возвращены. Демонстрационный ссылочный указатель, предоставленный sampleRefs параметр должен быть достаточно большим для получения числа записей, указанных этим параметром. Панель инструментов не возвращает больше записей, чем Вы указываете с этим параметром. Это может, однако, возвратить меньше.

    actualNumberofEntries

    Указатель на длинное целое. GetMediaSampleReferences64 обновляет поле, именуемое этим параметром с числом записей, именуемых возвращенной ссылкой.

    sampleRefs

    Указатель на число SampleReference64Record структуры, указанные в maxNumberOfEntries параметр. По возврату из этого вызова число демонстрационных контрольных записей, обозначенных значением, возвратилось в actualNumberofEntries будет заполнено в.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Обсуждение

    Единственная разница между этой функцией и GetMediaSampleReferences это sampleRefs параметр указывает на структуры SampleReference64Record вместо SampleReferenceRecord структуры.

    Специальные замечания

    Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetMediaSyncSampleCount GetMediaSyncSampleCount (OS X v10.9)

    Получает число синхронизирующих выборок в носители.

    Объявление

    Objective C

    long GetMediaSyncSampleCount ( Media theMedia );

    Параметры

    theMedia

    Носители для этой работы. Ваше приложение получает этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia. Посмотрите Media Identifiers.

    Возвращаемое значение

    Число синхронизирующих выборок в носителях.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetMovieDataSize64 GetMovieDataSize64 (OS X v10.9)

    Обеспечивает 64-разрядную версию GetMovieDataSize.

    Объявление

    Objective C

    OSErr GetMovieDataSize64 ( Movie theMovie, TimeValue startTime, TimeValue duration, wide *dataSize );

    Параметры

    theMovie

    Фильм для этой работы. Вы получаете этот идентификатор фильма из таких функций как NewMovie, NewMovieFromFile, и NewMovieFromHandle.

    startTime

    Временная стоимость, указывающая начальную точку сегмента.

    duration

    Временная стоимость, указывающая продолжительность сегмента.

    data size

    Размер, в байтах, демонстрационных данных в определенном сегменте определяемого фильма.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Обсуждение

    Единственная разница между этой функцией и GetMovieDataSize это dataSize параметр является 64-разрядным целым числом вместо 32-разрядного целого числа.

    Специальные замечания

    Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetMovieImporterForDataRef GetMovieImporterForDataRef (OS X v10.9)

    Получает компонент средства импорта фильма для фильма.

    Объявление

    Objective C

    OSErr GetMovieImporterForDataRef ( OSType dataRefType, Handle dataRef, long flags, Component *importer );

    Параметры

    dataRefType

    Тип ссылки на данные; посмотрите Data References.

    dataRef

    Дескриптор к data ссылка. Тип информации, хранившей в дескрипторе, зависит от data ссылочный тип, указанный dataRefType.

    flags

    Флаги (см. ниже), которые изменяют поведение этой функции. Посмотрите эти константы:

    • kGetMovieImporterDontConsiderGraphicsImporters

    importer

    Указатель на компонент средства импорта, который может импортировать фильм. Возвраты NIL если не может быть найдено никакое средство импорта.

    Возвращаемое значение

    Если этой функции позволяют использовать async вызовы (будучи переданным kGetMovieImporterUseAsyncCalls в flags параметр), это возвращается notEnoughDataErr если это блокировало бы. Можно получить доступ к этому ошибочному возврату через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Для других ошибок посмотрите Error Codes.

    Обсуждение

    Можно использовать GetMovieImporterForDataRef определить, может ли файл быть открыт QuickTime как фильм (например, в работе перетаскивания), как проиллюстрировано ниже:

    • AliasHandle alias;
    • MovieImportComponent mi;
    • NewAliasMinimal(&reply.sfFile, &alias);
    • GetMovieImporterForDataRef(rAliasType, (Handle)alias,
    • kGetMovieImporterDontConsiderGraphicsImporters, &mi);
    • DisposeHandle((Handle)alias);
    • if (mi !=NIL) {
    • // this file can be opened as a movie
    • . . .
    • }

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetTrackDataSize64 GetTrackDataSize64 (OS X v10.9)

    Обеспечивает 64-разрядную версию GetTrackDataSize.

    Объявление

    Objective C

    OSErr GetTrackDataSize64 ( Track theTrack, TimeValue startTime, TimeValue duration, wide *dataSize );

    Параметры

    theTrack

    Идентификатор дорожки. Ваше приложение получает этот идентификатор из таких функций как NewMovieTrack и GetMovieTrack.

    startTime

    Временная стоимость, указывающая начальную точку сегмента.

    duration

    Временная стоимость, указывающая продолжительность сегмента.

    dataSize

    Размер, в байтах, демонстрационных данных в сегменте дорожки. Эта функция считает каждое использование выборки. Т.е. если дорожка использует данную выборку несколько раз, размер той выборки включен в возвращенное значение размера одно время для каждого использования. Следовательно, возвращенный размер больше, чем или равен фактическому размеру демонстрационных данных дорожки.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Обсуждение

    Единственная разница между этой функцией и GetTrackDataSize тот размер демонстрационных данных, возвращается как 64-разрядное целое число в dataSize параметр вместо как 32-разрядное целое число, возвращенное функцией.

    Специальные замечания

    Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • GetTrackEditRate64 GetTrackEditRate64 (OS X v10.9)

    Возвращает уровень редактирования дорожки указанной дорожки в указанное время.

    Объявление

    Objective C

    Fixed GetTrackEditRate64 ( Track theTrack, TimeValue64 atTime );

    Параметры

    theTrack

    Идентификатор дорожки, который Ваше приложение получает из таких функций как NewMovieTrack и GetMovieTrack.

    atTime

    64-разрядная временная стоимость, указывающая время в который уровень редактирования дорожки (дорожки, идентифицированной в параметре theTrack) должен быть определен.

    Возвращаемое значение

    Уровень редактирования дорожки указанной дорожки в требуемое время.

    Обсуждение

    Эта функция полезна, если Вы продвигаетесь посредством редактирований дорожки непосредственно в Вашем приложении или если Вы - клиент основного обработчика носителей QuickTime.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • OpenADataHandler OpenADataHandler (OS X v10.9)

    Открывает компонент обработчика данных.

    Объявление

    Objective C

    OSErr OpenADataHandler ( Handle dataRef, OSType dataHandlerSubType, Handle anchorDataRef, OSType anchorDataRefType, TimeBase tb, long flags, ComponentInstance *dh );

    Параметры

    dataRef

    Дескриптор к ссылке на данные. Тип информации, хранившей в дескрипторе, зависит от data ссылочный тип, указанный dataHandlerSubType параметр.

    dataHandlerSubType

    Идентифицирует и тип ссылки на данные и, косвенно, component выделите подтипы в значении, присвоенном компонентам обработчика данных, воздействующим на ссылки на данные того типа.

    anchorDataRef

    Дескриптор к ссылке на данные привязки.

    anchorDataRefType

    Тип ссылки на данные привязки.

    tb

    Основа времени для обработчика данных. Ваше приложение получает на сей раз основной идентификатор из NewTimeBase.

    flags

    Флаги (см. ниже), которые указывают путь, которым Вы намереваетесь использовать компонент обработчика данных. Не все обработчики данных обязательно поддерживают все службы; например, некоторые компоненты обработчика данных могут не поддерживать записи потоковой передачи. Установите надлежащие флаги в 1. Посмотрите эти константы:

    dh

    Указатель на поле для получения ComponentInstance значение недавно открытого компонента обработчика данных.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • QTGetMIMETypeInfo QTGetMIMETypeInfo (OS X v10.9)

    Получает информацию об определенном типе MIME.

    Объявление

    Objective C

    OSErr QTGetMIMETypeInfo ( const char *mimeStringStart, short mimeStringLength, OSType infoSelector, void *infoDataPtr, long *infoDataSize );

    Параметры

    mimeStringStart

    Указатель на первый символ строки, содержащей тип MIME.

    mimeStringLength

    Число символов в MIME вводит строку. Паскаль, C, и неразграниченные строковые буферы могут быть переданы одинаково хорошо.

    infoSelector

    Константа (см. ниже), который указывает тип запрошенной информации. Посмотрите эти константы:

    • kQTGetMIMETypeInfoIsQuickTimeMovieType

    • kQTGetMIMETypeInfoIsUnhelpfulType

    infoDataPtr

    Указатель на значение, которое будет обновлено. Для текущих селекторов это значение является булевской переменной.

    infoDataSize

    На вводе, указателе на размер ожидаемых данных; на выводе, указателе на размер получаемых данных. Во всех текущих случаях они будут тем же размером.

    Возвращаемое значение

    Можно получить доступ к ошибочным возвратам Панели инструментов Фильма через GetMoviesError и GetMoviesStickyError, а также в функциональном результате. Посмотрите Error Codes.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SampleNumToMediaDecodeTime SampleNumToMediaDecodeTime (OS X v10.9)

    Находит время декодирования для указанной выборки.

    Объявление

    Objective C

    void SampleNumToMediaDecodeTime ( Media theMedia, SInt64 logicalSampleNum, TimeValue64 *sampleDecodeTime, TimeValue64 *sampleDecodeDuration );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    logicalSampleNum

    64-разрядное целое число со знаком, содержащее демонстрационное число.

    sampleDecodeTime

    Указатель на временную стоимость. Функция обновляет эту временную стоимость для указания времени декодирования выборки, указанной logicalSampleNum параметр. Эта временная стоимость выражена в масштабе времени носителей. Установите этот параметр в NULL, если Вы не хотите эту информацию.

    sampleDecodeDuration

    Указатель на временную стоимость. Функция обновляет эту временную стоимость для указания продолжительности декодирования выборки, указанной logicalSampleNum параметр. Эта временная стоимость выражена в масштабе времени носителей. Установите этот параметр в NULL, если Вы не хотите эту информацию.

    Обсуждение

    Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError. Это возвращается paramErr если существует плохое значение параметра, или noErr если нет никакой ошибки.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • SampleNumToMediaDisplayTime SampleNumToMediaDisplayTime (OS X v10.9)

    Находит время дисплея для указанной выборки.

    Объявление

    Objective C

    void SampleNumToMediaDisplayTime ( Media theMedia, SInt64 logicalSampleNum, TimeValue64 *sampleDisplayTime, TimeValue64 *sampleDisplayDuration );

    Параметры

    theMedia

    Носители для этой работы. Вы получаете этот идентификатор носителей из таких функций как NewTrackMedia и GetTrackMedia.

    logicalSampleNum

    64-разрядное целое число со знаком, содержащее демонстрационное число.

    sampleDisplayTime

    Указатель на временную стоимость. Функция обновляет эту временную стоимость для указывания времени дисплея выборки, указанной logicalSampleNum параметр. Эта временная стоимость выражена в масштабе времени носителей. Установите этот параметр в NULL, если Вы не хотите эту информацию.

    sampleDisplayDuration

    Указатель на временную стоимость. Функция обновляет эту временную стоимость для указания продолжительности дисплея выборки, указанной logicalSampleNum параметр. Эта временная стоимость выражена в масштабе времени носителей. Установите этот параметр в NULL, если Вы не хотите эту информацию.

    Обсуждение

    Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError. Это возвращается paramErr если существует плохое значение параметра, или noErr если нет никакой ошибки.

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.9.

    Не доступный 64-разрядным приложениям.

Обратные вызовы

Разная дорожка и обратные вызовы носителей

Типы данных

  • DataHandlerComponent DataHandlerComponent

    Представляет тип, используемый Дорожкой и Носителями API.

    Объявление

    Objective C

    typedef Component DataHandlerComponent;

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Не доступный 64-разрядным приложениям.

  • MediaHandlerComponent MediaHandlerComponent

    Представляет тип, используемый Дорожкой и Носителями API.

    Объявление

    Objective C

    typedef Component MediaHandlerComponent;

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Не доступный 64-разрядным приложениям.

  • MovieEditState MovieEditState

    Представляет тип, используемый Дорожкой и Носителями API.

    Объявление

    Objective C

    typedef MovieEditStateRecord * MovieEditState;

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Не доступный 64-разрядным приложениям.

  • MovieEditStateRecord

    Недокументированный

    Объявление

    Objective C

    struct MovieEditStateRecord { long data[1]; };

    Поля

    data

    Недокументированный

  • SampleReference64Ptr SampleReference64Ptr

    Представляет тип, используемый Дорожкой и Носителями API.

    Объявление

    Objective C

    typedef SampleReference64Record * SampleReference64Ptr;

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Не доступный 64-разрядным приложениям.

  • SampleReference64Record

    Обеспечивает 64-разрядную версию SampleReferenceRecord.

    Объявление

    Objective C

    struct SampleReference64Record { wide dataOffset; unsigned long dataSize; TimeValue durationPerSample; unsigned long numberOfSamples; short sampleFlags; };

    Поля

    dataOffset

    Указывает смещение в файл данных фильма. Это поле указывает смещение в файл демонстрационных данных.

    dataSize

    Указывает общее количество байтов демонстрационных данных, идентифицированных ссылкой. Все выборки, на которые ссылается единственный SampleReference64Record, должны быть тем же размером.

    durationPerSample

    Указывает продолжительность каждой выборки в ссылке. Необходимо указать этот параметр в масштабе времени носителей. Все выборки, на которые ссылается единственный SampleReference64Record, должны быть той же продолжительностью.

    numberOfSamples

    Указывает число выборок, содержавшихся в ссылке.

    sampleFlag

    Содержит флаги (см. ниже), которые управляют работой. Установите неиспользованные флаги в 0. Посмотрите эти константы:

    • mediaSampleNotSync

    Обсуждение

    См. также AddMediaSampleReferences64 и GetMediaSampleReferences64.

  • SampleReferencePtr SampleReferencePtr

    Представляет тип, используемый Дорожкой и Носителями API.

    Объявление

    Objective C

    typedef SampleReferenceRecord * SampleReferencePtr;

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Не доступный 64-разрядным приложениям.

  • SampleReferenceRecord

    Описывает выборку или группу подобных выборок.

    Объявление

    Objective C

    struct SampleReferenceRecord { long dataOffset; long dataSize; TimeValue durationPerSample; long numberOfSamples; short sampleFlags; };

    Поля

    dataOffset

    Указывает смещение в файл данных фильма. Это поле указывает смещение в файл демонстрационных данных.

    dataSize

    Указывает общее количество байтов демонстрационных данных, идентифицированных ссылкой. На все выборки ссылается сингл SampleReferenceRecord должен быть тот же размер.

    durationPerSample

    Указывает продолжительность каждой выборки в ссылке. Необходимо указать этот параметр в масштабе времени носителей. На все выборки ссылается сингл SampleReferenceRecord должна быть та же продолжительность.

    numberOfSamples

    Указывает число выборок, содержавшихся в ссылке.

    sampleFlag

    Содержит флаги (см. ниже), которые управляют работой. Установите неиспользованные флаги в 0. Посмотрите эти константы:

    • mediaSampleNotSync

    Обсуждение

    См. также AddMediaSampleReferences и GetMediaSampleReferences.

  • TrackEditState TrackEditState

    Представляет тип, используемый Дорожкой и Носителями API.

    Объявление

    Objective C

    typedef TrackEditStateRecord * TrackEditState;

    Оператор импорта

    Objective C

    @import QuickTime;

    Доступность

    Доступный в OS X v10.0 и позже.

    Не доступный 64-разрядным приложениям.

  • TrackEditStateRecord

    Содержит состояние редактирования дорожки.

    Объявление

    Objective C

    struct TrackEditStateRecord { long data[1]; };

    Поля

    data

    Массив данных, составляющих состояние редактирования дорожки.

Константы

  • Флаги GetMovieImporter

    Константы, представляющие флаги <codeVoice> GetMovieImporter </codeVoice>.

    Объявление

    Objective C

    enum { kGetMovieImporterValidateToFind = 1L << 0, kGetMovieImporterAllowNewFile = 1L << 1, kGetMovieImporterDontConsiderGraphicsImporters = 1L << 2, kGetMovieImporterDontConsiderFileOnlyImporters = 1L << 6, kGetMovieImporterAutoImportOnly = 1L << 10 /* reject aggressive movie importers which have dontAutoFileMovieImport set */ };

  • Значения AddClonedTrackToMovie

    Константы передали AddClonedTrackToMovie.

    Объявление

    Objective C

    enum { kQTCloneShareSamples = 1 << 0, kQTCloneDontCopyEdits = 1 << 1 };

  • Значения QTGetMIMETypeInfo

    Константы передали QTGetMIMETypeInfo.

    Объявление

    Objective C

    enum { kQTGetMIMETypeInfoIsQuickTimeMovieType = 'moov', /* info is a pointer to a Boolean */ kQTGetMIMETypeInfoIsUnhelpfulType = 'dumb' /* info is a pointer to a Boolean */ };

  • Значения GetMovieIndTrackType

    Константы передали GetMovieIndTrackType.

    Объявление

    Objective C

    enum { movieTrackMediaType = 1 << 0, movieTrackCharacteristic = 1 << 1, movieTrackEnabledOnly = 1 << 2 };

  • movieFileSpecValid

    Константы сгруппировались с movieFileSpecValid.

    Объявление

    Objective C

    enum { pasteInParallel = 1 << 0, showUserSettingsDialog = 1 << 1, movieToFileOnlyExport = 1 << 2, movieFileSpecValid = 1 << 3 };

  • Значения SetTrackUsage

    Константы передали SetTrackUsage.

    Объявление

    Objective C

    enum { trackUsageInMovie = 1 << 1, trackUsageInPreview = 1 << 2, trackUsageInPoster = 1 << 3 };

  • Идентификаторы носителей

    Идентифицируйте типы среды в QuickTime.

    Объявление

    Swift

    var SoundMediaType: Int { get } var TextMediaType: Int { get }

    Objective C

    enum { VideoMediaType = 'vide', SoundMediaType = 'soun', TextMediaType = 'text', BaseMediaType = 'gnrc', MPEGMediaType = 'MPEG', MusicMediaType = 'musi', TimeCodeMediaType = 'tmcd', SpriteMediaType = 'sprt', FlashMediaType = 'flsh', MovieMediaType = 'moov', TweenMediaType = 'twen', ThreeDeeMediaType = 'qd3d', SkinMediaType = 'skin', HandleDataHandlerSubType = 'hndl', PointerDataHandlerSubType = 'ptr ', NullDataHandlerSubType = 'null', ResourceDataHandlerSubType = 'rsrc', URLDataHandlerSubType = 'url ', AliasDataHandlerSubType = 'alis', WiredActionHandlerType = 'wire' };

    Константы

    • SoundMediaType

      SoundMediaType

      Звуковой канал.

      Доступный в OS X v10.0 и позже.

      Не доступный 64-разрядным приложениям.

    • TextMediaType

      TextMediaType

      Текстовые носители.

      Доступный в OS X v10.0 и позже.

      Не доступный 64-разрядным приложениям.