DirectX Programming (4)

===============================================================

리스트 4 : DXLoadBitmap 함수

---------------------------------------------------------------

// -------------------------------------------------
// DXLoadBitmap : 지정된 비트맵 파일을 로드하여 오프스크린
// 면을 생성한다.
// -------------------------------------------------

IDirectDrawSurface *DXLoadBitmap(LPCSTR lpBitmapFilename)
{
     HBITMAP hbm;
     BITMAP bm;
     IDirectDrawSurface *pdds;

     hbm = (HBITMAP)LoadImage(NULL, lpBitmapFilename,
          IMAGE_BITMAP, 0, 0,LR_LOADFROMFILE|LR_CREATEDIBSECTION);
     if (hbm == NULL)
          return NULL;
     GetObject(hbm, sizeof(bm), &bm);
     pdds = CreateOffScreenSurface(bm.bmWidth, bm.bmHeight);
     
     if (pdds)
          DXCopyBitmap(pdds, hbm, bm.bmWidth, bm.bmHeight);
     DeleteObject(hbm);

     return pdds;
}

===============================================================

 

===============================================================

리스트 5 : CreateOffScreenSurface 함수

---------------------------------------------------------------

// ----------------------------------------------
// CreateOffScreenSurface : 주어진 크기를 갖는 오프스크린
// 면을 생성한다.
// ----------------------------------------------

IDirectDrawSurface *CreateOffScreenSurface(int dx, int dy)
{
     DDSURFACEDESC ddsd;
     IDirectDrawSurface *pdds;

     ZeroMemory(&ddsd, sizeof(ddsd));
     ddsd.dwSize = sizeof(ddsd);
     ddsd.dwFlags = DDSD_CAPS | DDSD_HEIGHT | DDSD_WIDTH;
     ddsd.ddsCaps.dwCaps = DDSCAPS_OFFSCREENPLAIN;
     ddsd.dwWidth = dx;
     ddsd.dwHeight = dy;

     if (pDirectDrawObj->CreateSurface(&ddsd, &pdds, NULL) != DD_OK){
          return NULL;
     } else {

          // 컬러키를 설정한다.
          // 여기서 컬러키는 흰 색으로 한다.
          DDCOLORKEY ddck;
          ddck.dwColorSpaceLowValue = 0xff;
          ddck.dwColorSpaceHighValue = 0xff;
          pdds->SetColorKey(DDCKEY_SRCBLT, &ddck);

          return pdds;
     }
}

===============================================================

DXCopyBitmap 함수는 첫 번째 인자로 주어진 면 객체의 내용을, 두 번째

인자가 가리키는 비트맵 핸들의 내용으로 변경하는 역할을 한다. 세 번째

인자와 네 번째 인자로는 비트맵의 폭과 높이를 받는다. 실제 절차는 API

나 MFC에서 비트맵 핸들의 내용을 화면으로 복사하는 절차와 동일하다. 먼

저 비트맵 핸들을 내용으로 갖는 디바이스 컨텍스트를 메모

리에 만들어둔다(CreateCompatibleDC와 SelectObject 함수 호출부).

그 다음 면 객체의 디바이스 컨텍스트 핸들을 얻어내고(pdds->GetDC)

BitBlt 함수(이 함수는 다이렉트 드로우의 함수가 아닌 GDI 함수이다)의 호

출을 통해 비트맵의 내용을 면 객체로 복사한다.

 

===============================================================

리스트 6 : DXCopyBitmap 함수

---------------------------------------------------------------

// ----------------------------------------------

// DXCopyBitmap : 지정된 면으로 지정된 비트맵 리소스의

// 내용을 복사한다.

// ----------------------------------------------

HRESULT DXCopyBitmap(IDirectDrawSurface *pdds,

HBITMAP hbm, int dx, int dy)

{

HDC hdcImage;

HDC hdc;

HRESULT hr;

HBITMAP hbmOld;

hdcImage = CreateCompatibleDC(NULL);

hbmOld = (HBITMAP)SelectObject(hdcImage, hbm);

if ((hr = pdds->GetDC(&hdc)) == DD_OK)

{

BitBlt(hdc, 0, 0, dx, dy, hdcImage, 0, 0,

SRCCOPY);

pdds->ReleaseDC(hdc);

}

SelectObject(hdcImage, hbmOld);

DeleteDC(hdcImage);

return hr;

}

===============================================================

 

===============================================================

리스트 7 : UpdateFrame 함수

---------------------------------------------------------------

// ----------------------------------------------

// UpdateFrame : 주기적으로 호출되어 후위면과 전위면의

// 내용을 교체한다.

// ----------------------------------------------

void UpdateFrame(void)

{

RECT rcRect = { 0, 0, 26, 32 };

HRESULT ddrval;

static int xpos=(640-26)/2, ypos=440;

// 배경 면을 그린다.

if (DrawBackground() == DDERR_SURFACELOST)

RestoreSurface();

// 키눌림을 체크하여 메인 캐릭터를 움직인다.

if (GetAsyncKeyState(VK_LEFT) < 0) // 왼쪽으로

xpos -= 5;

else if (GetAsyncKeyState(VK_RIGHT) < 0)

// 오른쪽으로

xpos += 5;

else if (GetAsyncKeyState(VK_UP) < 0) // 위로

ypos -= 5;

else if (GetAsyncKeyState(VK_DOWN) < 0)

// 아래로

ypos += 5;

// 좌표가 경계를 벗어났는지 검사한다.

if (xpos < 0)

xpos = 0;

else if (xpos > 640-26)

xpos = 640-26;

if (ypos < 0)

ypos = 0;

else if (ypos > 480-32)

ypos = 480-32;

// 메인 캐릭터를 그린다.

ddrval = pBackSurface->BltFast

(xpos, ypos, pMainCharacter, &rcRect,

DDBLTFAST_SRCCOLORKEY | DDBLTFAST_WAIT);

// 전위 면과 후위 면을 교체한다.

ddrval = pPrimarySurface->Flip(NULL,

DDFLIP_WAIT);

}

===============================================================

 

UpdateFrame 함수

이제부터 할 일은 바로 앞서 제일 처음 WinMain에서 보았던 가장 중요한

함수 Updateframe의 내용을 살펴보는 일이다. UpdateFrame은 게임의 장면

을 하나 하나씩 구성하여 이를 페이지 플립핑을 통해 화면으로 내보내는 일

을 담당한다. 이 함수의 내용은 리스트 7과 같다.

새로운 장면을 구성하는 방법은 간단하다. 먼저 배경 비트맵의 내용을 후

위 면에 복사한다. 다음으로 스프라이트의 내용을 후위 면에 덮어써주는

데 키 입력이나 상황 변화 등을 고려해 스프라이트의 출력 위치를 보정해준

다. 배경을 그려주기 위한 용도로 DrawBackground라는 함수를 호출한다(리

스트 8 참조).

DrawBackground 함수는 단순히 배경을 그려주는 것이 아니다. 비행기가 가

만히 있어도 앞으로 진행되는 듯한 효과를 주기 위해 배경 비트맵을 조금

씩 회전시켜가며 뿌려준다. nStartRow라는 변수를 두어 배경 비트맵 출력

시 이 줄부터 마지막 줄까지를 후위 면의 앞에 출력하고 첫 번째 줄부터

nStartRow의 앞 줄까지를 후위 면의 그 뒤에 이어서 출력한다. 출력이 끝나

면 nStartRow의 값을 5씩 증가시켜 마치 배경 면이 앞으로 진행하는 듯

한 효과를 준다. 출력이 후위 면으로 나가는 것이기 때문에 후위 면 객체

의 BltFast 함수를 사용한다.

첫 번째 인자와 두 번째 인자로는 출력이 어디로 나갈 것인지 그 시작 위치

를 나타낸다. 세 번째 인자로는 소스 면 객체의 포인터를 지정하는 부분이

다. 네 번째 인자로 소스 면 객체의 어느 영역을 복사할 것인지를 지정한

다. BltFast 함수와 비슷한 기능을 하는 것으로 Blt 함수가 있는데 이는

복사시 확대나 축소까지 가능하다. BltFast는 1:1 복사만 가능하다. 배경

면의 복사시에는 컬러키가 필요없다(처음 뿌려지는 것이기 때문에 보존해

야할 배경이 없기 때문이다). 그렇기 때문에 BltFast 함수의 마지막 인자

를 보면 DDBLTFAST_SRCCOLORKEY라는 값을 지정하고 있다. 다시

UpdateFrame 함수로 돌아가서 배경 면의 출력이 끝나면 키 입력을 검사한

다. 사실 키 입력의 체크는 Update Frame이 아닌 WM_KEY* 메시지에서 수행

해도 관계없지만 보다 더 실시간으로 체크하려면 여기서 수행해주는 것이

더 좋다. 방향키를 체크하여 비행기 스프라이트의 출력 위치를 보정해 준

다. 출력 위치는 xpos와 ypos 변수에 들어간다. 스프라이트의 출력 좌표가

결정나면 후위 면에 그 내용을 출력하고 주 면 객체의 Flip 함수를 이용

해 주 면과 후위 면의 내용을 교체하여 후위 면의 내용이 사용자 눈에 보이

도록 한다.

 

// 메인 캐릭터를 그린다.

ddrval = pBackSurface->BltFast

(xpos, ypos, pMainCharacter, &rcRect,

DDBLTFAST_SRCCOLORKEY | DDBLTFAST_WAIT);

// 전위 면과 후위 면을 교체한다.

ddrval = pPrimarySurface->Flip(NULL, DDFLIP_WAIT);

 

리스트 8 : DrawBackground 함수

// ----------------------------------------------

// DrawBackground : 배경 면의 내용을 스크롤시켜가며

// 후위 면으로 그려준다.

// ----------------------------------------------

HRESULT DrawBackground()

{

RECT rcRect;

HRESULT ddrval;

static int nStartRow = 0;

// 배경 비트맵의 어느 줄부터 출력이 시작될지를 나타낸다.

rcRect.left = 0;

rcRect.top = nStartRow;

rcRect.right = 640;

rcRect.bottom = 480;

ddrval = pBackSurface->BltFast

(0, 0, pBackground, &rcRect,

DDBLTFAST_NOCOLORKEY | DDBLTFAST_WAIT);

if (ddrval != DD_OK)

{

return ddrval;

}

 

if (nStartRow)

{

rcRect.top = 0;

rcRect.bottom = nStartRow-1;

ddrval = pBackSurface->BltFast

(0, 480-nStartRow, pBackground, &rcRect,

DDBLTFAST_NOCOLORKEY | DDBLTFAST_WAIT);

if (ddrval != DD_OK)

{

return ddrval;

}

}

nStartRow += 5;

nStartRow = nStartRow % 480;

return DD_OK;

}

 

면의 유실 처리

 

앞의 용어 정리에서 설명했던 것처럼 다이렉트 드로우를 사용하다 보면

면 객체의 내용이 사라져 버리는 경우가 발생한다. 이는 다이렉트 드로우

가 동작하는 윈도 환경이 혼자서만 사는 공간이 아니라 다른 윈도 프로그램

들과 같이 공존하는 공간이며 또한 다른 윈도 프로그램에서 사용하는 GDI

가 다이렉트 드로우의 존재를 모르기 때문에 발생하는 문제이다.

다이렉트 프로그램을 실행 중인 상태에서 다른 윈도 프로그램의 전이는 얼

마든지 가능하다. 이 경우 다른 프로그램에서 출력 모듈로 GDI를 사용할

것이고 이 때 GDI는 출력 관련 자원을 독점해버린다. 즉, 다이렉트 드로우

에서 설정해놨던 내용이 모두 깨져버리게 된다.

이 현상을 면이 유실되었다고 한다. 면의 유실 여부는 면 객체의 IsLost

함수를 불러보거나 면 출력 관련 함수의 리턴값이 DDERR_SURFACELOST인지

를 살펴보면 된다. UpdateFrame 함수안에서 배경 면의 출력시에 면의 유

실 여부를 검사하여 유실되었으면 복구하는 부분이 나온다.

 

// 배경 면을 그린다.

if (DrawBackground() == DDERR_SURFACELOST)

RestoreSurface();

 

면이 유실되었으면 RestoreSurface를 호출하여 면을 복구한다. 이 함수의

내용은 리스트 9와 같다.

면 자체의 복구는 면 객체의 Restore 함수를 호출하면 된다. 하지만 오프

스크린 면 객체의 경우 그 내용은 Restore에서 복구할 수가 없기 때문에 다

시 로드해주어야 한다. 그 용도로 사용하는 함수가 바로 DXReLoadBitmap

함수이다(리스트 10 참조). 앞서 보았던 DXLoadBitmap 함수와 그 내용은

비슷하지만 면 객체를 직접 생성하지는 않고 내용만 다시 로드하는 역할을

한다.

 

다이렉트 드로우 객체 제거

 

다이렉트 드로우 객체의 제거는 UpdateFrame 함수의 뒤에서 수행한다.

....

}

// DirectDraw 객체를 제거한다.

if (pBackground)

pBackground->Release();

if (pMainCharacter)

pMainCharacter->Release();

if (pPrimarySurface)

pPrimarySurface->Release();

if (pBackSurface)

pBackSurface->Release();

if (pDirectDrawPal)

pDirectDrawPal->Release();

if (pDirectDrawObj)

pDirectDrawObj->Release();

 

===============================================================

리스트 9 : RestoreSurface 함수

---------------------------------------------------------------

// -----------------------------------------------
// RestoreSurface : 면 유실시 면의 내용을 복구해준다.
// -----------------------------------------------
BOOL RestoreSurface()
{
     if (pPrimarySurface && pPrimarySurface->IsLost() != DD_OK) {
          pPrimarySurface->Restore();
          if (pDirectDrawPal)
               pPrimarySurface->SetPalette(pDirectDrawPal);
     }

     // 배경 비트맵을 복구한다.

     if (pBackground && pBackground->IsLost()!= DD_OK) {
          pBackground->Restore();

          DXReLoadBitmap(pBackground, "MEDIA\\BACK0000.BMP");
     }

     // 비행기 비트맵을 복구한다.
     if (pMainCharacter && pMainCharacter->IsLost()!= DD_OK) {

          pMainCharacter->Restore();
          DXReLoadBitmap(pMainCharacter, "MEDIA\\SHIP0000.BMP");
     }
     return TRUE;
}

===============================================================

 

===============================================================

리스트 10 : DXReLoadBitmap 함수

---------------------------------------------------------------

// ---------------------------------------------

// DXReLoadBitmap : 면 유실의 경우 오프스크린 면의

// 내용을 다시 로드하는데 사용된다.

// ----------------------------------------------

BOOL DXReLoadBitmap(IDirectDrawSurface *pdds,LPCSTR lpBitmapFilename)
{
     HBITMAP hbm;
     BITMAP bm;
     BOOL bSuccess = FALSE;
     hbm = (HBITMAP)LoadImage(NULL, lpBitmapFilename, IMAGE_BITMAP, 0, 0,LR_LOADFROMFILE|LR_CREATEDIBSECTION);

     if (hbm == NULL)
          return NULL;

     GetObject(hbm, sizeof(bm), &bm);
     if (pdds) {
          bSuccess = (DXCopyBitmap(pdds, hbm, bm.bmWidth, bm.bmHeight) == DD_OK) ? TRUE : FALSE;
     }

     DeleteObject(hbm);

     return bSuccess;

}

===============================================================

 

 

- 계속 -

 

- the end of this article -