Установка ссылки дисплея

Установка ссылки дисплея включает следующие шаги:

• Создайте поток ссылки дисплея.

• Свяжите ссылку к определенному дисплею.

• Зарегистрируйте выходной обратный вызов дисплея.

• Запуск дисплея соединяет поток.

Метод awakeFromNib в Перечислении 2-2 показывает, как Вы могли бы реализовать ссылку дисплея.

Перечисление 2-2  , Настраивающее ссылку дисплея

- (void)awakeFromNib

{

    CVReturn            error = kCVReturnSuccess;

    CGDirectDisplayID   displayID = CGMainDisplayID();// 1

    error = CVDisplayLinkCreateWithCGDisplay(displayID, &displayLink);// 2

    if(error)

    {

        NSLog(@"DisplayLink created with error:%d", error);

        displayLink = NULL;

        return;

    }

    error = CVDisplayLinkSetOutputCallback(displayLink,// 3

                                 MyDisplayLinkCallback, self);

}

Вот то, как работает код:

1. Получает Базовый Графический дисплей ID для дисплея, который Вы хотите связать с этой ссылкой дисплея. Базовая Графическая функция CGMainDisplayID просто возвращает ID основного дисплея пользователя (т.е. тот, содержащий строку меню).

2. Создает ссылку дисплея для указанного дисплея. При желании можно создать ссылку дисплея, которая может работать с любым из в настоящее время активных дисплеев путем вызова CVDisplayLinkCreateWithActiveCGDisplays вместо этого. Необходимо тогда вызвать CVDisplayLinkSetCurrentCGDisplay определять определенный дисплей для ссылки дисплея.

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

   - (void)windowChangedScreen:(NSNotification*)inNotification

   {

   NSWindow *window = [mainView window];

   CGDirectDisplayID displayID = (CGDirectDisplayID)[[[[window screen]

   deviceDescription] objectForKey:@"NSScreenNumber"] intValue];

   if((displayID != NULL) && (mainViewDisplayID != displayID))

   {

   CVDisplayLinkSetCurrentCGDisplay(displayLink, displayID);

   mainViewDisplayID = displayID;

   }

   }

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

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

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

Инициализация Вашего источника видеосигнала

Прежде чем можно будет начать обрабатывать, необходимо установить источник видеосигнала для обеспечения кадров. Источник видеосигнала может быть чем-либо, что может предоставить несжатые видеоданные как текстуры OpenGL. Например, этим источником мог быть QuickTime, OpenGL или Ваш собственный генератор видеокадра.

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

Перечисление 2-3 показывает метод, устанавливающий фильм в формате QuickTime, чтобы быть Вашим источником видеосигнала.

Перечисление 2-3  , Инициализирующее источник видеосигнала QuickTime

- (id)initWithFilePath:(NSString*)theFilePath // 1

{

    self = [super init];

    OSStatus        theError = noErr;

    Boolean         active = TRUE;

    UInt32          trackCount = 0;

    OSType          theTrackType;

    Track           theTrack = NULL;

    Media           theMedia = NULL;

    QTNewMoviePropertyElement newMovieProperties[] = // 2

        {

        {kQTPropertyClass_DataLocation,

            kQTDataLocationPropertyID_CFStringNativePath,

            sizeof(theFilePath), &theFilePath, 0},

        {kQTPropertyClass_NewMovieProperty, kQTNewMoviePropertyID_Active,

            sizeof(active), &active, 0},

        {kQTPropertyClass_Context, kQTContextPropertyID_VisualContext,

            sizeof(qtVisualContext), &qtVisualContext, 0},

        };

    theError = QTOpenGLTextureContextCreate( NULL, NULL, // 3

        [[NSOpenGLView defaultPixelFormat]

         CGLPixelFormatObj], NULL, &qtVisualContext);

    if(qtVisualContext == NULL)

     {

        NSLog(@"QTVisualContext creation failed with error:%d", theError);

        return NULL;

    }

    theError = NewMovieFromProperties(

        sizeof(newMovieProperties) / sizeof(newMovieProperties[0]),// 4

        newMovieProperties, 0, NULL, &channelMovie);

    if(theError)

    {

        NSLog(@"NewMovieFromProperties failed with %d", theError);

        return NULL;

    }

    // setup the movie

    GoToBeginningOfMovie(channelMovie);// 5

    SetMovieRate(channelMovie, 1 << 16);

    SetTimeBaseFlags(GetMovieTimeBase(channelMovie), loopTimeBase);

    trackCount = GetMovieTrackCount(channelMovie);

    while(trackCount > 0)

    {

        theTrack = GetMovieIndTrack(channelMovie, trackCount);

        if(theTrack != NULL)

        {

            theMedia = GetTrackMedia(theTrack);

            if(theMedia != NULL)

            {

                GetMediaHandlerDescription(theMedia, &theTrackType, 0, 0);

                if(theTrackType != VideoMediaType)

                {

                    SetTrackEnabled(theTrack, false);

                }

            }

        }

        trackCount--;

    }

    return self;

}

Вот то, как работает код:

1. Этот метод берет путь к файлу фильма в формате QuickTime как его входной параметр.

2. Устанавливает массив свойств фильма. Эти свойства указывают

   • путь к файлу к фильму

   • должен ли новый фильм быть активным (да, в этом случае)

   • визуальный контекст для соединения с этим фильмом. qtVisualContext переменная является переменной экземпляра класса этого метода.

   Эти свойства передаются позже NewMovieFromProperties функция.

3. Создает контекст текстуры OpenGL. Это - абстрактное место назначения, в которое нарисованы текстуры OpenGL. Функция QuickTime QTOpenGLTextureContextCreate требует, чтобы Вы передали в CGLContext и объекте CGLPixelFormat. В Какао можно получить их из объектов NSOpenGLContext и NSOpenGLPixelFormat, создаваемых при инициализации OpenGL. В Углероде можно получить базовый контекст и формат пикселя от AGLContext и объектов AGLPixelFormat с помощью функций AGL aglGetCGLContext и aglGetCGLPixelFormat.)

   Этот контекст, сохраненный в переменной экземпляра qtVisualContext передается NewMovieFromProperties быть визуальным контекстом, в который QuickTime составит свои фильмы.

4. Создает фильм. Функция QuickTime NewMovieFromProperties, доступный в OS X v10.4 и позже, или QuickTime 7.0 и позже, предпочтительный способ инстанцировать фильмов.

   При использовании Какао можно вызвать метод QTKit movieFromFile вместо этого.

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

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

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

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

При использовании объектно-ориентированного программирования Вы, вероятно, захотите, чтобы Ваш обратный вызов вызвал метод, как показано в Перечислении 2-4 и Перечислении 2-5.

Перечисление 2-4  , Вызывающее метод от Вашего обратного вызова

CVReturn MyDisplayLinkCallback (

    CVDisplayLinkRef displayLink,

    const CVTimeStamp *inNow,

    const CVTimeStamp *inOutputTime,

    CVOptionFlags flagsIn,

    CVOptionFlags *flagsOut,

    void *displayLinkContext)

{

 CVReturn error =

        [(MyVideoView*) displayLinkContext displayFrame:inOutputTime];

 return error;

}

Функция обратного вызова просто вызывает displayFrame метод, реализованный в MyVideoView класс. Экземпляр этого класса передается Вашему обратному вызову в displayLinkContext параметр. ( MyVideoView класс, выводящий на экран Ваши кадры, должен быть подклассом NSOpenGLView, как показано в Перечислении 2-1.)

Перечисление 2-5  Реализовывая displayFrame метод

- (CVReturn)displayFrame:(const CVTimeStamp *)timeStamp

{

    CVReturn rv = kCVReturnError;

    NSAutoreleasePool *pool;

    pool = [[NSAutoreleasePool alloc] init];

    if([self getFrameForTime:timeStamp])

    {

        [self drawRect:NSZeroRect];

        rv = kCVReturnSuccess;

    }

    else

    {

       rv = kCVReturnError;

    }

    [pool release];

    return rv;

}

Вы получаете кадр в течение требуемого времени как текстура OpenGL. Перечисление 2-6 показывает, как Вы могли бы реализовать getFrameForTime метод, если Вы получали свои видеокадры из QuickTime. Этот пример предполагает, что метод является частью пользовательского MyVideoView класс.

Перечисление 2-6  Получая кадры из QuickTime

- (BOOL)getFrameForTime:(const CVTimeStamp*)syncTimeStamp

{

    CVOpenGLTextureRef      newTextureRef = NULL;

    QTVisualContextTask(qtVisualContext);// 1

    if(QTVisualContextIsNewImageAvailable(qtVisualContext, syncTimeStamp))// 2

    {

        QTVisualContextCopyImageForTime(qtVisualContext, NULL, syncTimeStamp,// 3

                 &newTextureRef);

        CVOpenGLTextureRelease(currentFrame);// 4

        currentFrame = newTextureRef;

        CVOpenGLTextureGetCleanTexCoords (// 5

                    currentFrame, lowerLeft, lowerRight, upperRight, upperLeft);

        return YES; // we got a frame from QT

    }

    else

    {

        //NSLog(@"No Frame ready");

    }

    return NO;  // no frame available

}

Вот то, как работает код:

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

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

3. Если кадр доступен, получите его как текстуру OpenGL. Функция QuickTime QTVisualContextCopyImageForTime позволяет Вам получить кадр из QuickTime как любой Базовый буферный тип Видеоизображения.

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

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