하나의 애니메이션 인서트 조립하기
당신은 하나의 완성된 애니메이션(4~10초)을 조립합니다. 이는 동영상에 인서트로 삽입되거나 프레임 위에 오버레이로 배치됩니다. 화면은 저자가 음성으로 설명하는 생각을 시각적으로 보여줘야 합니다. 일반적인 설명이 아니라, 그 특정 생각을 구체적으로 보여줘야 합니다.
기본 스타일 — v4 "사진 프레젠테이션"
사용자가 다른 것을 요청하지 않았다면 v4 스타일로 조립하세요. 저자는 이 스타일을 "완전히 이상적"이라고 부르며, 이후의 모든 동영상이 정확히 이와 같기를 요청했습니다. 모든 세부 사항은 references/style-v4.md에 있습니다: 레퍼런스(설명은 references/style-v4.md에), kinetic / full / split-cam / split-screen / lower 레이아웃(정확한 기하학), 상수, 사운드, 승인 기준.
- 공통 스타일과 헬퍼:
assets/style-v4/common.css,common.js(heroIn,rise,chipIn,countUp). - 레퍼런스 씬 (조각 +
.sfx.json):references/recipes/v4/— 레이아웃이 가장 가까운 것부터 시작하세요. - 빌드: 조각
W/scenes/NN.html작성 →python3 scripts/mk_scene.py W NN→check→ 렌더링. 이미지:scripts/gen_images.sh+scripts/alpha.py; 웹캠/화면 클립:scripts/cut_clips.py. - 스탬프 및 "나쁜 결과" 사운드 —
assets/style-v4/sfx/, 나머지는 media-use 번들.
오래된 레이어(아래): Austin Marchese의 편집에서 차용하여 채널 디자인 시스템에 적용한 기법 — PiP 모프, 줌 스루, 챕터 캐러셀 등. v4에서는 이를 씬 내 강조점으로 사용하며, 기본 기법으로 사용하지 않습니다. 기법은 타임라인, 커브, 레이어 순서를 정확히 복사합니다. 팔레트와 타이포그래피는 자체 시스템만 사용합니다.
읽을 순서
references/style-v4.md— 어떻게 보여야 하는지.references/gotchas.md— 코드를 작성하기 전에. 엔진 제한, 라이트 테마 함정, 솔기 규칙이 있습니다. 각 항목은 한 번쯤 반복 비용이 들었습니다.references/style-rules.md— 스타일 규칙: 텍스트가 나타나고 사라지는 방식, 리듬을 만드는 요소, 항상 움직이는 것. 어떤 기법을 조립하든 이를 준수해야 합니다. 이것이 편집을 알아볼 수 있게 만듭니다.references/design-system.md— 팔레트, 스케일, 컴포넌트, 브랜드 규칙. 위반할 수 없습니다.- 기법 메커니즘 — 자신의 섹션만 읽으세요:
references/techniques.md— 검증된 구현이 있는 기법;references/techniques-observed.md— 분석을 통해 포착되었지만 아직 조립되지 않은 기법; 설명을 기반으로 구축하세요.
references/recipes/<기법>.html—techniques.md의 실제 구현. 전체를 복사하는 템플릿이 아니라, 복잡한 부분이 어떻게 해결되었는지 보여주는 예시입니다. 메커니즘이 명확하지 않을 때 참고하세요.
특정 씬에 대한 사양은 /motion-plan 또는 사용자로부터 직접 제공됩니다.
작업 순서
1. 프로젝트 준비
프로젝트가 아직 없다면:
./node_modules/.bin/hyperframes init <이름> --example blank --non-interactive --resolution landscape --skill motion-graphics
리포지토리 루트에서 빈 npx hyperframes는 "Missing script" 오류와 함께 실패합니다 — CLI는 전역이 아닙니다. 이미 생성된 프로젝트 내에서는 npm run check 및 npm run render가 작동합니다. 외부에서는 위의 바이너리 경로를 사용하세요.
이 스킬의 assets/ 폴더를 파일별로 복사하지 말고 전체를 프로젝트에 복사하세요: tokens.css는 @import "./fonts/fonts.css"를 통해 폰트를 가져오므로 디렉토리 구조가 일치해야 합니다.
cp -R <스킬-경로>/assets/. <프로젝트>/assets/
Onest 및 Unbounded 폰트는 로컬에 있습니다(키릴 문자 및 라틴 문자). 따라서 텍스트는 모든 머신에서 동일하게 렌더링됩니다. GSAP, 시작 템플릿 및 모든 레시피는 CDN에서 로드합니다. 렌더링에는 네트워크가 필요합니다. 네트워크가 없으면 gsap.min.js를 옆에 두고 <script src>를 수정하세요.
컴포지션에 토큰을 연결하는 방법은 한 줄입니다:
<link rel="stylesheet" href="./assets/tokens.css" />
2. 컴포지션 조립
HyperFrames 계약: window.__timelines["main"]의 단일 paused 타임라인, 각 timed 요소는 class="clip", data-start 및 data-duration을 가집니다. 세부 사항은 /hyperframes-core에 있습니다. 구조가 확실하지 않으면 로드하세요.
기법의 성패를 결정하는 세 가지 사항:
타임라인과 커브를 문자 그대로 복사하세요. PiP 성장에서 power2.inOut과 power2.out의 차이는 카메라 이동과 이미지 확대의 차이입니다. 푸시 솔기에서 power3.inOut과 power4.inOut의 차이는 부드러운 이동과 급격한 움직임의 차이입니다.
기법을 유지하세요, 사양의 문자 그대로가 아니라. 사양의 프레임별 설명이 명시된 easing과 일치하지 않으면(성장 백분율이 커브와 일치하지 않으면), easing이 우선합니다. easing이 움직임이 어떻게 읽히는지 결정합니다. 사양이 클립이 잘리는 시점에 객체가 프레임을 벗어나지 않는 진폭을 제공한다면, 실제 1920×1080 지오메트리에 맞게 진폭을 다시 계산하고 이를 보고하세요.
읽히지 않는 기법은 강화해야 합니다. 형식적으로 올바르게 구현되었지만 보이지 않는 것은 완료된 작업이 아닙니다. 라이트 배경의 그라데이션 전환은 전면 마커를 추가하기 전까지 거의 보이지 않습니다. 중간에 양쪽이 비어 있는 솔기는 보여줄 것이 없습니다.
기법이 techniques.md나 techniques-observed.md에 없으면 사양의 프레임별 설명을 기반으로 구축하세요. 하지만 먼저 분기점을 찾으세요: 프레임의 성패를 결정하는 솔루션. 일반적으로 이것은 커브가 아니라 지오메트리입니다 — 얼마나 이동할지, 그룹의 중심이 어디인지, 가장자리를 벗어나는 것이 무엇인지. 사양은 프레임을 본 적이 없는 사람이 작성합니다. 그는 분기점을 알아차리지 못했을 가능성이 큽니다. 스스로 결정하고 프레임으로 확인한 후 반드시 보고서에 이름을 지정하세요. 이는 다음 스킬에 전달됩니다.
3. 확인
npm run check
오류와 경고가 0개여야 합니다. 대비 및 레이아웃 감사는 기법 자체에 대해 불평할 수 있습니다 — 흐릿한 배경 플레이트, 솔기의 씬 겹침, 흐릿한 이웃. 기법과 실제 문제를 구별하세요: 실제 결함은 수정하고, 기법은 표준 옵트아웃으로 표시하세요. 각 옵트아웃은 정확히 해당 검사를 비활성화합니다. gotchas.md의 표를 참조하세요. 무작위로 적용할 수 없습니다: data-layout-ignore는 대비도 비활성화하고, 그 아래 텍스트는 보고서에서 조용히 사라집니다.
그와 함께 사이드카 *.motion.json을 배치하세요. check가 이를 자동으로 선택하고, 렌더러가 사용하는 동일한 되감은 타임라인에서 움직임 의도를 확인합니다. 이는 "렌더링하고 확인"의 가장 가까운 자동 아날로그입니다. 되감기가 놓친 항목, 깨진 stagger 순서 및 정지된 샷을 포착합니다. 형식은 gotchas.md에 있습니다.
4. 눈으로 확인하세요 — 이것은 필수 단계입니다
../node_modules/.bin/hyperframes snapshot . --frames 8 -o snapshots
Read를 통해 snapshots/contact-sheet.jpg를 엽니다. 이것은 이미지이며, 당신이 보고 있습니다. check는 프레임이 비어 있거나, 텍스트가 너무 작거나, 블록이 엉망으로 배치되었다고 말하지 않습니다.
프레임 0을 별도로 확인하세요 — 이것은 가장 흔한 실패 지점입니다. 스타일 규칙에 따라 씬은 정적 상태나 빈 상태가 아니라 이미 움직이는 상태에서 시작합니다. 프레임 0이 비어 있거나 모든 것이 이미 조립된 상태라면, 기법은 가장 눈에 띄는 곳에서 망가진 것입니다.
가장 복잡한 지점에서 특정 프레임을 별도로 촬영하세요:
../node_modules/.bin/hyperframes snapshot . --at 1.45,1.55,1.675,1.8 --no-end -o snapshots-detail
선택할 지점: 기법에 솔기가 있으면 솔기 중간과 양쪽 각각의 프레임을 촬영하세요. 솔기가 없으면 컴포지션 재계산 지점을 촬영하세요: 목록 압축, 블록 재배열, 활성 요소 변경. 레이아웃이 깨지는 곳이 바로 여기이며, 8개의 균일한 프레임에서는 보이지 않습니다.
논란의 여지가 있는 부분(그라데이션, 작은 글꼴 크기)은 전체 크기 PNG로 확인하세요. JPEG 콘택트 시트는 크기와 밴딩 모두에서 왜곡됩니다.
이미지가 좋아질 때까지 반복하세요. 첫 번째 버전은 거의 항상 너무 작게 나옵니다. 이것이 가장 흔한 실수입니다. 1920×1080 프레임은 생각보다 큽니다.
5. 렌더링
npm run render
MP4 배치 위치
프로젝트의 renders/에만 배치하고 다른 곳에는 절대 배치하지 마세요. 보고서에 파일 경로를 명시하세요. 완성된 인서트를 공통 폴더에 배포하는 사람은 전체 동영상을 조립하는 사람입니다. 그는 인서트가 타임라인에서 무엇으로 불리는지와 어떤 것이 승인되었는지만 알고 있습니다.
이것은 형식적인 문제가 아닙니다. 한 동영상에서 9명의 조립자가 결과를 세 곳에 분산 배치했고, 두 명은 renders/를 완전히 삭제했으며, 한 명은 "오케스트레이터가 어쨌든 찾을 수 있도록" 파일을 두 폴더에 복제했고, 오케스트레이터는 디스크 전체에서 find로 렌더링을 검색해야 했습니다. CLAUDE.md의 "최종 비디오는 output/에" 규칙은 완성된 동영상에 대한 것이며, 조립 중인 인서트에 대한 것이 아닙니다. 인서트는 반제품입니다.
작업 프로젝트 폴더도 삭제하지 마세요. 씬이 승인되면 오케스트레이터가 삭제합니다. 그 전까지는 수정을 위해 필요할 수 있습니다.
프레임 위 오버레이: 컴포지션에 플레이트 포함
오버레이 — 유리 패널, 자막, 용어집 — 는 아래의 특정 프레임을 위해 설계되었으며, 기술적으로 중요한 결과가 있습니다: backdrop-filter는 컴포지션에 없는 것을 볼 수 없습니다. 투명 배경에 오버레이를 렌더링하고 편집 프로그램에서 오버레이하면 유리가 빈 공간을 흐리게 하므로, 즉 아무것도 흐려지지 않아 패널이 평평한 필름처럼 보입니다.
따라서 오버레이 컴포지션은 인서트와 다르게 구축됩니다:
# 씬 타임코드와 정확히 일치하는 소스 조각을 프로젝트의 assets에
ffmpeg -ss 20.0 -i <소스> -t 4.0 -vf "scale=1920:1080,fps=30" -an \
-c:v libx264 -crf 16 -preset veryfast -pix_fmt yuv420p -y assets/plate.mp4
<video id="plate" class="clip" data-start="0" data-duration="4" data-track-index="0"
src="./assets/plate.mp4" muted data-layout-ignore></video>
플레이트는 0번 트랙에 있으며 data-layout-ignore로 표시됩니다 — 감사되지 않습니다. 그 위의 유리는 실제로 작동합니다. 출력은 일반 MP4이며, 편집 시 해당 부분 대신 배치됩니다(위에 배치되지 않음). 플레이트의 사운드는 제거되었습니다. 오디오 트랙은 소스에서 가져옵니다.
대안인 --format mov(투명도 포함)는 편집자가 명시적으로 알파를 요청하고 레이어를 직접 배치할 의향이 있는 경우에만 필요합니다.
보고할 사항
간략하게, 10~15줄: 무엇이 완료되었는지, MP4 경로, 어려웠던 부분과 해결 방법, 불완전한 부분. 코드를 다시 설명하지 마세요. 파일에 있습니다.
사양과의 차이점을 별도로 명시하세요. 진폭을 다시 계산했거나, 커브를 변경했거나, 사양에 없는 요소를 추가했다면, 그 이유를 말하고 설명하세요. 사양은 프레임을 본 적이 없는 사람이 작성합니다. 당신은 보았습니다. 말한 차이점은 발견 사항입니다. 침묵한 차이점은 편집 시 놀라움입니다.
완료 기준
check가 깨끗하고, MP4가 렌더링되었습니다.- 기법이 프레임에서 눈으로 읽힙니다. "형식적으로 구현"된 것만이 아닙니다.
- 팔레트, 스케일 및 디자인 시스템 규칙이 준수되었습니다.
- 결정론: 씬에 의사 난수가 있는 경우, 동일한 타임코드의 두 스냅샷이 동일한 SHA-256을 생성합니다.