Матричные функции

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

Структуры фиксированной точки и Фиксированного Прямоугольника

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

FixedPoint тип данных определяет фиксированную точку. FixedRect тип данных определяет фиксированный прямоугольник. Обратите внимание на то, что обе из этих структур определяют координату x перед координатой y. Это отличается от стандартных структур QuickDraw.

struct FixedPoint

{

    Fixed x;        /* point's x coordinate as fixed-point number */

    Fixed y;        /* point's y coordinate as fixed-point number */

};

typedef struct FixedPoint FixedPoint;

struct FixedRect

{

    Fixed left;         /* x coordinate of upper-left corner */

    Fixed top;          /* y coordinate of upper-left corner */

    Fixed right;        /* x coordinate of lower-right corner */

    Fixed bottom;       /* y coordinate of lower-right corner */

};

typedef struct FixedRect FixedRect;

Создание матового стекла дорожки

 Перечисление 1-1 обеспечивает пример того, как создать матовое стекло дорожки. CreateTrackMatte функция добавляет неинициализированное, 8 битов глубиной, полутоновое матовое стекло к дорожке. UpdateTrackMatte функция рисует серый прямоугольник ската вокруг края матового стекла и заполняет центр матового стекла с черным цветом. (Прямоугольник ската постепенно заштриховывает от света до темноты в гладких инкрементах.)

Перечисление 1-1  , Создающее матовое стекло дорожки

void CreateTrackMatte (Track theTrack)

{

    QDErr err;

    GWorldPtr aGW;

    Rect trackBox;

    Fixed trackHeight;

    Fixed trackWidth;

    CTabHandle grayCTab;

    GetTrackDimensions (theTrack, &trackWidth, &trackHeight);

    SetRect (&trackBox, 0, 0, FixRound (trackWidth),

                FixRound (trackHeight));

    grayCTab = GetCTable(40);    /* 8 bit + 32 = 8 bit gray */

    err = NewGWorld (&aGW, 8, &trackBox, grayCTab,

                        (GDHandle) nil, 0);

    DisposeCTable (grayCTab);

    if (!err && (aGW != nil))

    {

        SetTrackMatte (theTrack, aGW->portPixMap);

        DisposeGWorld (aGW);

    }

}

void UpdateTrackMatte (Track theTrack)

{

    OSErr err;

    PixMapHandle trackMatte;

    PixMapHandle savePortPix;

    Movie       theMovie;

    GWorldPtr tempGW;

    CGrafPtr savePort;

    GDHandle saveGDevice;

    Rect        matteBox;

    short       i;

    theMovie = GetTrackMovie (theTrack);

    trackMatte = GetTrackMatte (theTrack);

    if (trackMatte == nil)

    {

        /* track doesn't have a matte, so give it one */

        CreateTrackMatte (theTrack);

        trackMatte = GetTrackMatte (theTrack);

        if (trackMatte == nil)

            return;

    }

    GetGWorld (&savePort, &saveGDevice);

    matteBox = (**trackMatte).bounds;

    err = NewGWorld(&tempGW,

                       (**trackMatte).pixelSize, &matteBox,

                       (**trackMatte).pmTable, (GDHandle) nil, 0);

    if (err || (tempGW == nil)) return;

    SetGWorld (tempGW, nil);

    savePortPix = tempGW->portPixMap;

    LockPixels (trackMatte);

    SetPortPix (trackMatte);

    /* draw a gray ramp rectangle around the edge of the matte */

    for (i = 0; i < 35; i++)

    {

        RGBColor aColor;

        long        tempLong;

        tempLong = 65536 - ((65536 / 35) * (long)i);

        aColor.red = aColor.green = aColor.blue = tempLong;

        RGBForeColor(&aColor);

        FrameRect (&matteBox);

        InsetRect (&matteBox, 1, 1);

    }

    /* fill the center of the matte with black */

    ForeColor (blackColor);

    PaintRect (&matteBox);

    SetPortPix (savePortPix);

    SetGWorld (savePort, saveGDevice);

    DisposeGWorld (tempGW);

    UnlockPixels (trackMatte);

    SetTrackMatte (theTrack, trackMatte);

    DisposeMatte (trackMatte);

}

Во время фильма

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

Системы координат времени

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

Масштаб времени QuickTime определяет число единиц измерения времени, передающих каждую секунду в данной системе координат времени. Система координат времени, имеющая масштаб времени 1 раза мер в секундах. Точно так же система координат времени, имеющая масштаб времени 60 мер sixtieths секунды. В целом каждая единица измерения времени в системе координат времени равна (1/масштаб времени) секунды. Некоторые общие масштабы времени перечислены в Таблице 1-1.

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

Определенный момент времени в системе координат времени представлен с помощью временной стоимости. Временная стоимость выражена с точки зрения масштаба времени ее системы координат времени. Без масштаба подходящего времени временная стоимость бессмысленна. Например, в системе координат времени с масштабом времени 60, временная стоимость 180 переводит в 3 секунды. Поскольку все системы координат времени скрепляют к абсолютному времени (т.е. время, поскольку мы измеряем его в секундах), Панель инструментов Фильма может перевести временные стоимости из одной системы координат времени в другого.

Системы координат времени имеют конечную максимальную продолжительность, определяющую максимальную временную стоимость какое-то время система координат (минимальная временная стоимость всегда 0). Обратите внимание на то, что, поскольку фильм в формате QuickTime редактируется, изменения продолжительности.

Как значение увеличений масштаба времени (поскольку единица измерения времени для системы координат становится меньшей с точки зрения абсолютного времени), максимальное абсолютное время, которое может быть представлено в системе координат времени уменьшения. Например, если бы временная стоимость была представлена как 16-разрядное целое число без знака, то его максимальное значение было бы 65,535. В системе координат времени с масштабом времени 1, максимальная временная стоимость представляла бы 65 535 секунд. Однако в системе координат времени с масштабом времени 5, максимальная временная стоимость соответствовала бы 13 107 секундам. Следовательно, время продолжительность системы координат ограничивается ее масштабом времени. QuickTime использует 32-разрядные и 64-разрядные количества для представления временных стоимостей, таким образом, только необходимо волноваться о достижении максимального абсолютного времени в ситуациях, где время, продолжительность системы координат очень длинна или ее масштаб времени, является очень большим.

Основы времени

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

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

 Рисунок 1-2 представляет систему координат времени и основу времени геометрически. Система координат времени представлена координатной осью. В этом примере система координат времени имеет масштаб времени 2; т.е. в каждую секунду существует две единицы измерения времени. Продолжительность этой системы координат времени составляет 2 секунды, который эквивалентен 4 единицам измерения времени. Основа времени объекта изображена крупной стрелкой под осью, представляющей систему координат времени. На сей раз основа имеет значение текущего времени 3 и уровень 1. Время начала является временной стоимостью, выраженной в модулях системы координат времени.

Работа со временем дорожки

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

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

• Можно использовать GetTrackDuration функция для определения продолжительности дорожки.

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

• TrackTimeToMediaTime функция позволяет Вам перевести время дорожки в соответствующую временную стоимость носители в дорожке.

Работа со временем носителей

Панель инструментов Фильма обеспечивает функции, позволяющие Ваше рвение с параметрами времени носители:

• Можно использовать GetMediaDuration функция для определения продолжительности носителей.

• GetMediaTimeScale и SetMediaTimeScale позвольте Вам определить или установить масштаб времени носителей.

Функции основы времени

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

Этот раздел был разделен на следующие темы:

• Создание и Избавление от Основ Времени описывают, как создать и избавиться от основ времени и как присвоить основу времени фильму

• Работа Со Значениями Основы Времени обсуждает функции, позволяющие Ваше рвение с содержанием основы времени

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

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

Создание и избавление от основ времени

Следующие функции Панели инструментов Фильма помогают Вашему приложению создать и избавиться от основ времени:

• NewTimeBase функция позволяет Вам заложить новую основу времени. Можно использовать DisposeTimeBase функция для избавления от времени базируется, как только Вы закончены с нею.

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

• Можно присвоить компонент часов основе времени; те часы тогда действуют как основной тактовый генератор для основы времени. Можно использовать SetTimeBaseMasterClock функция для присвоения компонента часов основе времени. GetTimeBaseMasterClock функция позволяет Вам определить компонент часов, присваивающийся основе времени. Можно изменить смещение между основой времени и ее источником времени путем вызова SetTimeBaseZero функция.

• Можно установить источник времени фильма путем вызова SetMovieMasterTimeBase и SetMovieMasterClock функции.

Работа со значениями основы времени

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

• GetTimeBaseTime функция позволяет Вам получить значение текущего времени основы времени. Можно установить значение текущего времени путем вызова SetTimeBaseTime функция; эта функция требует, чтобы Вы обеспечили временную структуру. Также можно установить текущее время на основе временной стоимости путем вызова SetTimeBaseValue функция.

• Можно установить курс основы времени путем вызова GetTimeBaseRate функция. Можно установить уровень основы времени путем вызова SetTimeBaseRate функция. Можно установить действующий курс основы требуемого времени (относительно основной основы времени, которой это подчинено) путем вызова GetTimeBaseEffectiveRate функция.

• Можно получить время начала основы времени путем вызова GetTimeBaseStartTime функция. Можно установить время начала основы времени путем вызова SetTimeBaseStartTime функция. Точно так же можно использовать GetTimeBaseStopTime и SetTimeBaseStopTime функции для работы со временем остановки основы времени.

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

• GetTimeBaseStatus функция позволяет Вам читать текущий статус основы времени.

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

Структура TimeRecord

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

struct TimeRecord

{

    CompTimeValue       value;      /* time value (duration or absolute) */

    TimeScale       scale;          /* units per second */

    TimeBase        base;           /* reference to the time base */

};

typedef struct TimeRecord TimeRecord;

Большие временные стоимости

Можно указать временную стоимость во временной структуре как 64-разрядное целочисленное значение следующим образом:

typedef Int64 CompTimeValue;

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

struct Int64

{

    long hi;    /* high-order 32 bits-value field in time structure */

    long lo;    /* low-order 32 bits-value field in time structure */

};

typedef struct Int64 Int64;

Управление пространством фильма

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

• SetTrackGWorld

• SetMovieGWorld

• GetMovieGWorld

• SetMovieBox

• GetMovieBox

• GetMovieDisplayBoundsRgn

• GetMovieSegmentDisplayBoundsRgn

• SetMovieDisplayClipRgn

• GetMovieDisplayClipRgn

• GetTrackSegmentDisplayBoundsRgn

• SetTrackLayer

• GetTrackLayer

• SetMovieMatrix

• GetMovieMatrix

• GetMovieBoundsRgn

• GetTrackMovieBoundsRgn

• GetMovieClipRgn

• SetTrackMatrix

• GetTrackMatrix

• GetTrackBoundsRgn

• SetTrackDimensions

• GetTrackDimensions

• SetTrackClipRgn

• GetTrackClipRgn

• SetTrackMatte

• GetTrackMatte

• DisposeMatte

• SetMovieColorTable

• GetMovieColorTable

Работа с матрицами

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

• SetIdentityMatrix

• GetMatrixType

• CopyMatrix

• EqualMatrix

• TranslateMatrix

• ScaleMatrix

• RotateMatrix

• SkewMatrix

• ConcatMatrix

• InverseMatrix

• TransformPoints

• TransformFixedPoints

• TransformRect

• TransformFixedRect

• TransformRgn

• RectMatrix

• MapMatrix

Управление временем фильма

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

• GetMovieDuration

• SetMovieTimeValue

• SetMovieTime

• GetMovieTime

• SetMovieRate

• GetMovieRate

• SetMovieTimeScale

• GetMovieTimeScale

• GetMovieTimeBase

Управление временем дорожки

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

• GetTrackDuration

• SetTrackOffset

• GetTrackOffset

• TrackTimeToMediaTime

Управление временем носителей

Три функции работают со временем носителей параметры. У каждого носители есть его собственный масштаб времени и продолжительность.

• GetMediaDuration

• SetMediaTimeScale

• GetMediaTimeScale

Нахождение интересных времен

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

• GetMovieNextInterestingTime

• GetTrackNextInterestingTime

• GetMediaNextInterestingTime

Управление основой времени

Различная Панель инструментов Фильма функционирует работа с основами времени. Основа времени QuickTime определяет систему координат времени для фильма. Это может также использоваться для предоставления общих услуг синхронизации.

• Создание и избавление от основ времени

  • NewTimeBase

  • DisposeTimeBase

  • SetMovieMasterClock

  • SetMovieMasterTimeBase

  • SetTimeBaseMasterClock

  • GetTimeBaseMasterClock

  • SetTimeBaseMasterTimeBase

  • GetTimeBaseMasterTimeBase

  • SetTimeBaseZero

• Работа со значениями основы времени

  • SetTimeBaseTime

  • SetTimeBaseValue

  • SetTimeBaseRate

  • GetTimeBaseRate

  • GetTimeBaseEffectiveRate

  • SetTimeBaseStartTime

  • GetTimeBaseStartTime

  • SetTimeBaseStopTime

  • GetTimeBaseStopTime

  • SetTimeBaseFlags

  • GetTimeBaseFlags

  • GetTimeBaseStatus

• Временные структуры

  • AddTime

  • SubtractTime

  • ConvertTime

  • ConvertTimeScale

• Функции обратного вызова основы времени

  • NewCallBack

  • CallMeWhen

  • CancelCallBack

  • DisposeCallBack

  • GetCallBackTimeBase

  • GetCallBackType

Большинство этих функций обсуждено в предыдущих разделах этой главы.