first commit

2026-10-06 12:16:46 +09:00
commit 619d980098
415 changed files with 22283 additions and 0 deletions
@@ -0,0 +1,52 @@
+# Ref1 목표에 가장 근접한 현재 기준안
+
+이 문서의 당시 기준안을 **옵션 1**로 보존한다. 2026-09-14 사용자가 현재 구현·설정을 **목표에 가장 근접한 두 번째 옵션**으로 추가 지정했다. 옵션 2의 정확한 설정과 구현 구분은 `docs/ref1-option-2.md`를 따른다.
+
+2026-09-14 사용자 지정: 지금까지 적용한 구현과 아래 비교 옵션을 **Ref1 목표에 가장 근접한 현재 기준안**으로 명시하고, 이후 작업은 이 기준안과 비교한다. 이는 지금까지의 프로젝트 내 선택이며 모든 사진의 최적 설정이나 Ref1 완성 판정을 뜻하지 않는다.
+
+## 기준 옵션
+
+2026-09-14 현재 브라우저에서 확인한 비교 설정이다. 앱 초기 기본값과 혼동하지 않는다.
+
+| 항목 | 현재 기준 비교값 | 앱 기본값/범위 |
+|---|---|---|
+| View Mode / Glass / 스타일 | Final / Mosaic / 조각 유리 | 동일 |
+| 색면 단순화 | 1.00 | 기본 0.65 |
+| Grid Size | 10 | 기본 10 |
+| Distortion | 1.00 | 기본 0.90 |
+| 셀 굴곡 | +1.00 | 기본 +0.65, 범위 -1~+1 |
+| 광택 / 조명 XY | 0.30 / 0.60, 0.80 | 동일 |
+| Depth Scale | 0.25 | 기본 0.25 |
+| Camera Offset | 0.50 | 기본 0.50, 최대 0.90 |
+| 사진 확대 / 팬 XY | 1.00 / 0, 0 | 자동 변경 금지 |
+| View sensitivity / Gyroscope | 1.00 / OFF | 동일 |
+
+비교 사진은 멍멍이 1(잔디 위 흰 포메라니안), 브라우저의 AI 추정 상대 depth다. 별도 회귀 확인에는 `public/assets/sample-pet.png`와 수작업 테스트 depth를 사용한다. 수작업 depth를 AI 추정이나 실제 측정으로 표현하지 않는다. 입력 사진의 촬영 구도와 질감이 다르므로 설정 숫자만으로 결과의 일치를 보장하지 않는다.
+
+## 기준 구현
+
+- 공통 장면과 카메라 광선, 부호 있는 곡면 법선을 사용하는 시점 의존 굴절. 독립적인 셀별 무작위 크롭을 사용하지 않는다.
+- RGB/Depth 공통 배치와 유리 근접 간격을 유지하고 확대·팬·크롭을 자동 변경하지 않는다.
+- 가까운 얼굴의 색면을 줄이던 거리 감쇠는 제거했다. 사진 속 배경도 피사체와 동일한 유효 장면 표면이다. 유효하지 않은 깊이/화면 밖 영역 제외와 사진 배경의 단순화 제외는 다른 개념이다.
+- 셀별 8×8 표본과 4색 팔레트, 설명률에 따른 수평·수직 2영역 분할, 복잡한 영역의 radial fallback.
+- 셀 내부 시점 반응 계수 0.18. 기본 Mosaic 가장자리 taper 1.25셀, 촘촘 유리는 기존 0.75셀.
+- 이산 분할 번호 대신 평가된 색면과 confidence만 70ms history로 보간한다. 원본 굴절은 현재 프레임을 사용한다.
+- Ref1 주 기준 / Ref2 보조 비교 배치를 유지한다.
+
+## 이 기준에서 이어갈 작업
+
+현재 기준안에도 잔디 등 배경의 작은 무늬가 많이 남는다. 사용자는 **눈·코의 보호 예외를 제거하고 얼굴과 배경에 같은 색면 규칙을 적용**하도록 정정했다. 눈·코는 결과에서 표정이 읽히는지 평가하는 대상이며, 어두운 픽셀이나 원본 RGB를 별도 보호하는 구현 조건이 아니다. 기존 보호 로직은 이 기준을 기록한 시점의 구현 이력이며 이후 작업에서 제거한다.
+
+배경까지 큰 면으로 정리하되 전체 사진 블러, 원본 저해상도 확대, 모든 셀의 일괄 단색화로 대체하지 않는다. 시점 반응과 전환 보간을 함께 유지한다. 기준안보다 개선됐는지는 같은 사진·같은 설정의 정면 및 이동 화면으로 확인한다.
+
+기존 검증 기록: `docs/ref1-shape-review.md`. 최대 대각 시점의 사진 바깥 여백, 실기기 FPS와 연속 영상 flicker 미측정은 기존 한계로 유지한다.
+
+## 후속 적용 결과
+
+최신 방식은 `docs/ref1-dark-color-planes.md`를 따른다. 눈·코 원본 픽셀을 복원하는 대신 깊이·어두움 증거로 사각 색면의 선택을 보정한다.
+
+추가 정정: 보호 범위를 원본 depth의 앞쪽과 어두운 RGB의 교집합으로 제한한다. 기준 및 결과는 `docs/ref1-depth-protection.md`를 따른다.
+
+최신 사용자 정정: 아래 보호 제거 실험을 확인한 뒤 눈·코 보호 예외를 다시 유지하기로 했다. 기존 보호를 복원하고 배경 강화 및 SSE 분할은 유지한다. 아래 제거 내용은 실험 이력이며 현재 유지 조건이 아니다.
+
+위 기준안을 보존한 뒤 눈·코 보호 예외 제거, 사진 배경과 가장자리의 색면 강화, 공통 색 차이 오차를 최소화하는 분할 선택을 적용했다. 적용 내용과 같은 조건의 비교 결과는 `docs/ref1-scene-simplification.md`에 기록한다. 이 문서의 기준 옵션은 비교용 기록이며 앱 기본값을 자동 변경한 것이 아니다.