geeklee/srt-whiteboard-animation

SRT 자막을 서사 순서대로 그린 화이트보드 손그림 비디오 기법으로 변환하세요. 이 방법은 파티션 마스크 배치와 스트림 필기 렌더링을 결합합니다: 각 요소는 자막 뒤를 따라 순차적으로 나타나고, 펜 끝은 해당 영역에 계속 잉크를 그려 점차 색을 더한 뒤 MP4로 내보냅니다.

지식 설명, 이야기 내레이션, 강의 자막 또는 짧은 영상 복사본을 따뜻한 베이지색 종이에 손으로 그린 애니메이션으로 변환하는 데 적합합니다.

효과의 예시

장면: 원숭이 산 바나나 빼앗기 — 자막의 서술 순서에 따라, 바위와 작은 원숭이, 큰 원숭이가 바나나를 낚아채는 장면, 그리고 지켜보는 아이들이 순식으로 그려진다.

원본 선화: PNG 보기.

핵심 역량

• 권장 25–35초 길이에 따라 SRT 자막과 분할 신 구문 분석
• 스토리보드와 이미지 배치 전략을 먼저 개발하여 각 장면이 단 하나의 핵심 의미만을 표현하도록 한다
• 화면 좌표가 아닌 자막 이벤트를 기반으로 요소의 의미 도면 순서를 설정한다
• annotation.json를 사용하여 지역, 연대기, 자막 연관성 및 겹치는 보호 구역을 관리하기
• 각 영역은 연속 흐름 필기체를 사용합니다: 먼저 ink 선화, 그다음 color에 색상을 덧붙입니다
• 브라우저 미리보기 콘솔에서 지역, 순서, 시간, 자막 연관성 조정 지원
• 장면별 렌더링 및 다중 막 병합 지원, 완전한 MP4 파일 출력

작업 방법

이 기술의 핵심은 '자막 중심의 단계별 확인’에 있습니다. 각 단계가 완료된 후에는 스토리보드, 라인아트, 주석이 아직 확정되지 않은 상태에서 렌더링 비용을 낭비하지 않도록 확인을 기다립니다:

1. SRT, 출력 스토리보드, 이미지 매칭 전략을 분석합니다.
2. 확인 후 통일된 스타일의 선화를 생성합니다.
3. 선화를 확인한 후, 자막과 원본 이미지를 결합해 주석을 작성하고 미리보기 콘솔에 불러옵니다.
4. 주석을 확인한 후, 분할 및 방향 검사 다이어그램을 생성합니다.
5. 미리보기 패널에서 영역, 서술 순서, 타이밍, 자막 연관성을 조정하고 저장합니다.
6. 최종 주석을 확인한 후, MP4 이미지를 장면별로 렌더링합니다.
7. 각 막이 완료된 것을 확인한 후 다중 막 프로젝트가 통합됩니다.

시각적 규범

• 따뜻한 베이지색 종이 배경: 권장 #F5EBD7
• 빨강, 주황, 파랑으로 몇 가지 개념적 포인트만 있는 짙은 회색 스케치 선들
• 미니멀리스트 손그림 그리기, 깔끔한 배경, 넉넉한 빈 공간
• 씬 텍스트, 태그, 시네마틱 효과, 3D 효과, 복잡한 텍스처 사용 금지

설치 및 환경

Skill은 독립형 Python 가상 환경 준비 스크립트와 함께 제공됩니다. 첫 실행 시 실행:

성공 후 첫 명령어는 ENV_PY= 를 출력합니다; 이후 렌더링을 위해 이 인터프리터를 사용하여 의존성 격리를 보장합니다.

프로젝트 자료 구조

이미지와 제목이 동일해야 하며, 예를 들어 scene-01-demo.png는 scene-01-demo.annotation.json에 해당합니다.

차원 형식

각 요소는 원본 이미지의 정수 픽셀 좌표를 사용하며, sequence, subtitle, narrativeRole를 통해 캡션에서 이벤트를 연관시킵니다. 영역은 “주요 인물/객체 → 장면 설정” 또는 반응/결과 변경→ “장면 설정”→ 정렬해야 합니다.

direction와 handPath는 미리보기 테이블의 직사각형 대리로 사용됩니다; 최종 실제 필기는 플로우 파셀에 의해 자동으로 생성됩니다. 서로 가려진 객체의 경우, 나중에 표시해야 할 영역은 앞서 요소의 protectedRegions에 표시하여 후속 콘텐츠가 조기 노출되는 것을 방지합니다.

공통 명령