feat: update doc (#966)

galacean · Feb 26, 2024 · a04e312 · a04e312
1 parent ff238c9
commit a04e312
Show file tree

Hide file tree

Showing 4 changed files with 18 additions and 12 deletions.
diff --git a/docs/graphics-mesh-primitiveMesh.zh-CN.md b/docs/graphics-mesh-primitiveMesh.zh-CN.md
@@ -18,7 +18,7 @@ label: Graphics/Mesh
 
 <img src="https://gw.alipayobjects.com/zos/OasisHub/b61f5f8c-1eba-4ea8-a019-f823a6c0b17d/image-20231009112014068.png" alt="image-20231009112014068" style="zoom:50%;" />
 
-内置几何体无法满足需求？您也可以在 **[资产面板](${docs}interface-assets)** 中 **右键** → **Create** → **PrimitiveMesh** 创建一个 `Mesh` 资产，您可以通过调整 `Mesh` 的各项参数来满足需求。
+内置几何体无法满足需求？您可以在 **[资产面板](${docs}interface-assets)** 中 **右键** → **Create** → **PrimitiveMesh** 创建一个 `Mesh` 资产，并通过调整 `Mesh` 的各项参数来满足需求。
 
 <img src="https://mdn.alipayobjects.com/huamei_yo47yq/afts/img/A*g3XwRrrVv8kAAAAAAAAAAAAADhuCAQ/original" alt="image-20231009111916680" style="zoom:50%;" />
 

diff --git a/docs/graphics-model-opt.zh-CN.md b/docs/graphics-model-opt.zh-CN.md
@@ -8,8 +8,8 @@ label: Graphics/Model
 
 模型的优化一般从以下几点入手：
 
-- 缩减顶点数据：不仅可以**缩小模型文件尺寸**，还可以**降低渲染压力**
-- 缩减纹理尺寸：不仅可以**缩小模型文件尺寸**，还可以**大幅度减少显存**
-- 使用压缩纹理：**大幅度减少显存**
+- 网格：**缩减顶点数与面数**，**压缩网格数据**
+- 纹理：**调整纹理尺寸**（如从 **1024 \* 1024** -> **512 \* 512**），使用**压缩纹理**
+- 动画：**压缩动画数据**
 
 ## 最佳实践
diff --git a/docs/graphics-texture-compression.zh-CN.md b/docs/graphics-texture-compression.zh-CN.md
@@ -6,7 +6,7 @@ group: 纹理
 label: Graphics/Texture
 ---
 
-**[KTX2](https://www.khronos.org/ktx/)**(Khronos Texture Container version 2.0) 是 Khronos 推出最新的纹理压缩方案，Galacean 在 1.1 版本中已经支持。KTX2 会根据设备平台支持运行时转码到对应格式的压缩纹理(BC/PVRTC/ETC/ASTC)。
+**[KTX2](https://www.khronos.org/ktx/)**(Khronos Texture Container version 2.0) 是 Khronos 推出最新的纹理压缩方案，Galacean 自 1.1 版本开始已经支持。KTX2 会根据设备平台支持运行时转码到对应格式的压缩纹理(BC/PVRTC/ETC/ASTC)。
 
 ## 使用
 

diff --git a/docs/interface-publish.zh-CN.md b/docs/interface-publish.zh-CN.md
@@ -10,28 +10,34 @@ label: Basics/Interface
 
 Galacean Editor 项目导出功能可以将当前编辑器项目作为一个前端项目下载到本地。你可以在编辑器中配置项目导出的参数，如资产导出配置、渲染导出配置、物理导出配置等。基于这些配置，编辑器会生成出项目所需的代码、资产，生成对应的 `package.json`，并最终打包成一个 zip 包供你下载。
 
-<img src="https://gw.alipayobjects.com/zos/OasisHub/e07d04fd-499c-40b6-90d7-f6f183e0b6a2/image-20231007201437362.png" alt="image-20231007201437362" style="zoom:50%;" />
-
 ### 导出配置
 
 #### 资产导出配置
 
+<img src="https://mdn.alipayobjects.com/huamei_yo47yq/afts/img/A*h5VhR56vjZcAAAAAAAAAAAAADhuCAQ/original" alt="image-20231007201437362" style="zoom:50%;" />
+
 资产导出配置可以用来控制导出的资源类型和质量等参数。在资产导出配置中，你可以选择导出的资源类型，例如模型、纹理、HDR 等等，以及选择每种类型的导出质量和格式等参数。在导出模型时，你可以选择是否导出模型的网格信息、骨骼信息、动画信息等。
 
-| 配置          | 描述                                                                                                                                                                                                                       |
-| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| glTF Quantize | 一种 glTF 压缩算法，详见[这里](https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_mesh_quantization/README.md)                                                                                      |
-| KTX2          | 勾选 [KTX2](https://www.khronos.org/ktx/) 开启[纹理压缩](${docs}graphics-texture-compression)优化选项，能减少约 80% 的纹理显存。默认的压缩配置是 UASTC，开启 MIPMAP 和 ZSTD 压缩。后续编辑器的迭代会逐步开放更多的配置选项 |
+| 配置          | 描述                                                                                                                              |
+| ------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| glTF Quantize | glTF 压缩算法，详见[这里](https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_mesh_quantization/README.md)  |
+| glTF Meshopt  | glTF 压缩算法，详见[这里](https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Vendor/EXT_meshopt_compression/README.md) |
+| 纹理类型      | 勾选 [KTX2](https://www.khronos.org/ktx/) 开启[纹理压缩](${docs}graphics-texture-compression)优化选项                             |
+| 纹理压缩格式  | 勾选 [KTX2](https://www.khronos.org/ktx/) 后可见，不同压缩格式会影响纹理的尺寸和渲染质量                                          |
+| 纹理压缩质量  | 勾选 [KTX2](https://www.khronos.org/ktx/) 后可见，可以一定限度上调整纹理的尺寸和渲染质量                                          |
+| 主场景        | 选择 **[资产面板](${docs}interface-assets)** 中的某个场景作为项目加载后的主场景                                                   |
 
 #### 渲染导出配置
 
+<img src="https://mdn.alipayobjects.com/huamei_yo47yq/afts/img/A*WZHzRYIpUzQAAAAAAAAAAAAADhuCAQ/original" style="zoom:50%;" />
+
 渲染导出配置可以用来控制项目的渲染效果和性能等参数。
 
 | 配置                                                                                                  | 描述                                                       |
 | ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
 | WebGL Mode                                                                                            | WebGL 的版本，`Auto` 值表示根据设备能力自动选择 WebGL 版本 |
 | WebGL [Context](https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement/getContext) 的配置 | Anti-Alias、Alpha、Preserve Drawing Buffer 等              |
-| Device Pixel Ratio                                                                                    | 设备的像素比，用来控制画布的尺寸                           |
+| Device Pixel Ratio                                                                                    | [设备的像素比](${docs}core-canvas)，用来控制画布的尺寸     |
 
 ### 项目启动