3d-chladni-render

3D Chladni Render

ワークフロー

1. 指定されたワークスペース、出力パス、長さ、寸法、ビジュアルモードを解決します。
2. ユーザーがモードを選択していない場合は、cosmic を使用します。
3. サウンドに反応する動きをユーザーが希望する場合は、--audio でオーディオファイルを渡します。オーディオ駆動の出力には、sand または dcosmic を優先してください。
4. インストール済みのスキルディレクトリを解決し、scripts/render_3d_chladni.py を実行します。
5. スクリプトが VALIDATION=PASS と OUTPUT_VIDEO=<absolute path> を出力するまで待ちます。
6. 絶対パスとレンダリング設定を返します。

クイックスタート

python3 scripts/render_3d_chladni.py \
  --workspace "$(pwd)" \
  --output "$(pwd)/out/3d-chladni-cosmic.mp4"

インストール済みスキルの解決

このスキルコレクションのソースチェックアウトではなく、インストール済みのスキルを使用してください。

skill_dir=""
for base in "${AGENTS_HOME:-$HOME/.agents}" "${CLAUDE_HOME:-$HOME/.claude}" "${CODEX_HOME:-$HOME/.codex}"; do
  if [ -d "$base/skills/3d-chladni-render" ]; then
    skill_dir="$base/skills/3d-chladni-render"
    break
  fi
done
[ -n "$skill_dir" ] || { echo "3d-chladni-render skill not found under ~/.agents, ~/.claude, or ~/.codex"; exit 1; }

python3 "$skill_dir/scripts/render_3d_chladni.py" \
  --workspace "$(pwd)" \
  --output "$(pwd)/out/3d-chladni-cosmic.mp4"

モード

--style	ビジュアルモード	最適な用途
sand	ダイナミックサンド	オーディオに反応する慣性を伴う砂の動き
msand	モーダルサンド	安定した彫刻のようなクラドニ節
cosmic	コズミックウェブ	穏やかに回転する三次元の粒子ウェブ
dcosmic	ダイナミックコズミック	オーディオに反応する宇宙的な変形

オーディオ駆動のレンダリング

ユーザーのオーディオファイルには絶対パスを使用してください。

python3 "$skill_dir/scripts/render_3d_chladni.py" \
  --workspace "$(pwd)" \
  --style dcosmic \
  --audio "/absolute/path/to/music.wav" \
  --seconds 12 \
  --output "$(pwd)/out/audio-chladni.mp4"

ソースエクスポーターは、指定されたオーディオをフレームごとに解析し、動画に多重化します。このオフラインのエクスポート経路について、ブラウザーのマイクやデスクトップのシステムオーディオのキャプチャーを説明に含めないでください。

透過出力

透過には ProRes 4444 MOV を使用してください。

python3 "$skill_dir/scripts/render_3d_chladni.py" \
  --workspace "$(pwd)" \
  --alpha \
  --output "$(pwd)/out/3d-chladni-alpha.mov"

動作

• --workspace では、親ワークスペースまたは既存の 3D Chladni チェックアウトを受け付けます。
• チェックアウトが存在しない場合は、https://github.com/nolangz/3D-Chladni.git を <workspace>/3D-Chladni にクローンします。
• チェックアウトに未コミットの変更がない場合、選択したブランチを取得して早送りマージします。
• 変更のあるチェックアウトの更新は拒否します。意図的なローカル編集を保持するには、--skip-update を使用してください。
• Electron が存在しない場合に限り、--skip-install が設定されていなければ、npm ci でプロジェクトの依存関係をインストールします。
• ライブページの画面録画ではなく、リポジトリのピクセル精度の高い Electron エクスポーターを実行します。
• デフォルトでは、1280×720、30 fps、6 秒、粒子数 15%、スイープ照明、歳差運動を使用します。
• 同じ設定で再実行したときに同じ粒子の動きを再現できるよう、決定論的なシードを使用します。
• H.264 には .mp4、ProRes には .mov を受け付けます。--alpha を使用する場合は .mov が必要です。
• 完成したコンテナーを ffprobe で検証します。検証項目には、寸法、長さ、--audio が指定された場合のオーディオストリームの有無が含まれます。
• 保存済みのクラドニパターンをレンダリングするには、--pattern /absolute/path/pattern.json を渡します。

必要条件

• git
• Python 3.9+
• Node.js と npm
• ffmpeg と ffprobe
• 初回のクローンと依存関係のインストールに必要なネットワークアクセス

プレビュー素材のライセンス

assets/3d-chladni-cosmic.gif は、ソースプロジェクトのデモメディアを改変したものです。帰属表示：Lykno による 3D Chladni メディア。CC BY-NC 4.0 ライセンス。