Direct Input을 이용한 마우스 입력.

[천동이]

요새 정말 할일 없이 바쁘네요. 강좌가 늦어진점 죄송하게 생각하구요.


흠... 이번시간에 배울 마우스 입력은...

단순히 지난시간에 배운 키보드 입력 시간의 소스의 Keyboard를 Mouse로 바꾸어 입력해 주는 것만으로도 90%는 완성이 됩니다.


즉, 키보드 입력과 마우스 입력은 코딩 과정이 동일 합니다.

그런데 마우스의 경우 한가지 더 생각해야 할 점이 있죠.

마우스는 버튼만 있는것이 아니라는 사실...

그렇습니다. 마우스에는 바로 좌표가 있습니다.


이 좌표를 처리해주는 것이 Direct Input을 처음 접하는 분께는 왜 이렇게 해야하나 라는 의문점을 갖게 만들기에 충분합니다.

마우스 좌표를 다루는 방법에는 상대 좌표와 절대 좌표 처리방법이 있습니다.

절대 좌표의 경우, 현재 기본 표면 내에서 마우스 커서가 어디에 위치하고 있는지를 의미합니다.

반면에 상대 좌표란, 이전의 좌표에서 현재 좌표까지 얼마나 이동했는지의 이동량을 의미합니다.


대부분의 Direct Input 프로그램이라면 상대 좌표를 사용하게 됩니다.

상대 좌표는 현재 마우스가 이동한 만큼을 마우스커서의 좌표에 변화를 주게 되겠지요?

그렇기 때문에, 상대 좌표로 표현한 마우스의 좌표는 윈도우의 실제 마우스 좌표와 다를 수가 있습니다.


오늘 만들게 될 소스는 지난시간에 만든 키보드 입력 소스는 그대로 놔두고, 마우스 입력 부분을 추가한 소스입니다.

평상시에는 그냥 현재 마우스 좌표만을 표시해 주다가, 왼쪽 버튼을 누르면 왼쪽 버튼이 눌려졌다고 나오고 오른쪽 버튼이 눌려지면 오른쪽 버튼이 눌려졌다고 나오는 그런 소스입니다.

원래 대부분의 Direct Input 책에 보면, 마우스 부분에서는 마우스 입력만을 다루는게 정석이지만,

키보드 입력의 과정과 마우스 입력의 과정을 비교하시길 바라면서 두개의 과정을 하나의 소스에 묶어보았습니다.

* Game.h

#ifndef _GAME_H_
#define _GAME_H_
#define DIRECTINPUT_VERSION 0x0700 // 우리는 DirectInput7버전을 사용할 것이다.

#include "Common.h"
#include "ddraw.h"
#include "dinput.h"

#define RLimit        ClientRect.right-lstrlen(str)*8
#define BLimit        ClientRect.bottom-15
#define Movement  5 // 이동량.

#define DIKEYDOWN(data, n)    (data[n] & 0x80)
#define DILBUTTON(State)       (State.rgbButtons[0] & 0x80) // 마우스 왼쪽 버튼 클릭.
#define DIRBUTTON(State)       (State.rgbButtons[1] & 0x80) // 마우스 오른쪽 버튼 클릭.
#define DIMBUTTON(State)      (State.rgbButtons[2] & 0x80) // 마우스 가운데 버튼 클릭.

class CGame
{
private:
    HDC hDC;
    HWND hWnd; 
    HINSTANCE hInst; 

    bool bPause; // 현재 게임이 정지 상태인지의 여부. 
    LPDIRECTDRAW7 lpdd;

    BYTE KeyState[256];
    DIMOUSESTATE MouseState;

    LPDIRECTINPUT lpdi;
    LPDIRECTINPUTDEVICE lpdiKbd;
    LPDIRECTINPUTDEVICE lpdiMouse;

    char str[50];
    POINT pt; // 클라이언트의 화면 좌표.
    RECT ClientRect; // 클라이언트 렉트.
    COORD Text; // 문자열의 좌표.
    COORD PreText; // 문자열의 이전 좌표.

    DDSURFACEDESC2 ddsd;
    LPDIRECTDRAWSURFACE7 lpddSPrimary; // Primary Surface.
public:
    int Init(HWND m_hWnd, HINSTANCE m_hInst); // 게임 초기화.
    int Main(); // 게임 메인.
    int Shutdown(); // 게임 종료.

    int GetClientPos(); // 클라이언트 영역의 화면 위치를 얻어온다.
    int SetAcquire();
    int GetInput(); // 키 입력을 받는다.
};

#endif // end of ifndef _GAME_H.

지난 시간에 봤던 헤더파일과 전~혀 다를 것이 없습니다.

단지, DIL/M/RBUTTON() 매크로 함수가 추가 되어있는데요.

이 함수 역시 DIKEYDOWN() 과 기능적 의미는 동일하지만, 부가 설명은 필요하겠죠.

조금 있다가 Game.cpp를 설명하면서 다시 한번 짚고 넘어가도록 하겠습니다.


그리고 키보드 입력을 받기 위해서 BYTE형 배열 256개를 선언해 주었던것에 비해,

DIMOUSESTATE라는 특이한 구조체를 선언해 주고 있습니다.

DIMOUSESTATE에는 마우스의 버튼 입력과 좌표 입력을 동시에 받기 위한 구조체이고, 조금 뒤에 또 설명해드릴 것입니다.


또 당연히, 마우스 입력을 받을 것이므로, 마우스 장치에 대한 LPDIRECTINPUTDEVICE 변수도 선언을 해주어야 하겠죠?^^

* Game.cpp

#include "Game.h"

int CGame::GetClientPos()
{
    pt.x = 0;
    pt.y = 0;

    ClientToScreen(hWnd, &pt); // 클라이언트 영역의 화면 좌표를 구해온다. 
    GetClientRect(hWnd, &ClientRect); // 클라이언트 렉트를 구한다.

    return 0;
}

int CGame::Init(HWND m_hWnd, HINSTANCE m_hInst)
{
    hWnd = m_hWnd;
    hInst = m_hInst;

    // DirectDraw 객체 생성.
    if( FAILED(DirectDrawCreateEx(NULL, (LPVOID*)&lpdd, IID_IDirectDraw7, NULL)) )
        return ERR;
    if( FAILED(lpdd->SetCooperativeLevel(hWnd, DDSCL_NORMAL)) )
        return ERR;

    // 프라이머리 서페이스 생성.
    memset(&ddsd, 0, sizeof(ddsd));
    ddsd.dwSize = sizeof(ddsd);
    ddsd.dwFlags = DDSD_CAPS;
    ddsd.ddsCaps.dwCaps = DDSCAPS_PRIMARYSURFACE;

    if( FAILED(lpdd->CreateSurface(&ddsd, &lpddSPrimary, NULL)) )
        return ERR;

    // DirectInput 객체 생성.
    if( FAILED(DirectInputCreate(hInst, DIRECTINPUT_VERSION, &lpdi, NULL)) )
        return ERR;

    // 키보드 인풋 세팅.
    if( FAILED(lpdi->CreateDevice(GUID_SysKeyboard, &lpdiKbd, NULL)) )
        return ERR;
    if( FAILED(lpdiKbd->SetDataFormat(&c_dfDIKeyboard)) )
        return ERR;
    if( FAILED(lpdiKbd->SetCooperativeLevel(hWnd, DISCL_NONEXCLUSIVE | DISCL_BACKGROUND)) )
        return ERR;

    // 마우스 인풋 세팅.
    if( FAILED(lpdi->CreateDevice(GUID_SysMouse, &lpdiMouse, NULL)) )
        return ERR;
    if( FAILED(lpdiMouse->SetDataFormat(&c_dfDIMouse)) )
        return ERR;
    if( FAILED(lpdiMouse->SetCooperativeLevel(hWnd, DISCL_NONEXCLUSIVE | DISCL_FOREGROUND)) )
        return ERR;

    bPause = false;
    if( SetAcquire() == ERR)
        return ERR;

    lstrcpy(str, "메롱");

    Text.X = 0;
    Text.Y = 0;
    PreText.X = 1;
    PreText.Y = 1;

    GetClientPos(); // 클라이언트의 화면상 위치를 구한다.

    return 0;
}

int CGame::SetAcquire()
{
    if( bPause )
    {
        if( FAILED(lpdiKbd->Unacquire()) )
            return ERR;
        if( FAILED(lpdiMouse->Unacquire()) )
            return ERR;
    }
    else
    {
        if( FAILED(lpdiKbd->Acquire()) )
            return ERR;
        if( FAILED(lpdiMouse->Acquire()) )
            return ERR;
    }

return 0;
}

int CGame::GetInput()
{
    // 키보드에서 데이터 읽어오기.
    if( FAILED(lpdiKbd->GetDeviceState(sizeof(KeyState), (LPVOID)KeyState)) ) 
        return ERR;

    // 마우스에서 데이터 읽어오기.
    if( FAILED(lpdiMouse->GetDeviceState(sizeof(DIMOUSESTATE), (LPVOID)MouseState)) )
         return ERR;

    if( DIKEYDOWN(KeyState, DIK_ESCAPE) )
    {
        bPause = true;
        return ERR;
    }

    // 방향키 입력 처리 멀티키 입력도 가능.
    if( DIKEYDOWN(KeyState, DIK_LEFT) )
        Text.X -= (Text.X < Movement)? 0 : Movement;
    if( DIKEYDOWN(KeyState, DIK_RIGHT) )
        Text.X += (Text.X >= RLimit-Movement)? 0 : Movement;
    if( DIKEYDOWN(KeyState, DIK_UP) )
        Text.Y -= (Text.Y < Movement)? 0 : Movement;
    if( DIKEYDOWN(KeyState, DIK_DOWN) )
        Text.Y += (Text.Y > BLimit-Movement)? 0 : Movement;

    // 마우스 좌표.
    Text.X += MouseState.lX;
    Text.Y += MouseState.lY;

    if(Text.X < 0)
        Text.X = 0;
    if(Text.X > RLimit-Movement)
        Text.X = RLimit-Movement;

    if(Text.Y < 0)
        Text.Y = 0;
    if(Text.Y > BLimit-Movement)
        Text.Y = BLimit-Movement;

    char str2[256];

    if( DILBUTTON(MouseState) ) // 마우스 왼쪽 버튼 클릭시,
    {
        wsprinf(str2, "왼쪽 버튼이 눌려짐, (%d, %d)", Text.X, Text.Y);
        lstrcpy(str, str2);
    }
    else if( DIRBUTTON(MouseState) ) // 마우스 오른쪽 버튼 클릭시,
    {
        wsprintf(str2, "오른쪽 버튼이 눌려짐, (%d, %d)", Text.X, Text.Y);
        lstrcpy(str, str2);
    }
    else // 아무런 버튼도 눌려지지 않았다면,
    {
        wsprintf(str2, "아무 버튼도 눌려지지 않았음, (%d, %d)", Text.X, Text.Y);
        lstrcpy(str, str2);
    }

    return 0;
}

int CGame::Main()
{
    if( GetInput() == ERR )
        return ERR;

    lpddSPrimary->GetDC(&hDC);

    // 이전 위치의 문자열을 지워주고,
    SelectObject(hDC, GetStockObject(BLACK_PEN));
    SelectObject(hDC, GetStockObject(BLACK_BRUSH));

    Rectangle(hDC, 
            pt.x + PreText.X, 
            pt.y + PreText.Y, 
            pt.x + PreText.X+lstrlen(str)*8+50,
            pt.y + PreText.Y+20);

    // 문자열을 그려준다.
    SetBkColor(hDC, RGB(0, 0, 0));
    SetTextColor(hDC, RGB(255, 255, 0));
    TextOut(hDC, pt.x+Text.X, pt.y+Text.Y, str, lstrlen(str));

    lpddSPrimary->ReleaseDC(hDC);

    Sleep(50);

    // 문자열의 이전위치 기억.
    PreText.X = Text.X;
    PreText.Y = Text.Y;

    return 0;
}

int CGame::Shutdown()
{
    SetAcquire();

    SAFERELEASE( lpdiMouse );
    SAFERELEASE( lpdiKbd );
    SAFERELEASE( lpdi );
    SAFERELEASE( lpddSPrimary );
    SAFERELEASE( lpdd );

    return 0;
}

글쎄요... 지난 번과 마찬가지로 설명해드릴 것이 별로 없습니다.

왜냐면 지난 번의 설명에서 c_dfDIKeyboard와 같은 부분을 c_dfDIMouse로 바꾸어 준 것이나, SysKeyboard를 SysMouse로 바꾸어준 것...

그 정도의 차이 말고는 별 차이가 없으니까요.


단지 마우스 입력 부분에서 가장 중요한 부분이 있다면, 협력 레벨을 세팅해주는 부분인데요.

  lpdiMouse->SetCooperativeLevel(hWnd, DISCL_NONEXCLUSIVE | DISCL_FOREGROUND)

이렇게 되어 있지요.

키보드 입력에서는 거의 모든 경우에 DISCL_NONEXCLUSIVE로 세팅하는 것이 정석이지만,

마우스 모드에서는 필요에 따라 협력 레벨을 바꿔주는 작업이 필요합니다.


보통의 경우 마우스 입력을 받을 때는,

    DISCL_EXCLUSIVE | DISCL_FOREGROUND

와 같이 줍니다.

DISCL_NONEXCLUSIVE로 주게 되면, 마우스 커서가 보이지만, DISCL_EXCLUSIVE로 작업을 하게 되면 마우스 커서가 안보이게 됩니다.(직접 소스를 코딩해 놓고 플래그를 이것 저것 바꿔보시면 훨씬더 이해가 빠릅니다.)

EXCLUSIVE 모드로 만들어 놓고 좌표를 내부적으로 계산해서 그 위치에 마우스 커서를 직접 그려주는 작업이 필요하게 되겠지요.


DISCL_NONEXCLUSIVE로 준 이유는 윈도우 자체의 마우스 좌표와 다이렉트 드로우 인풋에서 처리하는 마우스 좌표가 다를 수 있다는 것을 보여드리기 위해서 였습니다.

실제로 실행 해보시면, 마우스가 움직일때마다 글씨가 움직이기는 하지만, 글씨의 위치가 윈도우의 마우스 좌표와 일치하지는 않는 것을 보실수 있을겁니다.


또한, 다이렉트 인풋에서는 마우스의 좌표가 얼마나 이동했는지의 변화 값을 매 프레임 마다 DIMOUSESTATE구조체의 lX, lY에 전달 받게 되므로,

프레임 마다, 마우스 좌표의 변화값을 좌표 변수에 더해 주면 되겠죠.


또 마우스 버튼 클릭 여부를 조사 하는 부분에서,

DIL/RBUTTON 이라는 매크로 함수를 정의 해놓고 사용하고 있는데요.

DIMOUSESTATE 구조체의 rgbButtons[0]번이 1이라면, 왼쪽 버튼이 눌려진 것이고,

rgbButtons[1]번이 1이라면, 오른쪽 버튼, rgbButtons[2]번이 1이라면 가운데 버튼이 눌려진 것입니다.

그리고 사실은 rgbButtons[3] 번도 있는데요. 3번은 여분용으로 제작되었다고 하는데, MS사에서 나오는 X-Mouse의 버튼의 처리가 가능하다고 하네요.(이것때문에 Anti-MS 팬이 두배로 늘었다는 소문이...)


뭐 지금까지 설명 해드린것 외에는 전혀 특별한 것이 없습니다.