Deck Visuals (Estudio Visual 100% Local, Primero el Código)
Cada visual generado aquí es primero el código, determinista y con tokens de marca:
- Lee
window.BRAND_TOKENS(inyectados automáticamente desdetokens.jsondedeck-brand) y opcionalmentewindow.VISUAL_DATA(desde--data data.json). - Importa paquetes locales (
three,d3) desde el servidor estático efímero local—cero llamadas externas a redes o CDN. - Genera PNG transparentes retina 2x (
--mode png) o clips H.264 MP4 en bucle sin costuras (--mode mp4) listos parainsert.pictureoinsert.videoendeck-builder.
Guía de Selección Visual (Narrativa Primero)
| Necesidad Narrativa | Mejor Herramienta / Receta Incorporada | Salida |
|---|---|---|
| Recorrer un diagrama o acercarse a un pilar | DeckCraft Morph (deck-builder) | Formas vectoriales nativas |
| Portada icónica / ancla conceptual / héroe 3D | Three.js (three-hero-orb.html) | PNG transparente 2x o MP3 en bucle de 3–4 s |
| Sistema en capas / arquitectura de plataforma | Three.js Isométrico (three-isometric-layers.html) | PNG transparente 2x |
| Escala de esfuerzo / madurez / hoja de ruta por fases | Three.js Terrazas (three-ascending-steps.html) | PNG transparente 2x |
| Volante reutilizable / modelo operativo en N | Three.js Volante (three-orbital-flywheel.html) | MP4 en bucle sin costuras o PNG 2x |
| Prueba cuantificada, tendencias, rankings, comparaciones | D3 / SVG (editorial-chart.html) | PNG transparente 2x |
| Recorrido de producto / UI | Escenario 3D en Perspectiva HTML/CSS (Playwright) | PNG transparente 2x |
| Fotografía real genuina | Foto proporcionada por el usuario (o hook opcional futuro en la nube) | Imagen recortada |
Renderizar un Activo Visual
1. PNG Retina Transparente (3D estático, 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 en Bucle Determinista (tornamesa 3D, diagrama animado, shader)
Exponga window.renderFrame = (t) => { ... } donde t se ejecute suavemente de 0 a 1 (cierre sin costuras para que t=0 y t=1 coincidan!). Luego ejecute:
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. Pasar Datos Personalizados a Gráficos/Diagramas
Pase --data ruta/a/datos-grafico.json—el ejecutor lo inyecta como window.VISUAL_DATA antes de que se ejecute el script de la escena.
Regla de Calidad: Inspeccionar Antes de Insertar
Inspeccione siempre cada PNG renderizado (o fotograma intermedio de video) de forma aislada antes de colocarlo en una diapositiva de DeckCraft:
- Verifique la transparencia y el antialiasing de bordes (sin costura abrupta del cuadro delimitador contra el fondo de la diapositiva).
- Verifique que las etiquetas del gráfico sean nítidas, sin superposición y al menos equivalentes a 11–12pt en el tamaño rect objetivo de la diapositiva.
- Verifique que todos los colores armonicen con
tokens.json.