Editor and imgui (에디터와 imgui)

// 스크립트 예시: 에디터에서 노출되는 변수 class PlayerController : public Component { public: // 에디터에서 수정 가능 float moveSpeed = 5.0f; float jumpForce = 10.0f; bool enableDoubleJump = true; // 에디터에서 오브젝트 참조 연결 GameObject* targetEnemy = nullptr; }; // 에디터 인스펙터에서 보이는 내용: // Move Speed: [5.0] (슬라이더) // Jump Force: [10.0] (입력 필드) // Enable Double Jump: [✓] (체크박스) // Target Enemy: [드롭 영역] (오브젝트 참조)

// 게임 실행 중 (Play Mode) void Update() { // 인스펙터에서 moveSpeed를 실시간으로 변경 가능 transform.position += direction * moveSpeed * deltaTime; } // 게임을 멈추지 않고: // moveSpeed: 5.0 → 너무 느림 // moveSpeed: 10.0 → 적당함 // moveSpeed: 20.0 → 너무 빠름 // 즉시 피드백으로 최적값 찾기

// 충돌 박스 시각화 void OnDrawGizmos() { // 에디터에서만 보이는 디버그 드로우 Gizmos.DrawWireCube(position, size); Gizmos.DrawLine(start, end); Gizmos.DrawSphere(targetPosition, 0.5f); } // 에디터 Scene View에서 보이는 것: // - 캐릭터 주변의 충돌 박스 (녹색 와이어프레임) // - 레이캐스트 라인 (빨간 선) // - 목표 지점 (파란 구체)

// 레벨 생성 툴 예시 class LevelGeneratorTool { public: void OnGUI() { ImGui::Text("Level Generator"); ImGui::InputInt("Width", &width); ImGui::InputInt("Height", &height); ImGui::InputFloat("Density", &density); if (ImGui::Button("Generate")) { GenerateLevel(width, height, density); } } private: void GenerateLevel(int w, int h, float d) { for (int x = 0; x < w; x++) { for (int y = 0; y < h; y++) { if (Random() < d) { SpawnObstacle(x, y); } } } } int width = 10; int height = 10; float density = 0.3f; }; // 사용: // [Level Generator] 메뉴 클릭 // Width: 50 // Height: 50 // Density: 0.4 // [Generate] 버튼 클릭 // → 자동으로 50x50 레벨 생성

// ImGui를 사용한 버튼 if (ImGui::Button("Click Me")) { // 버튼 클릭 시 실행 } // 전통적인 GUI (Win32) HWND button = CreateWindow( "BUTTON", "Click Me", WS_TABSTOP | WS_VISIBLE | WS_CHILD | BS_DEFPUSHBUTTON, 10, 10, 100, 30, hwnd, (HMENU)ID_BUTTON, hInstance, NULL ); // WndProc에서 WM_COMMAND 처리 필요

bool Application::InitializeImGui() { // 1. ImGui 컨텍스트 생성 IMGUI_CHECKVERSION(); ImGui::CreateContext(); // 2. IO 설정 ImGuiIO& io = ImGui::GetIO(); // 키보드 내비게이션 활성화 io.ConfigFlags |= ImGuiConfigFlags_NavEnableKeyboard; // 게임패드 내비게이션 활성화 (선택적) io.ConfigFlags |= ImGuiConfigFlags_NavEnableGamepad; // 도킹 기능 활성화 (창을 자유롭게 배치) io.ConfigFlags |= ImGuiConfigFlags_DockingEnable; // 멀티 뷰포트 활성화 (창을 프로그램 밖으로 끌어낼 수 있음) io.ConfigFlags |= ImGuiConfigFlags_ViewportsEnable; // 3. 스타일 설정 ImGui::StyleColorsDark(); // 다크 테마 // ImGui::StyleColorsLight(); // 라이트 테마 // ImGui::StyleColorsClassic(); // 클래식 테마 // 4. 멀티 뷰포트 사용 시 스타일 조정 ImGuiStyle& style = ImGui::GetStyle(); if (io.ConfigFlags & ImGuiConfigFlags_ViewportsEnable) { style.WindowRounding = 0.0f; style.Colors[ImGuiCol_WindowBg].w = 1.0f; } // 5. 플랫폼 백엔드 초기화 (Win32) ImGui_ImplWin32_Init(mHwnd); // 6. 렌더러 백엔드 초기화 (DirectX 11) ya::graphics::GraphicDevice_DX11* graphicDevice = ya::graphics::GetDevice(); ID3D11Device* device = graphicDevice->GetID3D11Device().Get(); ID3D11DeviceContext* deviceContext = graphicDevice->GetID3D11DeviceContext().Get(); ImGui_ImplDX11_Init(device, deviceContext); // 7. 폰트 로드 (선택적) // io.Fonts->AddFontDefault(); // io.Fonts->AddFontFromFileTTF("fonts/Roboto-Regular.ttf", 16.0f); LOG_INFO("ImGui initialized"); return true; }

// imgui_impl_win32.h에 선언된 함수 extern IMGUI_IMPL_API LRESULT ImGui_ImplWin32_WndProcHandler( HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam ); LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam) { // ImGui가 메시지를 먼저 처리 if (ImGui_ImplWin32_WndProcHandler(hWnd, message, wParam, lParam)) return true; switch (message) { case WM_SIZE: { // 윈도우 크기 변경 시 그래픽 디바이스 리사이즈 if (wParam != SIZE_MINIMIZED) { application.ResizeGraphicDevice(); } break; } case WM_DPICHANGED: { // DPI 변경 시 창 위치 조정 (고해상도 모니터 지원) if (ImGui::GetIO().ConfigFlags & ImGuiConfigFlags_DpiEnableScaleViewports) { const RECT* suggested_rect = (RECT*)lParam; ::SetWindowPos( hWnd, NULL, suggested_rect->left, suggested_rect->top, suggested_rect->right - suggested_rect->left, suggested_rect->bottom - suggested_rect->top, SWP_NOZORDER | SWP_NOACTIVATE ); } break; } case WM_DESTROY: { PostQuitMessage(0); break; } default: return DefWindowProc(hWnd, message, wParam, lParam); } return 0; }

// ImGui가 처리하는 메시지 예시 WM_LBUTTONDOWN // 왼쪽 마우스 버튼 클릭 WM_RBUTTONDOWN // 오른쪽 마우스 버튼 클릭 WM_MOUSEWHEEL // 마우스 휠 스크롤 WM_MOUSEMOVE // 마우스 이동 WM_KEYDOWN // 키 입력 WM_CHAR // 문자 입력 WM_SETFOCUS // 포커스 받음 WM_KILLFOCUS // 포커스 잃음

void Application::Run() { MSG msg = {}; while (true) { // 1. 윈도우 메시지 처리 if (PeekMessage(&msg, nullptr, 0, 0, PM_REMOVE)) { if (msg.message == WM_QUIT) break; TranslateMessage(&msg); DispatchMessage(&msg); } else { // 2. 게임 로직 업데이트 Update(); // 3. 게임 렌더링 Render(); // 4. ImGui 렌더링 RenderImGui(); // 5. 화면에 표시 Present(); } } } void Application::RenderImGui() { // 1. ImGui 새 프레임 시작 ImGui_ImplDX11_NewFrame(); ImGui_ImplWin32_NewFrame(); ImGui::NewFrame(); // 2. UI 그리기 DrawEditorUI(); // 3. 렌더링 데이터 생성 ImGui::Render(); // 4. DirectX로 렌더링 ImGui_ImplDX11_RenderDrawData(ImGui::GetDrawData()); // 5. 멀티 뷰포트 업데이트 ImGuiIO& io = ImGui::GetIO(); if (io.ConfigFlags & ImGuiConfigFlags_ViewportsEnable) { ImGui::UpdatePlatformWindows(); ImGui::RenderPlatformWindowsDefault(); } } void Application::DrawEditorUI() { // ImGui 데모 창 (학습용) ImGui::ShowDemoWindow(); // 커스텀 에디터 창 DrawCustomEditor(); } void Application::DrawCustomEditor() { ImGui::Begin("My Editor"); ImGui::Text("Hello, ImGui!"); static float value = 0.0f; ImGui::SliderFloat("Value", &value, 0.0f, 1.0f); if (ImGui::Button("Click Me")) { LOG_INFO("Button clicked! Value: {}", value); } ImGui::End(); }

void Application::Release() { // 1. ImGui 백엔드 정리 ImGui_ImplDX11_Shutdown(); ImGui_ImplWin32_Shutdown(); // 2. ImGui 컨텍스트 파괴 ImGui::DestroyContext(); // 3. 게임 엔진 리소스 해제 // (조립의 역순으로 해제) ReleaseGameResources(); LOG_INFO("Application released"); }

// 보존 모드 예시 (Win32) // 1. UI 요소 생성 (한 번만) HWND button = CreateWindow( "BUTTON", "Click Me", WS_VISIBLE | WS_CHILD, 10, 10, 100, 30, hwnd, (HMENU)ID_BUTTON, hInstance, NULL ); // 2. 이벤트 핸들러에서 처리 LRESULT CALLBACK WndProc(...) { switch (message) { case WM_COMMAND: if (LOWORD(wParam) == ID_BUTTON) { // 버튼 클릭 처리 } break; } } // 특징: // - UI 요소가 메모리에 계속 존재 // - 상태를 시스템이 관리 // - 복잡한 이벤트 처리 필요

// 즉시 모드 예시 (ImGui) // 매 프레임마다 실행 void OnGUI() { if (ImGui::Button("Click Me")) { // 버튼 클릭 시 바로 처리 } } // 특징: // - UI를 매 프레임 다시 그림 // - 상태를 직접 관리 // - 코드 흐름이 직관적

void EditorLayer::OnImGuiRender() { // 매 프레임 실행 ImGui::Begin("Inspector"); // UI 요소 정의 ImGui::Text("Transform"); ImGui::DragFloat3("Position", &position.x); ImGui::DragFloat3("Rotation", &rotation.x); ImGui::DragFloat3("Scale", &scale.x); if (ImGui::Button("Reset")) { position = Vector3::Zero; rotation = Vector3::Zero; scale = Vector3::One; } ImGui::End(); } // 실행 흐름: // Frame 1: Begin → Text → DragFloat3 × 3 → Button → End // Frame 2: Begin → Text → DragFloat3 × 3 → Button → End // Frame 3: Begin → Text → DragFloat3 × 3 → Button → End // ...

// ImGui 내부 동작 (개념적) bool ImGui::Button(const char* label) { // 1. 버튼 영역 계산 ImVec2 pos = GetCursorScreenPos(); ImVec2 size = CalcItemSize(ImVec2(0, 0), 0.0f, 0.0f); ImRect bb(pos, pos + size); // 2. 마우스 입력 확인 bool hovered = IsMouseHoveringRect(bb.Min, bb.Max); bool clicked = hovered && IsMouseClicked(0); // 3. 상태에 따라 색상 결정 ImVec4 color = clicked ? activeColor : hovered ? hoveredColor : normalColor; // 4. DrawList에 추가 (실제 렌더링 X) RenderFrame(bb.Min, bb.Max, color, true, 0.0f); RenderText(bb.Min + style.FramePadding, label); // 5. 클릭 여부 반환 return clicked; }

// ImGui는 DrawList에 렌더링 명령을 저장 struct ImDrawList { // 버텍스 버퍼 std::vector<ImDrawVert> VtxBuffer; // 인덱스 버퍼 std::vector<ImDrawIdx> IdxBuffer; // 렌더링 명령 std::vector<ImDrawCmd> CmdBuffer; }; // 예시: 버튼 하나를 그리기 위한 데이터 DrawList->AddRectFilled( ImVec2(10, 10), // 시작 위치 ImVec2(110, 40), // 끝 위치 IM_COL32(100, 100, 200, 255) // 색상 (RGBA) ); DrawList->AddText( ImVec2(30, 15), // 텍스트 위치 IM_COL32(255, 255, 255, 255), // 흰색 "Click Me" // 텍스트 );

// imgui_impl_dx11.cpp의 렌더링 함수 (개념적) void ImGui_ImplDX11_RenderDrawData(ImDrawData* draw_data) { for (int n = 0; n < draw_data->CmdListsCount; n++) { const ImDrawList* cmd_list = draw_data->CmdLists[n]; // 1. 버텍스 버퍼 업데이트 D3D11_MAPPED_SUBRESOURCE vtx_resource; context->Map(vertexBuffer, 0, D3D11_MAP_WRITE_DISCARD, 0, &vtx_resource); memcpy(vtx_resource.pData, cmd_list->VtxBuffer.Data, cmd_list->VtxBuffer.Size * sizeof(ImDrawVert)); context->Unmap(vertexBuffer, 0); // 2. 인덱스 버퍼 업데이트 D3D11_MAPPED_SUBRESOURCE idx_resource; context->Map(indexBuffer, 0, D3D11_MAP_WRITE_DISCARD, 0, &idx_resource); memcpy(idx_resource.pData, cmd_list->IdxBuffer.Data, cmd_list->IdxBuffer.Size * sizeof(ImDrawIdx)); context->Unmap(indexBuffer, 0); // 3. 렌더링 명령 실행 for (int cmd_i = 0; cmd_i < cmd_list->CmdBuffer.Size; cmd_i++) { const ImDrawCmd* pcmd = &cmd_list->CmdBuffer[cmd_i]; // 셰이더 설정 context->VSSetShader(vertexShader, NULL, 0); context->PSSetShader(pixelShader, NULL, 0); // 텍스처 설정 context->PSSetShaderResources(0, 1, (ID3D11ShaderResourceView**)&pcmd->TextureId); // 드로우 콜 context->DrawIndexed(pcmd->ElemCount, pcmd->IdxOffset, pcmd->VtxOffset); } } }

// 프레임 종료 시 ImGui::EndFrame(); // ImGui 내부에서: // - DrawList 초기화 // - 입력 상태 초기화 // - 임시 데이터 정리 // 다음 프레임에서 모든 UI를 다시 정의

// 보존 모드 (Win32): 약 50줄 class MyDialog { HWND dialog; HWND nameEdit; HWND ageEdit; HWND submitButton; public: void Create(HWND parent) { dialog = CreateWindow(...); nameEdit = CreateWindow(...); ageEdit = CreateWindow(...); submitButton = CreateWindow(...); } void OnCommand(WPARAM wParam) { if (LOWORD(wParam) == ID_SUBMIT_BUTTON) { // 처리 } } // ... 더 많은 코드 }; // 즉시 모드 (ImGui): 약 10줄 void DrawDialog() { ImGui::Begin("My Dialog"); static char name[256] = ""; static int age = 0; ImGui::InputText("Name", name, sizeof(name)); ImGui::InputInt("Age", &age); if (ImGui::Button("Submit")) { // 처리 } ImGui::End(); }

// 슬라이더 값이 변경되었을 때 다른 UI 업데이트 static float volume = 0.5f; ImGui::SliderFloat("Volume", &volume, 0.0f, 1.0f); // 조건부로 다른 UI 표시 if (volume > 0.0f) { ImGui::Text("Sound is enabled"); ImGui::SliderFloat("Bass", &bass, 0.0f, 1.0f); ImGui::SliderFloat("Treble", &treble, 0.0f, 1.0f); } else { ImGui::Text("Sound is muted"); } // 보존 모드였다면: // - volume 변경 이벤트 처리 // - bass, treble 위젯 동적 생성/파괴 // - 레이아웃 재계산 // → 복잡한 상태 관리 필요

// 5분 만에 만드는 레벨 에디터 void LevelEditorGUI() { ImGui::Begin("Level Editor"); // 툴 선택 static int currentTool = 0; ImGui::RadioButton("Place", &currentTool, 0); ImGui::RadioButton("Delete", &currentTool, 1); ImGui::RadioButton("Move", &currentTool, 2); // 오브젝트 종류 static int objectType = 0; ImGui::Combo("Object", &objectType, "Wall\0Floor\0Enemy\0Item\0"); // 그리드 설정 static bool showGrid = true; ImGui::Checkbox("Show Grid", &showGrid); static float gridSize = 1.0f; ImGui::SliderFloat("Grid Size", &gridSize, 0.5f, 2.0f); ImGui::End(); }