Obsługa i przetwarzanie obrazów w przeglądarce
Narzędzie Czytnik kodów QR umożliwia dekodowanie zawartości kodów QR bezpośrednio z plików graficznych. Użytkownik może wprowadzić obraz na trzy sposoby: przesłać plik z dysku urządzenia, przeciągnąć i upuścić grafikę w obszar roboczy lub wykonać nowe zdjęcie za pomocą wbudowanego aparatu fotograficznego.
Proces dekodowania nakłada określone reguły na przetwarzane pliki:
- Formaty wejściowe: Narzędzie obsługuje pliki w formatach JPG, PNG oraz WebP. Bezpośrednie przesyłanie zdjęć w formacie HEIC (na przykład bezpośrednio z galerii systemu iOS/iPhone) nie jest obsługiwane.
- Skalowanie obrazu: Jeśli najdłuższy bok przesłanego zdjęcia przekracza 2200px, obraz jest automatycznie zmniejszany przed rozpoczęciem procedury dekodowania.
- Wielokrotne kody: W przypadku, gdy na jednym zdjęciu znajduje się więcej niż jeden kod QR, system zdekoduje wyłącznie pierwszy wykryty kod.
- Czyszczenie danych: Użycie opcji Wyczyść przerywa bieżące zadanie dekodowania, zwalnia adres URL podglądu oraz ukrywa dotychczasowe wyniki.
Wszelkie operacje związane z przetwarzaniem grafiki oraz odczytywaniem danych są wykonywane lokalnie. Państwa zdjęcie oraz jego zdekodowana zawartość pozostają w przeglądarce. Dekodowanie odbywa się w całości na Państwa urządzeniu – zdjęcie nigdy nie opuszcza przeglądarki, a żadne dane nie są przesyłane do BroBroGo. Narzędzie nie wymaga połączenia z zewnętrznymi serwerami w celu przetworzenia pliku graficznego.
Wyniki dekodowania i obsługa danych wyjściowych
Po zakończeniu analizy obrazu narzędzie prezentuje rezultat w sekcji Zdekodowana zawartość. Użytkownik ma do dyspozycji dedykowane akcje zależne od typu odczytanych danych:
- Kopiowanie tekstu: Przycisk Kopiuj pozwala na natychmiastowe zapisanie odczytanych danych w schowku systemowym.
- Otwieranie odnośników: Jeśli zdekodowana zawartość stanowi pełny adres URL zaczynający się od protokołu HTTP lub HTTPS, aktywowany zostaje przycisk Otwórz link.
Kliknięcie przycisku Otwórz link powoduje otwarcie adresu w nowym oknie przeglądarki. Ze względów bezpieczeństwa operacja ta jest wykonywana z użyciem atrybutów noopener,noreferrer. Zapobiega to przekazywaniu informacji o stronie odsyłającej (referrer) oraz chroni kontekst przeglądarki przed dostępem ze strony docelowej. Narzędzie w żaden sposób nie weryfikuje podpisu ani źródła pochodzenia kodu QR, nie wykonuje instrukcji zaszytych w kodzie (takich jak automatyczne łączenie z siecią Wi-Fi, inicjowanie płatności, dodawanie kontaktów czy uruchamianie aplikacji) ani nie nawiązuje samodzielnego połączenia z adresem URL zapisanym w kodzie.
Komunikaty systemowe i rozwiązywanie problemów
Podczas pracy z narzędziem mogą pojawić się następujące komunikaty statusu oraz błędy, wyświetlane w zależności od stanu aplikacji:
- Gotowy. Prześlij zdjęcie lub zrób je, aby odczytać kod QR. – stan początkowy, oczekiwanie na wprowadzenie pliku.
- Odczytywanie zdjęcia... – komunikat wyświetlany w trakcie analizy struktury graficznej.
- Zdekodowano. – informacja o pomyślnym zakończeniu procesu odczytu.
- Nie znaleziono kodu QR na tym zdjęciu. – błąd pojawiający się, gdy algorytm nie wykryje wzorca pozycjonującego kodu QR.
- Ten typ obrazu nie jest obsługiwany. Użyj formatu JPG, PNG lub WebP. – komunikat blokujący przetwarzanie plików o nieobsługiwanych rozszerzeniach (np. HEIC, GIF, TIFF).
- Nie udało się odczytać tego obrazu. – błąd krytyczny odczytu pliku, występujący np. przy uszkodzeniu struktury nagłówka graficznego.
Różnice między skanowaniem wideo a dekodowaniem statycznym
Narzędzie różni się od standardowych aplikacji aparatów w smartfonach tym, że nie skanuje wideo w czasie rzeczywistym. Zamiast tego analizuje pojedyncze, statyczne klatki obrazu (zdjęcia). Pozwala to na dekodowanie kodów QR dostarczonych w formie zrzutów ekranu, grafik przesłanych w wiadomościach e-mail, dokumentów PDF zapisanych jako obrazy czy zdjęć wykonanych wcześniej i przechowywanych w pamięci komputera lub telefonu.
Aby algorytm mógł poprawnie zidentyfikować i zdekodować kod ze zdjęcia, obraz musi spełniać podstawowe kryteria czytelności. Kluczowe znaczenie ma ostrość krawędzi modułów (czarnych i białych kwadratów), brak silnych odblasków światła na powierzchni kodu oraz zachowanie odpowiedniego kontrastu. Zniekształcenia geometryczne wynikające z fotografowania pod bardzo ostrym kątem mogą uniemożliwić prawidłową interpretację wzorców wyszukiwania umieszczonych w trzech narożnikach kodu QR.
Często zadawane pytania (FAQ)
Czy moje zdjęcie jest gdzieś przesyłane? Nie. Dekodowanie odbywa się w całości na Państwa urządzeniu – zdjęcie nigdy nie opuszcza przeglądarki.
Dlaczego nie udało się znaleźć kodu QR na moim zdjęciu? Najczęstszą przyczyną jest rozmycie obrazu, odblaski światła, zbyt ostry kąt lub sytuacja, gdy kod zajmuje tylko niewielką część kadru. Spróbuj zrobić zdjęcie z bliższej odległości, ostre i dobrze oświetlone. Jeśli na zdjęciu znajduje się więcej niż jeden kod QR, zdekodowany zostanie tylko pierwszy wykryty.
Dlaczego zdjęcie z iPhone'a nie zadziałało? Zdjęcia w formacie HEIC przesyłane bezpośrednio z galerii iPhone'a nie są jeszcze obsługiwane. Prosimy najpierw przekonwertować je za pomocą naszego narzędzia HEIC na JPG lub skorzystać z opcji zrobienia zdjęcia bezpośrednio tutaj, co zapisze je od razu w formacie JPG.
Czy narzędzie automatycznie połączy mnie z siecią Wi-Fi lub zrealizuje płatność po odczytaniu kodu? Nie. Narzędzie wyłącznie dekoduje i wyświetla surową zawartość tekstową kodu QR. Nie wykonuje ono żadnych instrukcji systemowych, takich jak konfiguracja sieci Wi-Fi, realizacja płatności, dodawanie kontaktów czy automatyczne uruchamianie zewnętrznych aplikacji.