Deck Visuals (100% 로컬 코드 우선 비주얼 스튜디오)
여기서 생성되는 모든 비주얼은 코드 우선, 결정론적, 브랜드 토큰 기반입니다:
window.BRAND_TOKENS읽기 (deck-brand의tokens.json에서 자동 주입됨) 및 선택적window.VISUAL_DATA(--data data.json에서 전달).- 로컬 임시 정적 서버에서 제공되는 로컬 패키지 (
three,d3) 가져오기—외부 네트워크 또는 CDN 호출 없음. deck-builder의insert.picture또는insert.video에 바로 사용할 수 있는 선명한 2배 레티나 투명 PNG (--mode png) 또는 매끄러운 루핑 H.264 MP4 클립 (--mode mp4) 렌더링.
시각 자료 선택 가이드 (내러티브 우선)
| 내러티브 필요 | 최적 도구 / 내장 레시피 | 출력 형식 |
|---|---|---|
| 다이어그램 단계별 탐색 또는 한 요소 확대 | DeckCraft Morph (deck-builder) | 네이티브 벡터 도형 |
| 상징적 커버 / 콘셉트 앵커 / 3D 히어로 | Three.js (three-hero-orb.html) | 투명 2배 PNG 또는 3–4초 루핑 MP4 |
| 계층형 시스템 / 플랫폼 아키텍처 | Three.js 아이소메트릭 (three-isometric-layers.html) | 투명 2배 PNG |
| 노력 규모 / 성숙도 / 단계별 로드맵 | Three.js 테라스 (three-ascending-steps.html) | 투명 2배 PNG |
| 재사용 가능한 플라이휠 / N-패턴 운영 모델 | Three.js 플라이휠 (three-orbital-flywheel.html) | 매끄러운 루핑 MP4 또는 2배 PNG |
| 정량적 증명, 트렌드, 순위, 비교 | D3 / SVG (editorial-chart.html) | 투명 2배 PNG |
| 제품 / UI 워크스루 | HTML/CSS 3D 원근 스테이지 (Playwright) | 투명 2배 PNG |
| 실제 사진 (일반적인 실사 이미지) | 사용자 제공 사진 (또는 미래의 선택적 클라우드 훅) | 크롭된 사진 |
비주얼 자산 렌더링
1. 투명 레티나 PNG (3D 정지 이미지, D3 차트, SVG 다이어그램)
node skills/deck-visuals/scripts/render_visual.mjs \
--scene skills/deck-visuals/references/recipes/three-hero-orb.html \
--tokens build/brand/tokens.json \
--width 600 --height 600 --scale 2 \
--mode png --transparent \
--out build/assets/hero-3d.png
2. 결정론적 루핑 MP4 (3D 턴테이블, 애니메이션 다이어그램, 셰이더)
window.renderFrame = (t) => { ... }를 노출시키고, t가 0에서 1로 부드럽게 실행되도록 하십시오 (t=0과 t=1이 일치하도록 매끄럽게 연결!). 그런 다음 실행:
node skills/deck-visuals/scripts/render_visual.mjs \
--scene skills/deck-visuals/references/recipes/three-hero-orb.html \
--tokens build/brand/tokens.json \
--width 600 --height 600 --scale 1 \
--mode mp4 --fps 30 --duration 4 \
--out build/assets/hero-3d-loop.mp4
3. 차트/다이어그램에 사용자 정의 데이터 전달
--data path/to/chart-data.json을 전달하면 러너가 씬 스크립트가 실행되기 전에 window.VISUAL_DATA로 데이터를 주입합니다.
품질 규칙: 임베드 전 검사
렌더링된 모든 PNG (또는 비디오 중간 프레임)는 DeckCraft 슬라이드에 배치하기 전에 반드시 단독으로 검사하십시오:
- 투명도와 가장자리 앤티앨리어싱 확인 (슬라이드 배경에 대해 거친 경계 상자 이음새 없음).
- 차트 레이블이 선명하고 겹치지 않으며, 대상 슬라이드 사각형 크기에서 최소 11–12pt에 해당하는지 확인.
- 모든 색상이
tokens.json과 조화를 이루는지 확인.