# 3DTextureExportTools

**Repository Path**: weiwengang/3DTextureExportTools

## Basic Information

- **Project Name**: 3DTextureExportTools
- **Description**: https://github.com/AshenOneArt/3DTextureExportTools
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-07
- **Last Updated**: 2026-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 3DTextureExportTools

**[English]**
A lightweight, robust Unity Editor tool for generating, previewing, and exporting 3D Noise Textures (Volume Textures) specifically designed for Volumetric Cloud rendering.

**[中文]**
一个轻量的 Unity 编辑器工具，专为体积云渲染设计，用于生成、预览和导出 3D 噪声纹理（Volume Textures）。

## Compatibility / 版本兼容性

* **Verified Environment (已验证环境):**
    * **Unity Version:** 2022.3.62f1
    * **Graphics API:** DirectX 11
    * **Pipeline:** HDRP (High Definition Render Pipeline)
        *(Note: Shader code is based on HDRP architecture. / 注：Shader 代码基于 HDRP 架构编写)*

* **Disclaimer (声明):**
    * This tool has currently **only** been tested on the specific version listed above.
    * Compatibility with other Unity versions (e.g., Unity 6, 2021 LTS) or other Graphics APIs (Vulkan, Metal, OpenGL) is **unknown** and not guaranteed.
    * 本工具目前**仅**在上述特定版本中进行过测试。
    * 对于其他 Unity 版本（如 Unity 6, 2021 LTS）或其他图形 API（Vulkan, Metal, OpenGL）的兼容性**未知**，暂不提供保证。

![Tool Preview](Document/preview.png)

---

## Download & Run (No Unity Required) / 下载与运行（无需安装 Unity）

If you simply want to use the tool without opening the Unity Editor, you can download the standalone executable.\
如果您只想直接使用工具而不想打开 Unity 编辑器，可以直接下载独立运行版。

1.  **Go to Releases:** Click the **[Releases](../../releases)** section on the right side of this page.
    * **前往发布页：** 点击页面右侧的 **[Releases](../../releases)** 链接。
2.  **Download:** Find the latest version (e.g., `v1.0`) and download the `.rar` or `.zip` file (e.g., `VolumeCloudTools.rar`).
    * **下载：** 找到最新版本（如 `v1.0`），下载对应的压缩包（如 `VolumeCloudTools.rar`）。
    * *Ignore the "Source code" zip files if you don't need the code.*
    * *注意：如果您不需要源码，请忽略 "Source code" 文件。*
3.  **Run:** Unzip the file and run the `.exe` application inside.
    * **运行：** 解压文件，直接运行其中的 `.exe` 程序即可。

---

## Integration (Source Code) / 源码集成（源码版）

If you want to use the tool inside your Unity project (as an Editor Window):
如果您需要在 Unity 项目内部使用此工具（作为编辑器窗口）：

1.  **Download Source:** Click `Code` -> `Download ZIP` (or download `Source code (zip)` from Releases).
    * **下载源码：** 点击 GitHub 页面绿色的 `Code` 按钮 -> `Download ZIP`（或在 Releases 页面下载源码包）。

2.  **Install:** Unzip the file, find the **`VolumeCloud`** folder, and drag it directly into your project's **`Assets`** directory.
    * **安装：** 解压文件，找到 **`VolumeCloud`** 文件夹，将其直接拖入您 Unity 项目的 **`Assets`** 目录下。
---

## Quick Start (Source Code) / 快速开始（源码版）

After dragging the folder into your project:
将文件夹拖入项目后：

1.  **Open Scene:** Click the top menu **`VolumeCloud`** -> **`Open Runtime Noise Generator Scene`**.
    * **打开场景：** 点击顶部菜单栏的 **`VolumeCloud`** -> **`Open Runtime Noise Generator Scene`**。
    * *(This menu item automatically locates and opens the tool's specific scene file. / 该菜单项会自动定位并打开工具专用的场景文件。)*

2.  **Run:** Press the **Play (▶)** button in the Unity Editor.
    * **运行：** 点击 Unity 编辑器的 **Play (▶)** 运行按钮。

3.  **Ready:** The tool UI will appear in the **Game View**. You can now start generating noise.
    * **就绪：** 工具 UI 将显示在 **Game View（游戏视图）** 中，您现在可以开始生成噪声了。

## Controls & Camera / 操作与视角

When the scene is running, the tool uses a "Roaming Camera" similar to Scene View.
场景运行时，工具使用类似 Scene View 的漫游相机。

### Mouse Mode Switching (Important!) / 鼠标模式切换（重要！）

* **Camera Look Mode (Default):**
    * The cursor is **hidden**. Moving the mouse rotates the camera view.
    * **默认模式（视角漫游）：** 光标**隐藏**。移动鼠标可以旋转视角。

* **UI Cursor Mode (Press TAB):**
    * **Press `TAB` key** to toggle mode.
    * The cursor becomes **visible**, and camera rotation **stops**.
    * Use this mode to click buttons or drag sliders on the UI.
    * **UI 交互模式（按 TAB 键）：**
    * **按 `TAB` 键** 切换模式。
    * 光标**显示**，视角旋转**锁定**。
    * 在此模式下，您可以点击按钮或拖拽调整 UI 参数。

### Movement Keys / 移动按键

* **`W / S / A / D`**: Move Forward / Backward / Left / Right (前后左右移动)
* **`Q / E`**: Move Down / Up (垂直升降)
* **`Shift` (Hold)**: Boost movement speed (按住加速移动)

## Features / 功能特性

* **Real-time Preview:** Visualize 3D noise directly in the Unity Editor before exporting.
  * **实时预览：** 在导出前直接在编辑器中查看 3D 噪声的体积渲染效果。

* **Composite Noise Generation:**
  * **复合噪声生成：**
    * **R Channel:** Perlin-Worley noise (Base cloud shape). (R 通道：Perlin-Worley 噪声，用于云的基础形状)
    * **G Channel:** High-frequency Worley noise (Edge details). (G 通道：高频 Worley 噪声，用于边缘侵蚀细节)

* **Format Support:**
  * **多格式支持：**
    * **DDS (Volume Texture):** Supports BC6H (HDR) and BC7 compression. (支持 BC6H HDR 和 BC7 压缩格式)
    * **PNG/EXR:** Exports slices for debugging or external processing. (支持导出切片序列，便于调试或外部处理)

* **Automated Dependency Management:**
  * **全自动依赖管理：**
    * Automatically downloads Microsoft **DirectXTex** tools (`texconv`, `texassemble`)(自动下载微软 **DirectXTex** 工具链)

---

## Usage Workflow (Important!) / 使用流程（重要！）

1. **Initialize / 初始化:**
   **Click the "Generate Noise" button first.**
   **首先点击 "Generate Noise" 按钮。**
   > *Note: Parameters are locked and export is disabled until the initial noise is generated.*
   > *注意：在生成初始噪声之前，所有参数均被锁定，且无法导出文件。*

2. **Tweak & Preview / 调整与预览:**
   Once generated, you can adjust sliders in real-time to see changes in the preview window.
   生成完毕后，你可以实时拖动滑块调整参数，并在预览窗口即时查看体积云的变化。

3. **Export / 导出:**
   Click **"Export as DDS"** to generate the final `.dds` volume texture.
   点击 **"Export as DDS"** 导出最终的 `.dds` 体积纹理文件。

---

## Parameters Explained / 参数详解

### 1. Noise Generation (噪声生成)
* **Resolution (分辨率):**
  * The resolution of the 3D texture (e.g., 64x64x64). Higher values provide more detail but consume more memory and processing time.
  * 3D 纹理的分辨率（如 64x64x64）。数值越高细节越丰富，但显存和计算耗时也会增加。
  * *Note: Changing resolution requires clicking "Generate Noise" again.* (注意：修改分辨率后需要再次点击 "Generate Noise" 才能生效。)

### 2. Base Shape - R Channel (基础形状 - R通道)
Defines the main body and structure of the clouds.
定义云朵的主体结构。

* **Base Frequency Exp:** Controls the scale of the Perlin noise. Higher values = smaller, more frequent cloud clumps.
  * 控制 Perlin 噪声的频率（缩放）。数值越高，云朵的团块越小、越密集。
* **Base Octaves:** The number of noise layers. Higher values add more fine detail to the base shape.
  * 噪声的层级数（八度）。数值越高，基础形状的细节层次越丰富。
* **Base Persistence:** How much each octave contributes. Higher values make the surface "rougher".
  * 持续度。数值越高，高频细节的占比越大，云朵表面看起来越“粗糙”。

### 3. Base Worley Settings (基础 Worley 设置)
Modifies the Perlin noise to look more "puffy" (Cumulus-like).
用于修饰 Perlin 噪声，使其看起来更具“棉花糖”般的堆积感（积云特征）。

* **Worley Scale Exp:** The size of the Worley cells.
  * Worley 晶格的大小。
* **Base Coverage:** Controls the fill rate. Lower values make the clouds wispier; higher values make them thicker.
  * 覆盖率。数值越低，云越稀薄（絮状）；数值越高，云越厚实。

### 4. Detail - G Channel (细节 - G通道)
High-frequency noise used for eroding the edges of the cloud to create realistic wisps.
用于侵蚀云朵边缘的高频噪声，制造出真实的丝状细节。

* **Detail Frequency/Octaves/Persistence:** Same logic as above, but applied to the detail layer (Green Channel).
  * 逻辑同上，但仅作用于细节层（绿色通道）。

### 5. Rendering Settings - Preview Only (渲染设置 - 仅预览)
These settings only affect how the noise looks in the Inspector preview, **not the exported file**.
这些设置**仅影响编辑器内的预览效果**，不会改变导出的文件。

* **Noise Scale:** Adjusts the tiling of the preview material.
  * 调整预览材质的平铺缩放，用于检查纹理细节。
* **Noise Offset:** Scrolls the noise to check continuity (seamless tiling).
  * 滚动噪声位置，用于检查纹理是否无缝衔接。

### 6. Export Settings (导出设置)
* **Compress DDS (BC6H/BC7):**
  * **Checked (勾选):** Uses `texconv` to compress the texture (Recommended for runtime). **BC6H** is used for HDR/High precision, **BC7** for standard usage.
    * 使用 `texconv` 进行压缩（推荐用于运行时）。**BC6H** 适用于 HDR 高精度需求，**BC7** 适用于标准需求。
  * **Unchecked (未勾选):** Exports uncompressed RGBA32 volume texture (Large file size).
    * 导出未压缩的 RGBA32 体积纹理。

---

## Dependencies / 依赖说明

This tool relies on **Microsoft DirectXTex** for DDS processing.
本工具依赖 **Microsoft DirectXTex** 进行 DDS 处理。

* You **do not** need to download them manually.
  * 你**无需**手动下载这些工具。
* The script will automatically detect missing tools and download `texconv.exe` and `texassemble.exe` to your project's `Library/ToolCache/` folder upon first use.
  * 脚本会在首次运行时自动检测，并自动将 `texconv.exe` 和 `texassemble.exe` 下载到你项目的 `Library/ToolCache/` 目录中。

---

## License / 许可

This project is licensed under the **MIT License**.
本项目采用 **MIT 许可证**。

* **Third Party Notices (第三方声明):**
  * This tool automatically downloads binaries from [Microsoft DirectXTex](https://github.com/microsoft/DirectXTex), which is also licensed under the MIT License.
  * 本工具自动下载并使用的 **Microsoft DirectXTex** 二进制文件同样遵循 MIT 许可证。