시네마틱 애니메이션은(는) 무엇을 하나요?
robloxmaxxing 다음의 프리미엄 레인. 그 스킬은 게임 에셋과 밝고 복잡한 설명 세계를 만듭니다. 이 스킬은 영화를 만듭니다: 소수의 캐릭터, 어두운 방, 하나의 램프, 소리를 꺼도 따라갈 수 있는 이야기, Cycles (참조 룩) 또는 EEVEE (아래 "엔진" 규칙을 따르면 같은 룩을 훨씬 짧은 시간에 렌더링) 로 렌더링합니다.
SKILL = 이 폴더. B = /Applications/Blender.app/Contents/MacOS/Blender (5.1). BP = 블렌더의 파이썬 (/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3.13), beatgrid.py 에만 필요합니다. 다른 스크립트: python3 -I.
세션당 한 번 읽기: references/craft.md (이야기, 샷, 편집, 애니메이션, 사운드) 및 references/look.md (조명, 재질, 렌즈, 그레이딩, 렌더 시간). references/reference-films.md 는 증거입니다: 두 영화 모두 샷별로 측정되었습니다. 이 파일의 숫자에 대해 논쟁하기 전에 읽으세요.
6줄로 보는 룩
- 장난감 캐릭터, 사실적인 세계. 그려진 얼굴이 있는 블록; 그 주변의 모든 것은 사실적이고 낡고 작은 규모입니다.
- 어둡다. 중간 프레임 밝기 0.10-0.26 (전체 범위 대비). 보이는 램프 하나가 키 조명입니다. 필 조명 없음, 하늘 없음.
- 소품 높이. 카메라는 테이블 높이에 가깝게 위치하고, 얕은 심도와 전경에 부드러운 무언가가 있습니다.
- 삽입 샷이 이야기를 전달한다. 손, 물체, 읽을 수 있는 소품. 약 절반의 샷에 얼굴이 없습니다.
- 그리드에 맞춰 컷. 샷 길이는 음악의 전체 또는 절반 박자입니다. 속도는 이야기에 따라 변합니다.
- 침묵도 하나의 샷이다. 음악은 전환점에서 한 번 멈춥니다. 엔딩은 얼굴 또는 물체, 그리고 검은 화면입니다.
엔진: Cycles 또는 EEVEE
K.setup(..., engine="CYCLES" | "EEVEE"). M4에서 1080x1920 해상도로 측정:
| 엔진 | 프레임당 | 60초 릴 (1,440 프레임, 2개 프로세스) | 사용 시기 |
|---|---|---|---|
| Cycles, 160 샘플 | 70-90 초 | 28-36 시간 | 히어로 스틸, 커버, 짧은 티저 |
| Cycles, 16 샘플, 40 % 크기 | 11 초 | 2 시간 (부드러움: 미리보기, 전달용 아님) | 컷 확인 |
| EEVEE, 64 샘플, 전체 크기, 샷 자체 세트만 로드 | 6-8 초 | 1-1.5 시간 | 약 15초보다 긴 모든 것의 전달 |
EEVEE는 다음 규칙을 지키면 룩(헤이즈, 보케, 역광 플라스틱, AgX)을 유지합니다. 각 규칙은 Negara Angin에서 한 라운드를 치렀습니다:
- 씬을 구축한 후
K.eevee_lights(keep=(...))를 호출하세요. 큰 동기가 있는 조명만 그림자를 드리웁니다. 작은 그림자 조명이 많으면 그림자 풀이 넘쳐 프레임마다 깜빡입니다. - 창문 유리는 알파, 유리가 아닙니다. EEVEE에서 투과 유리는 화면 공간을 굴절시켜 뒤에 있는 것이 번지고, 블렌디드 투과는 검게 렌더링됩니다. Principled 알파 ~0.14,
surface_render_method = "BLENDED"사용, 반사 + 범프 드롭. - EEVEE는 유리판을 통해 초점을 맞출 수 없습니다. 피사계 심도는 가장 가까운 표면의 깊이를 읽으므로, 유리 뒤의 모든 것은 마치 유리 표면에 있는 것처럼 흐려집니다. 유리가 피사체일 때만 표시하고 (
K.visible), 초점이 유리 뒤로 넘어가면 숨깁니다. - 유리는 그림자를 드리우지 않습니다 (
eevee_lights가 처리): EEVEE는 유리를 불투명으로 취급하여 창문이나 병을 통과하는 빛이 차단됩니다. - 각 샷은 자신의 세트만 로드하여 렌더링하세요 (
--sets): 로드된 모든 세트는 매 프레임마다 평가됩니다(인스턴스 필드, 비). Negara Angin에서 이 방법은 시간을 절반으로 줄였습니다. 두 명의 작업자가 동일한 작업 목록을 처리할 수 있습니다.render_range는 잠금 파일로 프레임을 청구합니다. - 모션 블러와 볼륨 타일 크기는 비용이 거의 들지 않습니다. 64 샘플 이상은 그레인 패스가 숨길 수 있는 이점을 제공하지 않습니다.
- Cycles는 코스틱이 꺼져 있습니다: 창유리 뒤의 조명이 방에 도달하지 않습니다. "창문 조명"을 유리판 안에 배치하세요.
파이프라인
| 단계 | 작업 | 관문 |
|---|---|---|
| 0. 브리핑 | 로그라인, 루프 또는 체인, 스테이크 오브젝트, 위치별 팔레트, 트랙 및 BPM (beatgrid.py) | GATE B: 브리핑의 모든 줄은 관찰 가능한 것 |
| 1. 샷 계획 | 행으로 구성된 샷: 크기, 렌즈, 움직이는 것, 박자 단위 길이; 씬당 하나의 마스터 샷 | GATE S: craft.md 의 규칙이 종이 위에서 유효함 |
| 2. 세계 + 출연진 | cine_kit: 방/거리, 소품, 램프, 헤이즈; K.Char 인물 | 마스터 샷의 스틸, 각각을 한 문장으로 설명 |
| 3. 조명 | 보이는 램프의 키, 악센트, 엣지; 각 카메라의 still 을 미리보기 크기로 | GATE L: 모든 샷의 스틸 (look_gate.py) |
| 4. 퍼포먼스 | 박자에 맞춘 포즈 (hit, pose, face, talk), 카메라 움직임, life() | 콘택트 시트가 소리 없이도 이야기로 읽힘 |
| 5. 렌더링 | render_range 를 2-3개 프로세스로, 16비트 PNG, skip-existing | 프레임 수 = 필름 길이 |
| 6. 완성 | finish.py (글로우, 그레이딩, 부드러움, 비네트, 그레인) + 사운드 믹스 | GATE L on the film, GATE E (shotlist.py --bpm), -14 LUFS |
실패한 관문은 해당 단계에서 수정됩니다: 밝은 프레임은 그레이딩 문제가 아니라 조명 문제입니다.
GATE B - 브리핑 (빌드 스크립트 상단의 독스트링)
- 로그라인: 욕망과 대가가 있는 한 문장.
- 형태: 짧아지는 루프 (규칙이 한 번 보여지고, 더 빠르게 반복됨) 또는 체인 (각 씬이 다음 씬을 시작하는 오브젝트로 끝남).
- 스테이크 오브젝트: 얼굴이나 숫자가 있는 작은 물건 하나 (사진, 청구서, 티켓). 카메라가 그것을 향해 푸시 인하는 지점.
- 위치별 팔레트: 지배적인 조명색 하나, 그림자색 하나, 악센트 하나. 장소마다 다릅니다.
- 사운드: 트랙, BPM, 음악이 들어오는 지점, 음악이 멈추는 3-8초 구간.
- 엔딩: 마지막 이미지 (얼굴 또는 물체)와 그 뒤 검은 화면에 나타나는 한두 단어.
- 제외 사항: 이 영화가 절대 닮지 말아야 할 것.
GATE L - 룩 (참조 자료의 숫자; scripts/look_gate.py)
| 측정값 (전체 범위의 0-1) | 통과 | 참조값 |
|---|---|---|
| 중간 프레임 밝기 | 0.10-0.26 | 0.20, 0.17 |
| 그림자 수준 (10번째 백분위 픽셀) | 0.09 미만 | 0.06, 0.04 |
| 밝은 수준 (90번째 백분위 픽셀) | 0.22-0.56 | 0.46, 0.36 |
| 피크 (가장 밝은 픽셀) | 0.85 초과 | 0.91, 0.98 |
| 검은 바닥 | 0.05 미만 | 0.02, 0.02 |
| 채도 | 앰버 0.10-0.30, 느와르 0.03-0.14 | 0.18, 0.07 |
각 샷의 완성된 스틸에서 실행한 다음, 전체 영화에서 실행하세요. 단일 밝은 삽입 샷은 WARN이 될 수 있습니다. FAIL은 수정됩니다. "Peak under 0.85"는 프레임에 실제 하이라이트가 없음을 의미합니다: 렌즈가 볼 수 있는 곳에 램프, 반짝임 또는 네온 튜브를 배치하세요.
GATE E - 편집 (scripts/shotlist.py film.mp4 --bpm N)
모든 샷의 길이는 전체 또는 절반 박자 수입니다. 평균 샷 1-3.5 초. 처음 두 샷은 해당 씬에서 가장 깁니다. 연속된 두 샷이 같은 크기와 각도를 가질 수 없습니다. 3-8초 동안 음악이 없는 구간이 하나 있습니다. 영화는 검은 화면이 나타난 후 1초 이내에 끝납니다.
씬 빌드하기
"$B" -b --factory-startup -P build.py -- --out out --stills # 샷당 하나의 스틸, 절반 크기, 각 약 10초
python3 -I "$SKILL/scripts/finish.py" out/still_master.png --out out/fin_master.jpg --look amber
python3 -I "$SKILL/scripts/look_gate.py" out/fin_master.jpg --look amber
"$B" -b --factory-startup -P build.py -- --out out --frames --final & # 2-3번 시작: 존재하는 프레임은 건너뜀
python3 -I "$SKILL/scripts/finish.py" out/frames --out out/film.mp4 --look amber --audio mix.wav
import sys; sys.path.insert(0, SKILL + "/blender"); import cine_kit as K
K.setup(aspect="16:9", height=1080, preview=True) # 릴용 "9:16"; 전달용 preview=False
K.room(26, 22, 10); K.round_table("Table", 3.2, 2.9); K.pendant("Lamp", (0, 0, 6.5), power=2600, spot=125)
K.neon("Ring", (0, 10.8, 5.6), radius=1.7, color="#FFB020"); K.bokeh_lights("Shelf", ((-11, 10.2, 2.5), (11, 10.6, 8)))
K.light("TableBounce", "AREA", (0, 0, 3.05), 260, 2300, target=(0, 0, 9), size=4); K.haze((26, 22, 10), (0, 0, 5), 0.006)
hero = K.Char("Hero", skin="#F2C230", shirt="#20242C", hat="hair", at=(-4.5, 0, 0), yaw=90); hero.sit(1)
master = K.Cam("Master", (-2.2, -9.6, 3.1), (0.2, 0, 4.3), lens=28, stop=5.6)
cu = K.Cam("HeroCU", (-1.6, -6.2, 4.1), (-4.4, 0, 4.4), lens=50, stop=4, focus=hero.head)
S = K.cut_list([("master", master, 4), ("hero", cu, 2.5)], bpm=100); B = K.beats(100)
hero.hit(B(4.5), 3, head=(2, -60, -5)).face(B(4.5), "smirk"); cu.push(*S["hero"], 0.06).handheld(0.3); hero.life()
examples/standoff/build.py 는 완전하고 테스트된 버전입니다 (4개 샷, 7.2 초): 새 영화의 시작점으로 복사하세요.
cine_kit 한 눈에 보기
| 필요 | 호출 |
|---|---|
| 씬 | setup(aspect, height, samples, preview), world(), room(), haze(size, loc, density) |
| 표면 | plastic (장난감 피부, 역광 시 빛남), cloth(kind=weave/knit/leather), wood(planks=), brick, asphalt(wet=), flat (펠트, 플라스터, 금속), glass, emit (네온, 전구, 스크린) |
| 형태 | box (항상 베벨 처리됨), cyl, torus(arc=), text (3D 글자, 네온 단어), paper (읽을 수 있는 줄이 있는 포스터/청구서/카드), round_table, chair |
| 램프 | pendant (보이는 갓 + 전구 + 스팟), neon (튜브 + 일치하는 필), bokeh_lights, light(kind, loc, power, color=kelvin or hex, target, size) |
| 출연진 | Char(name, skin, shirt, pants, hat=hair/cap/fedora/beanie): .pose(frame, arm_l=(fwd, out, twist), head=(nod, turn, tilt), torso, leg_l, at, yaw), .hit(frame, dur, ...) (스냅 + 홀드), .face(frame, expr), .talk(f0, f1), .sit, .walk, .life() |
| 제공 캐릭터 | Rigged("bugis_man" / "bugis_woman" / path.blend, at, yaw): 파일의 캐릭터 모델, Char 높이, Char 와 동일한 포즈 채널 (arm_l, head, torso, leg_l, .hit, .sit, .walk, .life, .head). 페인트된 얼굴: 교체 없음, 감정은 머리, 팔, 컷에서 옵니다. 새로운 원피스 모델은 scripts/rig_block.py 로 한 번 리깅하고 (먼저 슬라이스에서 목, 엉덩이, 팔 경계 측정) K.CAST 에 추가합니다. 리그는 목을 제외하고 딱딱하며, 목은 neck_blend.py 가 부드럽게 만듭니다 ("Neck seam" 참조) |
| 사용자의 아바타 | Avatar(at, yaw, pose): Aksa의 리깅된 Roblox 캐릭터 (Roblox/blender/hero_face.blend), Char 높이. .pose(frame, "table" / "stand" / "relax" / "reach" / "chin" / "hips", head=(nod, tilt, turn), arm_L=...), .hit, .sit, .life(), .head (카메라 타겟), .face.expr(f, eyes, brows, mouth) / .face.lipsync(words, vo_frame, fps=24) / .face.blink, 그런 다음 .finish() 한 번. 사용자는 자신의 영화의 주인공입니다: 그가 달리 말하지 않는 한 주인공에 Avatar 를 사용하고, 다른 모든 사람에게는 Char 를 사용하세요 |
| 얼굴 표정 | K.EXPRESSIONS: neutral, smirk, grin, angry, shout, shock, sad, shut, talk_a, talk_o, talk_m, side. 모프 없이 교체만 |
| 페인트된 얼굴로 노래하기 | 한 번: Blender -b cast/x.blend -P scripts/prep_mouth.py -- cast/x_sing.blend (정면 직교 렌더에서 페인트된 입을 찾고, 자신의 피부 위에 자신의 색상으로 10-모양 입 아틀라스를 그리고, 얼굴 위에 머리 뼈에 스킨된 판을 놓습니다. 셀 0 = 그림, 따라서 정지 시에는 보이지 않음. 그런 다음 판 아래의 모든 것이 머리를 따라 움직이도록 목을 다시 혼합합니다). 씬에서: K.Rigged(".../x_sing.blend").sing(words, f0, f1) (words = 트랙의 대본에서 가져온 [{"word","start","end"}], faster-whisper 단어 시간 사용). 그녀가 노래하는 동안 머리를 렌즈 쪽으로 돌리세요: 프로필은 입을 가립니다 |
| 카메라 | Cam(name, loc, target, lens, stop, focus, roll): .at(frame, loc, target, focus, roll), .push(f0, f1, 0.06), .handheld(amount); Cam.distance_for(lens, height) = 특정 높이의 피사체로 프레임을 채우기 위해 서 있어야 하는 거리 (카메라를 추측이 아닌 크기로 배치); .clip_follow(f0, f1, subject) = 키프레임된 근접 클립, 머리 위로 다이빙하여 그들의 손에 있는 휴대폰 속으로 들어가기 위해 |
| 가시성 | K.visible(ob, [(f0, f1), ...]): 해당 범위에서만 렌더링 가시성; 숨기기 커브만 터치 (오브젝트의 모든 커브를 CONSTANT로 설정하지 마세요: 모션이 계단식이 됩니다) |
| 편집 | beats(bpm) -> n번째 박자의 프레임; cut_list([(name, cam, beats), ...], bpm) 는 카메라를 마커에 바인딩하고 각 샷의 프레임을 반환 |
| 출력 | still(path, frame), render_range(dir, f0, f1) |
stop 은 피사체가 40cm 수집품인 것처럼 가정한 f-값입니다: 2-2.8 삽입 샷, 4 얼굴, 5.6-8 마스터 샷. 숫자가 작을수록 더 흐려집니다.
사용자의 다른 스킬과의 조화
- 스크립트: 인도네시아어 음성 해설에는
scriptmaxxing을 사용하세요. 몇 줄로 유지하세요; 1370만 뷰를 가진 참조 영화에는 음성 해설이 없습니다. - 음악 및 효과:
~/Ngonten/Maxxing/audio-lib(CC0). 샷을 계획하기 전에 트랙에서beatgrid.py를 실행하세요. - 사용자 자신의 아바타:
K.Avatar()는 얼굴 리그(깜빡임, 눈썹, 단어 단위의 정확한 인도네시아어 립싱크는Roblox/blender/face/face_rig.py에서 제공)와 함께 로드합니다.K.Char.talk()는 다른 화자에게만 제한된 애니메이션입니다. 시도:build.py -- --avatar --stills. - 소품 및 세트:
robloxmaxing/blender/rbx_kit.py는 동일한 스터드 스케일로 빌드합니다. 사실적인 소품이 핵심입니다. CC0 PBR 텍스처와 실제 세계 소품은 Poly Haven (Blender 용 MCPsearch_assets, 또는 3d-assets MCP); 하나의 히어로 소품은 Meshy. - 세로형 릴:
--aspect 9:16. 여기의 모든 규칙이 적용됩니다. 마스터 샷은 24-28 mm로 가고 깊이는 렌즈 축을 따라 쌓입니다.
클로즈업 작업을 위한 어렵게 얻은 규칙 (Negara Angin, 2026-11-21)
- 측정한 다음, 프레임을 구성하세요. 샷의 프레임에서 머리, 손, 소품의 평가된 위치를 출력한 다음,
Cam.distance_for로 카메라를 배치하세요. 눈대중으로 배치한 매크로 카메라는 2 스터드가 필요한 물체에서 0.5 스터드 떨어진 곳에 위치했습니다. - Roblox 손은 큰 블록입니다. 손 "안에" 쥔 휴대폰은 묻힙니다. 소품을 화면 법선을 따라 손 앞에 잡으세요.
- 본-부모를 소품에 설정하고 월드 매트릭스를 설정하지 마세요 (원점에 배치됩니다). 포즈가 유지되는 동안 소품을 월드-고정으로 유지하거나 연산자로 부모를 설정하세요.
- 스틸은 컷 마커를 무시합니다. 마커에 바인딩된 카메라는 해당 프레임에서
scene.camera를 재정의합니다: 스틸을 위해 지우세요. - 후크는 하나의 이미지와 하나의 이벤트입니다. 프레임 1은 이미 아름다워야 하며 (Negara Angin: 극단적인 매크로에서 창문을 타고 미끄러지는 빗방울, 그 안에서 굴절되는 방의 불빛), 첫 번째 박자가 그것을 바꿔야 합니다 (킥이 방울을 통해 초점을 이동).
- 전환은 디자인되며, 추가되지 않습니다: 화면을 통해 그것이 보여주는 세계로 푸시-스루 (다음 샷의 첫 번째 프레임을 화면 이미지로 렌더링), 한 샷에서 휙 빠져나와 다음 샷으로 들어가기.
보충 자료
beats.bvh 모션 캡처 (선택 사항)
Negara Angin에서 작곡된 보컬이 있는 짧은 루프의 경우, cine_kit/beats.bvh 는 100 BPM, 4/4 박자로, 각 비트에서 명확한 악센트가 있는 워킹/바운싱 루프입니다. 리타겟팅: blender --python scripts/retarget_bvh.py -- --bvh cine_kit/beats.bvh --target cast/your_char.blend --out cast/your_char_animated.blend. 그런 다음 K.Rigged("cast/your_char_animated.blend", at, yaw).hit(...) 및 .life()를 사용할 수 있습니다. 이 스킬에 필수는 아닙니다.
네크 심 (Neck Seam)
K.Char 는 목 베이스와 머리 사이의 기하학적 간격을 방지하기 위해 부드러운 본 블렌드를 사용합니다. 사용자 정의 리깅 캐릭터를 K.CAST 에 추가할 때 scripts/neck_blend.py 를 실행하세요. 이는 목 부위의 정점 그룹을 분석하고 각도 오프셋을 평활화합니다. 자세한 내용은 스크립트 설명서를 참조하세요.