...

Aby dodać Barcode Reader do systemu należy dodać poniższą zależność do systemu:

<dependency>
	<groupId>com.suncode.barcode</groupId>
	<artifactId>barcode-reader</artifactId>
	<version>2.0.5</version>
</dependency>

...

 Poprawa rozpoznawania kodów o niskiej jakości (od wersji 2.0.7)

W przypadku, gdy skany z kodami kreskowymi są niskiej jakości i standardowy mechanizm ma problemy z ich rozpoznawaniem można w pliku konfiguracyjnym zdefiniować filtry jakie mają być użyte do poprawy jakości kodów zanim zostaną one rozpoznane. Rozpoznawanie przy pomocy filtrów może być stopniowe, czyli program nakłada pierwszy zestaw filtrów, próbuje rozpoznać kod i jeżeli nie rozpozna to w kolejnym kroku stosuje kolejny zestaw zdefiniowanych filtrów i znowu próbuje odczytać kod.

Dostępne są następujące filtry:

• MEDIAN - filtr medianowy, przetwarza piksel na podstawie jego sąsiadów. Ma zastosowanie np.: dla kodów, które są "podziurawione", czyli czarne paski posiadają w środku białe piksele. Jest on nakładany tylko na obrazy czarno-białe i w odcieniach szarości. Dla obrazów kolorowych nie zostanie on nałożony, nawet mimo tego, że zostanie zdefiniowany w konfiguracji.
• AUTOTHRESHOLD - filtr, który automatycznie wyznacza granicę dla danego obrazu na podstawie której określa jaki odcień danego piksela ma zostać zamieniony na kolor czarny, a jaki na kolor biały. Filtr ten nie jest wykorzystywany dla stron, które już został zeskanowane w czarno-bieli.

Konfiguracja filtrów odbywa się bezpośrednio w gałęzi configuration i może wyglądać następująco:

//Zostanie wykonana tylko jedna próba odczytania kodów z zastosowaniem filtru medianowego.
<filters>
	<step>
		<filter type="median" />
	</step>
</filters>

//Zostanie wykonana tylko jedna próba odczytania kodów z zastosowaniem jednocześnie filtru medianowego i autothersholdu.
<filters>
	<step>
		<filter type="median" />
		<filter type="autothreshold" />
	</step>
</filters>

//Zostaną wykonane 3 kroki odczytania kodu.
//Krok 1: Bez zastosowania żadnych filtrów.
//Krok 2: Z zastosowaniem tylko filtra medianowego. Ten krok wykona się tylko w przypadku, gdy w kroku 1 nie zostanie znaleziony żaden kod pasujący do wzorca.
//Krok 3: Z zastosowaniem tylko filtra autothreshold. Ten krok wykona się tylko w przypadku, gdy w kroku 1 i kroku 2 nie zostanie znaleziony żaden kod pasujący do wzorca.
<filters>
	<step></step>
	<step>
		<filter type="median" />
	</step>
	<step>
		<filter type="autothreshold" />
	</step>
</filters>

Jednostka przetwarzania

...

Atrybuty elementu barcode

...

Nazwa	Wymagany	Wartość domyślna	Opis
scale			Parametr określa współczynnik zmiany rozmiaru pliku (jego wysokości i szerokości).
compression		0.75	Parametr określa poziom kompresji podczas generowania nowego pliku. Im wyższa wartość, tym lepsza jakość, ale też większy rozmiar pliku. Wartości mogą być z zakresu 0.1 - 1.0.
method		balanced	Parametr określa metodę skalowania obrazu. Metody dające lepsze wyniki są wolniejsze. Możliwe wartości to: auto, speed, balanced, quality, ultra.

...

<actions>
	<success>
		<move>
	        <destination>
    			<filename>${filename}</filename>
        		<directory path="D:/success"/>
        	</destination>
    	</move>
	</success>
	<error>
    	<copy>
        	<destination>
				<filename>${filename}</filename>
				<directory path="D:/error"/>
			</destination>
		</copy>
	</error>
</actions>