behind_glass/docs/ref1-option-ranges.md

# Ref1용 조절 범위와 UI 정리

2026-09-14 사용자 요청: 옵션 2의 색면 방식과 색면 단순화 1을 기준으로 Ref1에 가까운 Grid 및 유효 조절 범위를 선정하고 불필요한 조절을 정리한다. 옵션 1·2의 기록은 그대로 보존한다.

## 권장 범위

| 항목 | 권장값/범위 | 처리 |
|---|---|---|
| 색면 단순화 | 1 고정 | 슬라이더·출력·이벤트 제거, 고정값 안내 |
| Distortion | 1 고정 | 조절 제거. 낮추면 원래 RGB 질감도 다시 섞임 |
| Grid — 얼굴이 큰 한 마리 | 12~16, 시작 13 | 주 조절 |
| Grid — 작은 얼굴/여러 마리 | 20~24, 시작 20 | 같은 주 조절. 전체 UI 범위 10~24 |
| 셀 굴곡 | 절댓값 0.65~1, 시작 +1 | 부호는 공간 변화를 바꾸므로 −1~+1 유지 |
| 광택 | 0~0.3, 시작 0.3 | UI 0~0.4. 무광부터 약한 반사까지 |
| Camera Offset | 0.35~0.65, 시작 0.5 | 기존 0~0.9 보존. 시점 이동 범위 조절 |
| 사진 확대·팬 | 사진에 따라 수동 | ‘사진 구도’로 접어 유지, 자동 변경 금지 |

Grid는 화면 크기보다 사진에서 얼굴이 차지하는 비율에 따라 고른다. 숫자를 낮추면 큰 면이 되지만 눈·얼굴이 합쳐질 수 있다. 위 범위는 두 사진의 수동 비교와 현재 셰이더 구조를 바탕으로 한 작업 범위이며 전수 탐색의 최적값이 아니다. 곡률의 양·음 부호는 같은 모양을 보장하지 않는다.

## 비교 근거

- 초기 UI의 테스트 사진 선택은 dog3, Grid 24 / 굴곡 −1 / 조명 X 2였다. 선택값과 이미 불러온 사진이 다를 수 있으므로 최종 검증에서는 dog3를 명시적으로 다시 불러왔다. 같은 굴곡 −1 / 조명 X 2에서 Grid 16·20·24를 비교했다. 16에서는 작은 얼굴 정보가 크게 합쳐졌고 20~24가 더 많은 얼굴 구분을 남겼다.
- dog1에서 Grid 10은 한쪽 눈이 밝은 면에 흡수됐고, 기존 옵션 2의 13은 두 눈을 사각 면으로 남겼다. 16은 더 작은 면으로 얼굴을 표현했다. 따라서 이 사진에서는 12~16을 우선 조절 범위로 잡는다.
- dog1 / Grid 16에서 Distortion 0.8과 1을 비교했다. 0.8은 잔디 질감과 눈·코의 세부 윤곽이 다시 드러나므로 Ref1 색면 작업에서는 1로 고정한다.
- dog1 / Grid 13 / 굴곡 +0.65 / 광택 0에서도 사각 색면은 유지됐다. 굴곡 +1과 얼굴의 면 선택은 달랐으며 반사는 핵심 색면 생성 요소가 아니다.
- Camera Offset 권장 범위는 기존 0.5 시점 검증과 0.9에서 사진 밖 여백이 보일 수 있다는 기록에 기반한 보수적 조절 범위다. 모든 중간값의 영상 검증을 수행한 것은 아니다.

## 주 화면에서 제외할 항목

색면·Distortion은 고정하고 조절을 제거한다. 조명 XY(기본 0.6/0.8), Depth Scale(0.25), sensitivity(1)는 진단·비교 용도가 있어 접힌 ‘개발 비교’에 둔다. 다른 유리 효과/스타일, RGB·Depth·No Glass 등 보기 모드, 수동 depth 업로드와 영상 입력도 같은 곳으로 이동한다. 이들은 현재 Ref1의 주 조절에서 제외하며 렌더러 기능 자체를 삭제하지 않는다.

사진/AI depth 생성·테스트 사진, 격자·굴곡·광택·시점 범위, 시점 초기화와 Gyroscope는 접근 가능하게 유지한다. 수동 AI depth 생성 후에는 Final로 돌아와 접힌 보기 모드 때문에 No Glass에 머무르지 않게 한다.

## 적용 및 검증

`index.html`, `src/main.ts`, `src/style.css`와 관련 검사 스크립트를 수정했다. 색면/Distortion의 UI·출력·이벤트·해제 참조를 제거하고 셰이더 uniform은 1을 유지한다. 주 화면의 Grid 기본13/굴곡+1/광택.3/Camera.5와 실제 uniform을 맞췄다. 촘촘 유리 비교의 격자 초기값도 UI 상한24와 일치시켰다.

axis-split, camera-history, depth-distance, DOM ID 참조 검사 및 build 통과. 기존 번들 크기 경고는 남는다. 실제 브라우저에서 네 가지 주 조절, 두 접기 영역, 깊이 상태 노출을 확인했고 No Glass에서 수동 AI 생성을 실행한 뒤 Final 복귀를 확인했다. 사진 확대1/팬0을 유지했다. 모바일 실기기 검증은 수행하지 않았다.