This is a plugin for Virtools, which mainly serves Ballance mapping and other Ballance development.
Currently only contains the basic functions, the rest more useful functions will be developed in future versions.
The BM file standard used can be found in here(Chinese only).
The tools chain standard used and the format of the files in the BMMeshes
folder can be found in here(Chinese only).
Only supports Virtools 3.5
-
Import BM file: Import BM file. It should be noted that in order to ensure compatibility, the import operation will forcibly separate each vertices. The result of this operation is that the number of vertices will always be three times the number of faces, and each connected vertices will be Repeat, so the mesh size will increase.
-
Export BM file: Export BM file, you can choose to export by object, group, and all. It should be noted that when exporting all, a Virtools default 3D object will also be exported, but it only needs to be deleted when importing again.
-
Fix texture: This is a texture restoration in a broad sense, not just limited to the materials exported from Blender. This menu will repair material errors according to the texture file referenced by the material. This function is only to repair the error caused by the incomplete implementation of the early BM file import and export function. The BM import and export function is now complete. Using the latest version of the import and export tool, most materials do not need this option to repair.
- Auto grouping: automatic grouping, the grouping principle is based on the tools chain standard.
- Grouping detector: Grouping detector, incomplete.
Add shadow attributes to all objects in the Shadow group.
- Export to csv: Export the data in the specified table into csv format, by calling
WriteElements
. - Import to csv: Import csv data into the specified table, by calling
LoadElements
. - Clean all data: clear the data of the specified table.
Save the current document in NMO format with IC.
Convert the encoding which used in current document's multi-byte text. Used for garbled repair.
- External texture folder: Please fill in the Texture directory of Ballance, the plug-in will call the external texture file from this directory (the texture file originally with Ballance).
- No component group name: Objects in this group will be forced to be set as non-Component. If left blank, this function is not needed.
- Omitted material prefix: The name prefix of material which will be processed in Fix texture. This options may be useful for keeping some special materials configurated by yourself.
- zlib:Please fetch the latest version, then compile
zlibvc
project withReleaseWithoutAsm
mode via the project file located incontrib\vstudio\vc14
. You may need to change some compile parameters if you use other compilers or project files. - Virtools 3.5 SDK:We suggest to install full Virtools Dev 3.5 environment if you want to do some debugging.
First, you need open BallanceVirtoolsHelper.props
(via text editor or Visual Studio). Then you need to change all macro within this file and point them to correct folder(without slash).
VIRTOOLS35_PATH
:Point to Virtools install path. You should finddevr.exe
in this folder.ZLIB_PATH
:Point to yout fetched zlib project.
Now, you can pick a proper project configuration to compile this plugin. At the same time, you should copy your built zlibwapi.dll
to Virtools root path.
In addition, the files that need to be deployed in the BMMeshes
folder under the Virtools root directory are shared with another project of mine, which can be found in here found. You need to copy it manually.
Manually compile the project and install it. But this is not recommended, because the current latest commit may contain many bugs.
The recommended method is to find the latest stable version from the Release on the GitHub page and unzip it directly to the root directory of Virtools after downloading. If the same name or folder coverage appears, click Allow.