Создание новых атомов

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

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

Пример кода в Перечислении 6-3 создает новый контейнер атома QT и вызовы QTInsertChild добавить атом. Получающийся контейнер атома QT показан на рисунке 6-1. Значение смещения 10 возвращается в firstAtom параметр.

Перечисление 6-3  , Создающее новый контейнер атома QT и вызов QTInsertChild добавить атом.

QTAtom firstAtom;

QTAtomContainer container;

OSErr err

err = QTNewAtomContainer (&container);

if (!err)

    err = QTInsertChild (container, kParentAtomIsContainer, 'abcd',

        1000, 1, 0, nil, &firstAtom);

Следующие вызовы примера кода QTInsertChild создать второй дочерний атом. Поскольку значение 1 указано для index параметр, второй атом вставляется перед первым атомом в дочернем списке; индекс первого атома изменяется на 2. Получающийся контейнер атома QT показан на рисунке 6-2.

QTAtom secondAtom;

FailOSErr (QTInsertChild (container, kParentAtomIsContainer, 'abcd',

    2000, 1, 0, nil, &secondAtom));

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

firstAtom = QTFindChildByID (container, kParentAtomIsContainer,  'abcd',

    1000, nil);

Перечисление 6-4 показывает как QTInsertChild функция вставляет листовой атом в контейнер атома sprite. Новый листовой атом содержит индекс изображения спрайта как свои данные.

Перечисление 6-4  , Вставляющее дочерний атом

if ((propertyAtom = QTFindChildByIndex (sprite, kParentAtomIsContainer,

    kSpritePropertyImageIndex, 1, nil)) == 0)

    FailOSErr (QTInsertChild (sprite, kParentAtomIsContainer,

        kSpritePropertyImageIndex, 1, 1, sizeof(short),&imageIndex,

        nil));

Копирование существующих атомов

QuickTime обеспечивает несколько функций для копирования существующих атомов в контейнере атома. QTInsertChildren функция вставляет контейнер атомов как дочерние элементы родительского атома в другом контейнере атома. Рисунок 6-3 показывает двум примерам контейнеры атома QT, A и B.

Следующие вызовы примера кода QTFindChildByID получать смещение атома в контейнере A. Затем пример кода вызывает QTInsertChildren функционируйте для вставки атомов в контейнер B как дочерние элементы атома в контейнере A. Рисунок 6-4 показывает, какой контейнер взгляды как после атомов от контейнера B были вставлены.

QTAtom targetAtom;

targetAtom = QTFindChildByID (containerA, kParentAtomIsContainer,  'abcd',

    1000, nil);

FailOSErr (QTInsertChildren (containerA, targetAtom, containerB));

В перечислении 6-5, QTInsertChild функция вставляет родительский атом в контейнер атома theSample. Затем вызовы кода QTInsertChildren вставить контейнер theSprite в контейнер theSample. Родительский атом newSpriteAtom.

Перечисление 6-5  , Вставляющее контейнер в другой контейнер

FailOSErr (QTInsertChild (theSample, kParentAtomIsContainer,

    kSpriteAtomType, spriteID, 0, 0, nil, &newSpriteAtom));

FailOSErr (QTInsertChildren (theSample, newSpriteAtom, theSprite));

QuickTime обеспечивает три других функции, которые можно использовать для управления атомами в контейнере атома. QTReplaceAtom функционируйте заменяет атом и его дочерние элементы с различным атомом и его дочерние элементы. Можно вызвать QTSwapAtoms функционируйте для свопинга содержания двух атомов в контейнере атома; после свопинга, ID и индекса каждого атома остается тем же. QTCopyAtom функционируйте копирует атом и его дочерние элементы к новому контейнеру атома.

Получение атомов от контейнера Atom

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

Можно использовать QTCountChildrenOfType и QTGetNextChildType функции для получения информации о типах дочерних элементов атома. QTCountChildrenOfType функционируйте возвращает число дочерних элементов данного типа атома для родительского атома. QTGetNextChildType функционируйте возвращает следующий тип атома в дочернем списке родительского атома.

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

Перечисление 6-6 показывает функцию примера кода SetSpriteData, который обновляет контейнер атома, описывающий спрайт. (Для получения дополнительной информации о спрайтах и Панели инструментов Sprite, обратитесь к книге Programming With Wired Movies и Sprite Animation, доступной в http://developer.apple.com/techpubs/quicktime/qtdevdocs/RM/PDF.htm.) Для каждого свойства спрайта, который должен быть обновлен, SetSpriteData вызовы QTFindChildByIndex получать надлежащий атом от контейнера атома. Если атом найден, SetSpriteData вызовы QTSetAtomData заменять данные атома новым значением свойства. Если атом не найден, SetSpriteData вызовы QTInsertChild добавить новый атом для свойства.

Перечисление 6-6  , Находящее дочерний атом индексом

OSErr SetSpriteData (QTAtomContainer sprite, Point *location,

    short *visible, short *layer, short *imageIndex)

{

    OSErr err = noErr;

    QTAtom propertyAtom;

    // if the sprite’s visible property has a new value

    if (visible)

    {

        // retrieve the atom for the visible property --

        // if none exists, insert one

        if ((propertyAtom = QTFindChildByIndex (sprite,

            kParentAtomIsContainer, kSpritePropertyVisible, 1,

            nil)) == 0)

            FailOSErr (QTInsertChild (sprite, kParentAtomIsContainer,

                kSpritePropertyVisible, 1, 1, sizeof(short), visible,

                nil))

        // if an atom does exist, update its data

        else

            FailOSErr (QTSetAtomData (sprite, propertyAtom,

                sizeof(short), visible));

    }

    // ...

    // handle other sprite properties

    // ...

}

Можно вызвать QTFindChildByID функционируйте, чтобы искать и получить дочерний элемент родительского атома его типом и ID. Функция примера кода AddSpriteToSample, показанный в Перечислении 6-7, добавляет спрайт, представленный контейнером атома, к ключевой выборке, представленной другим контейнером атома. AddSpriteToSample вызовы QTFindChildByID определить ли контейнер атома theSample содержит атом типа kSpriteAtomType с ID spriteID. В противном случае AddSpriteToSample вызовы QTInsertChild вставить атом с тем типом и ID. Значение 0 передается для index параметр, чтобы указать, что атом должен быть вставлен в конце дочернего списка. Значение 0 передается для dataSize параметр, чтобы указать, что атом не имеет никаких данных. Затем AddSpriteToSample вызовы QTInsertChildren вставить атомы в контейнер theSprite как дочерние элементы нового атома. FailIf и FailOSErr макросы, которые выходят из текущей функции, когда происходит ошибка.

Перечисление 6-7  , Находящее дочерний атом ID

OSErr AddSpriteToSample (QTAtomContainer theSample,

    QTAtomContainer theSprite, short spriteID)

{

    OSErr err = noErr;

    QTAtom newSpriteAtom;

    FailIf (QTFindChildByID (theSample, kParentAtomIsContainer,

        kSpriteAtomType, spriteID, nil), paramErr);

    FailOSErr (QTInsertChild (theSample, kParentAtomIsContainer,

        kSpriteAtomType, spriteID, 0, 0, nil, &newSpriteAtom));

    FailOSErr (QTInsertChildren (theSample, newSpriteAtom, theSprite));

}

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

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

• Для копирования данных атома в дескриптор можно использовать QTCopyAtomDataToHandle функция.

• Для копирования данных атома в указатель можно использовать QTCopyAtomDataToPtr функция.

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

Изменение атомов

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

Вы используете QTSetAtomData функционируйте для обновления данных, связанных с листовым атомом в контейнере атома. QTSetAtomData функционируйте заменяет листовые данные атома новыми данными. Пример кода в вызовах Перечисления 6-8 QTFindChildByIndex определить, содержит ли контейнер атома видимое свойство спрайта. Если так, демонстрационные вызовы QTSetAtomData заменять данные атома новым видимым свойством.

Перечисление 6-8  , Изменяющее данные атома

QTAtom propertyAtom;

// if the atom isn’t in the container, add it

if ((propertyAtom = QTFindChildByIndex (sprite, kParentAtomIsContainer,

    kSpritePropertyVisible, 1, nil)) == 0)

    FailOSErr (QTInsertChild (sprite, kParentAtomIsContainer,

        kSpritePropertyVisible, 1, 0, sizeof(short), visible, nil))

// if the atom is in the container, replace its data

else

    FailOSErr (QTSetAtomData (sprite, propertyAtom, sizeof(short),

        visible));

Удаление атомов от контейнера Atom

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

Пример кода, показанный в Перечислении 6-9, добавляет выборки переопределения к дорожке спрайта для анимации спрайтов в дорожке спрайта. sample и spriteData переменные являются контейнерами атома. spriteData контейнер атома содержит атомы, описывающие единственный спрайт. sample контейнер атома содержит атомы, который описывает выборку переопределения.

Каждая итерация for вызовы цикла QTRemoveChildren удалить все атомы от обоих sample и spriteData контейнеры. Пример кода обновляет индекс изображения, которое будет использоваться для спрайта и расположения спрайта и вызовов SetSpriteData (Перечисление 6-6), добавляющее надлежащие атомы к spriteData контейнер атома. Затем вызовы примера кода AddSpriteToSample (Перечисление 6-7) для добавления spriteData контейнер атома к sample контейнер атома. Наконец, когда все спрайты были обновлены, вызовы примера кода AddSpriteSampleToMedia добавить выборку переопределения к дорожке спрайта.

Перечисление 6-9  , Удаляющее атомы из контейнера

QTAtomContainer sample, spriteData;

// ...

// add the sprite key sample

// ...

// add override samples to make the sprites spin and move

for (i = 1; i <= kNumOverrideSamples; i++)

{

    QTRemoveChildren (sample, kParentAtomIsContainer);

    QTRemoveChildren (spriteData, kParentAtomIsContainer);

    // ...

    // update the sprite:

    // - update the imageIndex

    // - update the location

    // ...

    // add atoms to spriteData atom container

    SetSpriteData (spriteData, &location, nil, nil, &imageIndex);

    // add the spriteData atom container to sample

    err = AddSpriteToSample (sample, spriteData, 2);

    // ...

    // update other sprites

    // ...

    // add the sample to the media

    err = AddSpriteSampleToMedia (newMedia, sample,

        kSpriteMediaFrameDuration, false);

}

Общие указания.

Для каждой альтернативной группы:

• Группа должна содержать дорожки только одного типа; например, только дорожки подзаголовка или только звуковые дорожки.

• Все дорожки того же типа должны быть в единственной альтернативной группе.

• Одна дорожка в группе должна быть включена; т.е. флаг Track Enabled должен быть установлен (0x0001) в его заголовке дорожки ('tkhd').

• Все другие дорожки в группе должны быть отключены.

Альтернативные дорожки подзаголовка

Для альтернативной группы, содержащей многократный подзаголовок ('sbtl') дорожки:

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

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

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

Для каждого языка в группе альтернативы подзаголовка дорожки подзаголовка могут быть сконфигурированы любым из следующих способов:

• Одноколейный путь: Содержит любую комбинацию принудительных и невызванных (регулярных) выборок подзаголовка.

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

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

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

Альтернативные звуковые дорожки

Для альтернативной группы, содержащей многократный звук ('soun') дорожки:

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

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

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

Отношения через Alternate Groups

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

Звуковые дорожки могут иметь ссылку дорожки типа 'folw' (для «следует») к единственной дорожке подзаголовка; если звуковая дорожка выбрана, эта дорожка является значением по умолчанию, чтобы выбрать. Использование a 'folw' ссылка является нейтрализацией в случаях, где определение языка не может использоваться по некоторым причинам (например, письменный язык и разговорный язык используют различные расширенные языковые теги, как с норвежским языком).

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

• Звуковая дорожка может включать a 'folw' («следует») за ссылкой дорожки на соответствующую дорожку подзаголовка.

• Если звуковая дорожка имеет a 'folw' отследите ссылку на дорожку подзаголовка, что дорожка подзаголовка, на которую ссылаются, является дорожкой подзаголовка по умолчанию для той звуковой дорожки.

• Каждая звуковая дорожка может иметь или нуль или ссылки дорожки 'folw' на дорожку подзаголовка.

• Если пара дорожки подзаголовка должна быть сделана значением по умолчанию, звуковая дорожка должна иметь a 'folw' отследите ссылку на принудительную дорожку подзаголовка пары дорожки.

• Если существует нет 'folw' отследите ссылку на дорожку подзаголовка, проигрыватель обычно определяет дорожку подзаголовка по умолчанию путем соответствия аспектов аудио и дорожек подзаголовка, обычно путем соответствия расширенного языкового тега (или код языка, если нет никакого языкового тега) в наборе дорожек кандидата.

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

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

Структура описания эффекта

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

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

Вы собираете описание эффекта путем добавления надлежащего набора атомов к a QTAtomContainer структура.

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

Можно изменить данные в атомах параметра непосредственно или позволить пользователю установить их путем вызова QTCreateStandardParameterDialog, который возвращает полное описание эффекта (необходимо добавить kEffectSourceName атомы для эффектов, требующих источников).

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

Требуемые атомы описания эффектов

Существует несколько требуемых атомов, которые должно содержать описание эффекта. Первое kParameterWhatName атом. kParameterWhatName атом содержит имя эффекта. Это указывает который из доступных эффектов использовать.

Фрагмент кода, показанный в Перечислении 6-10, добавляет a kParameterWhatName атом к контейнеру атома effectDescription. Константа kCrossFadeTransitionType содержит имя плавно накладывать эффекта.

Перечисление 6-10  , добавляющее a kParameterWhatName атом к контейнеру атома effectDescription

effectCode = kCrossFadeTransitionType;

QTInsertChild(effectDescription, kParentAtomIsContainer,

                kParameterWhatName, kParameterWhatID, 0,

                sizeof(effectCode), &effectCode, nil);

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

Атомы параметра описания эффектов

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

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

QTInsertChild функция используется для добавления этих параметров к описанию эффекта, как замечено в примере кода в Перечислении 6-10.

Рассмотрите, например, эффект нажатия. Его описание эффекта содержит a kParameterWhatName атом, два kEffectSourceName атомы и два атома параметра, один из которых является промежуточным кадром.

kParameterWhatName атом указывает, что это - a 'push' эффект.

Два kEffectSourceName атомы указывают два источника, которые этот эффект будет использовать в этом случае 'srcA' и 'srcB'. Имена соответствуют записям во входной карте дорожки эффекта.

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

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

В этом примере, источнике 'srcB' продвинет в от нижней части, покрывая источник 'srcA'.

'pcnt' параметр обычно вставляется промежуточные кадры от 0 до 100, так, чтобы эффект представил полностью, от 0 до 100 процентов. В этом примере, 'pcnt' параметр вставлен промежуточные кадры от 25 до 75, таким образом, эффект запустит 25 процентов пути через (с 'srcB' уже частично на экране) и конец 75 процентов пути через (с частью 'srcA' все еще видимый).

Рисунок 6-5 показывает набор атомов, которые должны быть добавлены к описанию записи.

Важное свойство параметров эффекта - то, что большинство может быть вставлено промежуточные кадры (и некоторые должны быть вставлены промежуточные кадры). Вставка промежуточных кадров является механизмом интерполяции QuickTime общего назначения (см. Носители Промежуточного кадра для получения дополнительной информации). Для многих параметров желательно позволить значению параметра изменяться, поскольку выполняется эффект. В примере, показанном на рисунке 6-5, 'pcnt' параметр должен быть промежуточным кадром. Эти средства управления параметром, которыми кадр эффекта представляется в любой момент времени, таким образом, это должно измениться для эффекта развиться. 'from' параметр не является промежуточным кадром в примере выше, но это могло быть, если бы мы хотели, чтобы направление нажатия изменилось в течение эффекта.

Создание входной карты

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

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

Структура входной карты

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

Каждый входной атом модификатора содержит два дочерних элемента, один из типа kEffectDataSourceType, и один из типа kTrackModifierType, которые содержат имя и тип источника.

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

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

Рисунок 6-6 показывает завершенную входную карту, это ссылается на два источника. Первый источник является видеотреком и вызывается 'srcA'. Второй источник, также видеотрек, вызывают 'srcB'.

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

QTNewAtomContainer(&inputMap);

AddTrackReference(theEffectsTrack, firstSourceTrack,

                 kTrackModifierReference, &referenceIndex);

QTInsertChild(inputMap, kParentAtomIsContainer,

            kTrackModifierInput, referenceIndex, 0, 0, nil, &inputAtom);

inputType = VideoMediaType;

QTInsertChild(inputMap, inputAtom,

                kTrackModifierType, 1, 0, sizeof(inputType), &inputType,

                nil);

aType = 'srcA';

QTInsertChild(inputMap, inputAtom, kEffectDataSourceType, 1, 0,

            sizeof(aType), &aType, nil);

Атомы Target для встроенных фильмов

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

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

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

Пути начинаются с текущего фильма, который является фильмом, содержащим объект, обрабатывающий событие. Можно подняться дерево с помощью a kTargetParentMovie атом, или вниз дерево с помощью одного из пяти новых дочерних атомов фильма. Можно использовать a kTargetRootMovie атом как ярлык для получения до верхушки дерева, содержащей встроенный фильм и, может использовать movieByName и movieByID атомы для указания корневого внешнего фильма.

Целевые атомы:

• kTargetRootMovie (листовой атом, никакие данные). Это - корневой фильм, содержащий обработчик действия.

• kTargetParentMovie (листовой атом, никакие данные). Это - родительский фильм.

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

• kTargetChildMovieTrackName. Дочерняя дорожка фильма указана именем дорожки.

• kTargetChildMovieTrackID. Дочерняя дорожка фильма, указанная дорожкой ID.

• kTargetChildMovieTrackIndex. Дочерняя дорожка фильма указана индексом дорожки.

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

• kTargetChildMovieMovieID. Дочерний фильм, указанный фильмом в настоящее время загруженного фильма ID. Дочерний фильм должен содержать movieID пользовательские данные с указанным ID.

Рихтовочный инструмент QTVR

Рихтовочный инструмент QTVR является компонентом экспорта фильма, преобразовывающим существующий QuickTime VR единственный фильм узла в новый фильм, оптимизированный для сети. Мало того, что рихтовочный инструмент переупорядочивает выборки носителей, но и для обзоров, он также создает маленький предварительный просмотр обзора. Когда просматривается в сети, этот предварительный просмотр появляется после 5% к 10% данных фильма был загружен, позволив пользователям видеть версию более низкого разрешения обзора.

Используя рихтовочный инструмент QTVR из Вашего приложения довольно просто. После создания QuickTime фильм VR Вы просто открываете компонент QTVR Flattener и вызываете MovieExportToFile подпрограмма как показано в Перечислении 6-17.

Перечисление 6-17  Используя рихтовочный инструмент

ComponentDescription desc;

Component flattener;

ComponentInstance qtvrExport = nil;

desc.componentType = MovieExportType;

desc.componentSubType = MovieFileType;

desc.componentManufacturer = QTVRFlattenerType;

flattener = FindNextComponent(nil, &desc);

if (flattener) qtvrExport = OpenComponent (flattener);

if (qtvrExport)

    MovieExportToFile (qtvrExport, &myFileSpec, myQTVRMovie,  nil, 0, 0);

Фрагмент кода, показанный в Перечислении 6-17, создает сглаженный файл ролика, указанный myFileSpec параметр. если Ваш QuickTime размер четверти, размытый JPEG, сжатый предварительный просмотр изображения обзора, фильм VR является обзором, сглаженный файл ролика включает

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

        err = MovieExportDoUserDialog (qtvrExport, myQTVRMovie,  nil, 0, 0,  &cancel);

Если пользователь отменяет диалоговое окно, то булева отмена установлена в true.

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

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

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

Атом предварительного просмотра размытости является булевым значением, указывающим, размыть ли изображение перед сжатием. Размывание обычно приводит к намного более очень сжатому изображению. Значение по умолчанию true.

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

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

Демонстрационный контейнер Atom для рихтовочного инструмента QTVR

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

Перечисление 6-18  , Указывающее файл предварительного просмотра для рихтовочного инструмента для использования

Boolean yes = true;

QTAtomContainer exportData;

QTAtom parent;

err = QTNewAtomContainer(&exportData);

// create a parent for the other settings atoms

err = QTInsertChild (exportData, kParentAtomIsContainer,

            QTVRFlattenerParentAtomType, 1, 0, 0, nil, &parent);

// Add child atom to indicate we want to import the preview from  a file

err = QTInsertChild (exportData, parent, QTVRImportPreviewAtomType,  1, 0,

            sizeof (yes), &yes, nil);

// Add child atom to tell which file to import

err = QTInsertChild (exportData, parent, QTVRImportSpecAtomType,  1, 0,

            sizeof (previewSpec), &previewSpec, nil);

// Tell the export component

MovieExportSetSettingsFromAtomContainer (qtvrExport, exportData);

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

Перечисление 6-19  , Переопределяющее настройки сжатия

ComponentInstance sc;

QTAtomContainer compressorData;

SCSpatialSettings ss;

sc = OpenDefaultComponent(StandardCompressionType,StandardCompressionSubType);

ss.codecType = kCinepakCodecType;

ss.codec = nil;

ss.depth = 0;

ss.spatialQuality = codecHighQuality

err = SCSetInfo(sc, scSpatialSettingsType, &ss);

err = SCGetSettingsAsAtomContainer(sc, &compressorData);

MovieExportSetSettingsFromAtomContainer (qtvrExport, compressorData);