From a04e3122c62cc2f5a447faeafb0a531c0bd2ffc2 Mon Sep 17 00:00:00 2001 From: AZhan Date: Mon, 26 Feb 2024 17:31:05 +0800 Subject: [PATCH] feat: update doc (#966) --- docs/graphics-mesh-primitiveMesh.zh-CN.md | 2 +- docs/graphics-model-opt.zh-CN.md | 6 +++--- docs/graphics-texture-compression.zh-CN.md | 2 +- docs/interface-publish.zh-CN.md | 20 +++++++++++++------- 4 files changed, 18 insertions(+), 12 deletions(-) diff --git a/docs/graphics-mesh-primitiveMesh.zh-CN.md b/docs/graphics-mesh-primitiveMesh.zh-CN.md index cd20318cb..d016b5fc7 100644 --- a/docs/graphics-mesh-primitiveMesh.zh-CN.md +++ b/docs/graphics-mesh-primitiveMesh.zh-CN.md @@ -18,7 +18,7 @@ label: Graphics/Mesh image-20231009112014068 -内置几何体无法满足需求？您也可以在 **[资产面板](${docs}interface-assets)** 中 **右键** → **Create** → **PrimitiveMesh** 创建一个 `Mesh` 资产，您可以通过调整 `Mesh` 的各项参数来满足需求。 +内置几何体无法满足需求？您可以在 **[资产面板](${docs}interface-assets)** 中 **右键** → **Create** → **PrimitiveMesh** 创建一个 `Mesh` 资产，并通过调整 `Mesh` 的各项参数来满足需求。 image-20231009111916680 diff --git a/docs/graphics-model-opt.zh-CN.md b/docs/graphics-model-opt.zh-CN.md index e549b98f7..89bbf71ad 100644 --- 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 index e81066421..2a8289f06 100644 --- 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 index 6dfdc1450..a1e371dec 100644 --- 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 包供你下载。 -image-20231007201437362 - ### 导出配置 #### 资产导出配置 +image-20231007201437362 + 资产导出配置可以用来控制导出的资源类型和质量等参数。在资产导出配置中，你可以选择导出的资源类型，例如模型、纹理、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)** 中的某个场景作为项目加载后的主场景 | #### 渲染导出配置 + + 渲染导出配置可以用来控制项目的渲染效果和性能等参数。 | 配置 | 描述 | | ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | | 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)，用来控制画布的尺寸 | ### 项目启动