trace-to-svg

Trace bitmap images (PNG/JPG/WebP) into clean SVG paths using potrace/mkbitmap. Use to convert logos/silhouettes into vectors for downstream CAD workflows (e.g., create-dxf etch_svg_path) and for turning reference images into manufacturable outlines.

1. Zainstaluj wymagane narzędzia. Na systemach Linux użyj menedżera apt: apt install potrace. Na macOS zainstaluj za pomocą Homebrew: brew install potrace. Oba polecenia instalują zarówno potrace, jak i mkbitmap.

2. Przygotuj obraz wejściowy w formacie PNG, JPG lub WebP. Narzędzie działa najlepiej na obrazach o wysokim kontraście — logach, sylwetkach i kształtach bez gradientów. Jeśli obraz zawiera wiele szczegółów lub odcieni, wynik może być mniej zadowalający.

3. Uruchom podstawową konwersję za pomocą skryptu: bash scripts/trace_to_svg.sh input.png --out out.svg. Zastąp input.png nazwą Twojego pliku, a out.svg to nazwa wyjściowego pliku SVG.

4. Jeśli wynik zawiera zbyt wiele szumu lub brakuje kontrastu, dostosuj parametry. Użyj flagi --threshold z wartością od 0 do 1 (np. 0.6) aby zmienić czułość progowania, oraz --turdsize aby zmniejszyć małe artefakty (np. 20). Przykład: bash scripts/trace_to_svg.sh input.png --out out.svg --threshold 0.6 --turdsize 20.

5. Otwórz wygenerowany plik SVG w edytorze tekstu lub graficznym, aby sprawdzić ścieżki. Plik zawiera elementy path z atrybutem d zawierającym wektorową definicję kształtu.

6. Jeśli planujesz dalsze przetwarzanie — na przykład tworzenie pliku DXF — skopiuj wartość atrybutu d z ścieżki SVG i przekaż ją do następnego narzędzia w Twojej pipeline'u, takiego jak create-dxf.