rise-origin

快速上手 ​

本教程在 Linux 上从源码构建 rise-origin，最后打开一个窗口，里面是一堆刚体和软体方块。第一次构建要编译引擎和它依赖的库，大部分时间花在这里。

开始之前，你的电脑要满足这些条件：

  • x86_64 的 Linux，显卡是 Volta 到 Hopper 的 NVIDIA 显卡；更新的显卡用 cuda13 后端。
  • 安装了 CUDA 工具包，并且 nvcc 在 PATH 里。
  • Python 3.10 或更新版本、CMake 3.22 或更新版本、C++ 编译器、nasm 和 meson。

构建引擎 ​

  1. 克隆仓库并进入目录：

    bash
    git clone https://github.com/iffiX/rise-origin
cd rise-origin

  2. 创建并激活虚拟环境：

    bash
    python3 -m venv venv
source venv/bin/activate

  3. 安装引擎的 GPU 后端和 Python 包。这一步会编译引擎：

    bash
    pip install ./rise_origin/cuda12 .

  4. 确认这个包可以导入：

    bash
    python -c "import rise_origin; print(rise_origin.__file__)"

    命令会输出虚拟环境里的一个路径。

运行世界 ​

  1. 运行第一个例子：

    bash
    python examples/basic/boxes.py

    窗口打开后，十六个刚体和软体方块落下，堆成一堆。

  2. 关闭窗口，把同一个世界录成视频：

    bash
    RISE_MODE=record RISE_OUT=boxes.mp4 RISE_DURATION=4 python examples/basic/boxes.py

    脚本不打开窗口。世界运行满四秒后，脚本写入 boxes.mp4。