https://github.com/mrglaster/transformers-normal-maps-converter
Convert the normal maps used in the game Transformers: Fall of Cybertron to the Mikk format
https://github.com/mrglaster/transformers-normal-maps-converter
3dmodelling blendmodes bumpmap color-transfer colortrans game-design game-development normal-mapping normal-maps normalmap pillow python python3 transformers transformers-models videogame
Last synced: 22 days ago
JSON representation
Convert the normal maps used in the game Transformers: Fall of Cybertron to the Mikk format
- Host: GitHub
- URL: https://github.com/mrglaster/transformers-normal-maps-converter
- Owner: mrglaster
- Created: 2023-01-23T10:31:40.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-01-26T09:49:02.000Z (over 3 years ago)
- Last Synced: 2025-03-04T21:41:51.123Z (about 1 year ago)
- Topics: 3dmodelling, blendmodes, bumpmap, color-transfer, colortrans, game-design, game-development, normal-mapping, normal-maps, normalmap, pillow, python, python3, transformers, transformers-models, videogame
- Language: Python
- Homepage:
- Size: 1.78 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### What is this utility for?
The utility was designed to convert the normal maps used in the game [Transformers: Fall of Cybertron](https://en.wikipedia.org/wiki/Transformers:_Fall_of_Cybertron) from its original format to the Mikk format, which is easier to work with and is supported by many 3D modeling software and more.
### How to use it?
1) Install [Python 3.X](https://www.python.org/downloads/)
2) Install required libraries with command
```pip install -r requirements.txt```
or
```
pip install blend_modes==2.1.0 colortrans==1.0.0 numpy==1.24.0 Pillow==9.4.0
```
3) The utility supports two modes of operation: first, we feed norm_x and norm_y textures as input, optionally write where the file will be saved (as a default setting, this is the results folder in the project folder).
Exaple:
```
normals_processor.py -xnormal RB_AirRaid_Chest_TEXSET_Color_NormX.tga -ynormal RB_AirRaid_Chest_TEXSET_Masks_NormY.tga
```
Second option, we specify the path to the folder where the norm_x and norm_y texture pairs are stored. For the program to work correctly, X and Y must have the same base names, only postfixes must differ. So, that the program correctly determines the pair, the textures must have the following naming format: ```mySuperTextureName_NormX.png``` and ```mySuperTexture_NormY.png```
As the default postfixes utility uses ```_Color_NormX``` and ```_Masks_NormY```. You can change them [if necessary] by command line arguments ```-xnpostfix``` and ```-ynpostfix```
Example:
```
normals_processor.py -texfolder C:\Users\mrglaster\Desktop\test -xnpostfix _NormX -ynpostfix _NormY
```
### Command Line Arguments
| Full Argunent Name
| Short Argument Name
| Type | Default Value
| Description |
| ---------------------- | ----------------------- | ---- | ------------------- | ----------------------------------------------------------------------------------------- |
| \--x_normals_file | \-xnormal | str | None | Path to X normals file |
| \--y_normals_file
| \-ynormal | str | None | Path to Y normals file |
| \--textures_folder | \-texfolder | str | None | Path to folder containing X and Y normals files |
| \--x_normals_postfix | \-xnpostfix | str | _Color_NormX | Postfix for X normals. It will be used if 'you work with multiple textures in one folder |
| \--y_normals_postfix | \-ynpostfix | str | _Masks_NormY | Postfix for Y normals. It will be used if 'you work with multiple textures in one folder |
| \--output_file | \-ofile | str | results//result.png | Name of the output file |
| \--output_folder | \-ofolder | str | results | Name of the folder in which results will be 'saved |