netlib.narod.ru< Назад | Оглавление | Далее >

Графический вывод

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

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

BOOL DirectDrawApp::OnIdle(LONG)
{
    if (ddwin->PreDrawScene())
    ddwin->DrawScene();
    return TRUE;
}

Функция OnIdle() вызывает функцию DirectDrawWin::PreDrawScene() и в зависимости от полученного результата вызывает функцию DrawScene(). Функция OnIdle() всегда возвращает TRUE, потому что при возврате FALSE MFC перестает ее вызывать. Функция PreDrawScene() реализована так:

BOOL DirectDrawWin::PreDrawScene()
{
    if (window_active && primsurf->IsLost())
    {
        HRESULT r;
        r = primsurf->Restore();
        if (r != DD_OK)
            TRACE("can't restore primsurf\n");
        r = backsurf->Restore();
        if (r != DD_OK)
            TRACE("can't restore backsurf\n");

        RestoreSurfaces();
    }

    return window_active;
}

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

Потеря поверхностей происходит из-за того, что DirectDraw выделяет занятую видеопамять для других целей. Потерянную поверхность можно легко восстановить, но лишь после того, как приложение станет активным, поэтому перед тем, как восстанавливать поверхности, функция PreDrawScene() ждет установки флага window_active (состояние флага window_active зависит от сообщений WM_ACTIVATEAPP, обрабатываемых функцией DirectDrawWin::OnActivateApp). После восстановления первичной поверхности и вторичного буфера вызывается функция RestoreSurfaces(). Она является чисто виртуальной функцией, которая должна быть реализована в производных классах. Сейчас мы рассмотрим ее возможную реализацию.

Так как функция OnIdle() вызывает DrawScene() лишь после проверки результата PreDrawScene(), DrawScene() будет вызвана лишь в том случае, если приложение активно, а первичная и вторичная поверхности не были потеряны.

Функция DrawScene()

Классы, производные от DirectDrawWin, реализуют функцию DrawScene(), в которой происходит обновление экрана. Версия DrawScene() из класса BounceWin выглядит так:

void BounceWin::DrawScene()
{
    CRect limitrect = GetDisplayRect();
    x += xinc;
    y += yinc;
    if (x < -160 || x > limitrect.right - 160)
    {
        xinc = -xinc;
        x += xinc;
    }
    if (y < -100 || y > limitrect.bottom - 120)
    {
        yinc = -yinc;
        y += yinc;
    }
    ClearSurface(backsurf, 0);

    BltSurface(backsurf, surf1, x, y);

    primsurf->Flip(0, DDFLIP_WAIT);
}

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

Затем мы вызываем функцию ClearSurface() и передаем ей два аргумента: указатель backsurf и 0. Это приводит к тому, что вторичный буфер заполняется черным цветом. Хотя я упоминал о том, что использование ClearSurface() иногда осложняется различными форматами пикселей, заполнение поверхностей черным работает надежно. Для палитровых поверхностей 0 означает черный цвет, потому что по умолчанию он стоит в палитре на первом месте; для беспалитровых поверхностей 0 всегда соответствует черному цвету.

Функция DrawScene() использует функцию DirectDrawWin::BltSurface() для копирования поверхности surf1 на поверхность backsurf. Два последних аргумента BltSurface() определяют точку поверхности-приемника, куда должно быть скопировано содержимое источника. Для выполнения этой операции можно было бы воспользоваться функцией Blt() или BltFast() интерфейса DirectDrawSurface, но мы не делаем этого из-за возможного отсечения. Обратите внимание — код, определяющий положение растра, позволяет источнику выйти за пределы приемника, в результате чего может потребоваться отсечение. Мы не можем воспользоваться функцией Blt(), потому что тогда потребовалось бы присоединить к приемнику объект DirectDrawClipper, чего мы не делаем. Функция BltFast() тоже не подходит, потому что она вообще не поддерживает отсечения. Функция BltSurface() автоматически выполняет отсечение, а функции Blt() и BltFast() вызываются внутри нее.

Но перед тем, как переходить к функции BltSurface(), мы закончим рассмотрение функции DrawScene(). Она завершается вызовом функции Flip(). При этом происходит переключение страниц, и подготовленный нами кадр отображается на экране. Функция Flip() получает два аргумента: указатель на поверхность и переменную типа DWORD, предназначенную для установки флагов. Указатель на поверхность необходим лишь в нестандартных ситуациях, когда в переключении поверхностей участвует несколько вторичных буферов. Второй аргумент обычно содержит флаг DDFLIP_WAIT, показывающий, что возврат из функции должен происходить только после того, как переключение страниц завершится.

Функция BltSurface()

Функция BltSurface() класса DirectDrawWin оказывается более гибкой и удобной по сравнению с функциями DirectDrawSurface::Blt() и BltFast(). Мы уже видели, как BltSurface() используется внутри функции BounceWin::DrawScene(), а сейчас рассмотрим саму функцию.

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


Листинг 3.3. Функция BltSurface()

BOOL DirectDrawWin::BltSurface(LPDIRECTDRAWSURFACE destsurf,
      LPDIRECTDRAWSURFACE srcsurf, int x, int y, BOOL srccolorkey)
{
    if (destsurf == 0 || srcsurf == 0)
        return FALSE;

    BOOL use_fastblt=TRUE;

    DDSURFACEDESC destsurfdesc;
    ZeroMemory(&destsurfdesc, sizeof(destsurfdesc));
    destsurfdesc.dwSize = sizeof(destsurfdesc);
    destsurf->GetSurfaceDesc(&destsurfdesc);
    CRect destrect;
    destrect.left = 0;
    destrect.top = 0;
    destrect.right = destsurfdesc.dwWidth;
    destrect.bottom = destsurfdesc.dwHeight;

    DDSURFACEDESC srcsurfdesc;
    ZeroMemory(&srcsurfdesc, sizeof(srcsurfdesc));
    srcsurfdesc.dwSize = sizeof(srcsurfdesc);
    srcsurf->GetSurfaceDesc(&srcsurfdesc);

    CRect srcrect;
    srcrect.left = 0;
    srcrect.top = 0;
    srcrect.right = srcsurfdesc.dwWidth;
    srcrect.bottom = srcsurfdesc.dwHeight;

    // Проверить, нужно ли что-нибудь делать...
    if (x + srcrect.left >= destrect.right)
        return FALSE;
    if (y + srcrect.top >= destrect.bottom)
        return FALSE;
    if (x + srcrect.right <= destrect.left)
        return FALSE;
    if (y + srcrect.bottom <= destrect.top)
        return FALSE;

    // При необходимости выполнить отсечение
    // для прямоугольной области источника
    if (x + srcrect.right > destrect.right)
        srcrect.right -= x + srcrect.right - destrect.right;
    if (y + srcrect.bottom > destrect.bottom)
        srcrect.bottom -= y + srcrect.bottom - destrect.bottom;

    CRect dr;
    if (x < 0)
    {
        srcrect.left = -x;
        x = 0;
        dr.left = x;
        dr.top = y;
        dr.right = x + srcrect.Width();
        dr.bottom = y + srcrect.Height();
        use_fastblt=FALSE;
    }

    if (y < 0)
    {
        srcrect.top = -y;
        y = 0;
        dr.left = x;
        dr.top = y;
        dr.right = x + srcrect.Width();
        dr.bottom = y + srcrect.Height();
        use_fastblt=FALSE;
    }

    DWORD flags;
    if (use_fastblt)
    {
        flags = DDBLTFAST_WAIT;
        if (srccolorkey)
            flags |= DDBLTFAST_SRCCOLORKEY;
        destsurf->BltFast(x, y, srcsurf, &srcrect, flags);
    }
    else
    {
        flags=DDBLT_WAIT;
        if (srccolorkey)
            flags |= DDBLT_KEYSRC;
        destsurf->Blt(&dr, srcsurf, &srcrect, flags, 0);
    }
    return TRUE;
}


Сначала функция BltSurface() проверяет указатели на поверхности. Если хотя бы один из них равен нулю, функция возвращает FALSE, тем самым сообщая о неудаче. Если проверка прошла успешно, два объекта CRect инициализируются в соответствии с размерами поверхностей, полученными с помощью функции DirectDrawSurface::GetSurfaceDesc().

Затем BltSurface() проверяет, попадает ли точка назначения в границы приемника. Если координаты x и y таковы, что копия не пересекается с поверхностью приемника, блиттинг не нужен, поэтому мы просто выходим из функции.

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

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


netlib.narod.ru< Назад | Оглавление | Далее >

Сайт управляется системой uCoz