Стэн Трухильо - Графика для Windows средствами DirectDraw

HRESULT WINAPI DirectDrawWin::DisplayModeAvailable(LPDDSURFACEDESC desc, LPVOID p) {

DirectDrawWin* win=(DirectDrawWin*)p;

int& count=win->totaldisplaymodes;

if (count==MAXDISPLAYMODES) return DDENUMRET_CANCEL;

win->displaymode[count].width = desc->dwWidth;

win->displaymode[count].height = desc->dwHeight;

win->displaymode[count].depth = desc->ddpfPixelFormat.dwRGBBitCount;

count++;

return DDENUMRET_OK;

}

DirectDraw вызывает функцию DisplayModeAvailable()для каждого поддерживаемого видеорежима. Структура DDSURFACEDESC, передаваемая косвенно вызываемой функции, содержит описание обнаруженного видеорежима. Функция DisplayModeAvailable()сохраняет разрешение экрана и глубину пикселей в специальном массиве, называемом displaymode. В переменной total displaymodesхранится количество обнаруженных видеорежимов; если значение totaldisplaymodesдостигает MAXDISPLAYMODES, перечисление завершается возвратом кода DDENUMRET_CANCEL.

Затем функция OnCreate()сортирует элементы displaymodeтак, чтобы режимы с низким разрешением находились в начале массива. Это делается с помощью функции Win32 qsort(), которой передается функция косвенного вызова для «сравнения» видеорежимов. В нашем случае используется функция CompareModes(), которая сравнивает видеорежимы сначала по разрешению, а затем по глубине пикселей. Я пропускаю дальнейшее обсуждение CompareModes(), потому что оно не имеет никакого отношения к DirectDraw.

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

virtual int SelectInitialDisplayMode() = 0;

В C++ чисто виртуальные функции обязательно должны переопределяться, в противном случае класс не будет компилироваться. Однако со стороны DirectDrawWinбыло бы нечестно требовать от производного класса выбора исходного видеорежима, не предоставляя ему средств для просмотра возможных вариантов (переменные класса, в которых хранятся сведения о видеорежимах, являются закрытыми ( private)). Для этой цели в классе DirectDrawWinпредусмотрены функции GetNumDisplayModes()и GetDisplayModeDimensions(). В версии SelectInitialDisplayMode()класса BounceWinэти функции используются для выбора исходного режима:

int BounceWin::SelectInitialDisplayMode() {

int i, nummodes=GetNumDisplayModes();

DWORD w,h,d;

for (i=0;i

GetDisplayModeDimensions(i, w, h, d);

if (w==desiredwidth && h==desiredheight && d==desireddepth) return i;

}

for (i=0;i>nummodes;i++) {

GetDisplayModeDimensions(i, w, h, d);

if (d==desireddepth) return i;

}

return 0;

}

Функция сначала определяет количество режимов функцией GetNumDisplayModes(), а затем в цикле пытается найти видеорежим с заданным разрешением и глубиной пикселей. Атрибуты каждого видеорежима извлекаются функцией GetDisplayModeDimensions(); если совпадение будет найдено, возвращается индекс видеорежима. В противном случае другой цикл ищет любой видеорежим с заданной глубиной пикселей. Поскольку цикл начинается с начала массива displaymode, с большей вероятностью будут выбираться режимы низкого разрешения. Если не найдено ни одного видеорежима с заданной глубиной пикселей, возвращается значение 0 — оно говорит о том, что следует использовать видеорежим с минимальным разрешением. Код возврата –1 сообщает DirectDrawWinо том, что ни один приемлемый видеорежим так и не был найден и работу приложения следует завершить.

На предпоследнем этапе происходит активизация выбранного режима. Для этого используется функция ActivateDisplayMode(), которая на самом деле выполняет и задачу последнего этапа (создание поверхностей приложения). Код этой функции приведен в листинге 3.2.

Листинг 3.2.Функция ActivateDisplayMode()

BOOL DirectDrawWin::ActivateDisplayMode(int mode) {

if (mode<0 || mode>=totaldisplaymodes) return FALSE;

DWORD width = displaymode[mode].width;

DWORD height = displaymode[mode].height;

DWORD depth = displaymode[mode].depth;

displayrect.left=0;

displayrect.top=0;

displayrect.right=width;

displayrect.bottom=height;

displaydepth=depth;

ddraw2->SetDisplayMode(width, height, depth, rate, 0);

curdisplaymode = mode;

TRACE("------------------- %dx%dx%d (%dhz) ---------------\n", width, height, depth, rate);

if (CreateFlippingSurfaces()==FALSE) {

FatalError("CreateFlippingSurfaces() failed");

return FALSE;