Using SuperBMD

This article describes how to use SuperBMD, a program which can convert between common 3d model files (.dae / .fbx / .obj )

Conversion: .bmd -> .dae
The basic usage of SuperBMD is to drag n drop the desired model onto SuperBMD.exe. In the .bmd to .dae conversion, it will dump a .dae file, the textures (including mipmaps), and material and texture data .json files in the same directory as the original .bmd file. Usually, this .dae file is then imported into a CAD software such as 3ds Max. The .json files will have the names _materials.json and _texheaders.json. If using the command line, use the instruction

SuperBMD.exe 

When importing into a cadding software, if asked, input with the units as meters. This will ensure correct scaling of the model.

The .json files
There are two .json files that are created with .bmd -> .dae conversion. One of them defines custom material data and the other defines custom texture data. They are described in more detail here.

Conversion: not .bmd -> .bmd
SuperBMD can convert .obj, .dae, and .fbx files, and their associated textures, to .bmd.

The basic usage of SuperBMD in this direction is to drag n drop the model onto SuperBMD.exe, and a .bmd of the same name will appear in the directory of the original file. The corresponding .bat file would be SuperBMD.exe  

Custom Materials / Texture Data
To have custom materials, you must specify a material data .json file and texture data .json data files. These files take the format of the material and texture data .json files from .bmd -> .dae conversion. The command line instruction SuperBMD.exe   --mat material_data.json --texheader texture_data.json will specify these files. The material_data.json and texture_data.json files can any filename, as long as they have the extension .json.

Additional Features

 * --rotate, which rotates the model poster-like for conversion from not .bmd -> .bmd conversion.
 * --nosort, which helps with models exported from Blender.
 * Mipmaps
 * Each image with mipmaps must have dimensions that are a power of 2. Each successive mipmap must be a quarter the size of the next larger one.
 * The base image should be named normally, and each successive mipmap should be named _mip#, with the # starting a 1 for the first mipmap.

Common Errors
STILL IN PROGRESS - PLEASE ADD IF YOU HAVE ANY COMMON ISSUES

{| class="wikitable"