Communitygithub.com

레트로 16비트 픽셀 비디오

React + HTML5 Canvas 기반으로 브로드캐스트급 16비트 레트로 픽셀 아트 모션그래픽 설명 영상과 다큐멘터리 영화를 제작하기 위한 종합 프로덕션 시스템입니다. 음성 해설, SRT 자막 동기화, 자연스러운 픽셀 전환, 16비트 BGM 및 절차적 SFX, 스튜디오 NLE 재생 UI, 클라이언트 측 1920×1080 MP4 내보내기를 지원합니다.

레트로 16비트 픽셀 비디오란 무엇인가요?

이 스킬은 SNES/Chrono Trigger/Sea of Stars/Celeste 스타일의 정교한 16비트 픽셀 아트 비디오를 제작하기 위한 완전한 엔드투엔드 파이프라인을 제공합니다. React와 HTML5 Canvas를 기반으로 하며, 384×216 가상 픽셀 그리드에서 제작된 모든 요소를 5배 정수 스케일링을 통해 1920×1080 HD로 깔끔하게 업스케일합니다. 28색 통합 팔레트, 9가지 전환 라이브러리, 이중 레이어 HD 타이포그래피 시스템, 3트랙 오디오(음성 해설 + 5막 BGM + 동기화된 16비트 SFX)를 갖추고 있어 브로드캐스트 품질의 다큐멘터리 및 설명 영상 제작에 적합합니다. mp4-muxer와 WebCodecs를 활용한 클라이언트 측 MP4 내보내기 파이프라인을 지원하며, 스튜디오 NLE 미리보기 UI, 단위 테스트, 브라우저 시각 검증 도구를 포함합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lithium023/retro-16bit-pixel-video-SKILL/tree/main

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

16비트 레트로 픽셀 비디오 제작 스킬

참조 청사진

  • 정식 참조 저장소: https://github.com/Lithium023/16bit-video-forNeon
  • 참조 벤치마크: 5분 14.5초(314.5초) 분량의 장편 다큐멘터리(AI 发展史), 5막에 걸친 55개의 수제 16비트 픽셀 장면, 155개의 동기화된 SRT 큐, 9개의 자연스러운 전환, 3트랙 오디오(음성 해설 + 자동 덕킹이 적용된 5막 16비트 BGM + 94개의 동기화된 16비트 SFX), 실시간보다 빠른 클라이언트 측 1920×1080 H.264/AAC MP4 내보내기.
  • 새 프로젝트 시작 시: 이 스킬과 references/ 파일에 문서화된 모듈 아키텍처 및 시각/오디오/내보내기 표준을 그대로 미러링합니다. 사용자가 새 스크립트, 음성 해설 오디오 또는 SRT 파일을 제공하는 경우, 전체 엔진, 미학 구성, 스튜디오 UI 및 MP4 내보내기 파이프라인은 동일하게 유지하면서 주제별 새 챕터, 픽셀 장면, 스프라이트 및 사운드 큐만 새로 작성합니다.

1. 미학 구성 (변경 불가)

SNES / Chrono Trigger / Sea of Stars / Celeste가 고품질 다큐멘터리 모션 그래픽과 만난 느낌—따뜻하고, 풍부하며, 분위기 있고, 맑고 선명합니다. 결코 삭막한 와이어프레임 미니멀리즘이나, 지저분한 저해상도 블러, 요란한 네온 쓰레기가 아닙니다.

  1. 순수 16비트 가상 픽셀 그리드(384×216 가로 / 216×384 세로):

    • 모든 픽셀 월드, 배경, 디더링된 하늘, 스프라이트, 소품, 아이콘을 오프스크린 가상 캔버스에 384×216 (16:9) 또는 216×384 (9:16) 크기로 그립니다.
    • 왜 384×216인가? 1920×1080에 대한 정확한 5배 정수 스케일이기 때문입니다(384 × 5 = 1920, 216 × 5 = 1080). ctx.imageSmoothingEnabled = false로 설정하여 HD 출력 캔버스에 블릿하면 모든 픽셀이 깜빡임이나 서브픽셀 블러 없이 선명하게 유지됩니다.
    • 유휴/주변 픽셀 애니메이션은 선명한 레트로 케이던스(stepT = Math.floor(time * 8..10) / 10)로 고정하고, 카메라 팬, 이징 곡선, 전환은 부드러운 60fps(내보내기 시 30fps)로 실행합니다.
  2. 통일된 28색 따뜻한 시네마틱 16비트 팔레트:

    • 모든 장면을 6가지 감정 계열(깊은 밤의 공허/네이비, 따뜻한 램프 골드/크림, 아늑한 코랄/플럼, 시원한 틸/파인, 북극 겨울 얼음, 게임보이 올리브 모노크롬)에 걸친 규율 있는 공유 팔레트(PAL)로 구성합니다. 올리브 모노크롬은 극적인 반전 하드 컷(예: "但其实")을 위해서만 엄격히 사용합니다.
    • 평평하고 질감 없는 그라데이션을 절대 사용하지 마십시오. 하늘의 이음새, 램프 후광, 새벽 폭발, 픽셀 디졸브에는 4×4 Ordered Bayer 디더링(drawDitheredSky, drawDitheredGlow)을 사용합니다.
    • 정확한 16진수 토큰, Bayer 행렬 수학, 스프라이트 그리기 프리미티브는 references/visual-and-typography-spec.md를 참조하십시오.
  3. 황금 타이포그래피 법칙 (뭉개진 CJK 텍스트 금지):

    • 절대 384×216 저해상도 캔버스에 작은 중국어 텍스트를 그린 다음 업스케일하지 마십시오. 밀집된 한자(最/魔/幻/澜/疆)는 읽을 수 없는 덩어리("糊成一坨")로 번질 것입니다.
    • 장면 내 동적 타이틀 및 배지(이중 레이어 HD 오버레이): 타이틀을 HD 캔버스(1920×1080)에 직접 렌더링합니다. 38px(큰 헤드라인), 32px(서브 헤드라인) 또는 24px(HUD 태그)로 래스터화된 바이너리 스냅 픽셀 글리프 스프라이트를 사용하며, 8방향 1픽셀 다크 잉크 외곽선, 단계별 그림자, 3밴드 메탈릭 베벨 채우기(상단 하이라이트 / 미드톤 / 하단 쉐이드)를 적용하고 최근린 이웃(imageSmoothingEnabled = false)으로 업스케일합니다.
    • 하단 서드 브로드캐스트 자막: 자막은 깔끔하고 가독성이 높은 원본 산세리프 타이포그래피(Noto Sans SC / y = 0.905 * h 위치의 미묘한 어두운 반투명 필과 가는 호박색 테두리 안의 시스템 산세리프 볼드)로 유지합니다. 특별히 요청하지 않는 한 주요 자막 스트립을 픽셀화하지 마십시오.
    • 디더링된 글로우가 중요한 레이블을 가리지 않도록 하십시오: 핵심 연도, 지표 또는 정상 배지(2026, 1950 — FUTURE)는 배경 글로우 후에 그려지는 골드/틸 픽셀 테두리가 있는 선명하고 대비가 높은 어두운 명판 안에 있어야 합니다.
  4. 하드 팝 인트로 및 우발적 하드 컷 금지:

    • 모든 장면 경계는 9가지 전환 라이브러리(aperture-open, whip-blinds, iris-flash, razor-wipe, invert-strobe, camera-pullback, ember-curtain, gravity-shatter, horizon-burst) 중 하나를 의도적으로 사용해야 하며, 부드러운 fromCam → toCam 카메라 보간 및 타이포그래피 크로스페이드가 있어야 합니다. 극적인 반전조차도 의도적인 CRT 래스터 와이프(invert-strobe)를 사용하며, 갑작스럽고 동기 없는 점프를 절대 사용하지 않습니다.
    • 장면 내부의 모든 다중 요소 그래픽(4개 모달리티 카드, 4개 기능 모듈, 4개 박스, 모놀리스 단계, 피날레 연도 배너)은 목적 있는 안무로 애니메이션되어야 합니다—엇갈린 스프링 팝인, 허브에서 노드로 연결되는 휩쓰는 에너지 빔, 펼쳐지는 RPG 명판, 또는 음성 단어에 동기화된 롤링 주행 거리계/카운터 틱. 절대 if (localTime > X) drawBox()처럼 처리하지 마십시오.
    • 모든 피날레/엔딩은 독창적인 클라이징 시퀀스(예: 일출 지평선 개화 + 앞을 바라보는 캐릭터 + 펼쳐지는 명판 + 롤링 연도 주행 거리계 1950 → 2026 → FUTURE + 빛나는 별궤적 소용돌이 + 따뜻한 하모닉 코드)가 있어야 합니다.

2. 표준 제작 워크플로우

새로운 16비트 픽셀 비디오를 처음부터 만들 때(또는 기존 비디오를 확장할 때) 다음 순서를 따르십시오.

1단계: 스크립트, 음성 해설 및 SRT 타이밍 수집

  • 사용자의 실제 음성 해설 오디오와 .srt 자막 파일을 파싱합니다(또는 음성 해설에 정렬된 정확한 타임스탬프 SRT를 생성합니다).
  • 인접한 큐 사이의 미세한 간격(< 0.18s)을 정규화하여 자막이 2프레임 동안 깜빡이는 것을 방지합니다.
  • 정확한 오디오/SRT 종료 시간으로 CLIP_DURATION을 설정합니다.

2단계: 스토리보드 및 비트 시트(페이싱 청사진)

  • 영화를 3~6개의 내러티브 막(각각 고유한 색 온도와 BGM 챕터가 있음)과 3~8초 길이의 장면(시각적 비트당 대략 1~3개의 자막 큐)으로 나눕니다.
  • 긴 비디오(>60초)의 경우 30초 챕터(retroPixelChapterTwo.ts, retroPixelChapterThree.ts 등) 단위로 반복적으로 구축하여 모든 샷이 재활용된 템플릿이 아닌 진정한 수제 픽셀 아트를 얻도록 합니다.
  • timeline.ts의 각 장면에 다음을 할당합니다:
    • index, id, title, quote, start, end(엄격히 연속적이며, [0, CLIP_DURATION]을 포함하는 간격이나 중복이 없어야 함)
    • transitionIn + transitionLabel
    • visualBeat(스토리보드 패널에 대한 간결한 편집 설명)
    • 타임라인 스트립의 accent 16진수 색상.

3단계: 코어 픽셀 엔진 및 모듈식 챕터 렌더러 구축

https://github.com/Lithium023/16bit-video-forNeon의 깔끔한 관심사 분리를 미러링합니다:

  • src/video/types.ts — SrtCue, SceneCut, TransitionType, RenderSettings, ExportResolution, ExportStatus.
  • src/video/srtParser.ts — 결정론적 SRT 파서, AUDIO_SRC, BGM_SRC, CLIP_DURATION, getActiveCue.
  • src/video/timeline.ts — 연속적인 SCENE_CUTS, 이징 곡선(easeOutExpo, easeOutBack, easeOutCubic, easeInOutQuint, smoothstep), getStaggerProgress, getSceneAtTime, getActiveTransition, 합성 폴백 음성 에너지.
  • src/video/pixelSprites.ts — PAL, BAYER_4X4, pxRect, pxOutline, pxCircle, pxRing, pxLine, drawDitheredSky, drawDitheredGlow, drawSprite, pxBitmapText, 재사용 가능한 픽셀 아트 스프라이트 및 환경 헬퍼(pxPineTree, pxCloud, pxSparkle, pxStarfield).
  • src/video/pixelTypography.ts — 캐시된 바이너리 스냅 픽셀 글리프 래스터라이저(drawPixelString, drawPixelKineticTitle, drawPixelHudTag).
  • src/video/retroPixelRenderer.ts — 마스터 가상 버퍼 풀(bufA, bufB, bufDither), 카메라 드리프트 계산기, 9가지 전환 컴포지터, CRT 스캔라인, 타이포그래피 핸드오프, 모듈식 retroPixelChapter*.ts 파일로의 디스패처.
  • src/video/sceneRenderers.ts — 최상위 renderVideoFrame: 픽셀 장면 → 미묘한 비네트(0.14) → 깔끔한 원본 하단 서드 자막 → 가는 호박색 진행 막대 → 0.25초 테일 페이드.

4단계: 전체 영화 채점(3트랙 오디오 시스템)

자세한 내용은 references/choreography-and-audio-spec.md를 읽으십시오:

  1. 트랙 1 — 음성 해설: 마스터 내러티브 앵커(volume = 1.0, 0.25초 테일 페이드).
  2. 트랙 2 — 다중 막 16비트 BGM: 각 막의 분위기에 맞는 실제 오픈 라이선스(CC0 / CC BY 3.0, 예: OpenGameArt / BoxCat Games / Kevin MacLeod / 칩튠 OST) 16비트 트랙을 소싱하고, 막 타임스탬프에 맞게 부드러운 크로스페이드로 단일 갭리스 BGM 트랙으로 연결한 다음 자동 음성 해설 덕킹(duck = 1 - voiceEnergy * 0.22)을 약 0.58 * bgmVolume에서 적용합니다.
  3. 트랙 3 — 동기화된 16비트 SFX(retroSfxEngine.ts): 모든 장면 컷에 대한 자동 전환 SFX + 수동으로 배치된 뮤지컬 비트 SFX(4장 카드 공개를 위한 5음계 상승 블립, 수정 클링크, 베기 버즈, 주행 거리계 틱, 따뜻한 피날레 메이저 코드)를 결합합니다. 모든 SFX는 Web Audio(BaseAudioContext + 선택적 scheduledTime)를 통해 깔끔하게 합성되어 실시간 재생과 오프라인 MP4 내보내기의 사운드가 동일합니다.

5단계: 스튜디오 NLE 미리보기 및 클라이언트 측 1080p MP4 내보내기

자세한 내용은 references/mp4-export-and-qa-spec.md를 읽으십시오:

  • 스튜디오 셸: 다크 옵시디언 작업 공간(#07080B), TopBar(브랜드 타이틀, 챕터 점프 탐색, 실시간 단계 진행 및 즉시 취소가 가능한 단일 기본 导出 1080p MP4 작업), Canvas 스테이지(16:9 / 9:16 전환, 재생/일시정지/스크럽/단계/속도/음소거/전체 화면), 멀티트랙 시각적 타임라인(씬 블록 + 자막 블록 + 플레이헤드), 오른쪽 편집 패널(分镜与转场 / 口播台词 / 画面调校에는 1080p vs 720p MP4 전환, BGM/SFX 슬라이더, 자막 토글, 하이라이트 점프 버튼 포함).
  • MP4 내보내기(videoExporter.ts): mp4-muxer + 브라우저 **WebCodecs(VideoEncoder H.264 + AudioEncoder AAC/Opus)**를 오프라인 직접 PCM 오디오 믹싱 + 캐시된 SFX 스탬핑과 함께 사용하며, 기본값은 1920×1080 @ 30fps, 14Mbps(세로는 1080×1920)이고, Safari 네이티브 MediaRecorder MP4로 자동 폴백됩니다.

6단계: 단위 테스트 및 시각적 브라우저 확인(필수)

  • 순수 로직을 분리하고 node:test(npx tsx --test)로 테스트합니다:
    1. SRT 타임스탬프 파싱 및 큐 커버리지(srtParser.test.ts)
    2. 간격이나 중복 없이 연속적인 장면 컷 및 전환(timeline.test.ts)
    3. Bayer 디더링 및 직사각형 스프라이트 그리드 검증(pixelSprites.test.ts)
    4. 시간 순서대로 SFX 큐 커버리지 및 순방향 전용 트리거 윈도우(retroSfxEngine.test.ts)
    5. 내보내기 해상도 설정, MP4 MIME 우선 순위 및 음성 에너지 타임라인(videoExporter.test.ts)
  • App.tsx에서 ?t=<seconds> URL 쿼리 매개변수를 지원하여 자동화된 헤드리스 브라우저 검사가 시각적 검사를 위해 모든 장면, 전환 중간 지점, 애니메이션 시작 비트 및 종료 프레임으로 직접 이동할 수 있도록 합니다.
  • 라이브 MP4 내보내기가 渲染 MP4에 도달하고, 오래된 콜백 없이 깔끔하게 취소되어 유휴 상태로 돌아가며, 브라우저 콘솔 오류를 발생시키지 않는지 확인합니다.

3. 시행착오를 겪은 규칙 및 절대 반복하지 말아야 할 함정

함정근본 원인필수 해결책
중국어 타이틀이 뭉개지고 덩어리짐("糊成一坨")384×216 저해상도 캔버스에 CJK를 렌더링한 후 업스케일CJK 타이틀을 이진 임계값(thresh = 142..148 for CJK, 88 for ASCII)이 적용된 38px/32px 글리프 스프라이트로 HD 캔버스에 렌더링하고 1px 잉크 외곽선 + 3밴드 베벨을 추가합니다. 하단 서드 자막은 깔끔한 원본 산세리프로 유지합니다.
후반 장면 간 하드 컷transitionIn 누락 또는 시각적 핸드오프 불일치SCENE_CUTS의 모든 컷은 목적 있는 transitionIn을 정의해야 합니다. 주제별 전환을 쌍으로 연결합니다(예: 피는 꽃이 떨어지는 얼음 결정체로 용해 → gravity-shatter로 겨울에 돌진).
요소가 갑자기 팝인원시 if (localTime > t) 부울로 UI 카드/박스 그리기모든 요소를 clamp01((localTime - delay) / dur) + easeOutBack / easeOutExpo, 빔 커넥터, 명판 펼침 또는 롤링 카운터로 구동합니다.
클라이막스 레이블이 가려지거나 반쯤 입력됨레이블 위에 글로우가 그려지거나, 바운드된 세그먼트 카운터에서 진행률 파생글로우 후에 프레임이 있는 어두운 명판 안에 레이블을 그립니다. 최대값이 있는 곡선 매개변수 대신 localTime에 직접 공개 진행률을 연결합니다.
오프라인 MP4 내보내기가 4%에서 중단90개 이상의 SFX(~280개의 BiquadFilterNode)를 단일 314초 OfflineAudioContext에 연결음성 + BGM을 한 번 디코딩하고, 스테레오 Float32Array PCM에서 직접 믹싱하고, 각각의 고유한 짧은 SFX를 작은 0.55–1.55s OfflineAudioContext(캐시됨)에서 렌더링한 다음 PCM에 스탬핑합니다.
오프라인 MP4 오디오 인코딩이 12초 이상 소요느슨한 드레인 폴링으로 작은 4096 샘플 AudioData 청크 제공AudioData를 1초(48000 샘플) 청크(5분 동안 약 315개 청크)로 배치하고 드레인 폴백을 20ms로 조입니다.
MP4 렌더링 중 취소 버튼을 클릭해도 버튼이 고정됨waitForEncoderDrain이 cancel() 후에 해결되고 마지막 onProgress를 한 번 더 내보냄onProgress/onComplete/onError를 !cancelled 가드로 래핑하고 모든 await 직후에 if (isCancelled()) return을 확인합니다.

4. 이 스킬의 참조 파일

실행 중 필요에 따라 다음 참조를 로드하십시오:

  • references/visual-and-typography-spec.md — 정확한 PAL 색상 팔레트, 384×216 캔버스 및 정수 스케일링 수학, Bayer 디더링, 픽셀 타이포그래피 래스터라이저, 9가지 전환 레시피.
  • references/choreography-and-audio-spec.md — 애니메이션 시작 패턴, 5막 BGM 크로스페이드 + 덕킹 수학, 15가지 절차적 16비트 SFX 레시피.
  • references/mp4-export-and-qa-spec.md — 4계층 클라이언트 측 MP4 내보내기 파이프라인, 고속 오프라인 PCM 믹서, 스튜디오 NLE UI 사양, 단위 및 브라우저 QA 체크리스트.

관련 스킬