Create readme_CN.md
Browse files- readme_CN.md +64 -0
readme_CN.md
ADDED
|
@@ -0,0 +1,64 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# MLSharp-TD-Bridge (2D to 3D Gaussian Splatting)
|
| 2 |
+
|
| 3 |
+
> **TouchDesigner 中的一键 2D 转 3D 高斯泼溅工具 | Portable AI Bridge** > **Author:** 多多GemosDodo
|
| 4 |
+
|
| 5 |
+
[中文版 (Chinese Version)](./README_zh-CN.md) | [English Version](./README.md)
|
| 6 |
+
|
| 7 |
+
<img width="1780" height="842" alt="image" src="https://github.com/user-attachments/assets/94273fd8-546f-41e1-b8c9-089944bb0463" />
|
| 8 |
+
|
| 9 |
+
## 项目简介 (Introduction)
|
| 10 |
+
|
| 11 |
+
**MLSharp-TD-Bridge** 是一个为 TouchDesigner 打造的便携式 AI 桥接工具。它基于 Apple 的 Sharp 模型架构,实现了**在 TouchDesigner 内部一键将 2D 图片转换为高质量 3D Gaussian Splatting(高斯泼溅)模型**。
|
| 12 |
+
|
| 13 |
+
传统的 AI 生成往往伴随着繁琐的 Python 环境配置、复杂的依赖安装(CUDA, PyTorch 等)以及命令行操作。本项目的目标是将这一过程彻底“自动化”与“黑盒化”。
|
| 14 |
+
|
| 15 |
+
**设计师无需编写任何代码,只需拖入图片,即可在几十秒内获得 3D 资产。**
|
| 16 |
+
|
| 17 |
+
## 💾 下载项目 (Download)
|
| 18 |
+
|
| 19 |
+
由于本项目内置了完整的便携式 Python 环境,文件体积较大,无法直接上传至 GitHub。**请务必通过下方的百度网盘链接下载完整的工程文件**。
|
| 20 |
+
|
| 21 |
+
**Due to GitHub file size limits (includes full portable Python env), please download the complete project via Baidu Netdisk:**
|
| 22 |
+
|
| 23 |
+
> **百度网盘 (Baidu Netdisk):** [点击下载 / Click to Download](https://pan.baidu.com/s/1FiFOcHLeYoDYhgth8ClS1A?pwd=v3g3)
|
| 24 |
+
>
|
| 25 |
+
> **提取码 (Password):** `v3g3`
|
| 26 |
+
|
| 27 |
+
---
|
| 28 |
+
|
| 29 |
+
## 核心亮点 (Features)
|
| 30 |
+
|
| 31 |
+
* **零配置,即插即用 (Zero-Config)** 内置了完整的便携式 Python 环境(包含 PyTorch, CUDA, gsplat, sharp 等)。用户下载解压后,**无需安装 Anaconda**,直接运行 `.toe` 文件即可。
|
| 32 |
+
|
| 33 |
+
* **全自动工作流 (Fully Automated)** 点击一个按钮,脚本自动完成:`图像保存` -> `清理旧文件` -> `调用 AI 推理` -> `重命名文件` -> `刷新 3D 视图`。
|
| 34 |
+
|
| 35 |
+
* **TD 原生体验 (Native Integration)** * **Input**: 支持任意 TOP 图像源(Movie File In, Noise, etc.)。
|
| 36 |
+
* **Output**: 生成结果自动回填至 Point File In,直接在 TD 视窗中预览。
|
| 37 |
+
|
| 38 |
+
* 🛠 **本地离线运行 (Offline Privacy)** 所有计算完全在本地 GPU 进行,无需联网,保护数据隐私。
|
| 39 |
+
|
| 40 |
+
## 系统要求 (Requirements)
|
| 41 |
+
|
| 42 |
+
* **操作系统**: Windows 10 / 11 (64-bit)
|
| 43 |
+
* **显卡**: NVIDIA 显卡 (建议显存 6GB 以上,支持 CUDA)
|
| 44 |
+
* **软件**: TouchDesigner 2022.x 或 2023.x 及以上版本
|
| 45 |
+
|
| 46 |
+
## 快速开始 (Getting Started)
|
| 47 |
+
|
| 48 |
+
1. **下载项目 (Download)** 通过上方的**百度网盘链接**下载压缩包,并解压整个项目文件夹。
|
| 49 |
+
> **⚠️ 注意**:请确保解压后的路径中**不包含中文字符**(例如放 D 盘根目录),以免 Python 读取路径时报错。
|
| 50 |
+
|
| 51 |
+
2. **启动工程 (Launch)** 双击运行文件夹内的 `MLSharp-TD-Bridge-by-GemosDodo.toe`。
|
| 52 |
+
|
| 53 |
+
3. **一键生成 (Generate)** 选中 `Sharp_3D_Bridge` 组件,在属性面板点击 **`Generate`** 按钮。
|
| 54 |
+
|
| 55 |
+
4. **查看结果 (View)** 等待约 30-60 秒(取决于显卡性能),生成的 3D 模型将自动加载到右侧的预览视窗中。
|
| 56 |
+
|
| 57 |
+
## 特别鸣谢 (Acknowledgements)
|
| 58 |
+
|
| 59 |
+
本项目还利用了由 **Yea Chen** 大佬开源的 **Touchdesigner 3D Gaussian Splatting Toolkits**,方便展示生成出来的高斯泼溅 3D 模型。
|
| 60 |
+
|
| 61 |
+
这也是本人制作的第一个开源项目,也是站在巨人的肩膀上了哈哈哈,本项目不做任何盈利,免费开源给各位,希望大家在 TD 的学习或者创作过程中使用愉快!!!!
|
| 62 |
+
|
| 63 |
+
* **ML_Sharp GitHub**:[https://github.com/apple/ml-sharp](https://github.com/apple/ml-sharp)
|
| 64 |
+
* **Touchdesigner 3D Gaussian Splatting Toolkits Github**:[https://github.com/yeataro/TD-Gaussian-Splatting](https://github.com/yeataro/TD-Gaussian-Splatting)
|