Skip to content
This repository has been archived by the owner on May 11, 2024. It is now read-only.

Latest commit

 

History

History
80 lines (47 loc) · 4.14 KB

README_ZH.md

File metadata and controls

80 lines (47 loc) · 4.14 KB

Ballance Virtools Helper

English version

简介

这是一个用于Virtools的插件,其主要是服务于Ballance制图以及其他方面的开发。
目前仅仅包含比较基本的功能,其余的更多有用的功能将在未来版本中进行开发。

技术信息

使用的BM文件标准可以在这里查找。
使用的制图链标准以及BMMeshes文件夹下的文件的格式可以在这里查找。
仅支持Virtools 3.5

功能介绍

Ballance Mapping

BM

  • Import BM file:导入BM文件,需要注意的是,为了保证兼容性,导入操作会强行分离各个顶点,这种操作的结果就是顶点个数将永远是面数的三倍,且各个相接顶点会重复,增大网格体积。
  • Export BM file:导出BM文件,可以选择按物体,按组,以及全部导出。需要注意的是,全部导出时,一个Virtools默认的3D物体也会被导出,不过只需要删除即可。
  • Fix texture:这是一个广义上的材质修复,不仅仅局限于从Blender导入进Virtools时出现的材质问题,根据材质引用的贴图文件来修复材质的错误。此功能仅是修复早期BM文件实现不完全时的错误,BM现在已经完善,使用最新版的导入导出工具,大多数材质无需此选项来进行修复了。

Group

  • Auto grouping:自动归组,归组原则基于制图链标准。
  • Grouping detector:归组检测器,未完成。

Add Shadow

为位于Shadow组中的所有物体加上影子属性。

Ballance Script

CKDataArray

  • Export to csv:将指定表中的数据导出成csv格式,通过调用WriteElements实现
  • Import to csv:导入csv数据到指定表中,通过调用LoadElements实现
  • Clean all data:清空指定表的数据

Ballance Misc

Export as special NMO

将当前文档保存成为具有IC的NMO格式。

Convert encoding

转换当前文档中的多字节文本所用的编码。用于乱码修复。

Plugin settings

  • External texture folder:请填写为Ballance的Texture目录,插件将从此目录下调用外置贴图文件(即Ballance原本带有的贴图文件)
  • No component group name:处于此组中的物体将被强制指定为非Component。如果留空则表示不需要这个功能。
  • Omitted material prefix:在Fix texture中需要被忽略的材质的名字的前缀。此选项在保留由您特殊配置的材质上非常有效。

编译与调试

SDK

  • zlib:请拉取最新的版本,然后使用contrib\vstudio\vc14中的项目配置文件,以ReleaseWithoutAsm配置编译zlibvc项目。如果您使用其他版本的编译器,您可能需要在编译选项中调整某些内容以让编译通过。
  • Virtools 3.5 SDK:如果您还需要进行调试,我们事实上更建议您安装完整的Virtools Dev 3.5环境。

编译

首先,您需要打开BallanceVirtoolsHelper.props文件(使用文本编辑器或者Visual Studio的配置器均可)。您需要修改其中的所有宏定义,将其指向正确的目录,这些目录最后都不需要附加斜杠。

  • VIRTOOLS35_PATH:指向Virtools安装的根目录,您在此目录中应该能找到devr.exe
  • ZLIB_PATH:指向您拉取的zlib的根目录。

然后您可以选择合适的项目配置进行编译。同时您还需要将您编译的zlib的zlibwapi.dll复制到Virtools的根目录下。
此外,需要被部署在Virtools根目录下的BMMeshes文件夹内的的文件与我的另一个工程共享,可以在这里找到。您需要手动复制它。

安装

手动编译工程并安装。但不建议这么做,因为当前最新的Commit可能包含很多bug。

推荐的方法是从GitHub页面的Release中查找最新的稳定版本,下载后直接解压到Virtools根目录即可,如果出现同名或者文件夹覆盖,点击允许即可。