Module Window

Module: Window

MiniLibX 윈도우 초기화, 이벤트 핸들링, 키 바인딩을 담당하는 모듈입니다.

---

소스 파일

파일	역할
window_init.c	윈도우/이미지/UI 초기화, 훅 등록
window_lifecycle.c	close_window — 리소스 정리 및 종료
window_events.c	handle_key, handle_key_release — 키 이벤트 분기
window_key_handlers.c	HUD, 오브젝트 선택, 변환 키 처리
window_loop.c	render_loop — 프레임 루프 콜백
window_camera.c	카메라 이동/회전/리셋
window_objects.c	오브젝트 이동 처리
window_selection.c	오브젝트 선택 (이전/다음 순환)
window_resize.c	오브젝트 리사이즈 처리
window_rotate.c	오브젝트 회전 처리
mlx_context.c	MiniLibX 초기화 (mlx_init, mlx_new_window)
mlx_pixel.c	픽셀 쓰기 (put_pixel_to_buffer)
mlx_pixel_codec.c	픽셀 형식 변환
render_flags_set.c	렌더 상태 플래그 헬퍼

---

MiniLibX 초기화

init_window(scene)
 ├── malloc(t_render)
 ├── init_mlx()
 │    ├── mlx_init()
 │    ├── mlx_new_window(1440, 900, "miniRT")
 │    ├── mlx_new_image()
 │    └── mlx_get_data_addr()
 ├── init_render_state()
 │    └── pixel_timing_init()
 ├── init_ui_components()
 │    ├── hud_init()
 │    ├── keyguide_init()
 │    └── hud_calculate_total_pages()
 └── register_hooks()
      ├── mlx_hook(close_window)       // 윈도우 닫기
      ├── mlx_hook(handle_key)         // 키 누름
      ├── mlx_hook(handle_key_release) // 키 해제
      └── mlx_loop_hook(render_loop)   // 프레임 루프

해상도: 1440 x 900 (고정)

---

키 바인딩 전체 목록

카메라 이동

키	동작	설명
W	전진	시야 방향으로 이동
X	후진	시야 반대 방향으로 이동
A	좌	시야 직교 방향 좌측
D	우	시야 직교 방향 우측
Q	상승	월드 Y축 상향
Z	하강	월드 Y축 하향

카메라 회전

키	동작
E	피치 위 (고개 올림)
C	피치 아래 (고개 내림)

카메라 리셋

키	동작
S	초기 위치 및 방향 복원

오브젝트 선택

키	동작
[	이전 오브젝트
]	다음 오브젝트

오브젝트 이동

키	축	방향
R	X	-
T	X	+
F	Y	-
G	Y	+
V	Z	-
B	Z	+

광원 이동

키	축	방향
Insert	X	-
Delete	X	+
Home	Y	-
End	Y	+
PageUp	Z	-
PageDown	Z	+

UI

키	동작
H	HUD 표시/숨김
I	성능 메트릭 토글
ESC	프로그램 종료

---

이벤트 처리 흐름

handle_key(keycode, render)
 ├── ESC → close_window()
 ├── H/I → handle_hud_keys()
 ├── [ / ] → handle_object_selection()
 ├── W/X/A/D/Q/Z/E/C/S → handle_camera_keys()
 └── R/T/F/G/V/B/Ins/Del/... → handle_transform_keys()

handle_key_release(keycode, render)
 └── is_movement_key() → 디바운스 full render 트리거

키 누름 시 RENDER_DIRTY + RENDER_LOW_QUALITY 플래그를 설정하여 즉시 low quality 렌더링을 수행하고, 키 해제 시 디바운스 타이머를 시작합니다.

---

리소스 정리

close_window(render)
 ├── pixel_timing_cleanup()
 ├── keyguide_cleanup()
 ├── hud_cleanup()
 ├── mlx_destroy_image()
 ├── cleanup_scene()
 │    ├── bvh_destroy()
 │    └── free(scene)
 └── exit(0)