70 lines
1.9 KiB
Markdown
70 lines
1.9 KiB
Markdown
# ColorCalc
|
|
|
|
ColorCalc ist ein kleines Desktop-Tool (Python + Tkinter + Pillow), das Farbbereiche in Bildern markiert. Statt nur eine feste Farbe zu prüfen, kannst du jede gewünschte Hue/Saturation/Value-Kombination einstellen, Ergebnisse sofort sehen und als Overlay speichern.
|
|
|
|
## Kurzüberblick
|
|
|
|
- Zwei Vorschaubereiche: links Original, rechts Overlay.
|
|
- Slider für Hue-/Sat-/Value-Grenzen und Overlay-Alpha.
|
|
- Farbwahl per Dialog, Bildklick oder vordefinierten Swatches.
|
|
- Rechteckige Ausschlüsse per Rechtsklick ziehen.
|
|
- Light/Dark-Theme, Trefferstatistik und Dateiname im UI.
|
|
- Einstellungen aus `config.toml` (optional) laden.
|
|
|
|
## Voraussetzungen
|
|
|
|
- Python ≥ 3.11 (bei 3.10: `pip install tomli`)
|
|
- Tkinter (unter Linux ggf. `sudo apt install python3-tk`)
|
|
- Pillow (`pip install pillow`)
|
|
|
|
## Schnellstart
|
|
|
|
```bash
|
|
git clone https://github.com/<dein-org>/ColorCalc.git
|
|
cd ColorCalc
|
|
python3 -m venv .venv
|
|
source .venv/bin/activate # Windows: .venv\Scripts\activate
|
|
pip install pillow
|
|
python3 main.py
|
|
```
|
|
|
|
## Bedienung
|
|
|
|
1. `📂` Bild laden.
|
|
2. Farbe wählen (`🎨` oder `🖱️` aktivieren und ins Bild klicken).
|
|
3. Slider nach Bedarf anpassen; Trefferquote erscheint unter dem Overlay.
|
|
4. Ausschlüsse mit Rechtsklick ziehen, per `🧹` löschen.
|
|
5. Overlay speichern (`💾`) oder Slider zurücksetzen (`🔄`).
|
|
|
|
## Konfiguration
|
|
|
|
`config.toml` (optional) mit Default-Werten:
|
|
|
|
```toml
|
|
[defaults]
|
|
hue_min = 250.0
|
|
hue_max = 310.0
|
|
sat_min = 15.0
|
|
val_min = 15.0
|
|
val_max = 100.0
|
|
alpha = 120
|
|
```
|
|
|
|
## Code-Struktur
|
|
|
|
```
|
|
app/
|
|
app.py # App-Zusammenbau
|
|
gui/ # UI-, Theme- und Picker-Mixeins
|
|
logic/ # Bildverarbeitung, Defaults, Reset
|
|
config.toml # optionale Startwerte
|
|
main.py # Einstiegspunkt
|
|
```
|
|
|
|
## Pflege
|
|
|
|
- Schneller Check: `python3 -m compileall app main.py`
|
|
- Pull Requests gerne mit kurzem Screenshot bei UI-Änderungen
|
|
|
|
Viel Spaß beim Einstellen deiner Farbbereiche!
|