SNAP2CNC Logo

Dokumentacja SNAP2CNC

📖 Dokumentacja Użytkownika

Kompleksowy przewodnik po aplikacji SNAP2CNC

🎯 O aplikacji

SNAP2CNC to zaawansowana aplikacja webowa, która umożliwia generowanie kodu G-code dla maszyn CNC na podstawie fotografii lub rysunków. Aplikacja automatycznie wykrywa elementy geometryczne (otwory, linie) i konwertuje je na precyzyjne instrukcje dla maszyn CNC.

✨ Główne funkcje:

  • 📸 Tryb Zdjęcia - analiza zdjęć z automatycznym wykrywaniem otworów i linii
  • 🎨 Tryb Ręczny - ręczne rysowanie i projektowanie
  • 🔧 Automatyczne generowanie G-code dla różnych typów operacji
  • ⚙️ Zaawansowane parametry skrawania
  • 🌙 Tryb ciemny/jasny
  • 🌙 Zapisywanie i otwieranie projektów

🎯 Zastosowania:

  • 🔨 Tworzenie nawiertów z pomocą CNC
  • 📐 Konwersja prostych rysunków technicznych na G-code
  • 🖼️ Analiza zdjęć i konwersja na G-code
  • ⚡ Szybkie generowanie G-code
  • 🎓 Edukacja w zakresie CNC
Zrzut ekranu głównego interfejsu aplikacji

🚀 Rozpoczęcie pracy

Wymagania systemowe:

  • ✅ Nowoczesna przeglądarka internetowa (Chrome, Firefox, Safari, Edge)
  • ✅ Połączenie z internetem
  • ✅ Zdjęcia w formacie JPG/JPEG (dla trybu fotografii)

Dostęp do aplikacji:

  1. 1. Otwórz przeglądarkę internetową
  2. 2. Przejdź na stronę app.snap2cnc.pl
  3. 3. Załóż konto przez "Sign Up" i używając konta Google lub podaj swój adres email - otrzymasz kod weryfikujący na pocztę e-mail (sprawdź spam), potwierdź kod i zacznij działać!
Ekran logowania

📋 Tryby pracy

📸

Tryb Zdjęcia

Do automatycznego wykrywania otworów i linii tak jak narysujesz na materiale.

  • • Automatyczne wykrywanie dla otworów - zaznacznenie czerwonymi kropkami
  • • Automatyczne wykrywanie dla linii - zaznaczenie niebieskimi kropkami dla początku i końca linii
  • • Wprowadzenie skali na podstawie zaznaczonej linii i wpisanie rzeczywistego dystansu
  • • Możliwość dodania własnych punktów w układzie współrzędnych
🎨

Tryb Ręczny

Pozwala na ręczne projektowanie i rysowanie elementów na pustym płótnie.

  • • Ręczne dodawanie otworów i linii
  • • Kopiowania, przesuwanie wielu elementów na raz
  • • Precyzyjne pozycjonowanie
  • • Wpisz prozmiar elementu na którym pracujesz
  • • Natychmiastowy podgląd
  • • Generuj G-code
Wybór trybu pracy

📸 Tryb Zdjęcia - Instrukcja krok po kroku

📸

Wgranie zdjęcia

  1. 1. Kliknij na przycisk "Wgraj Zdjęcie" w pierwszym kroku workflow
  2. 2. Wybierz plik z dysku komputera (format JPG/JPEG)
  3. 3. Poczekaj na załadowanie i wyświetlenie zdjęcia w podglądzie

💡 Wskazówka: Używaj zdjęć o dobrej jakości z wyraźnymi kontrastami kolorów dla lepszego wykrywania elementów. Pamiętaj o skali, otwory - kropki na czerwono, linie - 2 kropki na niebiesko dla początku i końca linii.

📍

Ustawienie punktu początkowego (Origin)

  1. 1. Kliknij na zdjęciu w miejscu, które ma być punktem (X0,Y0) w układzie współrzędnych
  2. 2. Zostanie wyświetlony pomarańczowy krzyżyk oznaczający wybrany punkt
  3. 3. Wszystkie wymiary będą względem tego punktu
📏

Zaznaczenie skali

  1. 1. Kliknij pierwszy punkt na zdjęciu (np. początek linijki lub znany wymiar)
  2. 2. Kliknij drugi punkt na zdjęciu (koniec linijki lub znany wymiar)
  3. 3. Wpisz rzeczywisty dystans dla skali (mm) w Obszarze pracy

💡 Przykład: Jeśli zaznaczysz 10cm na linijce, wpisz "100" w polu dystansu.

🔍

Automatyczne wykrywanie elementów

  1. 1. Typ elementu do wykrycia:
    • 🔴 Otwory - wykrywa czerwone kropki
    • 📏 Linie - wykrywa i łączy 2 niebieskie kropki
  2. 2. Automatczynie przechodzimy do "Wykryj automatycznie"
  3. 3. Sprawdź wyniki - wykryte elementy będą podświetlone
  4. 4. Dostosuj parametry, punkt 0, lub skalę - jeśli potrzeba
⚙️

Generowanie G-code

  1. 1. Sprawdź wszystkie wykryte elementy
  2. 2. Ustaw parametry skrawania (patrz sekcja "Parametry skrawania")
  3. 3. Kliknij "Generuj G-code"
  4. 4. Pobierz wygenerowany plik .gcode
  5. 5. Wgraj G-code do CNC
Tryb Zdjęcia

🎨 Tryb Ręczny - Instrukcja krok po kroku

📐

Ustawienie rozmiaru elementu

  1. 1. Wpisz szerokość elementu w milimetrach
  2. 2. Wpisz wysokość elementu w milimetrach
⚖️

Ustawienie skali

  1. 1. Wpisz ile milimetrów ma reprezentować 10 pikseli na obszarze roboczym
  2. 2. Domyślnie: 10mm = 10px (skala 1:1)
📍

Ustawienie punktu początkowego

  1. 1. Punkt 0 jest domyślnie ustawiony w Obszarze pracy
  2. 1. Aby zmienić punkt 0, Kliknij w "2 Ustaw Punkt 0", a później kliknij na obszar roboczy w miejscu, które ma być punktem (X0,Y0)
  3. 2. W nowym punkcie Zostanie wyświetlony pomarańczowy krzyżyk
✏️

Dodawanie elementów

  1. 1. Wybierz typ elementu:
    • ⭕ Otwory - kliknij na obszar roboczy, aby dodać otwór
    • 📏 Linie - kliknij dwa punkty, aby narysować linię
    • 🔄 Przesuń Otwory - złap i przeciągnij otwór na obszarze roboczym
    • 🔄 Przesuń Linie - złap i przeciągnij linie na obszarze roboczym
    • 🎯 Wiele - zaznacz wiele lub jeden element i skopiuj lub przesuń
    • 🗑️ Wyczyść - usuwa wszystkie elementy z obszaru roboczego
  2. 2. Dostosuj parametry każdego elementu (średnica, głębokość, itp.) w tabeli
  3. 3. Powtarzaj dla wszystkich potrzebnych elementów
⚙️

Generowanie G-code

  1. 1. Sprawdź wszystkie elementy
  2. 2. Ustaw parametry skrawania
  3. 3. Kliknij "Generuj G-code"
  4. 4. Pobierz wygenerowany plik
Tryb Obszar roboczy z narzędziami

⚙️ Parametry skrawania

Narzędzie i podstawowe parametry:

Średnica narzędzia (mm) średnica frezu lub wiertła
Krok boczny % procent średnicy narzędzia (domyślnie 40%)
Krok w głąb (mm) głębokość jednego przejścia
Bezpieczne Z (mm) wysokość bezpieczna nad materiałem
Posuw F (mm/min) prędkość posuwu
Naddatek wykańczający (mm) dodatkowy materiał do wykończenia

Parametry elementów:

Otwory (per sztuka):
  • • Średnica (mm) - średnica otworu
  • • Głębokość (mm) - głębokość otworu
  • • Typ narzędzia - wiertło lub frez
Slotów/linii:
  • • Szerokość (mm) - szerokość slotu
  • • Głębokość (mm) - głębokość slotu
  • • Typ operacji - outline (kontur) lub pocket (kieszeń)
Panel parametrów skrawania

🎛️ Interfejs użytkownika

Główny pasek nawigacji:

  • • Logo SNAP2CNC - powrót do strony głównej
  • • Przełącznik trybu - zmiana między trybem fotografii a obszarem roboczym
  • • Przycisk wylogowania - wylogowanie z aplikacji

Panel workflow:

  • • 5 kroków w każdym trybie
  • • Wizualne wskaźniki postępu (szary → niebieski → zielony)
  • • Klikalne kroki - możliwość powrotu do poprzednich etapów

Obszar roboczy:

  • • Interaktywne narzędzia do dodawania elementów
  • • Zoom i pan - powiększanie i przesuwanie widoku
  • • Współrzędne - wyświetlanie pozycji kursora
Pełny interfejs aplikacji

💾 Projekty: zapisywanie i otwieranie

Co jest zapisywane?

  • Elementy (otwory, linie) wraz z ich parametrami
  • Punkt 0 (origin) i skala
  • Rozmiar detalu/obszaru roboczego
  • Wybrane podstawowe ustawienia skrawania

Uwaga: projekty są przechowywane lokalnie w przeglądarce (na tym urządzeniu).

Jak zapisać projekt

  1. Skonfiguruj elementy na obszarze roboczym lub ze zdjęcia
  2. Ustaw parametry skrawania w panelu
  3. Kliknij przycisk 💾 Zapisz w górnym pasku
  4. Nazwij projekt i potwierdź

Jak otworzyć projekt

  1. Kliknij przycisk 📁 Otwórz w górnym pasku
  2. Wybierz projekt z listy zapisanych
  3. Potwierdź, aby załadować do interfejsu

Wczytanie zastąpi bieżący stan roboczy.

Wskazówki

  • Zapisuj projekt przed większymi zmianami
  • Używaj jednoznacznych nazw (np. klient_data_wersja)
  • Projekty są lokalne — na innym urządzeniu nie będą widoczne
Zarządzanie projektami

❗ Rozwiązywanie problemów

Problem: Aplikacja nie wykrywa elementów na zdjęciu

Rozwiązanie:

  • Sprawdź kontrast zdjęcia
  • Spróbuj różnych presetów kolorów
  • Dostosuj parametry wykrywania HSV

Problem: Nieprawidłowa skala

Rozwiązanie:

  • Upewnij się, że zaznaczasz znane wymiary
  • Sprawdź jednostki (mm vs cm)
  • Użyj linijki lub innego obiektu o znanych wymiarach

Problem: Błąd generowania G-code

Rozwiązanie:

  • Sprawdź czy wszystkie wymagane parametry są ustawione
  • Upewnij się, że elementy są prawidłowo wykryte
  • Sprawdź połączenie z internetem

Problem: Aplikacja działa wolno

Rozwiązanie:

  • Użyj mniejszego zdjęcia
  • Zamknij niepotrzebne karty w przeglądarce
  • Sprawdź połączenie z internetem

📞 Wsparcie techniczne

Kontakt:

Wersja aplikacji:

  • • Frontend: v1.0.0
  • • Backend: v1.0.0
  • • Ostatnia aktualizacja: Październik 2025
  • • Dokumentacja: v1.0.0

📚 Słownik terminów

G-code

Standardowy język programowania maszyn CNC

CNC

Computer Numerical Control - komputerowe sterowanie numeryczne

Frez

Narzędzie skrawające do obróbki materiałów

Posuw

Prędkość ruchu narzędzia podczas skrawania

Krok boczny

Odległość między przejściami narzędzia

Bezpieczne Z

Wysokość nad materiałem, na której narzędzie porusza się bezpiecznie

Origin

Punkt początkowy układu współrzędnych (0,0)

Obszar roboczy

Obszar roboczy do rysowania elementów