Seamless Satmap Tool - Til-Weimann/tilw-terrain-tools GitHub Wiki
Introduction
This tool allows Arma Reforger modders to easily create accurate satmaps for their terrains.
Features:
- Takes material parameters into account for full fidelity (color + UV scale)
- Manual work is minimized, no more silly texture screenshots
- No blending artifacts (the other satmap tool has them)
[!NOTE] If this tool helped you, consider linking it in your mod description, so others can find out about it.
Example: Satmap created using the Seamless Satmap Tool
Usage
- Click the green "<> Code" button in the top right of this repository, and select "Download ZIP".
- From the ZIPs tilw-terrain-tools-master folder, extract the "SeamlessSatmapTool" folder to a place of your liking.
- Open your terrain, and go into the Terrain Tools "Paint" tab. In the bottom, change the export folder to SeamlessSatmapTool/masks/, then hit export.
- While you're there, switch to the TTs "Info & Diags" tab and note down what it says after "Total Size" under "Heightmap".
- If you are using any custom terrain materials, go browse to them, open the folder in Windows Explorer (right click) and copy these .emat files (including any custom textures they may point to, as PNG or JPG) into SeamlessSatmapTool/data/.
- Run SeamlessSatmapTool/requirements.bat to install required Python packages, wait until it's finished then close it. You of course need to install Python before if you don't have it yet (make sure to tick "Add Python to environment variables" during installation).
- You should now be ready to run generate.py - it will prompt you for terrain dimensions in meters, you can look these up in the Terrain Tools "Info & Diags" tab under Heightmap, Total Size.
- If you did everything correctly, the tool should generate a satmap and save it as SeamlessSatmapTool/RESULT.png. When importing it, as usual make sure "Linear Colorspace" is not ticked.
Q&A
The tool can't find a material.
If it's a custom material, make sure you actually copied it to the tool.
The tool can't find a texture.
Again, if it's a custom texture make sure to copy it over as PNG/JPG.
If not, perhaps a custom material is using a texture the tool does not know about (it knows all middle maps from Reforger 1.2). In that case, screenshot the texture and save it to the data folder with the expected name.
A third issue potential issue could be that a material references a texture by an outdated name, in that case you'd have to rename this texture.
The python script doesn't run correctly, but automatically closes before I can see what's wrong.
In the folder, click the top bar like when copying the file path, type "cmd", press enter. Now enter "generate.py" to run the script. This way, the window will always stay open and allow you to read any errors.
The requirements.bat script displays this error: 'pip' is not regognized as an internal or external command
You probably did not tick "Add Python to environment variables" when installing Python. Simply modify your existing installation by re-running the installer.
I need help with my general Python setup, I can't get it to work.
I'll gladly help with things related to the actual script, but I will not help you with installing Python, use your favorite search engine for this.
I have a question, how do I best contact you?
On Discord, my name is tilw. I am active on the ARMA discord.