Maintenance script: Repair pages found by live-compare batch 0001

2026-03-26T14:46:17Z

Repair pages found by live-compare batch 0001

← Older revision		Revision as of 14:46, 26 March 2026
Line 78:		Line 78:
	----		----
	[[2dInDirect3d]]		[[2dInDirect3d]]

imported>Unknown at 05:22, 7 February 2021

2021-02-07T05:22:14Z

New page

= Creating a Device =
이번 챕터에서 할 일은
* IDirect3dDevice8 객체를 만드는 방법
* Viewport를 생성하고 사용하는 방법
* Viewport를 클리어하는 방법
* 화면을 Present하는 방법
* 다른(잘못된) Present 파라메터들을 리셋하는 방법

== IDirect3DDevice 객체를 생성 ==
이 객체는 IDirect3D 객체와는 달리 실질적일 일을 하는 객체이다. 이 객체를 생성하는 함수는 다음과 같다. IDirect3D 객체는 이것을 생성하기 위해 존재한다고 해도 과언이 아니다.
HRESULT IDirect3D8::CreateDevice(
UINT Adapter, // 어댑터의 번호, D3DADAPTER_DEFAULT를 사용
D3DDEVTYPE DeviceType, //디바이스의 타임, D3DDEVTYPE_HAL을 사용
HWND hFocusWindow, // 현재 창의 HWND를 넣어준다.
DWORD BehaviorFlag,
D3DPRESENT_PARAMETERS* pPresentationParameters,
IDirect3DDevice8** ppReturnedDeviceInterface
);

# 결과는 역시 성공하면 D3D_OK를 리턴한다.
# BehaviorFlag에는 버텍스를 처리하는 방법을 넣어준다. D3DCREATE_HARDWARE_VERTEXPROCESSING, D3DCREATE_MIXED_VERTEXPROCESSING, D3DCREATE_SOFTWARE_VERTEXPROCESSING중 한가지를 사용한다. (사실은 더 많은 옵션이 있다.) 대개 마지막 SOFTWARE를 사용한다.
# pPresentationParameters는 D3DPRESENT_PARAMERTERS의 포인터형이다. 저것은 Device의 형태를 결정하는 구조체이다.
# 마지막 인자로는 생성될 디바이스의 객체를 넣어준다.
# 다 사용한 이후는 꼭!! '''Release()'''함수를 사용하여 사용을 해제시킨다.

== Viewport의 세팅 =
뷰포트는 실제적으로 렌더링을 하는 지역이다. 뷰포트가 없이는 디바이스는 어디에 렌더링을 할지 모른다.
HRESULT IDirect3DDevice8::SetViewport(
CONST D3DVIEWPORT8* pViewport
);

# 결과는 성공하면 D3D_OK를 리턴한다.
# D3DVIEWPORT8 객체는 멤버는 다음과 같다.
X = 0: 좌표계의 왼쪽
Y = 0: 좌표게의 오른쪽 픽셀
Width = 800: (대개 화면의)넓이
Height = 600: (대개 화면의) 높이
MinZ = 0.0f : Z의 최소값. 대개 0.0f
MaxZ = 1.0f : Z의 최대값, 대개 1.0f

== Direct3D에서 사용하는 색상 ==
Direct3D에서 사용하는 색상은 '''D3DCOLOR''' 이다. (3D에서는 COLORREF였다.) 저것을 정의하는 매크로에는 다음과 같은 세가지가 있다.
RGB(r, g, b); // 보통 사용하는 색상 매크로
D3DCOLOR_ARGB(a, r, g, b); // 맨 앞에 알파값이 들어간다.
D3DCOLOR_RGBA(r, g, b, a); // 맨 뒤에 알파값이 들어간다.
D3DCOLOR_XRGB(r, g, b); // 보통 사용하는 매크로와 사용법이 같다. 이때 a 값은 0이 아닌 255(최대값)이 들어간다.

== Viewport의 클리어 ==
백버퍼를 싹 지우는 함수를 보자
HRESULT IDirect3DDevice::Clear(
DWROD count,
CONST D3DRECT* pRects,
DWORD Flags,
D3DCOLOR Color,
float Z,
DWORD Stencil
);

# 성공하면 D3D_OK가 리턴된다.
# 앞쪽의 두 변수는 함께 움직인다. count에는 0을 넣으면 되고 pRect는 NULL을 넣어주면 된다. count가 0이 아니라면 pRect에는 count의 개수만큼 D3DRECT의 배열이 들어간다. 그 Rect부분만 클리어할 수 있다.
# D3DCLEAR_STENCIL, D3DCLEAR_TARGET, D3DCLEAR_ZBUFFER 세개가 있는데, 보통 D3DCLEAR_TARGET를 사용한다.
# 네번째인자에는 색을 지정한다.
# Z와 Stencil은 12장에서.. ( 그냥 0을 넣자 지금은..)

== Present The Scene ==
백버퍼에 그림이 들어오거나 클리어 한 경우엔 그것을 앞으로 끌고나와야 한다. 그것을 하는 함수가 Present함수이다.
HRESULT IDirect3DDevice8::Present(
CONST RECT* pSourceRect,
CONST RECT* pDestRect,
HWND hDestWindowOverride,
CONST RGNDATA* pDirtyRegion
)

# 결과값은 D3D_OK, 실패했을경우엔 D3D_INVALIDCALL이나 D3D_DEVICELOST가 리턴된다.
# 네 인자 모두 NULL을 넣어주면 된다. (프레젠트는 한 화면단위로 하는 경우가 대부분이기 때문이다.)
----
[[2dInDirect3d]]

2dInDirect3d/Chapter2 - Revision history

Maintenance script: Repair pages found by live-compare batch 0001

imported>Unknown at 05:22, 7 February 2021