Bi-directional image projection converter. Converts images between equirectangular and mercator projections.
Features a fast GPU and a slower CPU conversion implementations:
- The GPU version uses moderngl to transform the image using shaders and then saves it using Pillow
- The CPU version simply uses Pillow to modify every pixel individually
This project therefore contains working examples of Python and GLSL conversion code. Feel free to borrow them and translate them to your language/project.
- Install Python 3.11+
- Clone the repository
- Install requirements
pip install -r requirements.txt
python convert.py input [--to_equirectangular] [--to_mercator] [--nearest] [--cpu]| Parameters | |
|---|---|
| input | The input file path. |
| ‑‑to_equirectangular | Convert the image to the Equirectangular projection. |
| --to_mercator | Convert the image to the Mercator projection. |
| --nearest | Use nearest sampling for stretching that will occur due to change of aspect ratio. Only used by GPU rendering. |
| --cpu | Use the CPU rendering implementation. Much slower and doesn't support linear sampling. |
# Convert merc.png (mercator) to the equirectangular projection
python convert.py merc.png --to_equirectangular
# Convert equi.png (equirectangular) to the mercator projection
python convert.py equi.png --to_mercatorYou can use the Converter class directly in Python. Check out the demo script to see how to run conversions from code.
If anyone wants to transform this into a functional, publishable package, feel free to fork the project and publish it. I don't have enough experience doing that and can't imagine many people will use this thing to make the extra effort worthwhile.