Consolidate character profiles and image production docs

2026-07-04 12:54:11 +09:00
parent 351c3d65ad
commit f8db111d71
1366 changed files with 3743 additions and 21740 deletions
@@ -0,0 +1,57 @@
+# Dance Rig Required Parts
+
+Solo Dance 3 수준의 자연스러운 댄스 모션을 위해 다음 파츠를 제작한다.
+
+## 팔/손
+
+- upperarm L/R
+- elbow corrective L/R
+- forearm L/R
+- wrist cuff L/R
+- palm L/R
+- backhand L/R
+- thumb/index/middle/ring/pinky group L/R
+- relaxed hand L/R
+- open palm L/R
+- soft fist L/R
+- pointing hand L/R
+
+## 상체/의상
+
+- chest base
+- chest left/right cloth stretch
+- under-bust shadow
+- abdomen front
+- waist bend corrective L/R
+- jacket body
+- jacket inner flap L/R
+- hoodie collar L/R
+- zipper/string overlays
+
+## 하체
+
+- pelvis
+- hip corrective L/R
+- thigh L/R
+- knee corrective L/R
+- shin L/R
+- foot L/R
+- pants fold overlays
+
+## 머리/헤어
+
+- face base
+- front hair center/L/R
+- side hair L/R
+- back hair mass
+- hair tip L/R
+- headset band and cups
+- choker/pendant overlays
+
+## 마스크와 레이어 이벤트
+
+- arm over torso
+- torso over arm
+- hand over face
+- hair over shoulder
+- shoulder over hair
@@ -0,0 +1,53 @@
+# Dance Rig Extension Specification
+
+## 리그 목표
+
+- 팔이 몸 앞뒤를 자연스럽게 오간다.
+- 상체와 골반이 반대 방향으로 움직인다.
+- 손목과 손바닥 방향이 프레임마다 달라진다.
+- 손가락이 펴지고 굽혀지는 변화를 표현한다.
+- 의상 라인이 파츠 이동 중에도 이어진다.
+
+## Bone Hierarchy
+
+- Root
+  - Pelvis
+    - Abdomen
+      - Chest
+        - Neck
+          - Head
+            - Hair groups
+        - Arm L
+          - UpperArm L
+          - ForeArm L
+          - Hand L
+          - Fingers L
+        - Arm R
+          - UpperArm R
+          - ForeArm R
+          - Hand R
+          - Fingers R
+    - Leg L
+    - Leg R
+
+## Motion Channels
+
+- rootX, rootY
+- pelvisRotateZ, pelvisX, pelvisY
+- abdomenBendX, abdomenBendY
+- chestRotateZ, chestX, chestY
+- headRotateZ, headX, headY
+- shoulderRaise L/R
+- elbowBend L/R
+- wristRoll L/R
+- palmOpen L/R
+- fingerCurl L/R
+- hairSway L/R
+
+## Z-order Events
+
+- armFront L/R
+- armBack L/R
+- handFrontFace L/R
+- hairFrontShoulder L/R
+- torsoFrontArm L/R
@@ -0,0 +1,35 @@
+# Live2D Parameter and Motion Specification
+
+## Parameters
+
+| Parameter | Range | Purpose |
+|---|---:|---|
+| ParamRootX | -1..1 | 전체 좌우 이동 |
+| ParamRootY | -1..1 | bounce |
+| ParamPelvisAngleZ | -30..30 | 골반 회전 |
+| ParamChestAngleZ | -30..30 | 흉곽 회전 |
+| ParamBodyBendX | -1..1 | 상체 좌우 굽힘 |
+| ParamBodyBendY | -1..1 | 상체 전후 굽힘 |
+| ParamHeadAngleZ | -30..30 | 머리 회전 |
+| ParamArmLiftL/R | 0..1 | 팔 올림 |
+| ParamElbowBendL/R | 0..1 | 팔꿈치 굽힘 |
+| ParamWristRollL/R | -1..1 | 손목 회전 |
+| ParamPalmOpenL/R | 0..1 | 손바닥 개방 |
+| ParamFingerCurlL/R | 0..1 | 손가락 굽힘 |
+| ParamHairSwayL/R | -1..1 | 머리카락 흔들림 |
+
+## Motion Loops
+
+- Loop A: idle groove
+- Loop B: hand forward / palm push
+- Loop C: arms up
+- Loop D: side turn / hair swing
+- Loop E: return settle
+
+## Timing
+
+- root와 pelvis가 리듬을 만든다.
+- chest는 pelvis보다 반 박자 늦거나 반대 방향으로 움직인다.
+- head는 chest보다 늦게 따라온다.
+- hair는 head보다 더 늦게 움직인다.
+- hand/finger는 짧고 빠른 accent로 처리한다.
@@ -0,0 +1,292 @@
+# SampleDance Motion Reference Requirements
+
+작성일: 2026-07-04
+대상 경로: `D:\Project\SampleDance`
+목적: LeeSori / Dansori 캐릭터 댄스 리그를 자연스럽게 만들기 위해 SampleDance 자료를 검토하고, 추가 제작해야 할 자료와 리그/모션 요구사항을 취합한다.
+
+## 1. 현재 자료 목록
+
+| 파일 | 형식 | 해상도 / 길이 | 프레임 | 1차 판단 |
+|---|---:|---:|---:|---|
+| `Group Dance 1.mp4` | video | 604x340 / 5.70s | 57 frames, 10fps | 군무/애니메이션 스타일 참고. 하체 스텝, 동시 팔동작, 실루엣 변화 참고용. LeeSori 주 리그 자료로는 우선순위 낮음. |
+| `Solo Dance 1.mp4` | video | 550x232 / 5.43s | 132 frames, 약 24fps | 애니 캐릭터의 간단한 상체/팔 제스처 참고. 해상도와 크롭이 작아 세부 리그 추출용으로는 약함. |
+| `Solo Dance 2.png` | image | 500x658 | static | 양팔 머리 위 포즈, 상체 S라인, 머리카락/가슴/허리 실루엣 참고. 모션보다는 키포즈/파츠 분리 참고용. |
+| `Solo Dance 3.mp4` | video | 576x1024 / 15.05s | 450 frames, 약 30fps | 최우선 목표 자료. 상체 회전, 팔 올림, 손바닥/손가락, 머리카락, 몸통 웨이브, 측면 회전이 풍부함. |
+
+생성한 검토 이미지:
+- `D:\Project\SampleDance\_analysis\Group_Dance_1_contact.png`
+- `D:\Project\SampleDance\_analysis\Solo_Dance_1_contact.png`
+- `D:\Project\SampleDance\_analysis\Solo_Dance_3_contact_1fps.png`
+- `D:\Project\SampleDance\_analysis\Solo_Dance_3_contact_2fps.png`
+
+## 2. 자료별 사용 방향
+
+### Solo Dance 3.mp4 - 주 목표
+
+가장 중요한 레퍼런스다. 현재 이소리 리그가 정지 포즈 전환처럼 보이는 문제를 해결하려면, 이 영상에서 다음 요소를 별도 자료로 추출해야 한다.
+
+- 몸 중심축이 좌우로 이동하는 리듬
+- 골반과 흉곽이 서로 반대로 움직이는 counter motion
+- 상체가 앞으로 숙여졌다가 다시 펴지는 bounce
+- 팔이 아래에서 앞으로, 앞으로에서 머리 위로 올라가는 lift arc
+- 손바닥이 카메라를 향했다가 손등/측면으로 돌아가는 wrist roll
+- 손가락이 펴짐, 살짝 굽힘, 엄지/검지 제스처로 바뀌는 변화
+- 머리가 상체보다 늦게 따라오는 follow-through
+- 머리카락이 몸 회전보다 늦게 흔들리는 secondary motion
+- 측면 회전 시 어깨, 가슴, 허리, 골반의 실루엣 변화
+- 팔이 몸 앞을 지나갈 때 생기는 occlusion / 앞뒤 레이어 순서 변화
+
+### Solo Dance 2.png - 키포즈 보조
+
+정적 이미지이므로 자연스러운 모션 추출에는 한계가 있다. 대신 다음 자료 제작에 쓴다.
+
+- 양팔 머리 위 포즈의 최종 키포즈
+- 겨드랑이/어깨/가슴 라인이 무너지지 않도록 하는 보정 파츠 참고
+- 머리카락이 팔과 겹칠 때 앞/뒤 레이어 분리 참고
+- 치마/허벅지/상체가 한 포즈에서 자연스럽게 이어지는 실루엣 참고
+
+### Solo Dance 1.mp4 - 단순 루프 보조
+
+해상도와 크롭이 작아서 세부 손/몸통 추출은 어렵다. 다만 캐릭터풍 간단 루프 제작 시 참고 가능하다.
+
+- 작은 폭의 손 흔들기
+- 정면 캐릭터가 제자리에서 리듬을 타는 최소 모션
+- 눈에 거슬리지 않는 idle dance loop 타이밍 참고
+
+### Group Dance 1.mp4 - 실루엣/하체 보조
+
+주 캐릭터 리그에는 우선순위가 낮지만, 하체와 단체 동작 아이디어에는 쓸 수 있다.
+
+- 좌우 스텝 타이밍
+- 무릎 들어올림 / 발 딛기 실루엣
+- 팔과 다리의 대칭/반대칭 리듬
+- 여러 캐릭터 제스처를 나중에 재사용할 때 카테고리 분류 참고
+
+## 3. 추가로 필요한 자료 - 우선순위별
+
+### P0. 반드시 필요한 자료
+
+1. `Solo Dance 3` 키포즈 프레임 세트
+   - 최소 16개, 권장 24~32개.
+   - 0.0s, 0.5s, 1.0s 식 균등 샘플이 아니라, 동작 전환점 기준으로 선별해야 한다.
+   - 필요 포즈: 준비, 손 앞으로, 손바닥 펼침, 손목 회전, 한팔 올림, 양팔 올림, 머리 위 손, 측면 회전, 등/후면 회전, 복귀, 바운스 다운, 바운스 업.
+
+2. 신체 관절 추적 데이터
+   - head, neck, chest, waist, pelvis
+   - left/right shoulder, elbow, wrist, palm center
+   - left/right hip, knee, ankle
+   - 가능하면 finger landmarks: thumb/index/middle/ring/pinky root/tip
+   - 프레임 단위 CSV 또는 JSON 필요.
+
+3. 파츠 분리용 기준 이미지
+   - 정면 기본 포즈
+   - 좌회전 30~60도 포즈
+   - 우회전 30~60도 포즈
+   - 양팔 위 포즈
+   - 손바닥 정면 포즈
+   - 손등/측면 포즈
+   - 팔이 몸 앞을 가리는 포즈
+
+4. 실제 리그 파츠 세분화
+   - 현재 whole-arm 임시 방식은 팔 중복을 없애는 데는 좋지만 팔꿈치 자연스러움이 부족하다.
+   - 상완/전완/손/손가락/소매/자켓 외곽/그림자 보정 파츠를 분리해야 한다.
+
+### P1. 자연스러움 향상 자료
+
+1. 흉곽/가슴/상의 라인 보정 파츠
+   - chest front
+   - left breast cloth stretch
+   - right breast cloth stretch
+   - center zipper/string overlay
+   - under-bust shadow
+   - side torso shadow
+   - hoodie inner flap left/right
+   - jacket outer flap left/right
+
+2. 허리/골반/하체 보정 파츠
+   - waist front
+   - abdomen highlight/shadow
+   - pelvis front
+   - pants waistband
+   - drawstring front overlay
+   - left/right hip side cloth
+   - thigh left/right
+   - knee left/right corrective fold
+   - shin left/right
+   - foot left/right
+
+3. 팔/손 파츠
+   - upperarm left/right front
+   - upperarm left/right back or sleeve underside
+   - elbow corrective patch left/right
+   - forearm left/right
+   - wrist cuff left/right
+   - palm left/right
+   - back-of-hand left/right
+   - thumb, index, middle, ring, pinky grouped layers or at least 3-state hand sprites
+   - fist, open palm, relaxed hand, pointing/finger-heart-like pose if needed
+
+4. 머리/헤어 파츠
+   - head base
+   - face
+   - front bangs clusters
+   - left/right side hair
+   - back hair mass
+   - hair tip sways
+   - headset left/right separated if head rotates
+   - neck/choker overlay
+
+5. 레이어 순서 전환 자료
+   - arm behind torso
+   - arm in front of torso
+   - hand in front of face/hair
+   - hair in front of shoulder
+   - shoulder/jacket in front of hair for side turn
+
+### P2. 고급 모션 자료
+
+1. 모션 커브
+   - rootY bounce
+   - rootX sway
+   - pelvis rotateZ
+   - pelvis translateX/Y
+   - waist bendX/Y/Z
+   - chest rotateZ
+   - chest translateX/Y
+   - head rotateZ / delayed follow
+   - shoulder left/right raise
+   - elbow left/right bend
+   - wrist left/right roll
+   - palm open amount
+   - finger curl amount
+
+2. 보간 방식
+   - linear 금지.
+   - 팔 올림은 ease-out + overshoot 필요.
+   - 몸통 bounce는 sine/cubic 기반 loop 필요.
+   - 머리카락은 2~4프레임 지연 또는 phase offset 필요.
+   - 손목/손가락은 팔보다 빠르고 작게 움직여야 한다.
+
+3. 루프 설계
+   - 15초 전체를 그대로 재현하기보다 2.5~4.0초 단위의 reusable loop로 분해한다.
+   - loop A: idle groove
+   - loop B: hand forward / palm push
+   - loop C: arms up
+   - loop D: side turn / hair swing
+   - loop E: return / settle
+
+## 4. LeeSori 리그 확장 제안
+
+### 최소 안정 리그
+
+현재 앱에 넣을 수 있는 안정 단계.
+
+- torso group
+- pelvis group
+- head group
+- left whole arm
+- right whole arm
+- legs static or light sway
+- hair sway overlay
+
+장점: 팔 중복이 적고 빠르게 안정화 가능.
+단점: 팔꿈치/손목/손가락 자연스러움 부족.
+
+### 권장 프로덕션 리그
+
+Solo Dance 3 수준을 목표로 하면 최소 다음 파츠가 필요하다.
+
+- Root
+- Pelvis
+- Abdomen
+- Chest
+- Neck
+- Head
+- Hair front / side / back / tips
+- Jacket torso left/right/front/back
+- Hoodie collar left/right
+- Shirt torso + chest corrective overlays
+- Left upper arm / left forearm / left cuff / left hand / left fingers
+- Right upper arm / right forearm / right cuff / right hand / right fingers
+- Left thigh / knee / shin / foot
+- Right thigh / knee / shin / foot
+- Occlusion masks: torso-over-arm, arm-over-torso, hair-over-shoulder
+
+### 고품질 댄스 리그
+
+움직임이 실제 영상처럼 보이려면 다음이 필요하다.
+
+- 각 팔 최소 4~6개 레이어: upper arm, elbow patch, forearm, cuff, palm/backhand, fingers
+- 각 손 최소 4개 상태: relaxed, open palm, fist/soft fist, pointing/finger gesture
+- 상체 최소 5개 corrective: neutral, left bend, right bend, forward bend, chest-up
+- 골반/복부 최소 4개 corrective: neutral, left hip, right hip, pelvis forward, pelvis back
+- 머리카락 최소 6개 sway layer: front L/R, side L/R, back mass, tips
+- 레이어 순서 전환용 z-index event table
+
+## 5. SampleDance 기준 작업 산출물 목록
+
+다른 세션과 취합하기 위해 다음 파일 단위로 생성하는 것이 좋다.
+
+1. `motion_reference_manifest.json`
+   - 각 영상/이미지의 역할, 우선순위, 사용할 구간, 생성된 분석 파일 목록.
+
+2. `solo_dance_3_keyframes.json`
+   - timecode, frame index, pose label, motion notes.
+
+3. `solo_dance_3_landmarks.csv`
+   - frame, time, joint, x, y, confidence.
+
+4. `solo_dance_3_motion_curves.json`
+   - root/chest/pelvis/head/arm/wrist/finger curve values.
+
+5. `leesori_required_parts.md`
+   - 필요한 파츠 목록, 기존 파츠 상태, 새로 만들어야 할 파츠, 우선순위.
+
+6. `leesori_rig_hierarchy.json`
+   - bone hierarchy, pivot, z-order, constraints.
+
+7. `leesori_z_order_events.json`
+   - 특정 포즈/시간에서 arm-over-body, hair-over-arm 같은 레이어 순서 변화.
+
+8. `leesori_corrective_parts_plan.md`
+   - 몸매/의상 라인 연결을 위한 보정 파츠 목록.
+
+9. `solo_dance_3_loop_segments.md`
+   - 2.5~4초 단위 재사용 루프 구간 정의.
+
+10. `qa_motion_checklist.md`
+   - 팔 중복, 절단, 어깨 탈구, 손목 뒤틀림, 의상 라인 끊김, 머리카락 부자연스러움 확인 항목.
+
+## 6. 현재 자료만으로 가능한 것과 불가능한 것
+
+가능:
+- Solo Dance 3의 대략적인 상체 리듬과 팔 올림 타이밍 추정
+- 손바닥 정면/손목 회전/양팔 위 키포즈 추출
+- 골반-흉곽 반대 움직임 패턴 설계
+- 머리카락 follow-through 방향 설계
+- reusable gesture category 설계
+
+부족:
+- 손가락별 정확한 굽힘 추출은 영상 해상도/모션블러 때문에 제한적이다.
+- 의상 라인과 몸매 라인을 완벽히 이어 붙이려면 별도 파츠 원화가 필요하다.
+- 기존 LeeSori clean 파츠는 임시 whole-arm 구조라 팔꿈치 리깅에는 부족하다.
+- 진짜 자연스러운 팔 올림을 위해서는 상완/전완/손/손가락을 새로 분리해야 한다.
+
+## 7. 권장 다음 순서
+
+1. `Solo Dance 3`에서 24~32개 키포즈 프레임을 추출한다.
+2. 각 키포즈에 pose label을 붙인다.
+3. 관절 랜드마크를 추출해 CSV/JSON으로 정리한다.
+4. LeeSori 기준 신규 파츠 요구 목록을 확정한다.
+5. 임시 whole-arm 리그를 유지한 채, production arm rig를 별도 브랜치/폴더에서 만든다.
+6. 팔/손/상체 corrective 파츠를 생성한다.
+7. `Solo Dance 3`를 2.5~4초 루프로 분해해 gesture library에 등록한다.
+8. DansoriEQ runtime에는 `poseSequence`가 아니라 `partsRig + curve animation + z-order events`로 적용한다.
+
+## 8. 검토 결론
+
+- 주 자료는 `Solo Dance 3.mp4`로 확정하는 것이 맞다.
+- 현재 필요한 것은 단순 이미지 추가가 아니라, 키포즈/랜드마크/모션커브/세분화 파츠/보정 파츠/레이어 이벤트 전체 세트다.
+- 팔이 4개로 보였던 문제는 파츠가 충분히 잘게, 정확히 분리되지 않은 상태에서 회전 애니메이션을 적용했기 때문이다.
+- 자연스러운 결과를 위해서는 `whole-arm 임시 리그`와 `production segmented rig`를 분리해서 관리해야 한다.
+- 다른 세션에서 준비 중인 작업과 취합할 때는 위 산출물 파일명을 기준으로 병합하면 된다.
@@ -0,0 +1,28 @@
+# Dance Motion
+
+LeeSori 댄스 모션은 Solo Dance 3를 기준으로 제작한다. 목표는 정지 이미지의 연속 재생이 아니라 파츠 리그, 모션 커브, z-order 이벤트를 이용한 연속적인 몸 움직임이다.
+
+## 핵심 모션 요소
+
+- 몸 중심 좌우 이동
+- 골반과 흉곽의 반대 회전
+- 상체 bounce와 forward bend
+- 팔 lift arc
+- 팔꿈치 bend
+- 손목 roll
+- 손바닥 방향 전환
+- 손가락 curl/open 변화
+- 머리 follow-through
+- 머리카락 secondary motion
+- 하체 무릎/골반 리듬
+
+## 산출물
+
+- keyframes
+- landmarks
+- motion curves
+- rig hierarchy
+- required parts
+- corrective parts
+- z-order events
+- QA checklist