Skip to content

CHANGELOG.md

Latest commit

 

History

History
230 lines (171 loc) · 9.41 KB

CHANGELOG.md

File metadata and controls

230 lines (171 loc) · 9.41 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.8.1] - 2026-04-17

Removed

  • tests/ 전체 삭제: test_shadow_calc.c는 calculate_shadow_bias가 static 전환 후 링크 불가, test_shadow_config는 소스 없는 고아 바이너리, baselines/metadata.json은 종료된 016-compliance-refactoring 스냅샷
  • 죽은 스크립트 15개 제거: 아카이브된 spec 012/013 전용 검증 스크립트, BVH 통합 수정 1회용, Norm에 역행하는 fix_whitespace.sh, 존재하지 않는 경로를 참조하는 fix_line_continuations.sh, .github/scripts/sync-wiki.sh로 대체된 create_wiki.sh, 하드코딩된 macOS 절대경로가 있는 scripts/test/test_progress.sh 등
  • .gitignore 정리: 존재한 적 없는 테스트 바이너리 패턴(test_vector, test_parser, test_mlx 등) 및 삭제된 test_optimizations.sh 항목 제거

순수 삭제 릴리스 (20개 파일, 977줄 삭제). 런타임/API/빌드 동작 변경 없음.

[2.8.0] - 2026-04-15

Refactored

  • Feature-based packaging: 16 flat modules → 7 packages (common, scene, spatial, render, lighting, interact, metrics)
  • Circular dependency resolution: render↔interact 순환을 타입 전용 헤더(ui_types.h, key_binds.h)로 분리
  • Inverted dependency fix: scene→lighting 역방향 의존 제거 (t_shadow_config를 t_scene에 임베드)
  • Public API minimization: bvh_debug 17→1 함수, 21개 헤더 선언 제거, 18개 함수 static 전환
  • 100% function documentation: 310개 함수에 doxygen 스타일 문서 추가

Fixed

  • Camera pitch rotation: 360° 회전 복원 (이전에 클램프되던 버그)

[2.7.0] - 2026-03-27

Refactored

  • Include dependency minimization: 모듈 간 헤더 의존 최소화
  • Prototype relocation: 적절한 헤더로 함수 선언 재배치
  • Debounce timer: 래퍼 함수 인라인화
  • Utils 이동: timer_elapsed_us를 utils 모듈로 이동
  • Scene helpers: flag 헬퍼 인라인화, object_list_grow static 전환
  • Parser consolidation: 작은 파서 유틸 파일 통합, 에러 처리 단순화

Renamed

  • mlx_context.h → display.h
  • minirt.h → scene.h
  • is_in_shadow → shadow_is_occluded
  • intersect_*_new → intersect_* (_new 서픽스 제거)
  • scene_build_bvh → build_scene_bvh
  • bvh_vis 모듈 → bvh_debug
  • HUD 함수들에 hud_ 프리픽스 통일 (ft_strcpy → hud_strcpy, ft_itoa_buf → hud_itoa_buf)

[2.6.2] - 2026-03-27

Fixed

  • Input: 수직 이동에 카메라 상대 up 벡터 사용 (월드 up 대신)

[2.6.1] - 2026-03-25

Changed

  • lib/ 서브모듈 인라인: libft, MiniLibX을 일반 소스 파일로 편입

Docs

  • v2.6.0 기반으로 README.md 갱신
  • Wiki 용어 및 설명 업데이트

[2.6.0] - 2026-03-25

Added

  • Parser 강화: 좌표 범위 검증, 숫자 파싱 강화
  • 테스트 씬: invalid 파서 씬 34개, valid 씬 2개 추가

Refactored

  • 모듈 분할: ray/ 및 lighting/을 intersect/, shading/, shadow/로 분할
  • HUD 헤더 통합: 작은 헤더 4개를 hud_internal.h로 병합
  • minirt.h 정리: 이동된 타입과 프로토타입 제거

Renamed

  • window.h → render.h, window_internal.h → input.h
  • window → display

Docs

  • Architecture 문서 및 wiki를 v2.6.0 모듈 구조에 맞게 갱신
  • CLAUDE.md 재구조화 반영

[2.5.1] - 2026-03-24

Refactored

  • Display 리네이밍: window/ MLX 파일을 src/display/로 이동, 픽셀 연산 단순화
  • Parser: 오브젝트 타입 카운팅을 get_type_count로 중복 제거

Removed

  • 미사용 aabb_surface_area, bvh.max_depth 제거
  • 미사용 bvh_vis 포맷 헬퍼 및 max_depth 경고 제거

[2.5.0] - 2026-03-24

Refactored

  • Key dispatch: 키 디스패치 체인을 바인드 테이블로 교체
  • Render init 통합: window_init + window_lifecycle → render_init
  • 파일 분할: mlx_context_destroy, bvh_vis prefix_push를 별도 파일로 분리

Fixed

  • macOS: window에서 NULL 해석을 위해 stdlib.h 무조건 포함
  • HUD: hud_toggle을 항상 버퍼 리페인트하도록 단순화
  • Input: KEY_1/KEY_3 카메라 yaw 방향 교환

Style

  • 공백 및 norminette 이슈 수정

[2.4.1] - 2026-03-24

Fixed

  • Render: HUD가 보일 때만 keyguide를 dirty로 표시

Docs

  • 모든 docs/ 및 wiki/ 페이지를 v2.4.0 코드베이스에 맞게 갱신

[2.4.0] - 2026-03

Refactored

  • Input module split: input_dispatch.c, input_camera.c, input_objects.c, input_resize.c, input_rotate.c moved from src/window/ to src/input/
  • Metrics module split: metrics_*.c moved from src/render/ to src/metrics/
  • File renames: trace.c → render_trace.c, camera.c → render_camera.c, intersect_cyl_new.c → intersect_cylinder.c, vector.c → vec3.c, bounds.c → aabb_bounds.c
  • Dead code removal: Removed pixel_timing module, unused handle_key_release, dead HUD files
  • Main refactoring: Extracted init_scene and load_bump_maps helpers

Fixed

  • Linux cleanup: Added mlx_destroy_display call for proper X11 cleanup
  • Shadow sampling: Fixed ceiling division for per-light sample adjustment
  • Safety guards: NaN guards in utils/bvh_vis, buffer overflow fixes in HUD, zero-normal safety in cylinder/cone intersection

Docs

  • Updated all docs/ module pages for file renames and module splits
  • Updated all wiki/ pages: key bindings, debounce FSM, resolution, multi-light, cone, bonus options

[2.3.0] - 2026-02

Added

  • Object Resize: Y/U 키로 반지름, N/M 키로 원기둥 높이 조절
  • Object Rotation: I/J (X축), O/K (Y축), P/L (Z축) Rodrigues 회전
  • LQ Preview Throttle: 디바운스 중 50ms 간격 low quality 프리뷰

Changed

  • Debounce FSM Redesign: 4-상태 머신 IDLE → ACTIVE (150ms) → FINAL → COOLDOWN (350ms)으로 단순화. PREVIEW 상태 제거
  • Keymap Overhaul: 광원 이동 키를 [/]/;/'/,/.으로 변경, 오브젝트 선택을 TAB으로 통일, HUD 페이지를 Up/Down으로 변경
  • Render Flags: RENDER_SHOW_INFO, RENDER_SHIFT_HELD 제거

Removed

  • Dead Code Cleanup: I 키 정보 토글 핸들러, shift 키 핸들링, 미사용 키 정의 (Insert, Home, PgUp, Delete, End, PgDn, Left, Right) 제거

[2.2.0] - 2026-02

Added

  • Plane BVH Separation: Plane을 BVH 트리에서 분리하여 bounded 오브젝트만으로 트리 구축
  • Shadow BVH Any-Hit: Shadow ray에 early-exit BVH 순회 적용
  • Shadow Offset LUT: cos/sin/sqrt 사전 계산으로 shadow sampling 가속
  • Math Optimizations: fast_pow32, sphere sqrt 캐싱, shadow magnitude 통합
  • inv_dir Precompute: 레이 생성 시 1/direction 사전 계산 (AABB 교차 최적화)
  • Camera Basis Caching: 카메라 basis 벡터(right, up) 프레임당 1회 계산 후 캐시
  • BVH Child Ordering: 레이 방향 기준 가까운 자식 우선 순회
  • Metrics Print on Startup: 시작 시 성능 메트릭 자동 출력

Changed

  • Shadow BVH Threshold: 20 → 5로 하향 (더 작은 씬에서도 BVH 활용)

Fixed

  • Shadow offset LUT: 샘플 수 변경 시 LUT 재생성
  • Parser FOV: FOV 범위를 exclusive (0, 180)으로 수정
  • BVH malloc guard: scene_build_bvh에서 malloc 실패 시 안전 처리
  • plane_refs leak: BVH 재구축 시 plane_refs 메모리 누수 수정
  • Parser line buffer: finalize_line에서 null-terminate 보장
  • Parser failure cleanup: parse 실패 시 미처리 라인 메모리 해제

Performance

  • S4 (혼합 18obj): 27.2s → 6.1s (77.7% 개선)
  • S3 (50 spheres): 3.4s → 1.4s (57.4% 개선)
  • Shadow tests (S4): 369M → 83.7M (-77.4%)
  • BVH skip rate (S4): 32.9% → 82.0%

[2.1.0] - 2026-01-15

Added

  • BVH Acceleration: 기본 활성화, 복잡한 씬에서 2~10배 렌더링 가속
  • Debounced Rendering: 150ms 디바운스 타이머 기반 렌더링 최적화
  • BVH Tree Visualization: --bvh-vis 플래그로 BVH 트리 구조 콘솔 출력
  • Unified Object Identifiers: 일관된 오브젝트 식별자 체계 (sp-1, pl-1, cy-1, co-1)
  • RENDER_RENDERING 비트 플래그로 정확한 렌더 진행 추적

Changed

  • 100% Norminette 준수 달성
  • 헤더 인클루드 구조 개선

Fixed

  • BVH 활성화 시 검정 화면 문제
  • 렌더 취소 로직 (실제 렌더링 중일 때만 취소)

Performance

  • BVH: 복잡한 씬에서 2~10배 가속
  • 디바운스: 입력 중 불필요 렌더 90%+ 감소

[2.0.0] - 2026-01

Added

  • 전면 코드 리팩토링 및 모듈화
  • 통합 오브젝트 구조체 (t_object union)
  • 문서 구조화

[1.2.0] - 2025-12

Added

  • Soft Shadows (스토캐스틱 다중 샘플링)
  • Specular Reflection (Phong 모델)
  • Adaptive Shadow Bias

[1.1.0] - 2025-12

Added

  • HUD 씬 정보 표시
  • 렌더링 최적화

[1.0.1] - 2025-12

Fixed

  • 마이너 버그 수정

[1.0.0] - 2025-12

Added

  • 초기 릴리스
  • 기본 레이 트레이싱 (구, 평면, 원기둥)
  • Phong 조명 (Ambient + Diffuse)
  • .rt 씬 파일 파서
  • 카메라/오브젝트 인터랙티브 조작
  • MiniLibX 윈도우 시스템