Glyphランディングページ
1つの被写体 → 1つのページ。被写体はループ(Klingクリップをピン留めし、最後のフレームが最初のフレームと一致するようにしたもの)し、シェーダーはそれをアニメーションバックドロップ上にグリフとして描画します。ページ上には:
- ヒーロー: カーソルXで 写真 ← | → グリフ を分割、カーソルYでグリッドサイズを設定、リングとクロスヘアがカーソルに追従します。タイトル(1単語を2つに分割)は、シェーダーによってぼかしたバックドロップの反転として描画されます。密な線画、一部は被写体を追跡します。
- セクション: マニフェスト(意外な要素を含む真実)、マーキー、4つのスペック、被写体上に再度配置されたCTA。スクロールするとグリッドが大きなピクセルに変わり、また戻ります。
- シリーズ: 複数のページが1つのエンジンとページ切り替え機能を共有し、各ページは独自のパレット、背景効果、グリフレンダラー、フォント、線画、コピーを持ちます。
assets/examples/pages/ には、その範囲を示す5つの完全なページがあります(夜空の宇宙飛行士、紙の上のポピー、設計図としての1984年のMac、ハーフトーンと等圧線のある雲、ネオンブライユのクラゲ)。ページを作成する前に1つか2つ読んでください。丸ごとコピーしないでください。各ページは被写体に合わせて新しくデザインされます。
必要なもの
| 必要なもの | 理由 | 方法 |
|---|---|---|
| 被写体 | ユーザーの画像、または生成するための説明 | 質問する、またはユーザーが与えたものを使う |
FAL_KEY | 静止画、編集、動画 | 各コマンドで環境変数として設定(FAL_KEY=… node …)。絶対にエコーしたり、追跡ファイルに書き込んだりしないでください。ユーザーが保存を求めた場合のみ:gitignoredな.env.localに保存 |
| Node 18+、ffmpeg、Python 3 | ジェネレーター、パッキング、マスク | node -v、ffmpeg -version、python3 -V。macOSではbrew install node ffmpeg python |
コスト:静止画は安価(約$0.15)。各15秒のKlingクリップはかなり高価で、多くの場合1回のリトライが必要です。falの価格を確認し、最初の動画の前にその旨を伝えてください。
ステップ0 — 意図の確認(短いメッセージ1回で、その後決定)
- 被写体。 独自の画像 → 確認(透かし:削除しないでください。ライセンス版を依頼するか、代わりにオリジナルを生成してください。実在の人物の写真 → 本人であること、または同意があることを確認してください。商標製品は、ロゴなしであれば編集目的で問題ありません)。画像がない場合 → 自分で生成します。ユーザーの目標に合った被写体を提案してください。
- ルック。 ユーザーが説明した場合はそれに従ってください。それ以外の場合は、
references/looks.mdの7つの決定をすべて自分で行い、1~2文で何を選んだかを伝えてください。プロジェクトに既にページがある場合は、新しいページを既存の各ページと7つのうち少なくとも5つで異なるものにしてください。 - モーション。 何がどの程度動くか(「多くの動き」か「穏やかな浮遊」か)。デフォルトは15秒。
- コピーとフレーミング。 トーン、ユーザーが希望する事実や名前、それ以外の場合は被写体を中心とした架空の展示/出版物/イベント(
references/copy.md)。
ステップ1 — スキャフォールド
python3 <skill>/scripts/new_project.py <project-dir> <id> --name "名前" --title "最初/2番目" [--image パス]
cd <project-dir>/tools && npm install
最初の呼び出しでプロジェクトを作成します(site/ 内に engine.js、base.css、pages.json、index.html、tools/ 内にパイプライン、.gitignore)。2回目以降の呼び出しでページを追加し(site/<id>.html)、pages.json に登録して、すべてのページの切り替え機能に表示されるようにします。
ステップ2 — プロンプト → 静止画 → レビュー
tools/subjects/<id>.json を書きます(references/pipeline.md にチェックリスト、assets/examples/subjects/ にうまくいった5つがあります)。デフォルトはフラットな純黒の背景、被写体は右寄せで左側に空きスペース。
FAL_KEY=… node generate.mjs <id> still # 「画像」プロンプトから
FAL_KEY=… node generate.mjs <id> edit # または:ユーザーの画像をフラットな背景に(元の画像は保持)
tools/<id>.png を表示。ユーザーが満足するまで繰り返します。以降のすべての工程はこれに基づきます。
ステップ3 — クリップ → チェック → レビュー
FAL_KEY=… node generate.mjs <id> video # 数分かかります。バックグラウンドで実行
node generate.mjs <id> check # モーション番号 + tools/<id>-sheet.png
番号を確認します。中央付近で約3未満の場合、ほとんど動いていないことを意味します。ビルド前に文言を強化して再生成してください。コンタクトシートを表示します。ユーザーが異なるモーションを希望する場合、再度費用が発生する前に修正したプロンプトを表示してください。
ステップ4 — パックされたループをビルド
cd <project-dir> && tools/build_media.sh tools/<id>.png <id> video tools/<id>-motion.mp4
python3 tools/track_blobs.py <id> 3 # オプション:トラッキングオーバーレイ用の光る/高コントラスト部分のパス
site/media/<id>-loop.mp4 のフレームを確認します。右半分はきれいな白いシルエットでなければなりません。次に、注釈を付ける位置を測定します(references/pipeline.md → 測定)。
ステップ5 — ページをデザイン
site/<id>.html を編集します(すべての EDIT マーカー)。決定には references/looks.md、GLSLには references/shader-recipes.md、文言には references/copy.md を使用します。
:rootトークンとGoogle Fontsリンク。- シェーダー:
field()(背景効果+ハロー)、scene()(グリフレンダラー、プレート、インク色)、photo()、main()(フリンジ、タイトル反転、仕上げ)。stage({ focus, cell, zoom, atlas })を設定。 - タイトルの単語、サイズ、配置。スプレッド文。ロゴ/シリーズ名。
- 線画:スクリプトで構築された高密度のSVG/DOM、アニメーション化。
onFrame内でtoScreen()を使用した追跡要素。 - セクション:マニフェスト、マーキー、スペック、CTA、フッター — このルックに属するセクションスタイルを使用。
- スマートフォン:
@media (max-width:760px)ブロックを確認(タイトルサイズ、CTAサイズ、混雑したラベルを非表示)。
ステップ6 — プレビューと確認
cd <project-dir> && python3 -m http.server 5180 -d site # http://localhost:5180/<file> を開く
コードを読むのではなく、ブラウザで確認してください。コンソールはクリーン、キャンバスが表示される、カーソルを動かすと分割とサイズ変更が行われる、タイトルが写真側とグリフ側で読める、オーバーレイが被写体に配置される、すべてのセクションをスクロールできる、ワイドデスクトップ、ほぼ正方形のウィンドウ、375pxのスマートフォンで水平スクロールがないこと。編集後はハードリロード(静的サーバーはキャッシュします)。references/troubleshooting.md にはこれまでに発生した問題が記載されています。
ステップ7 — 引き渡し
ユーザーに構築した内容(被写体、モーション、7つのルックの決定、コピー)、うまくいかなかった点、そして彼らが調整しそうなノブ(フリンジ定数、プレートの不透明度、グリッド範囲、ブラブの強度、タイトルサイズ)とそれぞれの場所を伝えます。生のKlingクリップはgitから除外します(.gitignore が既に行っています)。
別のページを追加する
new_project.py <project-dir> <new-id> --name … を再度実行し、そのページに対してステップ2~6を実行します。既存のページとは異なるルックを選択してください。