Files
behind_glass/docs/qa-five-photos/review.md
T
2026-10-06 12:16:46 +09:00

53 lines
6.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 테스트 사진 5장 / 레퍼런스 2장 QA
2026-09-13. 로컬 테스트 전용. 원본 사진·레퍼런스의 외부 게시 권한을 의미하지 않는다.
## 기준과 입력
레퍼런스1 `reference1.png`는 강한 색면/사각 셀의 보조 기준. 레퍼런스2 `reference2.png`가 주 기준이며 큰 눈·코 조각, 주변의 넓게 늘어난 면, 셀별 정보량 차이와 자연스러운 사각 유리 질감을 평가한다. 서로 다른 원본 사진이므로 픽셀 유사도 수치는 사용하지 않는다.
기존 `sample-pet.png` + 사용자 첨부 멍멍이1~4 = 총 5장. 추가 파일은 `public/assets/qa/dog1.jpeg`, `dog2.jpeg`, `dog3.webp`, `dog4.jpeg`로 원본 그대로 복사했다. SHA-256 일치는 `asset-hashes.json`에 기록했다.
기존 샘플에만 수작업 테스트 Depth가 있다. 추가 4장은 Depth 없는 평면 사진이며 부위별 3D parallax 검증 대상이 아니다. 원본에 없는 깊이를 생성하거나 추정했다고 표현하지 않는다.
## 실제 비교 설정
기본 광학 설정은 Mosaic 조각 유리, Grid10 / Distortion .90 / 굴곡 +.65 / 광택 .30. 추가 사진 기본 구도는 1/0/0, 기존 샘플은 기존 2.4/-.10/-.35를 유지했다. 데스크톱 1280×720에서 각 사진 No Glass, 기본 Final, 조정 Final을 기록했다. 아래는 제한된 수동 비교에서 선택한 후보이며 전역 최적값이 아니다.
| 사진 | 확대 / X / Y | Grid | Distortion | 굴곡 | 광택 | 판단 |
|---|---|---:|---:|---:|---:|---|
| 기존 샘플 | 3 / -.15 / -.35 | 8 | .90 | +.65 | .15 | 눈·코 식별 양호. 좁은 세로 구도와 어두운 배경의 한계 |
| 멍멍이1: 흰 포메라니안 | 2.3 / -.10 / -.30 | 8 | .90 | +.65 | .15 | 가장 유망. 큰 눈·코와 밝은 얼굴, 다만 큰 사각 면보다 얼굴 확대 인상이 강함 |
| 멍멍이2: 검은 털 전신 | 2.2 / +.60 / -.60 | 8 | .90 | +.65 | .15 | 얼굴이 커져 식별 개선. 검은 눈 주변 세부가 묻히고 물결 느낌이 남음 |
| 멍멍이3: 두 마리 | 1.3 / +.50 / 0 | 12 | .75 | +.65 | .15 | 두 표정 유지 우선. 확대1.45/X.10은 왼쪽 얼굴이 잘려 제외 |
| 멍멍이4: 옆얼굴 | 1.55 / +.10 / -.85 | 12 | .65 | +.35 | .15 | 기본값에서 눌리던 눈 식별 개선. 두 눈 정면 레퍼런스와 직접 일치는 어려움 |
공통 조명 X .60/Y .80, Camera Offset .30, sensitivity1. 셰이더와 광학 기본값은 이번 작업에서 수정하지 않았다. 사진 선택은 구도를 초기화하며, 위 후보값은 수동 적용한다.
## 시각 결과
5장 모두 레퍼런스2의 자연스러운 사각 유리 질감에 도달하지 않았다. 표정 식별은 개선되지만 주변 털·배경 세부가 많이 남아 셀마다 정보량이 크게 달라지는 효과가 약하다. 1번 잔디, 2번 벽, 3번 가구, 4번 벤치에서는 물결처럼 이어지는 윤곽이 특히 보인다. 레퍼런스1의 강한 단색 색면도 재현하지 않지만 이를 주 목표로 삼지는 않는다.
다음 시각 개선은 (1) 눈·코 조각을 남기면서 주변 셀의 확대·압축 분포 차이를 강화하고, (2) 길게 이어지는 물결을 얕은 사각 면의 굴절로 정리하며, (3) 한 마리 정면/두 마리/옆얼굴의 구도 안내를 나누는 순서가 적절하다. 광택만 올리는 방식으로 해결되지 않는다.
사용자에게는 멍멍이1 같은 정면 근접 사진을 첫 예시로 보여주고, 효과 강도보다 먼저 얼굴 크기·위치를 조정하도록 안내하는 편이 낫다. 두 마리 사진에는 둘을 함께 담는 구도를 우선한다. 이 5장 QA만으로 성별·국가별 실제 수요를 판단할 근거는 없다.
## 증거 파일
- `sample`, `dog1`~`dog4` 각각 `-noglass.png`, `-default.png`, `-tuned.png`.
- 기존 샘플 No Glass 드래그: `sample-noglass-drag.png`. cameraX 0→.081에서 코 projectedX 531.509→529.123, 몸 350.477→350.437로 상대 이동 차이 확인.
- 모바일 `sample-mobile.png`, `dog1-mobile.png`~`dog4-mobile.png`; 드래그 대표 `dog1-mobile-drag.png`, `dog4-mobile-drag.png`. 일부 캡처는 패널 폭 수정 전이며 광학 결과는 동일하다. 최종 패널 화면은 `dog1-final-ui.png`.
## 최종 구현 / 검증
수정 파일: `index.html`, `src/main.ts`, `src/input/MediaLoader.ts`, `src/style.css`, 추가 사진 4장. 테스트 사진 select에서 선택 후 '선택한 테스트 사진 불러오기'로 전환한다. 기존 샘플 버튼 기능은 유지했다.
- 모바일 390×844에서 5장 조정 구도 모두 렌더링 확인. 멍멍이1·4 드래그 시 유리/창틀 정렬 유지. 실제 휴대폰 하드웨어·자이로·FPS 측정은 하지 않았다.
- 기존→추가→기존 전환에서 수작업 Depth 안내와 2.4/-.10/-.35 복귀 확인. 추가 사진은 1/0/0, 평면 안내, 기존 진단 숨김 확인.
- dog1→dog3→sample→dog1 연속 선택·불러오기 후 최종 dog1/평면 안내/구도1/0/0 확인. 네트워크 지연을 강제로 주입한 경합 테스트는 하지 않았다.
- select의 긴 라벨로 설정 패널이 잘리던 문제를 재현 후 너비 제한·짧은 라벨로 수정. 최종 desktop aside client/scrollWidth 모두264, select228. 모바일 aside client/scrollWidth 모두375 확인.
- Astra 검토에서 발견한 로딩 실패 시 이전 RGB와 새 출처가 섞이는 문제는 성공 callback에서 Depth·구도·출처를 함께 반영하도록 수정. 수정은 정적 재검토 완료; 실패를 강제 주입한 브라우저 테스트는 하지 않았다.
- 최종 Luna 빌드 `tsc -b && vite build` 통과. QA 탭 error 로그 0건. 이번 작업에서 영상/일반 업로드/수동 Depth 업로드 전체 회귀 테스트는 실행하지 않았다.
현재 셰이더는 기존 이웃 셀의 좌표변환·표면기울기를 연결하고 공유 법선으로 굴절/반사를 계산하는 방식 그대로다. 이번 변경으로 유리 질감이 개선됐다고 해석하면 안 된다. 테스트 사진 다양화를 통해 한 장에만 맞춘 평가의 한계를 확인한 작업이다.