Texture-Transform/Cli

A command line tool that can be used to convert classic Diffuse-Specular-Glossiness textures to the more common Base-Metallic-Roughness format.

Running Texture-Transform

To run Texture-Transform, you need to specify the command, which currently is only “specgloss2pbr” and then the input directory and output directory.

texture-transform specgloss2pbr ../NovaBasilS23_specGloss ../NovaBasilS23_specGloss/output --overwrite=true

If you want to overwrite existing files, use the --overwrite=true option.

Input Textures

Texture-transform requires 3 textures to exist in the input directory, a diffuse map, a reflection/specular map and a glossiness map.

Texture-transform interprets the input texture roles by looking for filenames that it can understand. It looks for the last term in the filename prior to the extension. So for example, with this file name:

7440-NovaBasilS23_choice2754-diffuse.png

It will interpret this texture as a “diffuse” texture.

The understood input texture names are:

• “diffuse” - diffuse map (color)
• “specular”, “spec”, “reflect”, “reflection” - reflection map (color)
• “glossiness”, “gloss” - glossiness map (greyscale)

Output Textures

Texture-transform will write out 3 textures when doing the specgloss2pbr transform. They are:

• “base” - the PBR base/albedo texture (color)
• “metallic” - the PBR metallic texture (greyscale)
• “roughness” the PBR roughness map (greyscale)