{"id":20376219,"url":"https://github.com/mrglaster/transformers-normal-maps-converter","last_synced_at":"2026-05-09T08:09:57.845Z","repository":{"id":153693299,"uuid":"592256999","full_name":"mrglaster/transformers-normal-maps-converter","owner":"mrglaster","description":"Convert the normal maps used in the game Transformers: Fall of Cybertron to the Mikk format","archived":false,"fork":false,"pushed_at":"2023-01-26T09:49:02.000Z","size":1868,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-04T21:41:51.123Z","etag":null,"topics":["3dmodelling","blendmodes","bumpmap","color-transfer","colortrans","game-design","game-development","normal-mapping","normal-maps","normalmap","pillow","python","python3","transformers","transformers-models","videogame"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrglaster.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-23T10:31:40.000Z","updated_at":"2023-01-29T12:06:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"5dd64a70-28c3-4dbe-ad1c-ebd19408659a","html_url":"https://github.com/mrglaster/transformers-normal-maps-converter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mrglaster/transformers-normal-maps-converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrglaster%2Ftransformers-normal-maps-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrglaster%2Ftransformers-normal-maps-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrglaster%2Ftransformers-normal-maps-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrglaster%2Ftransformers-normal-maps-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrglaster","download_url":"https://codeload.github.com/mrglaster/transformers-normal-maps-converter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrglaster%2Ftransformers-normal-maps-converter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32811673,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3dmodelling","blendmodes","bumpmap","color-transfer","colortrans","game-design","game-development","normal-mapping","normal-maps","normalmap","pillow","python","python3","transformers","transformers-models","videogame"],"created_at":"2024-11-15T01:36:20.378Z","updated_at":"2026-05-09T08:09:57.814Z","avatar_url":"https://github.com/mrglaster.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"### What is this utility for? \n\nThe 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.\n\n\n![alt text](https://github.com/mrglaster/normal-maps-converter/blob/main/readme_images/demo.png)\n\n### How to use it?\n\n1) Install [Python 3.X](https://www.python.org/downloads/)\n2) Install required libraries with command\n\n```pip install -r requirements.txt```\n\nor\n\n```\npip install blend_modes==2.1.0 colortrans==1.0.0 numpy==1.24.0 Pillow==9.4.0\n```\n\n3) 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).\n\nExaple:\n\n```\nnormals_processor.py -xnormal RB_AirRaid_Chest_TEXSET_Color_NormX.tga -ynormal RB_AirRaid_Chest_TEXSET_Masks_NormY.tga\n```\n\nSecond 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```\nAs the default postfixes utility uses ```_Color_NormX```  and ```_Masks_NormY```. You can change them [if necessary] by command line arguments ```-xnpostfix```  and ```-ynpostfix```\n\nExample: \n\n```\nnormals_processor.py -texfolder C:\\Users\\mrglaster\\Desktop\\test -xnpostfix _NormX -ynpostfix _NormY\n```\n\n### Command Line Arguments \n\n| Full Argunent Name\u003cbr\u003e | Short Argument Name\u003cbr\u003e | Type | Default Value\u003cbr\u003e   | Description                                                                               |\n| ---------------------- | ----------------------- | ---- | ------------------- | ----------------------------------------------------------------------------------------- |\n| \\--x_normals_file      | \\-xnormal               | str  | None                | Path to X normals file                                                                    |\n| \\--y_normals_file\u003cbr\u003e  | \\-ynormal               | str  | None                | Path to Y normals file                                                                    |\n| \\--textures_folder     | \\-texfolder             | str  | None                | Path to folder containing X and Y normals files                                           |\n| \\--x_normals_postfix   | \\-xnpostfix             | str  | _Color_NormX        | Postfix for X normals. It will be used if  'you work with multiple textures in one folder |\n| \\--y_normals_postfix   | \\-ynpostfix             | str  | _Masks_NormY        | Postfix for Y normals. It will be used if  'you work with multiple textures in one folder |\n| \\--output_file         | \\-ofile                 | str  | results//result.png | Name of the output file                                                                   |\n| \\--output_folder       | \\-ofolder               | str  | results             | Name of the folder in which results will be 'saved                                        |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrglaster%2Ftransformers-normal-maps-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrglaster%2Ftransformers-normal-maps-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrglaster%2Ftransformers-normal-maps-converter/lists"}