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

}

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;

}

StorePixelFormatData();

if (CreateCustomSurfaces()==FALSE) {

FatalError("CreateCustomSurfaces() failed");

return FALSE;

}

return TRUE;

}

Нужный видеорежим определяется параметром mode, который сначала проверяется на правильность. Затем его ширина, высота и глубина извлекаются из массива displaymodeи заносятся в переменные displayrectи displaydepth. Доступ к этим переменным в производных классах осуществляется с помощью функций GetDisplayRect()и GetDisplayDepth().

Далее выбранный режим активизируется функцией SetDisplayMode()интерфейса DirectDraw. При вызове этой функции передаются пять аргументов: первые три определяют разрешение экрана (ширину и высоту) и глубину пикселей, а четвертый — частоту смены кадров. Пятый аргумент пока не используется и должен быть равен нулю.

Перед тем как рассматривать оставшуюся часть функции, следует сделать одно важное замечание. До сих пор, если функция заканчивалась неудачей и требовалось вывести сообщение, можно было использовать функцию MFC AfxMessageBox(). Пока видеорежим не изменялся, все было нормально, но после изменения видеорежима для вывода сообщений и завершения программы применяется функция FatalError(). Эта функция класса DirectDrawWinвосстанавливает видеорежим Windows, выводит окно сообщения и завершает программу.

Остается лишь создать поверхности, используемые в приложении. После вызова SetDisplayMode()функция ActivateDisplayMode()вызывает еще три функции: CreateFlippingSurfaces(), StorePixelFormatData()и CreateCustomSurfaces(). Функция CreateFlippingSurfaces()создает первичную поверхность с возможностью переключения страниц. Функция StorePixelFormatData()используется для чтения и записи сведений о формате пикселей в данном видеорежиме. Эта информация может пригодиться при работе с видеорежимами High и True Color. Функция CreateCustomSurfaces()отвечает за создание и инициализацию вспомогательных поверхностей, специфических для данного приложения. Начнем с функции CreateFlippingSurfaces():

BOOL DirectDrawWin::CreateFlippingSurfaces() {

if (primsurf) primsurf->Release(), primsurf=0;

DDSURFACEDESC desc;

ZeroMemory(&desc, sizeof(desc));

desc.dwSize = sizeof(desc);

desc.dwFlags = DDSD_CAPS | DDSD_BACKBUFFERCOUNT;

desc.ddsCaps.dwCaps = DDSCAPS_PRIMARYSURFACE | DDSCAPS_FLIP | DDSCAPS_COMPLEX;

desc.dwBackBufferCount = 1;

HRESULT r=ddraw2->CreateSurface(&desc, &primsurf, 0);

if (r!=DD_OK) return FALSE;

DDSCAPS surfcaps;

surfcaps.dwCaps = DDSCAPS_BACKBUFFER;

r=primsurf->GetAttachedSurface(&surfcaps, &backsurf);

if (r!=DD_OK) return FALSE;