Czym jest kod QR?
QR Code (ang Quick Response) jest dwuwymiarowym kodem kreskowym, opracowanym w 1994 roku przez japońską firmę Denso-Wave. Już jakiś czas obcuję z tymi kodami i mogę powiedzieć, że w odróżnieniu od standardowych kodów kreskowych, ich skuteczność odczytu jest bardzo wysoka (nawet w przypadku gdy kod jest obrócony lub w pewnym stopniu uszkodzony). Ten ostatni przypadek bardzo często zdarza się w faksach, gdzie nie każdy ma na tyle dobre urządzenie, aby przesłać oznaczony dokument bez charakterystycznych szumów lub poprzecznych śmieci.
Tak wygląda zakodowany ciąg znaków:
"To jest tekst zakodowany kodem QR"
Wygenerowano za pomocą : http://zxing.appspot.com/generator/
Po co to wszystko?
Zastosowań kodu QR jest bardzo wiele, można wykorzystać je do oznaczania dokumentów, produktów, kodowania adresów URL oraz wizytówek vCard. Kod QR stał się bardzo popularny w dobie smartfonów posiadających specjalny czytnik, który pozwala na błyskawiczne zapisanie kontaktu, adresu URL itp.
Osobiście wykorzystuję takie kody do oznaczania dokumentów, które druga strona podpisuje i odsyła faksem lub zwykłym skanem. Zarówno faks jak i skan wędruje na specjalną skrzynkę pocztową, gdzie zostaje zeskanowany i rozpoznany przez skrypt. Oczywiście można robić to ręcznie, ale kiedy takich dokumentów przychodzi kilkanaście lub kilkadziesiąt, pomoc jest niezastąpiona.
Co potrzebujemy?
- Środowisko uruchomieniowe Java(TM)
- ZXing 1.7 - http://code.google.com/p/zxing/downloads/list
- Zestaw narzędzi Apache Ant - http://ant.apache.org/
Kompilacja ZXing
Pierwsze co potrzebujemy to zestaw narzędzi Apache Ant, które pozwolą nam przygotować program ZXing. Zakładam, że każdy ogarnięty użytkownik wie jak je zainstalować. Ponieważ istnieje ogromna ilość systemów zarządzania pakietami w dystrybucjach, pozwolę sobię tą kwestię pominąć. Z góry uznam, że takie narzędzie już posiadacie :)
- unzip ZXing-1.7.zip
- cd zxing
- ant -f core/build.xml
- ant -f javase/build.xml
Jeśli wszystko pójdzie gładko otrzymamy dwa pliki zxing/core/core.jar oraz zxing/javase/javase.jar.
Następnie tworzymy katalog naszego skryptu. Np.:
- qrdecoder/
- |-- java
- | |-- core.jar
- | `-- javase.jar
- |-- scan.sh
- `-- test.png
Zawartość skryptu scan.sh
- #!/bin/sh
- DIRECTORY=$(cd `dirname $0` && pwd)
- java -cp $DIRECTORY/java/javase.jar:$DIRECTORY/java/core.jar \
- com.google.zxing.client.j2se.CommandLineRunner $1
Uruchomienie
Teraz już wystarczy tylko wydać odpowiednie polecenie:
- scan.sh test.png
W odpowiedzi otrzymamy następujący komunikat:
- file:/home/santyago/qrdecoder/test.png (format: QR_CODE, type: TEXT):
- Raw result:
- To jest tekst zakodowany kodem QR
- Parsed result:
- To jest tekst zakodowany kodem QR
- Found 4 result points.
- Point 0: (75.5,273.5)
- Point 1: (75.5,75.5)
- Point 2: (273.5,75.5)
- Point 3: (246.5,246.5)
Jak widać kod QR został poprawnie odnaleziony i odczytany. Zwracany komunikat możemy sobie przefiltrować i wykorzystać w dowolnym celu. Dekoder radzi sobie doskonale w skanowaniu kodów, które znajdują się wśród innych treści jak tekst czy grafika.
Dla leniwców mały gotowiec : Pobierz qrdecoder.tar.gz
Komentarze (1)
Domker_ / 26 cze 2011 / 11:54 Strona www «
"..popularny w dobie smartfonów posiadających specjalny czytnik"
Nie tylko na smartfonach, używam również na prostym fonie z Java. Testowałem wiele aplikacji, ale najlepsza według mnie to i-nigma -> darmowa i świetnie sobie radzi z rozpoznawaniem kodów QR. Brak mi niestety tylko prostego generatora :P