Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/swift502/equimercconverter
Convert equirectangular and mercator image projections
https://github.com/swift502/equimercconverter
converter equirectangular glsl mercator moderngl projection python
Last synced: about 2 months ago
JSON representation
Convert equirectangular and mercator image projections
- Host: GitHub
- URL: https://github.com/swift502/equimercconverter
- Owner: swift502
- License: mit
- Created: 2024-02-02T14:25:15.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-09-09T11:05:06.000Z (4 months ago)
- Last Synced: 2024-09-09T13:12:07.138Z (4 months ago)
- Topics: converter, equirectangular, glsl, mercator, moderngl, projection, python
- Language: Python
- Homepage: https://jblaha.art/projects/projection-converter/
- Size: 31.3 MB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Equirectangular-Mercator Projection Converter
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](https://github.com/moderngl/moderngl) to transform the image using shaders and then saves it using Pillow.
- The CPU version simply uses [Pillow](https://github.com/python-pillow/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.
## Setup
1. Install [Python 3.11+](https://www.python.org/downloads/)
1. [Clone the repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
1. Install requirements
```
pip install -r requirements.txt
```
## Usage
### CLI
```shell
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. |
#### Examples
```shell
# 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_mercator
```
### Python
You can use the Converter class directly in Python. Check out the [demo script](demo.py) to see how to run conversions from code.
## Python package
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.