doc: update zh-cn doc

This commit is contained in:
2026-03-24 16:12:07 +08:00
parent 2e76ce7862
commit 3b79b8a0b1
8 changed files with 32 additions and 6 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 21 KiB

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

View File

@@ -6,7 +6,7 @@
BBP的Virtools文件原生导入导出功能依赖BMap以及其Python绑定pybmap来实现。为了分发插件我们需要首先编译BMap及其前置LibCmo。而在编译前你需要先确认你需要的BMap版本。因为BBP并不总是使用最新的BMap例如你正在编译一个旧版的BBP其显然不可能依赖最新的BMap。BMap也在不断升级中其提供的功能也在不断变化不同版本的BMap是不兼容的。BBP通常会在发布时写明其所用的BMap版本如果BBP没有指出你可能需要寻找与BBP发布时最近的BMap版本来编译。
在明确版本后,你需要访问[LibCmo位于GitHub的存储库](https://github.com/yyc12345/libcmo21)。然后克隆项目使用Git命令转到对应版本或者直接下载对应版本的源码。然后按照LibCmo的编译手册编译得到BMap。在Windows上你通常会得到`BMap.dll``BMap.pdb`这两个文件。而在Linux上则会是`BMap.so`
在明确版本后,你需要访问[LibCmo位于GitHub的存储库](https://github.com/yyc12345/libcmo21)。然后克隆项目使用Git命令转到对应版本或者直接下载对应版本的源码。然后按照LibCmo的编译手册编译得到BMap。在Windows上你通常会得到`BMap.dll`文件。而在Linux上则会是`BMap.so`
然后我们需要配置pybmap。pybmap是随LibCmo一起提供的。请按照pybmap的手册将编译得到的二进制BMap库和pybmap结合在一起。即完成pybmap配置。

View File

@@ -5,11 +5,13 @@
## 导入Virtools文档
点击`File - Import - Virtools File`可以导入Virtools文档。导入支持CMOVMONMO文件。点击后会弹出文件打开界面并在侧边栏展示导入设置。首先你需要选择导入的Virtools文档然后在侧边栏配置导入设置配置完导入设置后即可点击导入开始导入并等待Blender下方提示导入完成即可。
点击`File - Import - Virtools File`可以导入Virtools文档。导入支持CMOVMONMO文件。点击后会弹出文件打开界面并在侧边栏展示导入设置,如下图所示。首先你需要选择导入的Virtools文档然后在侧边栏配置导入设置配置完导入设置后即可点击导入开始导入并等待Blender下方提示导入完成即可。
![](../imgs/import-virtools.png)
### 冲突解决选项
Conflict Options冲突解决选项章节指示了当导入器遇到物体名称重复的情况时该如何处理。分为5个等级分别针对Object物体Light灯光Mesh网格Material材质Texture贴图。处理方式则有2种Rename重命名和Use Current使用当前。选择重命名后当遇到重复名称时将会自动为其添加名称后缀使其名称唯一化。而选择使用当前则会忽略从文件中导入此项转而使用Blender文档中已经存在的同名的项目。
Conflict Options冲突解决选项章节指示了当导入器遇到物体名称重复的情况时该如何处理。分为5个等级分别针对Object物体Light灯光Camera摄像机Mesh网格Material材质Texture贴图。处理方式则有2种Rename重命名和Use Current使用当前。选择重命名后当遇到重复名称时将会自动为其添加名称后缀使其名称唯一化。而选择使用当前则会忽略从文件中导入此项转而使用Blender文档中已经存在的同名的项目。
!!! info "与Virtools冲突解决的不同"
相比较于在Virtools的冲突解决对话框BBP插件提供的冲突解决选项不支持替换功能同时其粒度也不支持精细到单个实例只能针对一整个类型进行设定。因此你无法单独为每一个冲突的实例设置不同的冲突解决方案。但目前这种设置已经能满足绝大对数的使用场景了。
@@ -35,7 +37,9 @@ Conflict Options冲突解决选项章节指示了当导入器遇到物体
## 导出Virtools文档
点击`File - Export - Virtools File`可以导出Virtools文档。点击后会弹出文件打开界面并在侧边栏展示导出设置。首先你需要选择导出的Virtools文档的位置然后在侧边栏配置导出设置配置完导出设置后即可点击导出开始导出并等待Blender下方提示导出完成即可。
点击`File - Export - Virtools File`可以导出Virtools文档。点击后会弹出文件打开界面并在侧边栏展示导出设置,如下图所示。首先你需要选择导出的Virtools文档的位置然后在侧边栏配置导出设置配置完导出设置后即可点击导出开始导出并等待Blender下方提示导出完成即可。
![](../imgs/export-virtools.png)
### 导出目标
@@ -46,6 +50,11 @@ Export Target导出目标章节用于决定你需要将哪写物体导出
* Selected Objects导出选择的物体。你需要在导出前选择好需要导出的物体。
* All Objects导出该文档中的所有物体。该选项慎用因为它是粗暴地遍历文档中的物体列表来进行导出很可能会导出许多你不需要的物体。
!!! warning "可导出目标与修改器"
自BBP 4.4版本开始BBP不仅支持导出Mesh类型物体还开始支持导出所有可转换为Mesh类型的物体包括Curve曲线Surface表面Font字体和Meta Ball融球。此前BBP仅支持Mesh类型物体的导出。通过该功能用户不再需要将各类物体转换为网格之后再进行地图导出和测试例如使用曲线放样得到花式钢轨的工作现在可以直接在曲线状态进行导出然后在游戏中进行可通关性的测试测试完毕后再将其固化为网格并添加相应材质。凭借该功能可大幅加速地图制作和调整速度。
额外的自BBP 4.4版本开始导出时也不再需要给物体应用修改器了。BBP在导出时会在一个类似“临时物体”的东西上应用所有修改器后再导出你可以这么近似理解实际实现并非如此。该功能可为之后使用几何节点等修改器赋能Ballance地图快速创作打下坚实基础。
### Virtools参数
Virtools ParamsVirtools参数章节与导入Virtools文档中的类似。Encodings编码属性决定了导出Virtools文档时所用的编码。

View File

@@ -10,7 +10,7 @@ BBP插件为每一个Blender物体添加了新的属性被称为Virtools Grou
BBP还在Blender的其它菜单提供了对Virtools组的访问具体内容请参阅[按组操作](./group-operations.md)。
需要注意的是Virtools组仅对网格物体生效,当你在其它物体上打开Virtools组面板时你会在面板中看到一条警告消息提示你Virtools组在该物体上无效。在非网格物体上设置的Virtools组数据尽管会被Blender承认和存储但不会在导出时保存到Virtools文件中。
需要注意的是Virtools组仅对网格物体和可转换为网格的物体生效,具体支持的物体可参考[导入导出Virtools文档](./import-export-virtools.md)页面的导出Virtools文档章节。当你在不支持的物体上打开Virtools组面板时你会在面板中看到一条警告消息提示你Virtools组在该物体上无效。在不支持的物体上设置的Virtools组数据尽管会被Blender承认和存储但不会在导出时保存到Virtools文件中。
## Virtools材质
@@ -67,3 +67,18 @@ BBP插件为所有Blender灯光添加了新的属性称为Virtools Light。
![](../imgs/virtools-light.png)
与Virtools材质类似Virtools的灯光系统与Blender的灯光系统差距较大Virtools灯光相当于一个桥梁它可以准确地反映Virtools的设置使得其可以完美地存储于Blender文件中并在导入导出时提供必要的数据。同时该面板并提供一个应用按钮用以将Virtools灯光设置应用到Blender灯光中。
## Virtools摄像机
BBP插件为所有Blender摄像机添加了新的属性称为Virtools Camera。转到`Data`属性面板,即可以找到`Virtools Camera`面板。
![](../imgs/virtools-camera.png)
与Virtools灯光类似Virtools的摄像机系统与Blender的摄像机系统差距较大Virtools摄像机相当于一个桥梁它可以准确地反映Virtools的设置使得其可以完美地存储于Blender文件中并在导入导出时提供必要的数据。
然而与Virtools灯光不同的是Virtools摄像机与Blender摄像机系统还有一个巨大的差异。每一个Virtools摄像机均可持有一个不同的分辨率比例例如4:316:9等而对于Blender摄像机系统Blender摄像机不持有这些数据而转而将他们存储在场景的渲染设置中该位置只能填写唯一的数值。为了解决该问题该面板提供的应用按钮仅将除了Aspect Ratio以外的属性精准地映射到Blender摄像机之上而对于Aspect Ratio单独提供了一个名为Apply Resolution的按钮用于将其反映到场景的渲染设置中的分辨率数值。当你想要义当前摄像机作为查看时点击该按钮应用分辨率后再进入摄像机视角就可以看到符合Aspect Ratio的摄像机结果了。
!!! tip "应用分辨率时的具体数值"
在应用分辨率时我们没有提供具体指定某一边像素个数的功能我们转而使用全自动的算法来计算出一个合适的分辨率。具体而言是首先取得Aspect Ratio的最小公倍数然后找到第一个大于1000且是其整数倍的数作为短边的像素数然后再以比例计算长边。该算法可保证计算出来的分辨率一定是整数。
选取1000是因为1000是一个较为适中的分辨率大小。然而这种随机选定的固定值也决定了其最终分辨率可能并不是用户想要的用户可酌情根据自身需要按比率增减分辨率。

View File

@@ -34,4 +34,6 @@
然后是选择摄像机的旋转角度。我们提供了8种游戏内预设角度分别对应90度和45度的各4种。此外如果这些预设角度不能满足你的需求你还可以设置自定义角度。
最后是选择摄像机视角分为Ordinary常规视角Lift按住空格键的视角和Easter Egg彩蛋视角三种。
接着是选择摄像机视角分为Ordinary常规视角Lift按住空格键的视角和Easter Egg彩蛋视角三种。
最后是分辨率选项可以在Normal正常游戏视角和Wide Screen加入宽屏补丁后的视角之间进行选择。通常来说选择正常游戏视角即可无需针对宽屏进行特殊配置。此外如果不勾选分辨率这个选项则不会修改当前选择摄像机的分辨率由于Blender与Virtools摄像机的实现差异也因此不会修改Blender渲染窗口的大小。有关该行为可参考[Virtools属性](./virtools-properties.md)页面的的Virtools摄像机章节。