eKeerar
51 lines
2.7 KiB
Markdown
51 lines
2.7 KiB
Markdown
# 아키텍처 (Architecture)
|
|
|
|
## 레이어 모델
|
|
```
|
|
[상황 이벤트] 예: "error" / "success" / "idle"
|
|
│
|
|
▼
|
|
[트리거 매퍼] reactions.json 상황키 → 반응 클립 이름
|
|
│
|
|
▼
|
|
[반응 시퀀서] clips/<name>.json 타임라인으로 아래 레이어들을 조율
|
|
├─ Body 레이어 ── 리그 클립(rig.json+track) │ 또는 │ 베이크드 포즈 이미지
|
|
├─ Face 레이어 ── 표정 프레임 스왑(neutral/negative/love/…)
|
|
├─ Mouth 레이어 ── 말하기(talk 프레임 순환, 유사 립싱크)
|
|
├─ Transform 레이어 ── 리그 위에 덧입히는 잔모션(고개젓기·바운스)
|
|
└─ FX/Caption 레이어 ── 말풍선·효과음(옵션)
|
|
│
|
|
▼
|
|
[컴포지터] 파츠 합성 + 표정 오버레이 + 앵커 정렬(AlphaTools 재활용)
|
|
│
|
|
▼
|
|
[렌더러] Canvas(웹 프로토타입) / WPF(본체) — 60fps
|
|
```
|
|
|
|
## 레이어 책임
|
|
- **Body**: 캐릭터 몸의 자세/모션. 두 모드.
|
|
- `rig` 모드 = 16파츠 리그를 클립으로 구동(앰비언트·열린 제스처·전환).
|
|
- `baked` 모드 = 통짜 포즈 이미지 1장(자기-가림 포즈: 팔짱·하트).
|
|
- **Face**: 감정 = 표정 프레임 교체(머리 이미지 스왑).
|
|
- **Mouth**: 말하기 = talk/neutral 프레임 순환(유사 립싱크). *정밀 립싱크는 mesh-warp 승급 시.*
|
|
- **Transform**: 리그 본에 delta를 더하는 잔모션(고개 좌우·호흡·바운스). Body가 baked여도 전체 트랜스폼은 적용 가능.
|
|
- **FX/Caption**: 말풍선 텍스트·효과음(옵션).
|
|
|
|
## 하이브리드 선택 규칙 (언제 무엇을)
|
|
| 상황 | Body 모드 | 근거 |
|
|
|---|---|---|
|
|
| 배경춤·유휴·호흡 | **rig** | 부드러운 앰비언트, 자산 최소 |
|
|
| 손 흔들기·가리키기·제시·박수 | **rig** | 열린 자세 → 리그로 자연스러움 |
|
|
| 고개 끄덕/젓기 | **rig**(Transform) | 작은 각도 + 가림 |
|
|
| 팔짱·핑거하트·볼하트 | **baked** | 손이 몸에 겹침 → 리그는 뚫림/어색 |
|
|
| 큰 감정 포즈(만세·좌절) | **baked** 또는 rig(joy/cheer) | 필요 정밀도에 따라 |
|
|
|
|
## 전환 (transition)
|
|
- rig→rig: 트랜스폼 보간(부드럽게).
|
|
- rig↔baked: 짧은 **크로스페이드**(150~250ms) 또는 리그로 근사 진입 후 스냅.
|
|
- 반응 종료 후 `return` 지정 클립(보통 `idle`/`dance_idle`)으로 복귀.
|
|
|
|
## 데이터 재사용
|
|
- `rig.json`·클립·`reactions.json`·표정/포즈 이미지는 **웹 뷰어와 WPF가 동일하게** 사용(플랫폼 독립 데이터).
|
|
- 앵커 정렬은 기존 `Character_Builder/AlphaTools.cs`(알파 기반 목/어깨 검출) 로직을 재활용.
|