Deck Visuals(100%ローカルコードファーストビジュアルスタジオ)
ここで生成されるすべてのビジュアルは、コードファースト、決定論的、ブランドトークン化されています。
window.BRAND_TOKENS(deck-brandのtokens.jsonから自動注入)と、オプションのwindow.VISUAL_DATA(--data data.json経由)を読み取ります。- ローカルなephemeral静的サーバーからローカルパッケージ(
three、d3)をインポートします—外部ネットワークやCDN呼び出しはゼロです。 - 2x Retinaの透明PNG(
--mode png)またはシームレスループH.264 MP4クリップ(--mode mp4)をレンダリングし、deck-builderのinsert.pictureまたはinsert.videoで使用できる状態にします。
ビジュアル選択ガイド(ナラティブ優先)
| ナラティブのニーズ | 最適なツール / 組み込みレシピ | 出力 |
|---|---|---|
| 図を段階的に表示、または1つの柱にズームイン | DeckCraft Morph(deck-builder) | ネイティブベクターシェイプ |
| 象徴的なカバー / コンセプトアンカー / 3Dヒーロー | Three.js(three-hero-orb.html) | 透明2x PNGまたは3〜4秒のループMP4 |
| レイヤードシステム / プラットフォームアーキテクチャ | Three.js Isometric(three-isometric-layers.html) | 透明2x PNG |
| 努力規模 / 成熟度 / フェーズ化されたロードマップ | Three.js Terraces(three-ascending-steps.html) | 透明2x PNG |
| 再利用可能なフライホイール / Nパターン運営モデル | Three.js Flywheel(three-orbital-flywheel.html) | シームレスループMP4または2x PNG |
| 定量化された証拠、トレンド、ランキング、比較 | D3 / SVG(editorial-chart.html) | 透明2x PNG |
| 製品 / UIウォークスルー | HTML/CSS 3D Perspective Stage(Playwright) | 透明2x PNG |
| 本物の現実世界の写真 | ユーザー提供の写真(または将来のオプションクラウドフック) | トリミングされた画像 |
ビジュアルアセットのレンダリング
1. 透明Retina 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と調和していることを確認します。