# Importer DXF do wyceny laserowej

Program Windows 64-bit. Python ani dodatkowe biblioteki nie muszą być instalowane.
Rozpakuj cały ZIP. Uruchom Importer_DXF.exe z rozpakowanego folderu. Zachowaj folder _internal obok programu.

## Pierwszy import

1. Wybierz folder z plikami DXF. Opcjonalnie zaznacz podfoldery i kliknij Odśwież folder.
2. Zaznacz warstwy zawierające wyłącznie kontury przeznaczone do cięcia. Ctrl pozwala zaznaczyć kilka. Nie zaznaczaj warstw z ramkami, wymiarami i geometrią pomocniczą. Program nie rozpoznaje znaczenia linii po ich wyglądzie.
3. Pozostaw Automatycznie z DXF, jeśli pliki zawierają poprawne jednostki. Gdy brak jednostek, wybierz mm, cm, m lub cale po sprawdzeniu rysunku. Ręczna jednostka zastępuje deklarację we wszystkich plikach danego pomiaru.
4. Kliknij Zmierz pliki DXF. Sprawdź statusy i długości w mm.
5. Do kontroli zaznacz plik w tabeli i kliknij Otwórz wybrany w eDrawings. Jeśli program nie znajdzie instalacji, wskaż eDrawings.exe. Instalacja eDrawings nie jest wymagana do samego pomiaru.
6. Kliknij Zapisz do kopii Excela. Wybierz nową nazwę pliku. Program nie nadpisuje szablonu ani istniejących plików wynikowych.
7. Otwórz wynik w Microsoft Excel. Formuły przeliczą się przy otwarciu. Uzupełnij klienta, daty, materiał, grubość, ilość, wymiary lub masę, liczbę przebić i materiał powierzony. Import nie ustala tych wartości na podstawie nazwy pliku i nie zgaduje liczby przebić.

## Gdzie trafiają dane

- Wycena, kolumna A: nazwa pliku bez rozszerzenia, jako nazwa detalu.
- Wycena, kolumna H: długość konturów w mm na jeden plik/detal.
- Wycena, kolumna N: pełna ścieżka źródłowego DXF.
- Wycena, kolumna O: informacja o pomiarze lub przybliżeniu krzywych.

Opcja Nowe zlecenie wyczyści dotychczasowe pozycje wyłącznie w zapisywanej kopii. Ustawienia i dane wspólne wybranego kalkulatora pozostają zachowane. Po odznaczeniu tej opcji program dopisuje pozycje w całkowicie pustych wierszach. Nie aktualizuje wcześniejszych wpisów po nazwie pliku.

Dołączony pusty kalkulator ma 30 pozycji i przykładowy cennik do dostosowania. Gdy zabraknie wolnych wierszy, zapis zostanie zatrzymany; podziel folder na partie. Importer obsługuje aktualny układ tego kalkulatora.

## Zakres pomiaru

Pomiar wykonuje biblioteka ezdxf bezpośrednio z danych DXF, zgodnie z uzgodnionym wariantem. eDrawings służy do podglądu i kontroli, nie jest silnikiem automatycznego pomiaru.

Uwzględniane są obiekty LINE, ARC, CIRCLE, LWPOLYLINE, POLYLINE, ELLIPSE, SPLINE oraz rozwinięta geometria bloków INSERT, również zagnieżdżonych, skalowanych i wielokrotnych. Dla warstwy 0 wewnątrz bloku stosowana jest warstwa jego wstawienia. Kontury są pobierane z przestrzeni modelu; arkusze papieru nie są mierzone.

Długości odcinków, łuków i okręgów są liczone geometrycznie. Krzywe SPLINE i ELLIPSE są przybliżane polilinią z kontrolą kolejnych przybliżeń. Początkowa odchyłka wynosi 0,001 mm; kryterium zbieżności długości nie stanowi ścisłej gwarancji błędu całkowitego. Takie pliki są oznaczane w informacjach o pomiarze.

Napisy, wymiary, punkty, kreskowania i oznaczenia są pomijane i wykazywane w informacji o pliku. Jeśli do cięcia przeznaczony jest tekst, musi zostać wcześniej zamieniony w CAD na kontury. Kreskowanie nie jest traktowane jako obrys cięcia.

Brak jednostek, błędny plik, nieobsługiwany obiekt na wybranej warstwie, część duplikatów geometrycznych, nieplanarna geometria 3D, nierozwiązany blok, XREF lub blok z dodatkowymi danymi (np. XCLIP) powodują status BŁĄD. Taki plik nie jest zapisywany z pozornie poprawną długością. Interfejs pyta przed zapisaniem tylko poprawnej części zestawu.

Program wykrywa m.in. identyczne odcinki (również odwrócone) i identyczne okręgi lub łuki. Nie wykrywa wszystkich częściowych nakładań i konturów zapisanych różnymi typami obiektów. Przed produkcją sprawdź geometrię w CAD/CAM.

Jeden plik oznacza jeden detal. Jeśli DXF zawiera kilka detali lub cały nesting, wynik jest sumą geometrii tego pliku. Program nie dodaje wejść i wyjść lasera, nie optymalizuje wspólnych cięć i nie wyznacza liczby przebić.

## Szybkie sprawdzenie

W folderze Przykladowe_DXF wybierz warstwę CUT. Oczekiwane wyniki:

- Plytka_100x50.dxf: 300,000 mm.
- Kolo_R10.dxf: 62,832 mm.
- Luk_R20_90stopni.dxf: 31,416 mm.

Warstwa OPIS jest pomocnicza. Wyniki testów dotyczą przygotowanych przykładów; nie otrzymano jeszcze rzeczywistych plików warsztatu.

Sprawdzono 11 testów geometrii i eksportu, utworzenie interfejsu oraz przeliczenie zaimportowanych danych w silniku arkuszy. Nie wykonano pełnego testu kliknięć użytkownika, porównania pomiarów z eDrawings ani wydruku w Microsoft Excel.

## Źródła i biblioteki

- Dokumentacja ezdxf: https://ezdxf.readthedocs.io/en/stable/
- Jednostki DXF: https://ezdxf.readthedocs.io/en/stable/concepts/units.html
- Bloki: https://ezdxf.readthedocs.io/en/stable/blocks/insert.html
- API eDrawings: https://help.solidworks.com/2025/english/api/emodelapi/Welcome-emodelapi.html

Program zawiera Python, ezdxf, NumPy i pozostałe zależności wymagane do uruchomienia. Licencje bibliotek znajdują się w folderze _internal oraz w katalogu Licencje. Kod aplikacji udostępniono w folderze Kod_zrodlowy.