Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/curegit/eqlm
Simple CLI tool to spatially equalize image luminance
https://github.com/curegit/eqlm
brightness image-manipulation image-processing luminance opencv saturation
Last synced: 21 days ago
JSON representation
Simple CLI tool to spatially equalize image luminance
- Host: GitHub
- URL: https://github.com/curegit/eqlm
- Owner: curegit
- License: agpl-3.0
- Created: 2024-02-10T16:49:54.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-28T13:25:18.000Z (4 months ago)
- Last Synced: 2025-01-23T02:37:04.136Z (27 days ago)
- Topics: brightness, image-manipulation, image-processing, luminance, opencv, saturation
- Language: Python
- Homepage: https://pypi.org/project/eqlm/
- Size: 62.9 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Eqlm
Simple CLI tool to spatially equalize image luminance, lightness, saturation, or brightness
## Examples
### `$ eqlm images/macaron.jpg -n 3 2 -t 0.8 -c`
| Source | Result |
| ---------------------------------- | ---------------------------------------- |
|  |  |
### `$ eqlm images/yaesu-wall.jpg -m lightness -t 0.9 -n 9 6`
| Source | Result |
| ------------------------------------- | ------------------------------------------- |
|  |  |
### `$ eqlm images/hakone.jpg -m saturation -t 0.2 --clamp`
| Source | Result |
| --------------------------------- | --------------------------------------- |
|  |  |
## Install
```sh
pip3 install eqlm
```
## Usage
The main program can be invoked either through the `eqlm` command or through the Python main module option `python3 -m eqlm`.
```txt
usage: eqlm [-h] [-v] [-m {luminance,brightness,saturation,lightness}]
[-n M N] [-t RATE] [-c] [-e] [-u] [-g [GAMMA]] [-d {8,16}] [-s] [-x]
IN_FILE [OUT_FILE]
```
### Options
```txt
positional arguments:
IN_FILE input image file path (use '-' for stdin)
OUT_FILE output PNG image file path (use '-' for stdout)
(default: Auto)
options:
-h, --help show this help message and exit
-v, --version show program's version number and exit
-m {luminance,brightness,saturation,lightness}
--mode {luminance,brightness,saturation,lightness}
processing mode (default: luminance)
-n M N, --divide M N divide image into MxN (Horizontal x Vertical) blocks
for aggregation (default: (2, 2))
-t RATE, --target RATE
set the target rate for the output level, ranging from
0.0 (minimum) to 1.0 (maximum) (default: Average)
-c, --clamp clamp the level values in extrapolated boundaries
(default: False)
-e, --median aggregate each block using median instead of mean
(default: False)
-u, --unweighted disable weighting based on the alpha channel
(default: False)
-g [GAMMA], --gamma [GAMMA]
apply inverse gamma correction before process
[GAMMA=2.2] (default: None)
-d {8,16}, --depth {8,16}
bit depth of the output PNG image (default: 8)
-s, --slow use the highest PNG compression level (default: False)
-x, --no-orientation ignore the Exif orientation metadata (default: False)
```
## License
GNU Affero General Public License v3.0