1. Chapter 14 DirectInput의 전말

2. 이 장에서는 - DirectDinput에 대해서 파악하기 - 키보드 장치 생성하고 사용하기 - 마우스 사용하기
- 조이스틱 설정하기

3. DirectX 가 지원하는 입력장치 키보드: 표준 QWERTY 키보드 마우스: 2버튼 그리고 3버튼 마우스
조이스틱과 비행 요크: 아날로그와 디지털 조이스틱/비행-요크는 6만큼의 자유도와 최대 32개의 버튼을 지원한다.
운전대 컨트롤: 아날로그 디지털 운전 시뮬레이션용
패들: 다양한 회전 장치
포스-피드백(force-feedback) 장치: 기계적인 액튜에이터(actuator)가 있어서, 컴퓨터가 진동시키거나 모양을 바꿀 수 있는 조이스틱 또는 다른 장치들.
가상현실 헤드기어 트래킹 시스템(virtual reality headgear tracking system): 가상현실 헤드기어의 위치와 회전을 지원. (착용자의 머리의 상태를 전송.)

4. DirectInput 인터페이스의 구조

5. DirectInput의 사용
DINPUT.LIB, DINPUT8.LIB, DINPUT.H

6. DirectInput 사용 순서 1. DirectInput8Create()으로 주요 DirectInput 객체를 생성한다.
2. CreateDevicde()으로 하나 혹은 그 이상의 입력 장치를 생성한다.
각각에 대해서 GUID가 필요하다. 따라서, DirectInput이 모든 입력 장치를 나열하도록 요청할 수도 있다.
3. SetCooperativeLevel()으로, 각 장치의 협력 수준을 설정한다.
4. SetDataFormat()으로 각장치의 데이터 형식을 설정하고, SetProperty()로 특별한 속성들을 설정한다.
5. Acquire()로 각 입력장치를 획득한다.
이 단계는 각 입력 장치를 주요 DirectInputDevice8에 추가한다.
6. GetDeviceState()로 입력을 받는다.
수동 폴링이 필요한 장치는 Poll()을 호출한다

7. DirectInput 생성 LPDIRECTINPUT8 lpdi; // main DirectInput object
HRESULT WINAPI DirectInput8Create(
HINSTANCE hinst, // instance of application
DWORD dwVersion, // backward version compatibility
REFIID riidltf, // interface id being requested
LPVOID* ppvOut, // pointer to interface
LPUNKNOWN punkOuter); // com stuff, null
#include “DINPUT.H”
LPDIRECTINPUT8 lpdi; // pointer to DirectInput object
// create DirectInput object
if (DirectInput8Create(main_instance, DIRECTINPUT_VERSION, IID_IDirectInput8, (void **)&lpdi,NULL)!=DI_OK)
{ /* error */ }

8. 키보드 입력 1. 키보드 장치를 생성한다. 2. 키보드의 협력 수준을 설정한다.
3. 키보드 장치를 위한 데이터 형식을 설정한다.
4. 키보드 장치를 얻어온다(aquire).

9. 여러 개의 device들이 하나의 DirectInput device를 구성할 수도 있다.

10. DirectInput Object (객체)
하나의 device에 여러 개의 object가 존재 가능

11. CreateDevice Function
HRESULT CreateDevice(
REFGUID rguid, // GUID of device to create
LPDIRECTINPUTDEVICE *lplpDIDev,// ptr to device interface
LPUNKNOWN pUnkOuter); // always NULL
GUID_SysKeyboard: 기본 시스템 키보드
GUID_SysMouse: 기본 시스템 마우스
#define INITGUID 와 OBJBASE.H 필요

12. CreateDevice Example
#define INITGUID // needed to get the GUIDS in here
#include <OBJBASE.H> // COM stuff
#include “DINPUT.H” // you need this!
LPDIRECTINPUT8 lpdi; // main DirectInput object
// create DirectInput object
if (DirectInput8Create(main_instance, DIRECTINPUT_VERSION, IID_IDirectInput8, (void **)&lpdi,NULL)!=DI_OK)
{ /* error */ }
LPDIRECTINPUTDEVICE8 lpdikey; // the keyboard device
// create keyboard device
if (lpdi->CreateDevice(GUID_SysKeyboard, &lpdikey,NULL)!=DI_OK) { /* error */ }

13. 협력 수준의 설정 Value Meaning DISCL_BACKGROUND
Your application can use a DirectInput device whether the application is idling in the background or active in the foreground.
DISCL_FOREGROUND
The application requires foreground access. If foreground access is granted, the device is automatically unacquired when the associated window moves to the background.
DISCL_EXCLUSIVE
After you acquire the device, no other application can request exclusive access to it; however, other applications can still request nonexclusive access.
DISCL_NONEXCLUSIVE
The application requires nonexclusive access. Access to the device does not interfere with other applications that are accessing the same device.

14. 협력 수준의 설정 DISCL_BACKGROUND | DISCL_NONEXCLISIVE 를 협력 설정으로 사용해야 한다.
if (lpdikey->SetCooperativeLevel(main_window_handle,
DISCL_BACKGROUND | DISCL_NONEXCLUSIVE)!=DI_OK)
{ /* error */ }

15. 데이터 형식의 설정 Custom-made Data formats c_dfDIKeyboard c_dfDIMouse
DIDATAFORMAT df;
SetDataFormat(&df); // ptr to data format structure
Custom-made Data formats
c_dfDIKeyboard
c_dfDIMouse
c_dfDIJoystick
c_dfDIJoystick2 : for force feedback device
if (FAILED(lpdikey->SetDataFormat(&c_dfDIKeyboard))) { … }

16. Acquire Device를 입력 스트림에 추가하고 데이터를 입수할 수 있도록 만드는 것이다.
if (FAILED(lpdikey->Acquire())) { … }

17. Keyboard 읽어오기 키보드 상태는 256 BYTE 요소의 배열
int ship_x = 100, ship_y = 100; // initial ship position
// storage for the keyboard data
UCHAR keystate[256];
// in your main loop, you would do this
if (lpdikey->GetDeviceState(256, keystate)!=DI_OK)
{ /* something’s amiss */ }
// test whether the player is “moving” the ship
if (keystate[DIK_RIGHT] & 0x80) ship_x++;
if (keystate[DIK_LEFT] & 0x80) ship_x--;
if (keystate[DIK_DOWN] & 0x80) ship_y++;
if (keystate[DIK_UP] & 0x80) ship_y--;
키보드 상태는 256 BYTE 요소의 배열

18. DirectInput 키보드 가상 키 코드 DIK_ESCAPE ESC키 DIK_0 - DIK_9 메인 키보드의 0-9
DIK_A - DIK_Z A-Z
DIK_RETURN 메인 키보드의 엔터키
DIK_LCONTROL 왼쪽 Ctrl키
DIK_RCONTROL 오른쪽 Ctrl키
DIK_SPACE 스페이스바
DIK_F1 - DIK_F12 펑션키 F1-F12
DIK_UP (위)화살표
DIK_DOWN (아래)화살표
DIK_LEFT (왼쪽)화살표
DIK_RIGHT (오른쪽)화살표
DIK_PRIOR Page Up
DIK_NEXT Page Down

19. Unacquire lpdikey->Unacquire( )
Temporarily stop to get the device input
By Acquire( ) the input can be reactivated.

20. DEMO 14_1

21. 마우스 입력 LPDIRECTINPUTDEVICE8 lpdimouse; // the mouse device
// create mouse device
if (lpdi->CreateDevice(GUID_SysMouse, &lpdimouse,NULL)!=DI_OK) { }
if (lpdimouse->SetCooperativeLevel(main_window_handle,
DISCL_BACKGROUND | DISCL_NONEXCLUSIVE)!=DI_OK) { }
// set data format, notice the use of the address operator
if (lpdikey->SetDataFormat(&c_dfDIMouse)!=DI_OK) { /* error */ }
// acquire the mouse
if (lpdimouse->Acquire()!=DI_OK) { /* error */ }

22. Mouse – Relative Mode

23. 마우스 입력 typedef struct { LONG lX; // x-axis of mouse
LONG lY; // y-axis of mouse
LONG lZ; // z-axis of mouse, typically a wheel or dial
BYTE rgbButtons[4]; // buttons of the mouse, high bit means pressed
} DIMOUSESTATE, *LPDIMOUSESTATE;
// this holds the mouse data
DIMOUSESTATE mouse_state;
// get mouse data
if (lpdimouse->GetDeviceState(sizeof(DIMOUSESTATE) (LPVOID)&mouse_state)!=DI_OK) { /* problem */ }
// test left button
if (mouse_state.rgbButtons[0]) { /* do whatever */ }
else if (mouse_state.rgbButtons[1]) { /* do whatever */ }

24. 마우스 입력 // is the mouse moving right if (mouse_state.lX > 0 )
else // check for left motion
if (mouse_state.lX < 0)
{ /* left */ }
// is the mouse moving down
if (mouse_state.lY > 0 )
{ /* down *}
else // check for upward motion
if (mouse_state.lY < 0)
{ /* up */ }

25. DEMO14_2