Deck Visuals (Atelier Visuel 100 % Local, Piloté par le Code)
Chaque visuel généré ici est piloté par le code, déterministe et aligné avec la charte graphique :
- Lit
window.BRAND_TOKENS(injecté automatiquement depuistokens.jsondedeck-brand) et, en option,window.VISUAL_DATA(depuis--data data.json). - Importe les paquets locaux (
three,d3) depuis le serveur statique éphémère local — zéro appel réseau externe ou CDN. - Produit des PNG transparents 2x retina nets (
--mode png) ou des clips MP4 H.264 en boucle fluides (--mode mp4) prêts pourinsert.pictureouinsert.videodansdeck-builder.
Guide de Sélection Visuelle (Narratif d'Abord)
| Besoin Narratif | Meilleur Outil / Recette Intégrée | Sortie |
|---|---|---|
| Parcourir un diagramme ou zoomer sur un pilier | DeckCraft Morph (deck-builder) | Formes vectorielles natives |
| Couverture / ancrage conceptuel / 3D héroïque | Three.js (three-hero-orb.html) | PNG 2x transparent ou MP4 boucle 3-4s |
| Système en couches / architecture de plateforme | Three.js Isométrique (three-isometric-layers.html) | PNG 2x transparent |
| Échelle d'effort / maturité / roadmap par phases | Three.js Terrasses (three-ascending-steps.html) | PNG 2x transparent |
| Volant réutilisable / modèle opérationnel en N | Three.js Volant (three-orbital-flywheel.html) | MP4 boucle fluide ou PNG 2x |
| Preuve quantifiée, tendances, classements, comparaisons | D3 / SVG (editorial-chart.html) | PNG 2x transparent |
| Parcours produit / UI | Scène 3D HTML/CSS Perspective (Playwright) | PNG 2x transparent |
| Photographie réelle authentique | Photo fournie par l'utilisateur (ou hook cloud futur optionnel) | Image recadrée |
Rendu d'un Actif Visuel
1. PNG Retina Transparent (3D fixe, graphique D3, diagramme 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 Boucle Déterministe (table tournante 3D, diagramme animé, shader)
Exposez window.renderFrame = (t) => { ... } où t parcourt de 0 à 1 (boucle parfaitement : t=0 et t=1 identiques !). Exécutez ensuite :
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. Passage de Données Personnalisées aux Graphiques/Diagrammes
Passez --data chemin/vers/chart-data.json — l'exécuteur injecte les données dans window.VISUAL_DATA avant l'exécution du script de scène.
Règle de Qualité : Inspecter avant d'Intégrer
Inspectez toujours chaque PNG rendu (ou mi-trame vidéo) en isolation avant de le placer sur une diapositive DeckCraft :
- Vérifiez la transparence et l'anti-crénelage des bords (pas de bordure de boîte englobante dure contre l'arrière-plan de la diapositive).
- Vérifiez que les étiquettes du graphique sont nettes, non chevauchantes et d'au moins 11-12pt à la taille cible du rectangle de la diapositive.
- Vérifiez que toutes les couleurs s'harmonisent avec
tokens.json.