BitmapTracer

Benutzerhandbuch · v1.10.7
Version 1.10.7 Windows · Portable Autor: Bernhard Lickert Entwickelt mit Claude (Anthropic) © 2026

1. Über BitmapTracer

BitmapTracer wandelt Rastergrafiken (Bitmaps) automatisch in skalierbare Vektorgrafiken um. Das Programm erkennt Konturen und erzeugt präzise Vektorpfade für verlustfreien Druck in jeder Größe.

Ideal für: Logos, Stempel, Stencils, technische Zeichnungen, Strichgrafiken, Porträt-Vektorisierung mit feinem Korn.
MerkmalDetails
EingabeformateBMP, PNG, JPG/JPEG, TIFF, GIF, WebP
AusgabeformateSVG, PDF, DXF, PNG
EnginesOpenCV (integriert) + potrace (extern, optional)
BetriebssystemWindows 10 / 11 (64-Bit)
AutorBernhard Lickert · Entwickelt mit Claude (Anthropic)

2. Installation & Start

1

ZIP entpacken

bitmap_tracer_v1.10.7.zip in einen Ordner entpacken, z. B. C:\Tools\BitmapTracer\.

2

EXE erstellen (einmalig, ca. 3–5 Min.)

Doppelklick auf build_bitmap_tracer.bat. Das Script installiert alle Abhängigkeiten und erstellt dist\BitmapTracer_v1.10.7.exe.

3

Programm starten

Doppelklick auf start_bitmap_tracer.bat – löscht automatisch den __pycache__-Ordner und startet die EXE oder Python direkt.

Wichtig bei Updates: Immer start_bitmap_tracer.bat verwenden – es löscht den Python-Cache automatisch. Ohne diesen Schritt kann eine veraltete .pyc-Datei geladen werden.

Inhalt des EXE-Ordners (dist\)

Nach dem Build enthält der dist\-Ordner die EXE. Folgende Dateien müssen neben der EXE liegen:

DateiPflichtHinweis
BitmapTracer_v1.10.7.exe✓Die Anwendung
potrace.exeempfohlenAb v1.10.5 in EXE eingebettet (Fallback). Eine eigene Datei neben der EXE hat Vorrang und ermöglicht Updates ohne Rebuild. Download: potrace.sourceforge.net
bt_profiles.jsonoptionalAb v1.10.5 in EXE eingebettet. Wird neben der EXE angelegt sobald Profile gespeichert werden (dann hat diese Datei Vorrang).
bt_5_Farben.jsonoptionalAb v1.10.5 eingebettet. Farbprofil-Ergänzung.
bt_config.json–Wird automatisch beim ersten Start angelegt (Benutzereinstellungen, Fenstergröße, Sprache).
start_bitmap_tracer.batoptionalStartet EXE oder Python direkt, löscht Cache.
Python-Betrieb (ohne EXE): Alle Dateien aus der ZIP liegen im selben Ordner. Start via start_bitmap_tracer.bat oder python bitmap_tracer.py.

3. Bedienung

Fensteraufbau

BereichFunktion
Header / Panel linksProfil-Verwaltung, Engine-Wahl, alle Parameter
Linke SpalteModus, Vorverarbeitung, Kontrast/Levels
Rechte SpalteKontur, Farben, Stencil, Export & Maßstab
ToolbarBild öffnen · Neu tracen · Zoom 1:1 · Vorschau-Qualität · Original ein/aus
Datei-MenüÖffnen · Exportieren · MRU-Liste (letzte 5 Dateien) · Beenden
Vorschau linksOriginalbild
Vorschau rechtsTracing-Ergebnis (Live-Update)
Farbpaletten-LeisteUnter Tracing-Ergebnis: Farb-Swatches mit Hex-Code. Klick = ein/aus, Hex-Klick = kopieren, Rechtsklick = Farbe ändern
StatusleisteEngine, Konturzähler, Schwellenwert · Fortschrittsbalken rechts während Trace

Slider bedienen

AktionFunktion
ZiehenGrober Wert einstellen
MausradFeinfühlig ±1 Schritt
Shift + MausradGrob ±10 Schritte
Doppelklick auf ZahlenwertDirekteingabe eines exakten Werts
Hover über Slider / ComboTooltip mit Wertebereich, Wirkung und ⚠-Hinweis
Strg+Z / Strg+YUndo / Redo (bis 20 Schritte)

Vorschau bedienen

AktionFunktion
Mausrad auf VorschauZoom zur Cursor-Position – Original und Ergebnis bleiben synchron
Linksklick + DragBild verschieben (Pan) – Greif-Cursor erscheint
Mittelklick + DragBild verschieben (alternative Pan-Methode)
⊞ Zoom 1:1Zoom und Pan zurücksetzen
Zoom-%-Anzeige (Toolbar)Aktueller Zoomfaktor (100% = Fit)

4. Farbpaletten-Leiste

Nach einem Farb-Tracing (Modus = color, OpenCV-Engine) erscheint unter dem Tracing-Ergebnis eine Leiste mit einem Swatch pro k-Means-Farbschicht.

Jeder Swatch zeigt einen Farbblock (mit Auge-Symbol ●/○) und daneben den Hex-Code der Farbe (z. B. #3a2f1c).

AktionWirkung
Linksklick auf Farbblock (●)Layer ein-/ausblenden (● = sichtbar, ○ = ausgeblendet). Vorschau aktualisiert sofort.
Linksklick auf Hex-CodeHex-Wert (z. B. #3a2f1c) in die Zwischenablage kopieren. Statusleiste zeigt Bestätigung.
Rechtsklick auf SwatchFarbwähler öffnen – Farbe dieser Schicht ändern. Vorschau aktualisiert sofort.
✓ alle-ButtonAlle ausgeblendeten Layer wieder einblenden.
Hinweis: Die Farbpaletten-Leiste erscheint nur im Modus color (OpenCV-Engine). Bei mono, canny und potrace zeigt sie „noch kein Trace".
Anwendungstipp: Den Hex-Code eines k-Means-Farbtons per Klick kopieren und direkt in Inkscape, CSS oder einem anderen Programm einfügen – kein Ablesen nötig.

5. Zoom & Pan (v1.8.3)

Original- und Ergebnis-Vorschau sind immer synchron – beide zeigen denselben Ausschnitt beim selben Zoomfaktor.

Das Mausrad zoomt zur Cursor-Position (nicht zur Canvas-Mitte). Zoome direkt auf das Detail, das du vergleichen möchtest – beide Bilder bleiben deckungsgleich.

Tipp für Detailvergleich: Zoomstufe 400–800%, dann Linksklick-Drag zum Positionieren. Original links und Tracing-Ergebnis rechts zeigen immer exakt denselben Bereich.

6. MRU-Liste & Exportpfad-Gedächtnis (v1.8.0)

MRU-Liste (Most Recently Used)

Die letzten 5 geöffneten Bilder erscheinen automatisch im Menü Datei am Ende der Liste. Klick öffnet das Bild direkt – kein Durchsuchen des Ordners nötig.

Die MRU-Liste wird in bt_config.json gespeichert und bleibt zwischen Programmstarts erhalten.

Exportpfad-Gedächtnis

Der zuletzt verwendete Export-Ordner wird ebenfalls in bt_config.json gespeichert. Beim nächsten Export (SVG, PDF, DXF, PNG) öffnet der Datei-Dialog automatisch diesen Ordner.

7. Engines

EngineStärkenWann nutzen
OpenCVImmer verfügbar, Farb-Tracing, Canny-KantenLogos, Farb-Vektorisierung, Strichzeichnungen
potraceGlatteste Kurven, bestes Korn bei Fotos, Inkscape-QualitätPorträts, feines Korn, Stencils aus Fotos
potrace installieren: potrace.exe von potrace.sourceforge.net herunterladen und neben bitmap_tracer.py ablegen oder in den PATH eintragen. Dann BitmapTracer neu starten.

8. Einstellungsreferenz

Modus / Parameter (OpenCV)

ModusBeschreibungGeeignet für
monoSchwarz/Weiß-Tracing, ein SchwellenwertLogos, Stempel, Schrift
colork-Means-Farbquantisierung, je Farbe ein LayerMehrfarbige Logos, Cliparts
cannyKantenerkennung, nur UmrisseFotos → Strichzeichnungen

Vorverarbeitung

FilterBeschreibungTipp
noneKeine VorverarbeitungFür Inkscape-ähnliches Ergebnis
ditherFloyd-Steinberg-Dithering → feines organisches Korn. Schwellenwert intern immer 128.Gamma steuert Punktdichte
bayerOrdered Dithering, regelmäßiges Raster. Bayer-Korn steuert Rastergröße (Potenz von 2: 2/4/8/16).Geometrisches Korn
halftoneRunde Rasterpunkte wie im Offsetdruck. Halftone-Slider steuert Punktgröße.Druckoptik
claheLokale Kontrastverstärkung. CLAHE-Limit steuert Stärke.Schlechte Beleuchtung, Scans
bilateralKanten erhalten, Rauschen reduzieren. Bilateral σ steuert Stärke.Verrauschte Fotos
Wichtig: Bayer-Korn, Halftone und Bilateral σ sind jeweils nur beim passenden Filter aktiv. Bei anderen Filtern sind diese Slider wirkungslos. Hover über den Slider für den ⚠-Tooltip.

Kontrast / Levels

ParameterWirkung
Eingang Schwarz / WeißSchwarzpunkt und Weißpunkt des Eingangsbildes
GammaMittelton-Helligkeit. < 1 = abdunkeln (mehr Korn), 1.0 = neutral, > 1 = aufhellen (weniger Korn). Mausrad = ±0.05, Shift+Mausrad = ±0.5
Ausgang Schwarz / WeißKontrastbegrenzung der Ausgabe

potrace-Parameter

ParameterBereichWirkung
Schwellenwert0–255Binarisierungsschwelle. Inkscape-Standard: 126. Bei Dithering ignoriert (intern 128).
Alphamax0.0–1.34Kurvenglättung. 0.0 = reine Polygone (maximales Korn, aber Treppchen an Diagonalen). 0.5 = Kompromiss. 1.0 = glatte Kurven (Inkscape-Standard). Siehe auch Abschnitt Treppchen.
Opttolerance0.0–5.0Pfad-Vereinfachung. Inkscape-Wert: 2.632. Höher = glatter, vereinfachter.

9. Tooltips (v1.8.4)

Alle Einstellungen (Slider, Checkboxen, Combos, Farb-Eingaben) haben Tooltips. Einfach mit der Maus 1–2 Sekunden über ein Element hovern.

Tooltips erklären drei Dinge:

Tipp: Unbekannte Einstellung? Hover über den Slider – der Tooltip sagt sofort, ob sie für den aktuellen Filter/Modus relevant ist.

10. Reset-Buttons (v1.8.5)

Drei Reset-Buttons setzen alle Werte eines Abschnitts auf die Standard-Defaults zurück und lösen sofort einen neuen Trace aus:

ButtonSetzt zurück
Levels zurücksetzenEingang Schwarz/Weiß · Gamma · Ausgang Schwarz/Weiß
Vorverarbeitung zurücksetzenFilter=none · CLAHE-Limit=2.0 · Bilateral σ=75 · Bayer-Korn=8 · Halftone=4 · Gauss-Blur=0
Kontur zurücksetzenApprox=smooth · Bézier=✓ · Löcher=✓ · Glättung=0 · Eckenwinkel=70° · Min-Fläche=20 · Max-Fläche=0

11. Feines Korn einstellen

Feines Korn bedeutet: Grautöne werden als Punktdichte dargestellt, wie beim Zeitungsdruck oder Siebdruck. Je dunkler ein Grauton, desto dichter das Punktmuster.

Methode 1: Ohne Dithering (Inkscape-Stil)

Potrace direkt auf dem Originalbild – so arbeitet auch Inkscape.

ParameterWertErklärung
Enginepotrace–
FilternoneKein Dithering
Schwellenwert100–130Inkscape nutzt 126
Alphamax0.0–0.1Möglichst kantig = mehr Details
Opttolerance2.0–3.0Wie Inkscape
Min-Fläche1–5Auch kleine Punkte tracen
Gamma1.0–1.3Leicht abdunkeln für mehr Punkte

→ Profil „Inkscape-Korn" enthält genau diese Einstellungen.

Methode 2: Floyd-Steinberg Dithering

Floyd-Steinberg verteilt den Quantisierungsfehler auf Nachbarpixel und erzeugt ein organisches, unregelmäßiges Punktmuster. Der FS-Schwellenwert ist intern immer 128. Gamma steuert die Punktdichte:

ProfilGammaPunktdichteWann nutzen
Feinkorn-locker0.7~23% schwarzHelle Bilder, lockeres Korn
Feinkorn-mittel1.0~50% schwarzNatürliche Grautonwiedergabe – Startpunkt
Feinkorn-dicht1.5~77% schwarzDunkles, dichtes Korn
Feinkorn-max2.5~93% schwarzMaximale Korn-Dichte
Feinjustierung: Den Gamma-Slider mit dem Mausrad bedienen – jeder Schritt ist 0.05, Shift+Mausrad = 0.5. So lässt sich das Korn sehr präzise einstellen.

Profil-Empfehlung für Porträts

ZielProfil
Wie InkscapeInkscape-Korn
Feiner als InkscapeUltra-Fein
Organisches Korn, natürliche GrautöneFeinkorn-mittel
Sehr dichtes KornFeinkorn-dicht oder Feinkorn-max
Stencil aus Porträtpotrace Stencil

12. Treppchen an Diagonalen beheben

Bei niedrigem Alphamax (z. B. 0.0–0.05, wie im Profil „Ultra-Fein") zeichnet potrace Diagonalen als Treppenstufen – das ist das typische Pixel-Treppenmuster. Ursache: Alphamax ≈ 0 erzeugt reine Polygone ohne Kurvenglättung.

AlphamaxWirkung
0.00 – 0.05Reine Polygone → maximales Korn, aber Treppchen an Diagonalen
0.5Kompromiss: Korn bleibt, Diagonalen werden geglättet
1.00Glatte Kurven (Inkscape-Standard) – keine Treppchen
1.34Maximale Glättung
Schnell-Fix für potrace: Alphamax von 0.03 auf 0.5–1.0 erhöhen – Treppchen verschwinden, das Korn in den Flächen bleibt weitgehend erhalten. Optional: Gauss-Blur 1 aktivieren.

Treppchen im Farb-Modus (OpenCV color)

Inkscape erzeugt glattere Farbflächen, weil es intern potrace mit alphamax=1.0 für jede Farbschicht verwendet. Die empfohlene Lösung in BitmapTracer:

Empfehlung: Profil „Farbe-potrace" laden. Dieses Profil aktiviert den Farb-Modus im potrace-Panel: k-Means → für jede Farbmaske → potrace → echte glatte Bézier-Kurven. Entspricht exakt dem Inkscape-Scan-Verfahren.
Hinweis: OpenCV-Konturen + Glättung annähern sich Inkscapes Qualität, erreichen sie aber nicht vollständig – Inkscape nutzt potrace intern, das echte glatte Bézier-Kurven direkt aus den Pixeldaten berechnet.
Schnell-Fix für potrace: Alphamax von 0.03 auf 0.5–1.0 erhöhen – Treppchen verschwinden, das Korn in den Flächen bleibt weitgehend erhalten. Optional: Gauss-Blur 1 aktivieren um Pixelgrenzen vor dem Tracing zu glätten.

13. Profile

Profile speichern alle Einstellungen. Datei: bt_profiles.json neben der EXE. Die EXE enthält ab v1.10.5 eine eingebettete Kopie aller Werksprofile als Fallback – fehlt bt_profiles.json neben der EXE, werden die eingebetteten Profile geladen.

AktionBeschreibung
LadenProfil aus Dropdown wählen → Laden klicken oder Dropdown-Auswahl
SpeichernAktuelle Einstellungen unter einem Namen ablegen
ExportAls .json-Datei exportieren (Weitergabe an andere)
ImportMenü Profile → Importieren
LöschenMenü Profile → Profil löschen

Mitgelieferte Profile

Beim Laden eines Profils erscheint eine kurze Beschreibung in der Statusleiste. Alle Profile zeigen beim Hover einen Tooltip.

ProfilEngineBeschreibung
StandardOpenCVAusgewogene Einstellungen für allgemeine Bilder. OpenCV · Mono · Schwellenwert 128.
5 FarbenOpenCV5-Farb-Tracing mit k-Means. Gut für Logos, flächige Illustrationen.
StencilOpenCVStencil-optimiert: hoher Kontrast, harte Kanten. Ideal für Schablonen und Schneideplotter.
potrace Fotopotracepotrace-Engine mit CLAHE-Vorverarbeitung. Beste Qualität für Fotos mit gleichmäßigem Kontrast.
potrace Stencilpotracepotrace + hoher Schwellenwert für harte Stencil-Kanten. Bézier-Kurven mit maximaler Glättung.
Bayer-KornpotraceRegelmäßiges Bayer-Raster-Dithering. Gleichmäßiges geometrisches Punktmuster.
HalftonepotraceHalbtondruck-Simulation: runde Punkte wie im Offsetdruck. Punktgröße über Halftone-Slider steuerbar.
ZeitungsdruckpotraceGrobes Halftone-Raster für Zeitungsdruck-Optik. Hoher Kontrast, große Punkte.
Korn (OpenCV)OpenCVFloyd-Steinberg-Dithering mit OpenCV. Organisches, unregelmäßiges Punktkorn.
Inkscape-Kornpotracepotrace + Floyd-Steinberg: entspricht Inkscape-Nachzeichnen. Feines, natürliches Korn.
Ultra-FeinpotraceMinimale Fläche, viele Konturen. Für filigrane Details in sauberen Strichzeichnungen.
Farbe-potracepotracek-Means + potrace pro Farbschicht (wie Inkscape Scan). Jede Farbe = echte Bézier-Kurven. Langsamer, max. Qualität.
Ultra-KornOpenCVExtremes Floyd-Steinberg-Korn. Hochkontrast + maximales Dithering.
BleistiftOpenCVSimuliert Bleistiftzeichnung: helle Linien auf hellem Grund. Canny-Kantenerkennung + Invert.
Logo hartOpenCVFür Logos und Vektorgrafiken: harte Kanten, kein Blur. Schwellenwert hoch, minimale Glättung.
Aquarell-UmrissOpenCVWeiche Konturen wie bei Aquarellzeichnungen. Bilateral-Filter + Kurvenglättung.
Siebdruck 3FOpenCV3-Farben-Siebdruck-Simulation. k-Means mit 3 Farben, harte Kanten.
Porträt SchattenpotracePorträts: betont Schattenbereiche. CLAHE + angepasster Schwellenwert.
KupferstichpotraceKupferstich-Optik: feines Bayer-Raster. Kleine Rastergröße, hoher Kontrast.
Druckgrafik lockerpotraceLockere Druckgrafik-Linien. Mittleres Korn, entspannte Konturführung.
Druckgrafik dichtpotraceDichte Druckgrafik: viele enge Linien. Hohes Korn, enge Konturannäherung.
Hochkontrast-FarbeOpenCVFarbtracing mit hohem Kontrast. Wenige Farben, harte Grenzen.
InvertiertOpenCVInvertiertes Tracing: helle Flächen werden Vordergrund. Für dunkle Bilder mit hellen Motiven.

14. Exportformate

SVG

Universelles Vektorformat. Öffenbar in Inkscape, Illustrator, CorelDRAW, Webbrowsern. Native Bézier-Kurven, Farbschichten, Loch-Erkennung (fill-rule nonzero – korrekt für Browser seit v1.7).

PDF

Druckfertig, skalierbar, mit Metadaten und Urheber-Footer. Farbschichten werden mit getrennten Pfaden gezeichnet (kein FILL_EVEN_ODD-Fehler seit v1.8.2).

DXF

CAD-Format. Y-Achse automatisch gespiegelt. Bézier-Kurven als Polylinien aufgelöst. Farbebenen mit Truecolor. Kompatibel mit AutoCAD R13+.

PNG

Datei → Als PNG exportieren speichert das Tracing-Ergebnis als Rasterbild in Originalauflösung. Ideal für Web, Lasercutter-Rasterengraving oder Vorschauen.

PNG für Inkscape

Für Inkscape … exportiert das vorverarbeitete Bild (nach Levels/CLAHE/Dithering). In Inkscape öffnen → Erweiterungen → Bitmap nachzeichnen → Helligkeitsschwellenwert. Kombiniert BitmapTracers Vorverarbeitung mit Inkscapes Tracing-Qualität.

15. Undo & Redo

BitmapTracer speichert bis zu 20 Einstellungsschritte im Arbeitsspeicher.

AktionTastenkürzelMenü
RückgängigStrg+ZBearbeiten → Rückgängig
WiederholenStrg+YBearbeiten → Wiederholen
Neu tracenF5Toolbar → Neu tracen
Laufenden potrace-Trace abbrechen (neu v1.9.18)Esc–
Esc-Abbruch: Wirkt auf potrace-Traces (mono und Farb-Modus) sowie im Batch-Export. Reine OpenCV-Traces laufen in nativen Bibliotheksroutinen und können nicht unterbrochen werden – dort bleibt Esc folgenlos.
Der Undo-Stack wird beim Laden eines neuen Bildes geleert. Er speichert Einstellungen, nicht Bilddaten.

16. Neue Features v1.9.5 – v1.10.7

v1.10.7 – Versions-Drift behoben, selbstheilender Versions-Bump

Vier Dateien trugen über mehrere Releases hinweg unbemerkt veraltete Versionsnummern: version_info.txt meldete in filevers/prodvers noch 1.10.4 (die EXE zeigte unter Eigenschaften → Details also eine falsche Binärversion), Handbuch_EN.html trug in Titel und Kopfzeile noch 1.10.5, der Versions-Badge stand in beiden Handbüchern auf 1.10.5, und bt_5_Farben.json auf 1.10.4.

Ursache: bump_version.py suchte bis v1.10.6 mit Zeichenketten, die aus der alten Versionsnummer gebaut wurden (z. B. filevers=(1, 10, 5, 0)). War eine Stelle einmal aus dem Tritt, passte ihr Suchmuster nie wieder – das Skript gab nur die folgenlose Meldung „NICHT GEFUNDEN“ aus und der Drift wuchs still weiter. Genau dieser Fehlertyp war bereits in v1.9.14 einmal von Hand repariert worden, ohne die Ursache zu beseitigen.

Behebung: Alle Suchmuster sind jetzt reguläre Ausdrücke, die eine beliebige Version X.Y.Z an einer eindeutig verankerten Stelle erkennen. Jeder Bump setzt jede Stelle auf die Zielversion – unabhängig davon, was vorher dort stand. Vorhandener Drift heilt damit automatisch aus; die alte Versionsnummer ist als Argument nicht mehr nötig (python bump_version.py 1.10.8).

Neu ist außerdem Invariante 4 – der Versions-Drift-Scan: Nach dem Schreiben (und jederzeit per --check) wird jede verankerte Stelle gegen die Zielversion geprüft; eine Abweichung beendet das Skript mit Fehlercode 3 statt mit einer überlesbaren Warnung. Zwei bisher ungepflegte Stellen wurden in die Regeln aufgenommen: der Copyright-Block in Abschnitt 21 und die Fußzeile beider Handbücher. Zusätzlich unterstützt das Skript --yes (ohne Rückfrage) und --check (nur prüfen). Nebenbei korrigiert: der windnd-Build-Fix stand in der Versionstabelle fälschlich unter v1.10.5 – korrekt ist v1.10.4.

v1.10.3 – Sprachumschaltung Etappe 3: Englisches Handbuch

Die Sprachumschaltung ist abgeschlossen: Handbuch_EN.html – eine vollständige englische Übersetzung des Handbuchs – gehört jetzt zum Release. Bei englischer Oberfläche öffnet Help → Open manual (English) das englische Handbuch (mit automatischem Rückfall auf das deutsche, falls die Datei fehlt). Zusätzlich sucht die Handbuch-Öffnung jetzt auch im PyInstaller-Bundle (sys._MEIPASS) – bisher fand die Onefile-EXE das Handbuch nur, wenn es zufällig neben der EXE lag. bump_version.py erhielt eine dritte Invariante: den Übersetzungs-Vollständigkeitstest – jedes T("…")-Literal muss einen Eintrag in _TR_EN haben, sonst bricht der Versions-Bump ab. Damit können neue UI-Texte dauerhaft nicht mehr unübersetzt ins Release gelangen. Außerdem behoben: Abschnitt 21 zeigte seit längerem die veraltete Versionsnummer v1.9.12.

v1.10.2 – Sprachumschaltung Etappe 2: Tooltips, Profile, Statusmeldungen

Die englische Oberfläche umfasst jetzt auch alle zur Laufzeit gesetzten Texte: sämtliche ~48 Tooltips (inkl. dynamischem Profil-Tooltip), alle 23 Profilbeschreibungen (Tooltip der Profil-Combobox und Kurzanzeige in der Statuszeile beim Laden eines Profils), alle dynamischen Statusmeldungen (Trace-Status, Konturzähler links und rechts, SVG-Vorschau, Export-, Undo/Redo- und Fehlermeldungen, Esc-Abbruch), der Engine-Hinweis „potrace nicht gefunden – Hilfe > potrace einrichten“ sowie der komplette Batch-Export-Dialog (Status, Log, Messageboxen, Ordner-Dialogtitel). Tooltips werden erst beim Anzeigen übersetzt – ein Sprachwechsel wirkt dort also ohne Neustart. Ausstehend ist nur noch Etappe 3 (Handbuch_EN.html).

v1.10.0/v1.10.1 – Sprachumschaltung Deutsch/Englisch

Unter Ansicht → Sprache / Language lässt sich die Oberflächensprache zwischen Deutsch und Englisch umschalten. Die Wahl wird in bt_config.json gespeichert. Die Menüleiste wechselt sofort; alle übrigen Elemente erscheinen nach einem Neustart in der neuen Sprache. Fehlt eine Übersetzung, wird automatisch der deutsche Text angezeigt – es kann also nie ein leerer oder fehlerhafter Text entstehen.

v1.9.21 – Invarianten-Selbsttest & Release-Standard

v1.9.20 – Code-Audit: drei Regressionen behoben

v1.9.19 – BUGFIX: Mini-Vorschau & PDF/DXF-Export bei potrace

v1.9.18 – Esc-Abbruch & NumPy-Zukunftssicherung

v1.9.17 – Code-Review: 8 Bugfixes

v1.9.16 – Performance & Robustheit

v1.9.15 – Code-Bereinigung & Stabilitätsfixes

v1.9.14 – Bugfixes & Konsistenz

v1.9.13 – Bugfixes & Verbesserungen

v1.9.12 – Bugfixes & Code-Qualität

v1.9.11 – Features & Profil-Überarbeitung

ProfilEngine / ModusVisuelles Ergebnis
BleistiftOpenCV · CannyNur Kanten, kein Fill – Bleistiftzeichnung
Logo hartOpenCV · monoHoher Schwellenwert, scharfe Ecken – Logos/Stempel
Aquarell-UmrissOpenCV · CannyStarker Blur + weiche Linien – malerisch
Siebdruck 3FOpenCV · colorNur 3 Farben, kräftige Grenzen
Porträt Schattenpotrace · bilateralNur Schatten bleiben (heller Gamma)
Kupferstichpotrace · Bayer 4pxGeometrisches Feinraster
Druckgrafik lockerpotrace · kein FilterGamma 2.8 – lockeres Inkscape-Korn
Druckgrafik dichtpotrace · kein FilterGamma 1.4 – dichtes Inkscape-Korn
Hochkontrast-FarbeOpenCV · color 8FKräftige Farbblöcke
InvertiertOpenCV · monoWeiß auf Schwarz

v1.9.10 – Code-Review & Fixes

v1.9.9 – PDF-Fix, Post-Export-Dialog, Zoom-Shortcuts

PDF-Fix: FILL_EVEN_ODD → FILL_NON_ZERO in export_pdf. Behebt ausgeschnittene Farbschichten im PDF-Farb-Export (Regression seit v1.8.2).

v1.9.8 – Vollständiger Code-Review

v1.9.7 – SVG-Vorschau & Konturzahl

v1.9.6 – Invert-Bugfix

Wichtig für ältere Profil-Nutzer: Profile mit preproc=clahe oder bilateral und potrace-Engine waren vor v1.9.6 dauerhaft invertiert. Threshold-Werte dieser Profile können nach dem Update anders wirken und sollten neu eingestellt werden.

v1.9.5 – Tastenkürzel & Qualität

17. Wie Invert funktioniert

Seit v1.9.6 gibt es eine einzige Funktion _thresh_flag(invert, for_potrace), die alle Threshold-Entscheidungen trifft:

Modusinvert=Falseinvert=True
OpenCV mono/color/cannySchwarz = Vordergrund (BINARY_INV)Hell = Vordergrund (BINARY)
potrace (für Binarisierung)Schwarz = Vordergrund (BINARY)Hell = Vordergrund (BINARY_INV)
CannyKanten normalKanten invertiert (bitwise_not)
Farb-ModusMasken normalMasken invertiert (bitwise_not pro Maske)
Tipp: Invert und Eingang inv. sind verschieden: Invert wirkt auf die Binarisierung (Hell/Dunkel tauschen). Eingang inv. entspricht potrace --invert und wirkt auf die potrace-interne Verarbeitung.

18. Tipps & Tricks

Beste Ergebnisse

Vorlagen-Empfehlungen

VorlageProfilBlur
Porträt, Inkscape-QualitätInkscape-Korn0
Porträt, noch feinerUltra-Fein (Alphamax ggf. erhöhen)0
Porträt, organisches KornFeinkorn-mittel0
Logo / Stempel (s/w)Standard1–2
Mehrfarbiges Logo5 Farben1
Stencil aus Fotopotrace Stencil1
Foto → Strichzeichnungpotrace Foto, Modus canny1–2

19. Systemanforderungen

KomponenteMinimumEmpfohlen
BetriebssystemWindows 10 64-BitWindows 11 64-Bit
RAM512 MB frei2 GB frei
Auflösung1280 × 7201920 × 1080
Python (für Build)3.103.13

Verwendete Bibliotheken

BibliothekZweckLizenz
OpenCV (cv2)Bildverarbeitung, Kontur-ErkennungApache 2.0
Pillow (PIL)Bildformate, VorschauHPND
ReportLabPDF-ExportBSD
NumPyArray-OperationenBSD
tkinterGUIPython License
potraceVektorisierungs-Engine (extern)GPL v2

20. Versionsgeschichte

VersionWichtigste Änderungen
v1.6Thumbnail-Preview-System – Live-Vorschau bis 20× schneller.
v1.7SVG fill-rule-Fix (Browser-Rendering). PNG-Export in Originalauflösung. potrace-Vorschau-Fix.
v1.8.0MRU-Liste (letzte 5 geöffnete Bilder) · Exportpfad-Gedächtnis.
v1.8.1Animierter Fortschrittsbalken in der Statusleiste.
v1.8.2Farbpaletten-Leiste repariert · PDF-Export color-Fix · Trace-Hash-Optimierung.
v1.8.3Zoom-Synchronisation – Mausrad zoomt zur Cursor-Position · Linksklick-Pan · Zoom-%-Anzeige.
v1.8.4Tooltips für alle Einstellungen mit ⚠-Kontext.
v1.8.5Hex-Code in Farbpaletten-Leiste · Reset-Buttons für Vorverarbeitung und Kontur.
v1.8.6Hex-Code per Linksklick in die Zwischenablage kopierbar.
v1.8.7Code-Review – 5 Bugfixes: Bayer-Dithering, _init_vars, potrace-Hash, save_profiles, Exportpfad.
v1.8.8Farbe-Ändern in Farbpaletten-Leiste repariert (Dialog hinter Hauptfenster · Preview zeigte alte Farben).
v1.8.9Interne Konsolidierung, potrace_color_mode-Grundlage.
v1.9.0Bugfixes Farb-potrace: SVG-Koordinaten-Ursprung, Farbmasken-Extraktion.
v1.9.1Farb-potrace: k-Means-Farbquantisierung + potrace pro Farbmaske (wie Inkscape Scan). Bézier-Kurven pro Farblayer. SVG-Export aus potrace-Pfaden.
v1.9.2–v1.9.4Zwischenversionen (nicht veröffentlicht): Fensterpersistenz, Profil-Dirty-Flag, Drag&Drop-Vorbereitung.
v1.9.5Tastenkürzel (Ctrl+O/S, F5), Drag&Drop, geteilte Statusleiste, Fenstergeometrie-Persistenz, Profil beim Start wiederherstellen, „Alle Profile speichern".
v1.9.6Invert-Bugfix (_thresh_flag), Canny- und Farb-Invert-Fix.
v1.9.7SVG-Vorschau im Browser · Konturzahl in der Toolbar.
v1.9.8Vollständiger Code-Review: Farb-Invert-Fix, SVG-Temp-Aufräumen, CREATE_NO_WINDOW.
v1.9.9PDF-Fix: FILL_EVEN_ODD → FILL_NON_ZERO (Regression seit v1.8.2). Post-Export-Dialog „Jetzt öffnen?". Zoom-Shortcuts Ctrl++/−/0.
v1.9.10Code-Review: 7 Bugfixes (Docstring, DEFAULT_SETTINGS, fill-rule, Hintergrund-Hex, Konturzähler, Hex-Kopier-Status, FILL_EVEN_ODD-Import).
v1.9.11Handbuch im Hilfe-Menü · PNG Post-Dialog · Batch-Ordner öffnen · Alle Profile exportieren · last_export_fmt-Persistenz · 11 Profile entfernt, 10 neue (Bleistift, Kupferstich, Siebdruck 3F u. a.).
v1.9.12Bugfixes: Thread-Guard (keine parallelen Trace-Jobs mehr) · f-String SyntaxError auf Python 3.10/11 behoben · webbrowser-Reimporte bereinigt · windnd als SPEC-hiddenimport · pathlib-basiertes URI-Handling.
v1.9.13Profil-Beschreibungen als Tooltip · last_export_fmt in _collect · dirty-Flag nur in _on_close · potrace Timeout-Meldung · Batch _is_tracing-Fix · MRU-Pfadanzeige · last_profile beim Start geladen.
v1.10.3Sprachumschaltung Etappe 3: Englisches Handbuch (Handbuch_EN.html) · sprachabhängiger Hilfe-Menüeintrag · Handbuch-Suche auch im PyInstaller-Bundle (_MEIPASS) · dritte bump-Invariante: Übersetzungs-Vollständigkeit T()/_TR_EN · Versions-Fossil in Abschnitt 21 behoben.
v1.10.5Bugfix Transparenz (RGBA-PNGs): Freigestellte PNGs mit transparentem Hintergrund wurden korrekt verarbeitet. Vorher: convert('RGB') machte transparente Pixel schwarz → schwarzer k-Means-Cluster überdeckte den gesamten Hintergrund im SVG. Fix: Alpha-Kanal wird extrahiert und als Maske genutzt – transparente Pixel (Alpha ≤ 127) werden aus k-Means ausgeschlossen (label = -1) und erscheinen in keiner Farbmaske. Dilation wird auf den opaken Bereich beschränkt. Ergebnis: transparent bleibt im SVG-Export wirklich transparent, unabhängig von Motivfarbe oder Hintergrundfarbe. Zusätzlich: potrace-eigener <rect fill="#000000"/> wird bei bg_color=transparent korrekt entfernt.
v1.10.5EXE-Verbesserungen: bt_profiles.json, bt_5_Farben.json und potrace.exe werden jetzt in die EXE eingebettet (Fallback/Vollständigkeit – alle 23 kuratierten Profile und die potrace-Engine sind ohne separate Dateien verfügbar; eine eigene potrace.exe neben der EXE hat weiterhin Vorrang). Icon-Pfad im Spec wird jetzt relativ zur Spec-Datei aufgelöst (SPECPATH) – Icon wurde trotz vorhandener Datei beim Build nicht gefunden.
v1.10.6EXE-Build-Fixes & Verbesserungen: SPECPATH-Fehler im Spec behoben (dirname(SPECPATH) ergab falsches Verzeichnis → potrace.exe und Icons wurden nicht eingebettet). potrace-Radiobutton aktualisiert sich jetzt nach 500 ms automatisch (✅ /❌ korrekt in der EXE). potrace_available() mit lazy reload. bt_profiles.json, bt_5_Farben.json und potrace.exe in EXE eingebettet; build_bitmap_tracer.bat lädt potrace automatisch herunter. find_potrace() sucht jetzt auch im Python-Verzeichnis.
v1.10.4Build-Fix: build_bitmap_tracer.bat installiert windnd mit – ohne Installation fehlte Drag & Drop in der EXE trotz Spec-Eintrag.
v1.10.2Sprachumschaltung Etappe 2: alle Tooltips (~48), alle 23 Profilbeschreibungen, alle dynamischen Statusmeldungen (Trace-Status, Konturzähler, SVG-Vorschau, Export, Undo/Redo, Esc-Abbruch, Fehlertexte), Engine-Hinweis und kompletter Batch-Export-Dialog zweisprachig (+121 Übersetzungen). Tooltips übersetzen ohne Neustart.
v1.10.1Sprachumschaltung: Hauptfenster vollständig – Sektions-Überschriften, Slider-/Combo-/Checkbox-Labels (Wrap in den UI-Helpern), Toolbar, Profil-Buttons, Panel-Titel, Modus-Tipps (+67 Übersetzungen).
v1.10.7Versions-Drift behoben: version_info.txt (filevers/prodvers hingen auf 1.10.4), Handbuch_EN.html (Titel + Kopfzeile auf 1.10.5), Versions-Badge in beiden Handbüchern (1.10.5) und bt_5_Farben.json (1.10.4) korrigiert. bump_version.py ersetzt jetzt regexbasiert und versionsunabhängig (selbstheilend) · vierte Invariante: Versions-Drift-Scan mit Exit-Code 3 · neue Optionen --yes/--check · Copyright-Block und Fußzeile in die Bump-Regeln aufgenommen · windnd-Build-Fix in der Tabelle von v1.10.5 auf v1.10.4 richtiggestellt.
v1.10.0Sprachumschaltung de/en: Ansicht → Sprache / Language · T()-Wrapper mit deutschem Fallback · Einstellung persistent in bt_config.json · Menüs sofort, restliche UI nach Neustart (Etappe 1: Menüs, Buttons, Dialoge).
v1.9.21FEATURE Invarianten-Selbsttest in bump_version.py (subprocess-creationflags, webbrowser-URI; AST-basiert, Abbruch vor Änderungen) · Release-Standard: bt_config.json bewusst nicht im ZIP (Benutzerzustand, wird automatisch erzeugt).
v1.9.20Code-Audit: CREATE_NO_WINDOW in _auto_install (Konsolen-Blitz in EXE) · fill-rule nonzero im potrace-Farb-Modus (sich kreuzende Konturen gleicher Farbe schnitten sich aus) · SVG-Vorschau-URI via pathlib.as_uri() (Umlaute/Leerzeichen im Temp-Pfad).
v1.9.19BUGFIX KRITISCH: potrace-Fallback-Konturen in falschen Koordinaten → Mini-Vorschau nach Layer-Umfärben/-Ausblenden und winzige Zeichnung im PDF/DXF-Export behoben · PERF: Layer-Ausblenden rendert auf Vorschau-Maßen (vorher sekundenlang bei großen Bildern).
v1.9.18FEATURE Esc bricht laufende potrace-Traces ab (mono, Farbe, Batch) · Batch-Abbrechen beendet auch laufenden Prozess · np.bmat → np.block (NumPy-Zukunftssicherung).
v1.9.17Code-Review: FIX Profil-Warnung beim Beenden (Startup-Snapshot) · FIX Tooltip-Stapel Profil-Combobox · FIX potrace-Vorschau bei Otsu/Dither · FIX Zoom-Tasten in Eingabefeldern · FIX Batch-potrace-SVG (mm + Copyright) · FIX PDF-Hex-Hintergrund · Über-Dialog versionsunabhängig · PNG-Icon in EXE gebundelt.
v1.9.16FIX input() headless · PERF Grau-Konvertierung · FIX Tooltip winfo_* · FIX _coerce_settings() Typsicherung
v1.9.15FIX potrace_color_mode in DEFAULT_SETTINGS · Toter Code entfernt · last_export_fmt aus Hash · Batch-Export Exception-Schutz
v1.9.14FIX Undo bei Profil-Laden · version_info.txt korrigiert (war v1.9.3) + in SPEC eingebunden · bt_5_Farben.json Versionskorrektur · start_bitmap_tracer.bat echo-Fix · Handbuch Abschnitt 13 komplett (alle 23 Profile) · bump_version.py um bt_5_Farben.json + version_info.txt erweitert.

21. Urheberrecht & Haftungsausschluss

Urheberrecht

BitmapTracer v1.10.7
Autor: Bernhard Lickert
Entwickelt mit Claude (Anthropic)
Copyright © 2026 Bernhard Lickert. Alle Rechte vorbehalten.


Haftungsausschluss

Dieses Programm wird ohne jegliche Gewährleistung bereitgestellt. Die Benutzung erfolgt vollständig auf eigene Gefahr. Der Autor übernimmt keinerlei Haftung für direkte, indirekte oder Folgeschäden durch die Verwendung dieses Programms.