3d-chladni-render

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

3D Chladni Render

3D Chladni 渲染

Workflow

工作流

Resolve the requested workspace, output path, duration, dimensions, and visual mode.
Use
```
cosmic
```
when the user does not choose a mode.
Pass an audio file with
```
--audio
```
when the user wants sound-reactive motion. Prefer
```
sand
```
or
```
dcosmic
```
for audio-driven output.
Resolve the installed skill directory and run
```
scripts/render_3d_chladni.py
```
.

Wait for the script to print

VALIDATION=PASS

and

OUTPUT_VIDEO=<absolute path>

Return the absolute output path and the render settings.

确定所请求的工作区、输出路径、时长、尺寸和视觉模式。
如果用户未选择模式，则使用
```
cosmic
```
。
当用户想要声音响应式运动时，通过
```
--audio
```
传入音频文件。对于音频驱动的输出，优先使用
```
sand
```
或
```
dcosmic
```
。
确定已安装的 Skill 目录并运行
```
scripts/render_3d_chladni.py
```
。

等待脚本打印

VALIDATION=PASS

和

OUTPUT_VIDEO=<absolute path>

。

返回绝对输出路径和渲染设置。

Quick Start

快速开始

bash

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

bash

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

Installed Skill Resolution

已安装 Skill 的定位

Use the installed skill copy, not a source checkout of this skill collection:

bash

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"

使用已安装的 Skill 副本，而不是此 Skill 集合的源代码检出副本：

bash

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"

Modes

模式

`--style`	Visual mode	Best use
`sand`	Dynamic Sand	Audio-reactive inertial sand motion
`msand`	Modal Sand	Stable sculptural Chladni nodes
`cosmic`	Cosmic Web	Calm rotating three-dimensional particle web
`dcosmic`	Dynamic Cosmic	Audio-reactive cosmic deformation

`--style`	视觉模式	最适用场景
`sand`	Dynamic Sand	音频响应式惯性沙粒运动
`msand`	Modal Sand	稳定、雕塑般的 Chladni 节点
`cosmic`	Cosmic Web	平静旋转的三维粒子网
`dcosmic`	Dynamic Cosmic	音频响应式宇宙形变

Audio-Driven Render

音频驱动渲染

Use an absolute path for the user's audio file:

bash

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"

The source exporter analyzes the supplied audio frame by frame and muxes it into the video. Do not describe browser microphone or desktop system-audio capture as part of this offline export path.

为用户的音频文件使用绝对路径：

bash

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"

源导出器会逐帧分析提供的音频，并将其封装到视频中。在这条离线导出路径中，不要将浏览器麦克风或桌面系统音频采集描述为其中的一部分。

Transparent Output

透明输出

Use ProRes 4444 MOV for transparency:

bash

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

使用 ProRes 4444 MOV 输出透明通道：

bash

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

Behavior

行为说明

Accept either a parent workspace or an existing 3D Chladni checkout through
```
--workspace
```
.

Clone

https://github.com/nolangz/3D-Chladni.git

into

<workspace>/3D-Chladni

when absent.

Fetch and fast-forward the selected branch when the checkout is clean.
Refuse to update a dirty checkout; use
```
--skip-update
```
to preserve intentional local edits.
Install project dependencies with
```
npm ci
```
only when Electron is missing, unless
```
--skip-install
```
is set.
Invoke the repository's pixel-exact Electron exporter instead of screen-recording the live page.
Default to 1280×720, 30 fps, 6 seconds, 15% particles, sweep lighting, and precession.
Use deterministic seeds so reruns with the same settings reproduce the same particle motion.
Accept
```
.mp4
```
for H.264 and
```
.mov
```
for ProRes; require
```
.mov
```
when
```
--alpha
```
is used.
Validate the finished container with
```
ffprobe
```
, including dimensions, duration, and audio-stream presence when
```
--audio
```
is supplied.
Pass
```
--pattern /absolute/path/pattern.json
```
to render a saved Chladni pattern.

支持通过
```
--workspace
```
传入父工作区或现有的 3D Chladni 检出目录。

如果

<workspace>/3D-Chladni

不存在，则将

https://github.com/nolangz/3D-Chladni.git

克隆到该目录。

当检出目录状态干净时，拉取并快进选定分支。
拒绝更新状态不干净的检出目录；使用
```
--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 图案进行渲染。

Requirements

环境要求

```
git
```
Python 3.9+
Node.js and
```
npm
```
```
ffmpeg
```
and
```
ffprobe
```
Network access for the initial clone and dependency installation

```
git
```
Python 3.9+
Node.js 和
```
npm
```
```
ffmpeg
```
和
```
ffprobe
```
网络访问，用于初始克隆和依赖安装

Preview Asset License

预览素材许可

assets/3d-chladni-cosmic.gif

is adapted from the source project's demo media. Attribution: 3D Chladni media by Lykno, licensed under CC BY-NC 4.0.

assets/3d-chladni-cosmic.gif

改编自源项目的演示媒体。署名：3D Chladni 媒体由 Lykno 提供，采用 CC BY-NC 4.0 许可。