Home

miniRT Wiki

C로 작성한 실시간 인터랙티브 레이트레이서. BVH 가속 구조, Phong 조명 모델, 소프트 섀도우, 카메라/오브젝트/광원 인터랙티브 조작을 지원합니다.

---

빠른 시작

git clone --recursive https://github.com/gdtknight/miniRT.git
sudo apt-get install libx11-dev libxext-dev libbsd-dev
make
./miniRT scenes/valid/valid_smoke_simple.rt

---

주요 기능

• 지오메트리 4종: 구(sphere), 평면(plane), 원기둥(cylinder), 원뿔(cone)
• Phong 조명 모델 (ambient + diffuse + specular)
• 소프트 섀도우 (4x4 스토캐스틱 샘플링, offset LUT 사전 계산)
• BVH 가속 구조 (median split, plane 분리, any-hit shadow 가속)
• 인터랙티브 조작: 카메라 이동/회전, 오브젝트 선택/이동/리사이즈/회전, 광원 이동
• HUD 오버레이: 씬 정보, 성능 메트릭, 키가이드, 페이지네이션
• 텍스처: 체커보드 패턴, XPM 범프맵

---

주요 조작키

카테고리	키	동작
카메라 이동	W / X / A / D / Q / Z	전진 / 후진 / 좌 / 우 / 상승 / 하강
카메라 회전	E / C	상하 회전
	1 / 3	좌우 회전
카메라 리셋	S	초기 위치 복원
오브젝트 선택	TAB	다음 오브젝트 순환
오브젝트 이동	R/T, F/G, V/B	X, Y, Z축
오브젝트 리사이즈	Y / U	반지름 -/+
	N / M	높이 -/+
오브젝트 회전	I/J, O/K, P/L	X, Y, Z축
광원 선택	=	다음 광원 순환
광원 이동	[ / ] , ; / ' , , / .	X, Y, Z축
UI	H	HUD 토글
	Up / Down	HUD 페이지 이동
	ESC	종료

---

목차

사용자 가이드

• 빌드 및 실행
• 씬 파일 형식
• 인터랙티브 컨트롤

설계 문서

• 아키텍처
• 광선 교차 및 공간가속
• 조명 그림자 시스템

모듈 레퍼런스

• 렌더링
• 공간가속
• 파서
• 디스플레이 입력

참고

• 성능 최적화
• 버전 히스토리

---

Version: 2.4.0 | Last Updated: 2026-03