doc: update manual

This commit is contained in:
yyc12345 2024-02-11 16:38:06 +08:00
parent 02082bf99e
commit da71d5560c
13 changed files with 183 additions and 20 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 272 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 133 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 199 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

View File

@ -1,4 +1,30 @@
# 添加路面 # 添加路面
!!! info "制作中..." ## 开始生成
手册的这部分还在制作当中。稍安勿躁。
在3D视图中点击`Add - Floors`可展开添加机关菜单。菜单如下图所示。
![](../imgs/bme-adder.png)
点击菜单后可以在弹出的子菜单中查看所有受支持的路面类型。其名称和图标提示了它所要创建路面的样式与形状。
!!! info "BME是可扩展的"
BME的路面添加器是可扩展的菜单中的每一个项实际上都由一组JSON数据描述。您可以阅读[技术信息](./tech-infos.md)章节来了解我们是如何编写这些JSON的甚至您还可以根据你的需求自行扩展BME可创建的路面种类。
## 配置路面
点击其中一个路面类型将打开路面创建对话框这里我们展示的是Normal Platform平面平台如下图所示。在对话框里我们可以配置这个路面类型的各种属性例如长宽高等距离属性面的显示与否的属性等来定制它生成的几何模型以使其符合我们的要求。
![](../imgs/bme-adder-dialog.png)
在Normal Platform的对话框中我们首先可以看到它要求我们提供路面的长度宽度这决定了我们平台的大小下面还有对应的文字描述来帮助你理解这个属性具体是控制着什么。
然后它还需要我们提供这个平台的高度高度默认为5即Ballance中默认的路面高度大小小于5将创建类似“魔虬”地图中的薄路面大于5将创建类似“魔脓空间站”中非常高的路面墙体。
最后它指示我们需要配置这个路面哪些面需要显示。需要注意的是Top和Bottom指的是沿高度方向Z轴的顶面和底面而FrontBackLeftRight则是以头顶朝向-X轴眼睛朝向-Z轴俯视状态下的前后左右。您可能注意到这6个面按钮中间有一个透视的六面体实际上这六个面的选项的位置与这个透视六面体的六个面的位置是一一对应的。
## 小贴士
每个路面类型,其配置的条目数是不同的,因此对于不同路面类型,需要根据配置的提示文本来了解对应配置具体是做什么的。一些路面类型所需要设置的条目可能很多,另一些则根本没有配置条目。
路面类型配置的默认值被设置为创建此路面时最常用的值。每一次切换路面类型或重新创建时,都会将值重置为默认值。

View File

@ -36,6 +36,6 @@ BBP内置了一系列自定义图标以及其组件BME需要的用于描述
## 生成帮助文档 ## 生成帮助文档
虽然本项目会利用GitHub Page功能提供帮助文档但有时可能需要提供帮助文档的离线版本,本节将会介绍如何生成离线版本的帮助文档。 虽然本项目会利用GitHub Page功能提供帮助文档但有时可能需要提供帮助文档的离线版本,本节将会介绍如何生成离线版本的帮助文档。
首先需要通过pip安装`mkdocs`和`pymdown-extensions`。然后转到`docs`文件夹下,运行`mkdocs build --no-directory-urls`。运行命令后得到一个名为`site`的文件夹,其中就是可以离线浏览的帮助文档。 首先需要通过pip安装`mkdocs`和`pymdown-extensions`。然后转到`docs`文件夹下,运行`mkdocs build --no-directory-urls`。运行命令后得到一个名为`site`的文件夹,其中就是可以离线浏览的帮助文档。

View File

@ -12,8 +12,8 @@
* PS_FourFlame关卡开始的4火焰盘点全局唯一因此没有小节属性。 * PS_FourFlame关卡开始的4火焰盘点全局唯一因此没有小节属性。
* PE_Ballon关卡终点的飞船全局唯一因此没有小节属性。 * PE_Ballon关卡终点的飞船全局唯一因此没有小节属性。
* PC_TwoFlames小节的检查点。具有小节属性,但需要注意的是,其小节指的是其要检查哪个小节,例如指定小节号为1则表示它是第一小节的检查点即第二小节的开始通过后开启第二小节。 * PC_TwoFlames小节的检查点,具有小节属性。但需要注意的是,其小节属性指的是其要检查哪个小节,例如指定小节属性为1则表示它是第一小节的检查点即第二小节的开始通过后开启第二小节。
* PR_Resetpoint小节的重生点小节号表示它是哪个小节的重生点。因此当PC_TwoFlames和PR_Resetpoint成对出现时PR_Resetpoint总比PC_TwoFlames的标号小1。 * PR_Resetpoint小节的重生点具有小节属性。但需要注意的是小节属性表示它是哪个小节的重生点。由此可知当PC_TwoFlames和PR_Resetpoint成对出现时PR_Resetpoint总比PC_TwoFlames的标号大1。
!!! info "自动名称冲突检测" !!! info "自动名称冲突检测"
一部分物体在一张Ballance地图中名称是唯一的例如开头盘点与终点飞船有且只能有一个小节检查点与复活点同一小节只能存在一个等。 一部分物体在一张Ballance地图中名称是唯一的例如开头盘点与终点飞船有且只能有一个小节检查点与复活点同一小节只能存在一个等。
@ -24,8 +24,12 @@
在添加机关菜单中,`Nong Components`分类下的是脓机关的添加。我们只提供两类常用脓机关的添加:脓分和脓风扇。 在添加机关菜单中,`Nong Components`分类下的是脓机关的添加。我们只提供两类常用脓机关的添加:脓分和脓风扇。
### Nong Extra Point
脓分添加需要指定脓分的小节号和个数。并且会自动帮用户对脓分实现一个逐个旋转的效果,以让游戏内的脓分显示的更好看。 脓分添加需要指定脓分的小节号和个数。并且会自动帮用户对脓分实现一个逐个旋转的效果,以让游戏内的脓分显示的更好看。
### Nong Ventilator
脓风扇的添加同样要指定小节号和个数。不同的是我们提供了一些预设数值,这些预设数值构造的脓风扇可以恰好吹起木球或石球,如果你对这些预设数值不满意,仍可以自行输入数量。 脓风扇的添加同样要指定小节号和个数。不同的是我们提供了一些预设数值,这些预设数值构造的脓风扇可以恰好吹起木球或石球,如果你对这些预设数值不满意,仍可以自行输入数量。
!!! info "风扇阵列也可以" !!! info "风扇阵列也可以"
@ -35,14 +39,20 @@
在添加机关菜单中,`Series Components`分类下的是阵列机关的添加。我们只提供两类常用阵列机关的添加:浮板阵列和风扇阵列。 在添加机关菜单中,`Series Components`分类下的是阵列机关的添加。我们只提供两类常用阵列机关的添加:浮板阵列和风扇阵列。
### Tilting Block Series
浮板阵列需要提供小节号和浮板个数,并且还可以自由调整相邻浮板之间的间距,默认间距取自游戏内。 浮板阵列需要提供小节号和浮板个数,并且还可以自由调整相邻浮板之间的间距,默认间距取自游戏内。
### Ventilator Series
风扇阵列也需要提供小节号和风扇个数,然而它提供三维的偏移量,这样你就可以构建竖直的风扇阵列或水平的风扇阵列。默认偏移数值取自游戏内竖直风扇阵列的数值。 风扇阵列也需要提供小节号和风扇个数,然而它提供三维的偏移量,这样你就可以构建竖直的风扇阵列或水平的风扇阵列。默认偏移数值取自游戏内竖直风扇阵列的数值。
## 添加机关对 ## 添加机关对
在添加机关菜单中,`Components Pair`分类下的是机关对的添加。目前只有一种机关对:盘点对可添加。 在添加机关菜单中,`Components Pair`分类下的是机关对的添加。目前只有一种机关对:盘点对可添加。
### Sector Pair
盘点对需要你输入一个小节号它会为你自动生成盘点火与重生点机关对。例如输入1小节则会自动生成4火焰盘点火和第1小节的重生点输入2则会生成第1小节检查点和第2小节重生点以此类推。 盘点对需要你输入一个小节号它会为你自动生成盘点火与重生点机关对。例如输入1小节则会自动生成4火焰盘点火和第1小节的重生点输入2则会生成第1小节检查点和第2小节重生点以此类推。
!!! info "自动名称冲突检测" !!! info "自动名称冲突检测"

View File

@ -1,4 +1,48 @@
# 导入导出Virtools文档 # 导入导出Virtools文档
!!! info "制作中..." !!! warning "这是实验性内容"
手册的这部分还在制作当中。稍安勿躁。 原生导入导出Virtools文档是BBP插件的试验性内容它可能存在许多问题请参阅[报告问题](./report-bugs.md)章节来了解更多。当遇到问题时请及时汇报。BBP插件的作者不对因BBP插件问题导致的任何后果负责。
## 导入Virtools文档
点击`File - Import - Virtools File`可以导入Virtools文档。导入支持CMOVMONMO文件。点击后会弹出文件打开界面并在侧边栏展示导入设置。首先你需要选择导入的Virtools文档然后在侧边栏配置导入设置配置完导入设置后即可点击导入开始导入并等待Blender下方提示导入完成即可。
### 冲突解决选项
Conflict Options冲突解决选项章节指示了当导入器遇到物体名称重复的情况时该如何处理。分为4个等级分别针对Object物体Mesh网格Material材质Texture贴图。处理方式则有2种Rename重命名和Use Current使用当前。选择重命名后当遇到重复名称时将会自动为其添加名称后缀使其名称唯一化。而选择使用当前则会忽略从文件中导入此项转而使用Blender文档中已经存在的同名的项目。
!!! info "与Virtools冲突解决的不同"
相比较于在Virtools的冲突解决对话框BBP插件提供的冲突解决选项不支持替换功能同时其粒度也不支持精细到单个实例只能针对一整个类型进行设定。因此你无法单独为每一个冲突的实例设置不同的冲突解决方案。但目前这种设置已经能满足绝大对数的使用场景了。
冲突解决选项章节里的选项的默认值是通常导入时会选择的解决方案。当然针对特殊导入情况需要特殊设置,例如正在从外部导入一个从原版中导出的机关模型,则可能连材质选项都可以选择使用当前,而无需复制一份。正确使用冲突解决选项是制图经验所给予的,本手册不会对此进行教学。
### Virtools参数
众所周知Virtools使用基于系统的多字节字符编码来处理文档因而很容易出现所谓乱码问题。Blender本身不会出现乱码问题然而如果我们不能以正确的编码读取Virtools文档则当Virtools文档被导入Blender时其中存储的字符仍然可能会呈现乱码状态。Virtools ParamsVirtools参数章节的Encodings编码属性用于指定读取Virtools文档的编码。可以指定多个编码多个编码之间用`;`(分号)分隔。下面列出一些常用的编码:
* 1252Windows下Ballance所用的西欧编码
* 936Windows下中文Windows系统默认编码
* CP1252非Windows下Ballance所用的西欧编码
* CP936非Windows下中文默认编码
编码属性非常重要如果设置了错误的编码导入Blender的各类物体的名称会出现不可认知的情况
!!! warning "编码是一个平台相关的设定"
根据BBP的Virtools文档导入模块使用的底层库LibCmo的实现编码属性是一个平台相关的设定。在Windows下这里需要填写的是[Windows代码页](https://learn.microsoft.com/en-us/windows/win32/intl/code-page-identifiers)数字。而在其它操作系统下LibCmo使用iconv进行字符编码解码因此需要使用合法的[iconv编码标识符](https://www.gnu.org/software/libiconv/)。
## 导出Virtools文档
点击`File - Export - Virtools File`可以导出Virtools文档。点击后会弹出文件打开界面并在侧边栏展示导出设置。首先你需要选择导出的Virtools文档的位置然后在侧边栏配置导出设置配置完导出设置后即可点击导出开始导出并等待Blender下方提示导出完成即可。
### 导出目标
Export Target导出目标章节用于决定你需要将哪写物体导出到Virtools文档中。你可以选择导出一个集合或一个物体并在下面选择对应的集合或物体。需要注意的是选择集合的时候会将内部集合中的物体也一起导出即支持嵌套集合的导出。
### Virtools参数
Virtools ParamsVirtools参数章节与导入Virtools文档中的类似。Encodings编码属性决定了导出Virtools文档时所用的编码。
Global Texture Save Option全局贴图保存选项决定了那些设置了Use Global使用全局设定的贴图的真实保存方式。通常而言设置为Raw Data原始数据则可以100%保证保存的Virtools文档可以包含正确贴图但是其体积也可能会变大设置为External外部数据则可以尽可能减少文件大小但可能会出现导出的文档找不到贴图文件的问题。我们建议你在进行材质设置时就对每个材质单独指定应该如何保存而不是依赖全局选项来设置。这个选项是给那些依赖全局贴图保存选项的旧地图的再编辑来使用的。还需要注意的是尽管这个选项里有Use Global选项但请 **不要** 选择,否则会导致错误,因为显然你不能让一个全局选项再去使用全局选项的设置。
Use Compress使用压缩属性指定保存的文档是否压缩存储。压缩可以显著减少文档体积且在现代计算机平台上压缩所造成的性能损失几乎可以忽略不计。当选择使用压缩后一个额外的Compress Level压缩等级属性将会显示用于指定压缩的级别数值越高压缩率越大文件越小。

View File

@ -8,13 +8,13 @@ BBP对Blender支持的原则是支持当前最新的 **LTS** 版本,在最新
## 卸载旧插件 ## 卸载旧插件
如果您之前使用过BBP那么您需要首先卸载它。旧版的BBP通常被安装在下列的位置中 如果你之前使用过BBP那么你需要首先卸载它。旧版的BBP通常被安装在下列的位置中
* `Blender/3.6/scripts/addons/ballance_blender_plugin` * `Blender/3.6/scripts/addons/ballance_blender_plugin`
* `Blender/3.6/scripts/addons_contrib/ballance_blender_plugin` * `Blender/3.6/scripts/addons_contrib/ballance_blender_plugin`
* `Blender/3.6/scripts/addons/bbp_ng` * `Blender/3.6/scripts/addons/bbp_ng`
只需要删除这些文件夹(如果它们存在的话)即可完全卸载插件。路径中的`Blender`指代您的Blender安装位置。路径中的`3.6`是您安装的Blender的版本号需要根据您安装的版本进行调整,本手册均以`3.6`为例。 只需要删除这些文件夹(如果它们存在的话)即可完全卸载插件。路径中的`Blender`指代你的Blender安装位置。路径中的`3.6`是你安装的Blender的版本号需要根据你安装的版本进行调整,本手册均以`3.6`为例。
!!! info "`ballance_blender_plugin`和`bbp_ng`" !!! info "`ballance_blender_plugin`和`bbp_ng`"
`ballance_blender_plugin`是旧版BBP插件4.0版本前)的模块名,`bbp_ng`是新版BBP插件4.0版本后包括4.0版本)的模块名。为了保证用户确实删除了旧版插件,所以同时提供了这两者。 `ballance_blender_plugin`是旧版BBP插件4.0版本前)的模块名,`bbp_ng`是新版BBP插件4.0版本后包括4.0版本)的模块名。为了保证用户确实删除了旧版插件,所以同时提供了这两者。
@ -24,9 +24,9 @@ BBP对Blender支持的原则是支持当前最新的 **LTS** 版本,在最新
## 下载插件 ## 下载插件
可以通过[本工程的GitHub代码库的Release页面](https://github.com/yyc12345/BallanceBlenderHelper/releases)下载最新的插件。插件是以ZIP压缩包形式提供的。 可以通过[本工程的GitHub代码库的Release页面](https://github.com/yyc12345/BallanceBlenderHelper/releases)下载最新的插件。插件是以ZIP压缩包形式提供的。
此外,还可以在yyc12345提供的制图教程网盘中获得此插件 此外,还可以在yyc12345提供的制图教程网盘中获得此插件
* 中国特供:[百度网盘](https://pan.baidu.com/s/1QgWz7A7TEit09nPUeQtL7w?pwd=hf2u) 提取码hf2u位于`制图插件(新)`下) * 中国特供:[百度网盘](https://pan.baidu.com/s/1QgWz7A7TEit09nPUeQtL7w?pwd=hf2u) 提取码hf2u位于`制图插件(新)`下)
* 非中国:[Mega](https://mega.nz/#F!CV5SyapR!LbduTW51xmkDO4EDxMfH9w) (位于`Mapping`目录下) * 非中国:[Mega](https://mega.nz/#F!CV5SyapR!LbduTW51xmkDO4EDxMfH9w) (位于`Mapping`目录下)
@ -38,7 +38,7 @@ BBP对Blender支持的原则是支持当前最新的 **LTS** 版本,在最新
开启Blender选择`Edit - Preferences`,在打开的窗口中转到`Add-ons`选项卡,点击`Install...`按钮选择刚刚下载完毕的ZIP压缩包即可安装完成。若没有在列表中看到可选择刷新按钮或重启Blender。 开启Blender选择`Edit - Preferences`,在打开的窗口中转到`Add-ons`选项卡,点击`Install...`按钮选择刚刚下载完毕的ZIP压缩包即可安装完成。若没有在列表中看到可选择刷新按钮或重启Blender。
也可以选择手动安装插件(如果上述安装方法失败了的话),转到`Blender/3.6/scripts/addons`将下载好的ZIP压缩包内容解压到此文件夹下启动Blender即可在插件列表中找到BBP。 也可以选择手动安装插件(如果上述安装方法失败了的话),转到`Blender/3.6/scripts/addons`将下载好的ZIP压缩包内容解压到此文件夹下启动Blender即可在插件列表中找到BBP。
BBP插件位于`Community`类别下,名称为`Object: Ballance Blender Plugin`,找到后勾选名称左侧的勾即可启用插件。插件安装成功后的偏好设置页面如下图所示。 BBP插件位于`Community`类别下,名称为`Object: Ballance Blender Plugin`,找到后勾选名称左侧的勾即可启用插件。插件安装成功后的偏好设置页面如下图所示。

View File

@ -10,7 +10,7 @@
其一为技术信息章节已经阐述的制图链标准,在本插件中的名称为`YYC Tools Chains`。 其一为技术信息章节已经阐述的制图链标准,在本插件中的名称为`YYC Tools Chains`。
其二为[Imengyu/Ballance](https://github.com/imengyu/Ballance)所用命名标准,在本插件中的名称为`Imengyu Ballance`。 其二为[Imengyu/Ballance](https://github.com/imengyu/Ballance)所用命名标准,在本插件中的名称为`Imengyu Ballance`。
这些功能最终只会展示成功与否的一个概括性消息。如果需要详细查看某个物体为什么不能转换,请点击`Window - Toggle System Console`,插件在那里有更详细的输出。 这些功能最终只会展示成功与否的一个概括性消息。如果需要详细查看某个物体为什么不能转换,请点击`Window - Toggle System Console`,插件在那里有更详细的输出。
### Rename by Group ### Rename by Group

View File

@ -1,4 +1,81 @@
# 添加钢轨 # 添加钢轨
!!! info "制作中..." 在3D视图中点击`Add - Components`可展开添加钢轨菜单。菜单如下图左侧所示。
手册的这部分还在制作当中。稍安勿躁。
![](../imgs/rail-adder.png)
上图右侧则展示了一些机关添加的界面会在后续依次介绍它们右侧从上到下分别是添加Rail Section钢轨截面添加Straight Rail直钢轨添加Side Rail侧轨添加Arc Rail圆弧轨添加Spiral Rail螺旋轨
!!! info "非标准数据的钢轨"
BBP的钢轨添加菜单是为新手玩家快速添加钢轨而设计的并不是为老手添加钢轨而设计的。对于需要非标准数据的钢轨的情况例如具有非标准间距或非标准截面的钢轨你需要通过Blender自带的创建圆操作构建钢轨截面然后通过挤出桥接又或者螺旋修改器生成整个钢轨。在这样的创作过程中你可以随意控制每个步骤的所有参数以满足你对钢轨参数的特殊需求。
!!! info "钢轨数据的来源"
钢轨添加菜单的所使用的钢轨各类参数来源于游戏中的实际测量和Ballance社区中多位制图玩家十几年来总结的经验数据。
钢轨截面半径与轨距由多年制图经验总结和测量所得。侧轨倾斜数据来源BallanceBug计算。单双轨转换下沉数据来源失衡之梦计算。螺旋轨间距来自第九关和第十三关测量。
## 钢轨截面
在添加机关菜单中,`Sections`分类下的是钢轨截面的添加。钢轨截面是钢轨的轮廓,钢轨截面的创建通常是各类异形钢轨的创建的开始步骤,例如通过放样,挤出等操作制作钢轨。
### Rail Section
钢轨截面创建一个钢轨截面,你可以在面板中选择创建一个单轨或双轨截面。
当创建单轨截面时,会自动将八边形的钢轨截面的平头朝上,双轨截面则不会。如果你需要修改这种行为,你需要在创建后进入编辑模式,手动旋转钢轨截面顶点使其钢轨截面的平头或尖头朝上。
### Transition Section
单双轨转换截面将创建一个适用于单双轨转换的钢轨截面。这个轨道截面的创建不需要指定任何参数。
## 直线钢轨
在添加机关菜单中,`Straight Rails`分类下的是直线钢轨的添加。
### Straight Rail
直钢轨是一段直来直去的钢轨。创建直钢轨需要为其指定Length长度。你也可以选择创建直的双轨或单轨。
当创建单轨时,与截面类似,会自动将钢轨截面的平头朝上,修改这一行为的操作则也是创建后进入编辑模式再旋转即可。
直钢轨的创建还支持封盖属性这些特性由位于Rail Cap钢轨封盖下的Start Cap始端封盖和End Cap末端封盖选项控制勾选后对应端将进行封盖。封盖即为钢轨的端面自动补面并正确处理其法线问题这通常用于确保钢轨与其它路面或物体接触的部分的美观钢轨与钢轨之间的连接端无需封盖。
### Transition Rail
单双轨转换轨通常可被视为是Transition Section创建的进阶使用将Transition Section创建的截面挤出并处理好法线问题即可得到此选项创建的结果。创建单双轨转换轨需要为其指定Length长度其也支持封盖属性。
### Side Rail
侧轨创建首先需要指定Side Type侧轨类型可以选择Normal纸球木球用侧轨或Stone Specific石球专用侧轨。纸球木球用侧轨就是通常意义上的侧轨石球不可以通过。石球专用侧轨是倾斜度更大的侧轨石球也可以通过当然纸球和木球也可以。
除了侧轨类型外侧轨创建也需要Length长度和封盖属性。
## 曲线钢轨
在添加机关菜单中,`Curve Rails`分类下的是曲线钢轨的添加。
### Arc Rail
圆弧轨首先需要指定Angle角度和Radius半径表示这个圆弧轨将会以多少的半径转过多少角度。通常来说角度以90度180度270度比较常见当然也可以指定任意度数。半径则通常按需调整。对于双轨圆弧轨半径是圆弧轨旋转圆心到双轨截面两轨中心连线的中点的距离对于单轨圆弧轨半径是圆弧轨旋转中心到单轨截面的中心的距离。
圆弧轨的Steps步数步数表示这个圆弧轨的分段数数字越大圆弧轨看起来越平滑相对的顶点也会更多对存储空间和渲染的要求也越高因此需要选择一个合理的数值。
圆弧轨同样支持双轨单轨选择,可以创建单轨圆弧轨和双轨圆弧轨。也支持封盖属性。
### Spiral Rail
螺旋轨也就是螺旋双轨其与圆弧轨类似需要指定Radius半径表示其旋转半径但不需要指定角度因为它总是旋转一圈。
螺旋轨有Iterations迭代属性表示这个螺旋轨将要螺旋上升几圈。Screw螺距属性则表示每一个迭代之间的距离是多少。
螺旋轨也需要设置Steps步数属性含义与圆弧轨一致。但需要注意的是步数指的是每一个迭代内的步数个数并不是总体的步数。因此调整迭代属性的时候不需要再调整步数属性。
螺旋轨也有封盖属性。
### Side Spiral Rail
侧边螺旋轨,与螺旋轨类似,但是球是沿侧边滚动的,类似于侧轨。
侧边螺旋轨没有螺距属性,因为侧边螺旋轨在设计上,相邻的旋进是共用一条边的,因此螺距是固定的。
侧边螺旋轨设定中的Radius半径Iterations迭代和Steps步数属性含义均与螺旋轨一致。螺旋轨也有封盖属性。

View File

@ -12,7 +12,7 @@ BBP不是完美的由于BBP的Virtools文件导入导出模块是由C++编写
## 哪部分出错了 ## 哪部分出错了
对于BBP插件而言如果你在Python异常输出中观察到类似于`BMap operation failed`的字样,或者在`Blender/3.6/scripts/addons/bbp_ng/PyBMap`文件夹下观察到了`IronPad.log`文件则说明BBP插件的由C++编写的BMap部分出错了**您需要立即保存您当前的Blender文档并退出Blender。** 因为此时插件已处于非正常状态,您不应继续任何操作。 对于BBP插件而言如果你在Python异常输出中观察到类似于`BMap operation failed`的字样,或者在`Blender/3.6/scripts/addons/bbp_ng/PyBMap`文件夹下观察到了`IronPad.log`文件则说明BBP插件的由C++编写的BMap部分出错了**你需要立即保存你当前的Blender文档并退出Blender。** 因为此时插件已处于非正常状态,你不应继续任何操作。
如果并没有上述情况那么这就只是普通的Python代码执行错误不需要过度担心但错误仍然是致命的建议做完所有必要的操作后退出Blender并报告错误。 如果并没有上述情况那么这就只是普通的Python代码执行错误不需要过度担心但错误仍然是致命的建议做完所有必要的操作后退出Blender并报告错误。
@ -26,4 +26,4 @@ BBP不是完美的由于BBP的Virtools文件导入导出模块是由C++编写
首先你需要详细描述你是如何出发这个错误的,这个错误有什么结果。如果可以上传导致错误的文档,请尽量上传(如果不方便公开发布,可以通过邮件等私有渠道发送给作者)。 首先你需要详细描述你是如何出发这个错误的,这个错误有什么结果。如果可以上传导致错误的文档,请尽量上传(如果不方便公开发布,可以通过邮件等私有渠道发送给作者)。
还需要提供Blender控制台中输出的Python堆栈报告使用`Window - Toggle System Console`打开控制台。如果你的错误是BMap部分的错误还需要提供`Blender/3.6/scripts/addons/bbp_ng/PyBMap`文件夹下的`IronPad.log`和`IronPad.dmp`文件以方便开发者定位错误。 还需要提供Blender控制台中输出的Python堆栈报告使用`Window - Toggle System Console`打开控制台。如果你的错误是BMap部分的错误还需要提供`Blender/3.6/scripts/addons/bbp_ng/PyBMap`文件夹下的`IronPad.log`和`IronPad.dmp`文件以方便开发者定位错误。

View File

@ -21,9 +21,9 @@ BBP还在Blender的其它菜单提供了对Virtools组的访问具体内容
可以在`Virtools Material`面板中设置材质属性就像在Virtools中操作一般。`Virtools Material`面板中所有的材质参数均为Virtools中材质参数的映射将准确地反映到最后保存的Virtools文档中。 可以在`Virtools Material`面板中设置材质属性就像在Virtools中操作一般。`Virtools Material`面板中所有的材质参数均为Virtools中材质参数的映射将准确地反映到最后保存的Virtools文档中。
`Virtools Material`面板提供了预设功能,点击顶部的`Preset`按钮即可开始进行预设。预设功能允许用户使用一些预设的材质设置,例如路面顶面,侧面的材质数据等,方便使用。需要注意的是,使用预设不会影响材质的贴图选项,当应用预设后,仍然需要手动设置材质的贴图。 `Virtools Material`面板提供了预设功能,点击顶部的`Preset`按钮即可开始进行预设。预设功能允许用户使用一些预设的材质设置,例如路面顶面,侧面的材质数据等,方便使用。需要注意的是,使用预设不会影响材质的贴图选项,当应用预设后,仍然需要手动设置材质的贴图。
`Virtools Material`面板同样提供把`Virtools Material`面板中的材质数据反应到Blender材质上的功能以在Blender中获得可视的效果。点击顶部的`Apply`按钮即可执行此功能。当在Blender中保存Virtools文档时Virtools文档中的材质数据将从`Virtools Material`面板中指定的数值获取而不会从Blender材质中获取。这意味一个正确的材质设置过程是先在`Virtools Material`面板中编辑材质参数,然后使用`Apply`按钮将其反映到Blender材质上而不是直接去编辑Blender材质。 `Virtools Material`面板同样提供把`Virtools Material`面板中的材质数据反应到Blender材质上的功能以在Blender中获得可视的效果。点击顶部的`Apply`按钮即可执行此功能。当在Blender中保存Virtools文档时Virtools文档中的材质数据将从`Virtools Material`面板中指定的数值获取而不会从Blender材质中获取。这意味一个正确的材质设置过程是先在`Virtools Material`面板中编辑材质参数,然后使用`Apply`按钮将其反映到Blender材质上而不是直接去编辑Blender材质。
TODO: 添加有关贴图选择按钮的帮助内容 TODO: 添加有关贴图选择按钮的帮助内容
@ -32,3 +32,9 @@ TODO: 添加有关贴图选择按钮的帮助内容
TODO... TODO...
![](../imgs/virtools-texture.png) ![](../imgs/virtools-texture.png)
## Virtools网格
TODO...
![](../imgs/virtools-mesh.png)