Deck Visuals (100% lokale, code-first visuelle Werkstatt)
Jedes hier generierte Bild ist code-first, deterministisch und markenkonform:
- Liest
window.BRAND_TOKENS(automatisch austokens.jsonvondeck-brandinjiziert) und optionalwindow.VISUAL_DATA(aus--data data.json). - Importiert lokale Pakete (
three,d3) vom lokalen, ephemeren statischen Server – keine externen Netzwerk- oder CDN-Aufrufe. - Rendert gestochen scharfe 2x Retina-PNGs mit transparentem Hintergrund (
--mode png) oder nahtlos loopende H.264-MP4-Clips (--mode mp4), bereit fürinsert.pictureoderinsert.videoindeck-builder.
Visualauswahl-Leitfaden (Narrativ zuerst)
| Narrativer Bedarf | Bestes Werkzeug / Eingebautes Rezept | Ausgabe |
|---|---|---|
| Schrittweises Diagramm oder Zoom in einen Bereich | DeckCraft Morph (deck-builder) | Native Vektorformen |
| Ikonischer Cover / Konzeptanker / 3D-Held | Three.js (three-hero-orb.html) | Transparentes 2x-PNG oder 3–4 s Loop-MP4 |
| Geschichtetes System / Plattformarchitektur | Three.js Isometrisch (three-isometric-layers.html) | Transparentes 2x-PNG |
| Aufwandsskala / Reifegrad / Phasen-Roadmap | Three.js Terrassen (three-ascending-steps.html) | Transparentes 2x-PNG |
| Wiederverwendbares Schwungrad / N-förmiges Betriebsmodell | Three.js Schwungrad (three-orbital-flywheel.html) | Nahtlos loopendes MP4 oder 2x-PNG |
| Quantifizierte Belege, Trends, Rankings, Vergleiche | D3 / SVG (editorial-chart.html) | Transparentes 2x-PNG |
| Produkt / UI-Durchlauf | HTML/CSS 3D-Perspektivenbühne (Playwright) | Transparentes 2x-PNG |
| Echte Fotografie aus der realen Welt | Vom Benutzer bereitgestelltes Foto (oder optionaler zukünftiger Cloud-Hook) | Zugeschnittenes Bild |
Rendern eines visuellen Assets
1. Transparentes Retina-PNG (3D-Still, D3-Diagramm, SVG-Diagramm)
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. Deterministisches Loop-MP4 (3D-Drehteller, animiertes Diagramm, Shader)
Lege window.renderFrame = (t) => { ... } offen, wobei t gleichmäßig von 0 bis 1 läuft (nahtloser Übergang, sodass t=0 und t=1 übereinstimmen!). Führe dann aus:
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. Übergeben eigener Daten an Diagramme/Visualisierungen
Übergib --data pfad/zu/diagramm-daten.json – der Runner injiziert die Daten als window.VISUAL_DATA, bevor das Szenenskript ausgeführt wird.
Qualitätsregel: Vor dem Einbetten prüfen
Überprüfe jedes gerenderte PNG (oder Videobild) isoliert, bevor du es auf eine DeckCraft-Folie setzt:
- Prüfe Transparenz und Kantenglättung (keine harten Rahmenkanten gegen den Folienhintergrund).
- Prüfe, dass Diagrammbeschriftungen scharf, nicht überlappend und mindestens 11–12pt in der Zielfolienauflösung sind.
- Prüfe, dass alle Farben mit
tokens.jsonharmonieren.