imgui DirectX 12 에서 초기화하기

struct FrameContext { ID3D12CommandAllocator* CommandAllocator; UINT64 FenceValue; }; static constexpr UINT APP_NUM_FRAMES_IN_FLIGHT = 2; // 또는 3 FrameContext mFrameContext[APP_NUM_FRAMES_IN_FLIGHT];

// 프레임 시작 시 동기화 UINT frameIndex = mSwapChain->GetCurrentBackBufferIndex(); FrameContext* frameCtx = &mFrameContext[frameIndex]; // 이 프레임의 이전 작업이 완료될 때까지 대기 UINT64 fenceValue = frameCtx->FenceValue; if (mFence->GetCompletedValue() < fenceValue) { mFence->SetEventOnCompletion(fenceValue, mFenceEvent); WaitForSingleObject(mFenceEvent, INFINITE); }

void ImGuiManager::Begin() { // DirectX 12 백엔드 프레임 시작 ImGui_ImplDX12_NewFrame(); // Win32 플랫폼 백엔드 프레임 시작 (입력 처리) ImGui_ImplWin32_NewFrame(); // ImGui 코어 프레임 시작 ImGui::NewFrame(); // ImGuizmo 프레임 시작 (선택적) ImGuizmo::BeginFrame(); }

// Begin 이후 UI 구성 ImGui::Begin("Debug Info"); ImGui::Text("FPS: %.1f", ImGui::GetIO().Framerate); ImGui::SliderFloat("Exposure", &exposure, 0.0f, 5.0f); ImGui::ColorEdit3("Clear Color", clearColor); ImGui::End();

void ImGuiManager::End() { ImGuiIO& io = ImGui::GetIO(); io.DisplaySize = ImVec2( static_cast<float>(application.GetWindow().GetWidth()), static_cast<float>(application.GetWindow().GetHeight()) );

auto* graphicDevice = ya::graphics::GetDevice(); auto* frameCtx = graphicDevice->WaitForNextFrameResources(); UINT backBufferIdx = graphicDevice->GetSwapChain()->GetCurrentBackBufferIndex();

D3D12_RESOURCE_BARRIER barrier = {}; barrier.Type = D3D12_RESOURCE_BARRIER_TYPE_TRANSITION; barrier.Flags = D3D12_RESOURCE_BARRIER_FLAG_NONE; barrier.Transition.pResource = graphicDevice->GetRenderTargetResource(backBufferIdx).Get(); barrier.Transition.Subresource = D3D12_RESOURCE_BARRIER_ALL_SUBRESOURCES; barrier.Transition.StateBefore = D3D12_RESOURCE_STATE_PRESENT; barrier.Transition.StateAfter = D3D12_RESOURCE_STATE_RENDER_TARGET;

auto commandList = graphicDevice->GetCommandList(); // Clear color 설정 (선택적) ImVec4 clear_color = ImVec4(0.45f, 0.55f, 0.60f, 1.00f); const float clear_color_with_alpha[4] = { clear_color.x * clear_color.w, clear_color.y * clear_color.w, clear_color.z * clear_color.w, clear_color.w }; // Descriptor Heap 핸들 준비 auto rtvHeap = graphicDevice->GetRTVHeap(); CD3DX12_CPU_DESCRIPTOR_HANDLE rtvHandle = graphicDevice->GetRenderTargetDescriptorHandle(backBufferIdx); auto srvHeap = graphicDevice->GetSrvHeap();

// 배경 클리어 (메인 렌더링에서 이미 처리한 경우 생략 가능) // commandList->ClearRenderTargetView(rtvHandle, clear_color_with_alpha, 0, nullptr); // 렌더 타겟 설정 (메인 렌더링에서 이미 설정한 경우 생략 가능) // commandList->OMSetRenderTargets(1, &rtvHandle, FALSE, nullptr);

commandList->SetDescriptorHeaps(1, srvHeap.GetAddressOf());

ImGui_ImplDX12_RenderDrawData(ImGui::GetDrawData(), commandList.Get());

barrier.Transition.StateBefore = D3D12_RESOURCE_STATE_RENDER_TARGET; barrier.Transition.StateAfter = D3D12_RESOURCE_STATE_PRESENT; commandList->ResourceBarrier(1, &barrier);

commandList->Close(); }

void GraphicDevice_DX12::Present() { UINT64 fenceValue = mFenceLastSignalValue + 1;

mCommandQueue->Signal(mFence.Get(), fenceValue);

mFenceLastSignalValue = fenceValue;

FrameContext* frameCtx = &mFrameContext[mFrameIndex % APP_NUM_FRAMES_IN_FLIGHT]; frameCtx->FenceValue = fenceValue;

mFrameIndex = mSwapChain->GetCurrentBackBufferIndex(); }

FrameContext* frameCtx = &mFrameContext[frameIndex]; UINT64 requiredFence = frameCtx->FenceValue; UINT64 completedFence = mFence->GetCompletedValue(); if (completedFence < requiredFence) { // GPU가 아직 이 프레임을 처리 중 // 대기 필요 } else { // GPU가 이 프레임을 완료함 // 안전하게 재사용 가능 }

if (mFence->GetCompletedValue() < requiredFence) { // Fence 값이 도달하면 이벤트 신호 mFence->SetEventOnCompletion(requiredFence, mFenceEvent); // 이벤트가 신호될 때까지 CPU 스레드 대기 WaitForSingleObject(mFenceEvent, INFINITE); }

// 나쁜 예: 매 프레임 동기화 Present(); WaitForGPU(); // 매번 대기 - 병렬성 상실 // 좋은 예: 필요할 때만 동기화 Present(); // GPU가 N 프레임 뒤처질 때만 대기 // 대부분의 경우 즉시 진행

void GraphicDevice_DX12::InitializeImGui(HWND hwnd) { // ImGui 컨텍스트 생성 IMGUI_CHECKVERSION(); ImGui::CreateContext(); ImGuiIO& io = ImGui::GetIO(); // 도킹과 멀티 뷰포트 활성화 io.ConfigFlags |= ImGuiConfigFlags_NavEnableKeyboard; io.ConfigFlags |= ImGuiConfigFlags_DockingEnable; io.ConfigFlags |= ImGuiConfigFlags_ViewportsEnable; // 스타일 설정 ImGui::StyleColorsDark(); // SRV Descriptor Heap 생성 (ImGui용) D3D12_DESCRIPTOR_HEAP_DESC desc = {}; desc.Type = D3D12_DESCRIPTOR_HEAP_TYPE_CBV_SRV_UAV; desc.NumDescriptors = 1; // Font atlas용 desc.Flags = D3D12_DESCRIPTOR_HEAP_FLAG_SHADER_VISIBLE; mDevice->CreateDescriptorHeap(&desc, IID_PPV_ARGS(&mImGuiSrvHeap)); // Win32 백엔드 초기화 ImGui_ImplWin32_Init(hwnd); // DirectX 12 백엔드 초기화 ImGui_ImplDX12_Init( mDevice.Get(), APP_NUM_FRAMES_IN_FLIGHT, DXGI_FORMAT_R8G8B8A8_UNORM, mImGuiSrvHeap.Get(), mImGuiSrvHeap->GetCPUDescriptorHandleForHeapStart(), mImGuiSrvHeap->GetGPUDescriptorHandleForHeapStart() ); }

void Application::Run() { while (!shouldClose) { // 입력 처리 ProcessWindowMessages(); // ImGui 프레임 시작 imguiManager->Begin(); // UI 구성 BuildUI(); // 렌더링 시작 graphicDevice->BeginFrame(); // 메인 렌더링 RenderScene(); // ImGui 렌더링 imguiManager->End(); // 프레임 제출 및 Present graphicDevice->EndFrame(); graphicDevice->Present(); } }

void GraphicDevice_DX12::ShutdownImGui() { // GPU 작업 완료 대기 WaitForGPU(); // ImGui 백엔드 종료 ImGui_ImplDX12_Shutdown(); ImGui_ImplWin32_Shutdown(); // ImGui 컨텍스트 파괴 ImGui::DestroyContext(); } void GraphicDevice_DX12::WaitForGPU() { // 현재까지 제출한 모든 작업 완료 대기 UINT64 fenceValue = mFenceLastSignalValue + 1; mCommandQueue->Signal(mFence.Get(), fenceValue); mFenceLastSignalValue = fenceValue; if (mFence->GetCompletedValue() < fenceValue) { mFence->SetEventOnCompletion(fenceValue, mFenceEvent); WaitForSingleObject(mFenceEvent, INFINITE); } }

// 잘못된 예 const UINT APP_NUM_FRAMES_IN_FLIGHT = 2; swapChainDesc.BufferCount = 3; // 불일치! // 올바른 예 const UINT APP_NUM_FRAMES_IN_FLIGHT = 2; swapChainDesc.BufferCount = 2; // 일치

// 최소: Font atlas만 desc.NumDescriptors = 1; // 권장: 사용자 정의 텍스처 고려 desc.NumDescriptors = 100;

// ImGui 백엔드 내부에서 버퍼 크기 힌트 제공 // (imgui_impl_dx12.cpp 수정 필요) const int VERTEX_BUFFER_SIZE = 50000; const int INDEX_BUFFER_SIZE = 100000;

// 매 프레임 업데이트하지 않기 static float cachedValue = 0.0f; static int frameCount = 0; if (++frameCount % 60 == 0) // 1초마다 업데이트 { cachedValue = CalculateExpensiveValue(); } ImGui::Text("Value: %.2f", cachedValue);