서론

시작하기 앞서 Microsoft 에서 제공하는 ‣ 의 샘플 코드를 활용해 Direct3D 12 를 공부해 나간다는 것을 알리고 싶다.

앞으로 반복적으로 사용할 DXSample의 구조를 살펴보는 시간이기 때문에 한줄한줄 꼼꼼하게 분석해 나가기로 한다.

0. 개요 및 용어 정리

Microsoft에서 제공하는 샘플 코드의 경우 Windows Desktop Application 프로젝트 위에서 돌아간다. 때문에 각 솔루션마다 정의되어 있는 Main.cpp파일(파일명은 중요하지 않음)의 WinMain()함수(함수명 중요)에서 프로젝트가 시작된다. (기본 설정이라면)

각 단계별 코드들은 DXSample 라는 클래스를 상속받아 추가 동작들이 구현되어지는데 해당 HelloWindow의 경우 DXSample을 상속받은 D3D12HelloWindow 클래스에 동작이 구현된다.

class D3D12HelloWindow : public DXSample
{
public:
    D3D12HelloWindow(UINT width, UINT height, std::wstring name);

    virtual void OnInit();
    virtual void OnUpdate();
    virtual void OnRender();
    virtual void OnDestroy();

private:
    static const UINT FrameCount = 2;

    // Pipeline objects. | 파이프라인 객체.
    ComPtr<IDXGISwapChain3> m_swapChain;
    ComPtr<ID3D12Device> m_device;
    ComPtr<ID3D12Resource> m_renderTargets[FrameCount];
    ComPtr<ID3D12CommandAllocator> m_commandAllocator;
    ComPtr<ID3D12CommandQueue> m_commandQueue;
    ComPtr<ID3D12DescriptorHeap> m_rtvHeap;
    ComPtr<ID3D12PipelineState> m_pipelineState;
    ComPtr<ID3D12GraphicsCommandList> m_commandList;
    UINT m_rtvDescriptorSize;

    // Synchronization objects. | 동기화 객체.
    UINT m_frameIndex;
    HANDLE m_fenceEvent;
    ComPtr<ID3D12Fence> m_fence;
    UINT64 m_fenceValue;

    void LoadPipeline();
    void LoadAssets();
    void PopulateCommandList();
    void WaitForPreviousFrame();
};

해당 클래스의 헤더파일을 살펴보면 꽤나 간단하다. 첫 단계인 Window 띄우기를 위한 필드들만 선언되어 있어 Direct3D를 처음 접하는 사람들에 대한 배려가 꽤나 느껴진다.

여기서 중요하게 알아야할 것들은 각 파이프라인 객체들의 용도, 그리고 동기화 객체가 어떤 방식으로 맞춰지고 있는지 정도 일것이다.

윈도우 클래스의 초기화 과정이나 윈도우 창 핸들을 저장하고 사용하는 등의 그래픽 렌더 목적 외의 로직들은 추후에 차차 알아보도록 하고 추상함수로 선언된 OnInit, OnUpdate, OnRender, OnDestory 시점의 동작들을 집중적으로 알아보자.

해당 동작들을 알아보기전 용어부터 간단하게 짚고 넘어가는게 좋아 보이는데 D3D12(Direct3D 12) 와 DXGI(DirectX Graphics Infrastructure) API를 사용하는 과정에서 나올 용어들이므로 앞으로 다양한 샘플코드들을 분석할때 꾸준히 나올 용어들이다. DXGI는 사용할 그래픽 장치를 찾고 완성된 그림을 화면에 표시하는 일을 주로 담당한다. 그리고 D3D12는 GPU로 그림을 만드는 작업을 담당한다고 보면 좋겠다. (인터페이스 이름으로 명시되어있어 구분하기 편하다)

[ 명칭 ( 타입, 변수명 ) : 설명 ]

  1. 스왑체인 (IDXGISwapChain3, m_swapChain) : 백 버퍼들을 관리하고, Present() 로 완성된 프레임의 화면 표시를 요청한다.
  2. 디바이스 (ID3D12Device, m_device) : 버퍼, 텍스처, 명령 큐 등 Direct3D 객체를 생성하고, GPU가 지원하는 기능을 확인한다.
  3. 리소스, 백 버퍼 배열 (ID3D12Resource, m_renderTargets) : 배열로 선언되어 화면에 표시할 이미지의 픽셀값을 저장하는 백 버퍼 들을 참조한다.
  4. 명령 할당자 (ID3D12CommandAllocator, m_commandAllocator) : GPU 명령을 기록하는데 필요한 메모리를 할당하고, 재사용할 수 있도록 관리한다.
  5. 명령 큐 (ID3D12CommandQueue, m_commandQueue) : 기록한 명령 리스트를 GPU에 제출하고, 해당 큐의 작업 실행과 동기화를 관리한다.
  6. 설명자(디스크럽터) 힙 (ID3D12DescriptorHeap, m_rtvHeap) : 리소스의 사용 방법을 설명하는 디스크럽터들을 저장한다. 이 예제에서는 백 버퍼 별 RTV(Render Target View)를 보관한다.
  7. 파이프라인 상태 객체 (ID3D12PipelineState, m_pipelineState) : 셰이더, 블렌딩, 깊이 검사 등 그리기에 사용할 설정을 저장한다. HelloWindow 에서는 nullptr 상태이다.
  8. 그래픽 명령 리스트 (ID3D12GraphicsCommandList, m_commandList) : 배경색 칠하기, 삼각형 그리기, 리소스 상태 전환 등 GPU 가 실행할 명령을 기록한다.