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

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:

[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!