MayoStainHelper

Opis Projektu

MayoStainHelper to aplikacja wspierająca rzemieślników zajmujących się nakładaniem bejcy na gitary. Głównym celem projektu jest eliminacja zawodności ludzkiego oka w ocenie subtelnych różnic kolorystycznych, co prowadzi do uzyskania perfekcyjnej powtarzalności barw. Dzięki temu rozwiązaniu nawet najbardziej skomplikowane i wieloetapowe procesy bejcowania stają się przewidywalne, a finalny produkt spełnia najwyższe standardy jakości.

Aplikacja jest zaprojektowana tak, aby była intuicyjna i prosta w obsłudze, nawet dla osób bez specjalistycznej wiedzy na temat fotografii czy przetwarzania obrazu.

---

Kluczowe Funkcje

• Podgląd na żywo z kamery
  Aplikacja wyświetla obraz w czasie rzeczywistym z podłączonego aparatu, umożliwiając bieżące monitorowanie procesu nakładania koloru.

• Porównanie w czasie rzeczywistym
  Możliwość nałożenia obrazu referencyjnego na podgląd na żywo z kamery, co ułatwia natychmiastowe porównanie i weryfikację koloru.

• Łatwa kalibracja kolorów
  Użytkownik może w prosty sposób skalibrować obraz z aparatu oraz wyświetlany na ekranie, używając karty SpyderChecker 24. Zapewnia to, że kolory widziane w aplikacji są zawsze wiarygodne.

• Wspomaganie ekspozycji
  Aplikacja wyświetla histogram na bieżąco, pomagając użytkownikowi w optymalnym ustawieniu parametrów aparatu (ISO, przesłona, czas naświetlania).

• Baza kolorów
  Aplikacja przechowuje bazę referencyjnych zdjęć i filmów, zorganizowaną według modeli gitar. Pozwala to na szybki dostęp do odpowiednich wzorców.

• Rejestrowanie mediów
  Możliwość robienia zdjęć oraz nagrywania wideo, które można dodać do bazy kolorów. Jest to przydatne, gdy dany proces bejcowania wymaga uwiecznienia poszczególnych etapów.

---

Wymagania Systemowe

Projekt jest pisany w języku Python i projektowany z myślą o kompatybilności z różnymi systemami operacyjnymi:

• Systemy operacyjne:
  macOS (docelowy), Windows, Linux

• Sprzęt:

  • Podłączony aparat cyfrowy, kompatybilny z biblioteką gphoto2 (np. Canon 550D)
  • Karta kalibracyjna SpyderChecker 24

---

Technologia

Projekt wykorzystuje następujące biblioteki i technologie:

• Python – język programowania
• PySide6 – do tworzenia interfejsu graficznego (GUI)
• pygphoto2 (wymaga gphoto2) – do komunikacji z aparatem
• OpenCV – do przetwarzania obrazu i kalibracji kolorów
• SQLite – do zarządzania bazą danych kolorów
• Matplotlib & NumPy – (potencjalnie) do analizy i wizualizacji danych

---

Instalacja

Szczegółowe instrukcje instalacji zostaną dodane w przyszłości. Przykładowe kroki:

1. Sklonuj repozytorium:
   git clone https://github.com/twoja_nazwa_uzytkownika/MayoStainHelper.git
2. Przejdź do katalogu projektu:
   cd MayoStainHelper
3. Zainstaluj zależności:
   pip install -r requirements.txt
4. Uruchom aplikację:
   python main.py

---

Licencja

Projekt jest prywatny i przeznaczony do użytku wewnętrznego firmy.