Deck Visuals (Estúdio Visual 100% Local e Orientado a Código)
Cada visual gerado aqui é orientado a código, determinístico e personalizado com a marca:
- Lê
window.BRAND_TOKENS(injetado automaticamente a partir detokens.jsondodeck-brand) e opcionalmentewindow.VISUAL_DATA(a partir de--data data.json). - Importa pacotes locais (
three,d3) do servidor estático efêmero local — zero chamadas de rede externa ou CDN. - Renderiza PNGs transparentes nítidos em retina 2x (
--mode png) ou clipes MP4 H.264 em loop contínuo (--mode mp4) prontos parainsert.pictureouinsert.videonodeck-builder.
Guia de Seleção Visual (Narrativa Primeiro)
| Necessidade Narrativa | Melhor Ferramenta / Receita Integrada | Saída |
|---|---|---|
| Percorrer um diagrama ou ampliar um pilar | DeckCraft Morph (deck-builder) | Formas vetoriais nativas |
| Capa icônica / âncora conceitual / herói 3D | Three.js (three-hero-orb.html) | PNG transparente 2x ou MP4 em loop de 3–4s |
| Sistema em camadas / arquitetura de plataforma | Three.js Isométrico (three-isometric-layers.html) | PNG transparente 2x |
| Escala de esforço / maturidade / roadmap em fases | Three.js Terraços (three-ascending-steps.html) | PNG transparente 2x |
| Modelo operacional de flywheel reutilizável / padrão N | Three.js Flywheel (three-orbital-flywheel.html) | MP4 em loop contínuo ou PNG 2x |
| Prova quantificada, tendências, rankings, comparações | D3 / SVG (editorial-chart.html) | PNG transparente 2x |
| Walkthrough de produto / UI | Palco de Perspectiva 3D HTML/CSS (Playwright) | PNG transparente 2x |
| Fotografia real genuína | Foto fornecida pelo usuário (ou hook futuro opcional na nuvem) | Imagem cortada |
Renderizando um Asset Visual
1. PNG Retina Transparente (Still 3D, gráfico D3, diagrama 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 em Loop Determinístico (Mesa giratória 3D, diagrama animado, shader)
Exponha window.renderFrame = (t) => { ... } onde t roda suavemente de 0 a 1 (envolva perfeitamente para que t=0 e t=1 coincidam!). Então execute:
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. Passando Dados Personalizados para Gráficos/Diagramas
Passe --data caminho/para/chart-data.json — o executor injeta como window.VISUAL_DATA antes de o script da cena executar.
Regra de Qualidade: Inspecione Antes de Incorporar
Sempre inspecione cada PNG renderizado (ou quadro intermediário de vídeo) isoladamente antes de colocá-lo em um slide do DeckCraft:
- Verifique a transparência e o anti-aliasing de borda (sem costura brusca de caixa delimitadora contra o fundo do slide).
- Verifique se os rótulos do gráfico estão nítidos, sem sobreposição e com tamanho equivalente a pelo menos 11–12pt no tamanho alvo do retângulo do slide.
- Verifique se todas as cores harmonizam com
tokens.json.