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

}

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;

return TRUE;

}

Функция CreateFlippingSurfaces()вызывается при каждой инициализации нового видеорежима, поэтому ее работа начинается с освобождения ранее созданных поверхностей функцией Release(). Затем она объявляет и инициализирует экземпляр структуры DDSURFACEDESC. Эта структура описывает тип создаваемой поверхности. В соответствии с требованиями DirectDraw необходимо установить флаги для всех инициализируемых полей. В нашем случае флаги DDSD_CAPSи DDSD_BACKBUFFERCOUNTговорят о том, что мы задаем возможности поверхности (поле dwCaps) и количество вторичных буферов (поле dwBackCount). В поле dwCapsустанавливаются три флага:

• DDSCAPS_PRIMARYSURFACE

• DDSCAPS_FLIP

• DDSCAPS_COMPLEX

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

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

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

Новая поверхность создается вызовом функции CreateSurface()интерфейса DirectDraw. Первым аргументом является указатель на структуру desc, а вторым - указатель на переменную DirectDrawWin::primsurf. Эта переменная объявлена защищенной ( protected), поэтому мы можем использовать ее для доступа к первичной поверхности в своих программах. Третий аргумент функции CreateSurface()должен быть равен 0.