mcpField
3
3d-chladni-render

3d-chladni-render

github.com/vibe-motion创意与媒体1.4k204 次安装3 周前更新
代码仓库

关于 3d-chladni-render

用于渲染 3D Chladni 粒子动画的技能，适合需要生成视频或音频响应视觉效果的创作者。它通过 Electron 导出器生成像素精确的视频，并支持多种视觉模式及透明输出。

主要功能

  1. 01支持四种视觉模式
  2. 02根据音频驱动动画
  3. 03导出 MP4 或 MOV
  4. 04支持透明 ProRes 4444 输出
  5. 05验证视频尺寸、时长和音轨

适用场景

  1. 01生成动态沙粒或宇宙效果视频
  2. 02将音乐与音频响应动画合成
  3. 03导出带透明背景的动画素材
  4. 04渲染已保存的 Chladni 图案

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/vibe-motion/skills --skill 3d-chladni-render

安装后在 Claude Code 中输入/3d-chladni-render确认已加载。

附带文件agents/openai.yamlscripts/render_3d_chladni.py

详细介绍

3D Chladni 渲染

工作流

  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模态沙粒稳定的雕塑感 Chladni 节点
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 时使用 npm ci 安装项目依赖，除非设置了 --skip-install。
  • 调用仓库的像素级精确 Electron 导出器，而不是录制实时页面。
  • 默认使用 1280×720、30 fps、6 秒、15% 粒子、扫掠光照和进动。
  • 使用确定性种子，确保使用相同设置重新运行时能复现相同的粒子运动。
  • H.264 使用 .mp4，ProRes 使用 .mov；使用 --alpha 时必须指定 .mov。
  • 使用 ffprobe 验证完成后的容器，包括尺寸、时长，以及提供了 --audio 时是否存在音频流。
  • 传入 --pattern /absolute/path/pattern.json 可渲染已保存的 Chladni 图案。

要求

  • git
  • Python 3.9+
  • Node.js 和 npm
  • ffmpeg 和 ffprobe
  • 初次克隆和安装依赖时需要网络访问

预览素材许可

assets/3d-chladni-cosmic.gif 改编自源项目的演示媒体。署名：Lykno 制作的 3D Chladni 媒体，依据 CC BY-NC 4.0 授权。

评论

支持 Markdown