A utility to convert from Celestia's .cmod files (binary and ASCII formats are supported) to Wavefront .obj/.mtl files. This may be useful for importing them into 3D editor software that does not have built-in support for the Celestia format.
Note that the features supported by the two file formats differ: if the .cmod file uses these features, the feature will be ignore. Such features include, but are not limited to:
- Point sprite sizes: sprites are output as points instead.
- Separate UV-mapping for diffuse/emissive/specular textures: only one set of texture coordinates is used.
- Normal maps.
Note that Celestia-specific features, such as the directory handling (in particular, when importing into Blender, texture files must be located in the same directory as the .obj and .mtl files), and asset filename wildcard extensions are not altered. This may require manual alterations to the .mtl file. Spaces in asset names will cause problems.
The application runs on the command line, taking the input cmod file as a
first parameter. By default, the .obj and .mtl files will be output to the
same directory, this can be changed using the --output-file and
--output-mtl options. For details, run with the --help option.
cmodconvert input.cmod --output-obj=output.obj --output-mtl=output.mtl
If the output parameters are not supplied, the default is to use the same filename as the input with the extensions changed.
Building the application requires a recent version of the Rust compiler. The application should build with stable Rust, the packaged version uses unstable compiler options to reduce the file size.