Code

Określa rodzaj rysowanego kodu kreskowego.

Wartość domyślna: 'Code=Code128A;'

Domyślnie rysowany jest Code-128A.

Przykład: 'Code=Code39;'

Użycie takiego parametru spowoduje wyświetlenie kodu kreskowego Code-39.

Dopuszczalne wartości:

Rect

Definiuje prostokąt, w którym zostanie narysowany kod kreskowy. Współrzędne prostokąta powinny być podawane w mikrometrach, jako cztery liczby całkowite oddzielone przecinkami. Podane liczby określają kolejno współrzędne lewego-górnego i prawego-dolnego wierzchołka prostokąta. Prostokąt służy do pozycjonowania kodu kreskowego, a nie do jego obcinania. Nawet jeśli rozmiar prostokąta jest mniejszy od rozmiaru kodu kreskowego, to kod kreskowy zostanie poprawnie narysowany i będzie wychodził poza obręb prostokąta.

Wartość domyślna: 'Rect=10000,10000,130000,100000;'

Domyślnie wierzchołki prostokąta leżą w odległości (10mm,10mm) i (130mm,100mm) od początku obszaru rysowania (patrz: Uwagi).

Przykład: 'Rect=12000,13000,170000,110000;'

Podanie takiego parametru spowoduje wyświetlenie kodu kreskowego wewnątrz prostokąta, którego lewy górny wierzchołek leży w punkcie w odległości (12mm,13mm), a prawy dolny wierzchołek leży w punkcie (170mm,110mm) od początku obszaru rysowania (patrz: Uwagi).

Dopuszczalne wartości: Każda ze współrzędnych wierzchołków prostokąta musi być liczba całkowitą z zakresu od -2147483648 do +2147483647.

Uwagi: Układ współrzędnych zaczyna się w lewym górnym rogu obszaru rysowania (ekran lub kartka papieru). Wartości dodatnie w osi x oznaczają przesunięcie w prawo, ujemne - przesunięcie w lewo. Wartości dodatnie w osi y oznaczają przesunięcie w dół, ujemne - przesunięcie w górę.

Scale

Określa skalę w jakiej zostanie narysowany kod kreskowy (w poziomie i w pionie). Skala podawana jest w procentach. Wartość 100 oznacza skalę 1:1 (czyli 100%). Nadmierna zmiana skali może spowodować, że czytnik nie odczyta poprawnie kodu kreskowego.

Wartość domyślna: 'Scale=100;'

Domyślnie kod rysowany jest w skali 1:1.

Przykład: 'Scale=120;'

Podanie takiego parametru spowoduje wyświetlenie kodu kreskowego powiększonego o 20%.

Dopuszczalne wartości: Skala musi być liczba całkowitą z zakresu od 1 do 2147483647.

Uwagi: Parametr ten dotyczy skalowania jednocześnie w poziomie i w pionie. Jeśli kod kreskowy ma być wyświetlony w innej skali w pionie i w poziomie to nie należy podawać tego parametru, tylko niezależnie ustawiać skalę w poziomie i w pionie za pomocą parametrów HorzScale i VertScale.

HorzScale

Określa skalę w poziomie w jakiej zostanie narysowany kod kreskowy. Skala podawana jest w procentach. Parametr ten jest ignorowany, jeśli podano parametr Scale.

Wartość domyślna: 'HorzScale=100;'

Domyślnie kod rysowany jest w poziomie w skali 1:1.

Przykład: 'HorzScale=120;'

Podanie takiego parametru spowoduje rozciągnięcie kodu kreskowego o 20% w poziomie.

Dopuszczalne wartości: Parametr musi być liczba całkowitą z zakresu od 1 do 2147483647.

VertScale

Określa skalę w pionie w jakiej zostanie narysowany kod kreskowy. Skala podawana jest w procentach. Parametr ten jest ignorowany, jeśli podano parametr Scale.

Wartość domyślna: 'VertScale=100;'

Domyślnie kod rysowany jest w pionie w skali 1:1.

Przykład: 'VertScale=120;'

Podanie takiego parametru spowoduje rozciągnięcie kodu kreskowego o 20% w pionie.

Dopuszczalne wartości: Parametr musi być liczba całkowitą z zakresu od 1 do 2147483647.

DPI

Określa rozdzielczość w jakiej zostanie narysowany kod kreskowy (w poziomie i w pionie). Rozdzielczość podawana jest jako liczba całkowita w punktach na cal (dots per inch). Rozdzielczość powinna być ustawiona na wartość odpowiadającą rozdzielczości docelowego urządzenia, na którym będzie drukowany kod, na przykład drukarki.

Wartość domyślna: 'DPI=96;'

Domyślnie kod rysowany jest w rozdzielczości ekranu komputera, czyli 96 punktów na cal.

Przykład: 'DPI=600;'

Podanie takiego parametru spowoduje wyświetlenie lub wydrukowanie kodu kreskowego w rozdzielczości 600 punktów na cal, co odpowiada typowej rozdzielczości drukarek laserowych.

Dopuszczalne wartości: Rozdzielczość musi być liczba całkowitą z zakresu od 0 do 2147483647. Jeśli wartość tego parametru jest równa 0 (zero), wtedy brane są pod uwagę parametry HorzDPI oraz VertDPI.

Uwagi: Parametr ten dotyczy zmiany rozdzielczości jednocześnie w poziomie i w pionie. Jeśli kod kreskowy jest drukowany lub wyświetlany na urządzeniu, które ma różną rozdzielczość w pionie i w poziomie, to nie należy podawać tego parametru, tylko niezależnie ustawiać rozdzielczość w poziomie i w pionie za pomocą parametrów HorzDPI i VertDPI.

HorzDPI

Określa rozdzielczość w poziomie w jakiej zostanie narysowany lub wydrukowany kod kreskowy. Rozdzielczość podawana jest w punktach na cal (dots per inch). Parametr ten jest ignorowany, jeśli podano parametr DPI.

Wartość domyślna: 'HorzDPI=96;'

Domyślnie kod rysowany jest w rozdzielczości ekranu, czyli 96 punktów na cal.

Przykład: 'HorzDPI=600;'

Podanie takiego parametru spowoduje ustawienie poziomej rozdzielczości na wartość 600 punktów na cal.

Dopuszczalne wartości: Parametr musi być liczba całkowitą z zakresu od 1 do 2147483647.

VertDPI

Określa rozdzielczość w pionie w jakiej zostanie narysowany lub wydrukowany kod kreskowy. Rozdzielczość podawana jest w punktach na cal. Parametr ten jest ignorowany, jeśli podano parametr DPI.

Wartość domyślna: 'VertDPI=96;'

Domyślnie kod rysowany jest w pionie w skali 1:1.

Przykład: 'VertDPI=600;'

Podanie takiego parametru spowoduje ustawienie pionowej rozdzielczości na wartość 600 punktów na cal.

Dopuszczalne wartości: Parametr musi być liczba całkowitą z zakresu od 1 do 2147483647.

Module

Definiuje szerokość modułu podstawowego (najwęższego). Szerokość modułu podstawowego jest podawana w mikrometrach, czyli wartość 1000 odpowiada szerokości 1 mm. Każdy kod kreskowy ma określony dopuszczalny zakres szerokości modułu podstawowego, który najczęściej waha się w granicach od 0,3 mm do 2,5 mm. Ten parametr jest jednym z krytycznych parametrów kodu kreskowego, mającym decydujący wpływ na możliwość jego odczytania przez czytnik. Zmieniając ten parametr należy mieć na uwadze wytyczne zawarte w normach opisujących poszczególne rodzaje kodów kreskowych.

Wartość domyślna: 'Module=1000;'

Domyślnie moduł podstawowy ma szerokość 1 mm.

Przykład: 'Module=1200;'

Podanie takiego parametru spowoduje ustawienie szerokości modułu podstawowego na wartość 1,2 mm.

Dopuszczalne wartości: Moduł może być liczba całkowitą z zakresu od 1 do 2147483647.

Ratio

Współczynnik powiększenia modułu pochodnego podawany w mikrometrach. Parametr ten odpowiada za szerokości modułów pochodnych. Szerokość każdego z modułów pochodnych jest wielokrotnością szerokości modułu podstawowego ze współczynnikiem Ratio. Każdy kod kreskowy ma określony zakres zmian tego parametru, przy czym wartość najczęściej stosowana to 2 mm. Należy pamiętać, że podobnie jak parametr Module, ten parametr jest znaczący dla jakości kodu kreskowego i możliwości jego odczytania przez czytnik. Podczas doboru tego parametru należy ściśle stosować się do norm opisujących określony rodzaj kodu kreskowego.

Wartość domyślna: 'Ratio=2000;'

Domyślnie współczynnik modułów pochodnych ma wartość 2 mm.

Przykład: 'Ratio=2200;'

Podanie takiego parametru spowoduje ustawienie współczynnika szerokości modułów pochodnych na wartość 2,2 mm.

Dopuszczalne wartości: Parametr może być liczbą całkowitą z zakresu od 1 do 2147483647.

Height

Określa wysokość rysowanego kodu kreskowego. Wysokość podawana jest w mikrometrach. Wysokość kodu można dobierać w dość szerokim zakresie, ale należy mieć na uwadze ograniczenia zawarte w normach opisujących poszczególne rodzaje kodów kreskowych.

Wartość domyślna: 'Height=35000;'

Domyślna wysokość kodu kreskowego to 35 mm.

Przykład:'Height=20000;'

Podanie takiego parametru spowoduje narysowanie kodu kreskowego o wysokości 20 mm.

Dopuszczalne wartości:Liczba całkowita z zakresu od od 1 do 2147483647.

Angle

Kąt obrotu kodu kreskowego. Poprzez zmianę wartości tego parametru można obrócić rysunek kodu kreskowego o dowolny kąt. Wartość kąta należy podawać w dziesiątych częściach stopnia. Jeśli kod kreskowy ma być obrócony o kąt 36,5 stopnia, to parametr ten powinien mieć wartość 365. Dodatnia wartość kąta powoduje obrót w kierunku przeciwnym do wskazówek zegara. Najczęściej stosowane wartości kąta to 0°, 90°, 180° i 270° czyli wartości parametru 0, 900, 1800, 2700.

Wartość domyślna:'Angle=0;'

Domyślny kąt obrotu kodu kreskowego to 0°.

Przykład:'Angle=-900;'

Podanie takiego parametru spowoduje obrót kodu kreskowego o kąt 90° zgodnie z ruchem wskazówek zegara.

Dopuszczalne wartości:liczba całkowita z zakresu od -3600 do 3600.

BarColor

Kolor ciemnych kresek kodu. Najczęściej, ciemne kreski kodu są rysowane w kolorze czarnym, ale można to zmienić ustawiając odpowiednią wartość tego parametru. Kolor podawany jest jako trójka liczb całkowitych oddzielonych przecinkami oznaczających odpowiednio wartości R (kanał czerwony), G (kanał zielony), B (kanał niebieski). Należy pamietać, że zmiana koloru ciemnych kresek może mieć wpływ na jakość odczytu kodu przez czytniki, bardzo istotny jest odpowiedni kontrast pomiedzy ciemnymi kreskami, a jasnymi odstępami.

Wartość domyślna:'BarColor=0,0,0;'

Domyślny kolor ciemnych kresek to czarny (RGB=0,0,0).

Przykład:'BarColor=0,255,0;'

Podanie takiego parametru spowoduje narysowanie ciemnych kresek w kolorze zielonym (RGB=0,255,0).

Dopuszczalne wartości:każda z liczb określających kanał RGB musi być z zakresu od 0 do 255.

SpaceColor

Kolor jasnych kresek kodu (odstępów). Najczęściej, jasne kreski kodu (odstępy) są rysowane w kolorze białym. Kolor podawany jest jako trójka liczb całkowitych oddzielonych przecinkami oznaczających odpowiednio wartości R (kanał czerwony), G (kanał zielony), B (kanał niebieski). Należy pamietać, że zmiana koloru jasnych kresek może mieć wpływ na jakość odczytu kodu przez czytniki. Istotny jest odpowiedni kontrast pomiędzy ciemnymi kreskami, a jasnymi odstępami.

Wartość domyślna:'SpaceColor=255,255,255;'

Domyślny kolor odstępów to biały (RGB=255,255,255).

Przykład:'SpaceColor=255,0,0;'

Podanie takiego parametru spowoduje narysowanie odstępów w kolorze czerwonym (RGB=255,0,0).

Dopuszczalne wartości:każda z liczb określających kanał RGB musi być z zakresu od 0 do 255.

FontName

Nazwa czcionki, która zostanie użyta do wyświetlenia czytelnej dla użytkownika części kodu kreskowego. Za pomocą tego parametru można dowolnie dobrać rodzaj czcionki użytej do wyświetlenia wartości kodu kreskowego jak i opisu typu kodu.

Wartość domyślna:'FontName=Arial;'

Domyślna czcionka to 'Arial'.

Przykład:'FontName=Times New Roman;'

Podanie takiego parametru spowoduje narysowanie tekstu z użyciem czcionki szeryfowej 'Times New Roman'.

Dopuszczalne wartości:dowolny tekst będący poprawną nazwą czcionki zainstalowanej w systemie Windows(TM).

FontSize

Wysokość czcionki tekstu wyrażona w punktach. Za pomocą tego parametru można dowolnie dobrać wysokość czcionki użytej do wyświetlenia wartości kodu kreskowego i opisu typu kodu.

Wartość domyślna:'FontSize=10;'

Domyślna wysokość czcionki to 10 pt.

Przykład:'FontSize=18;'

Podanie takiego parametru spowoduje narysowanie tekstu z użyciem czcionki o wysokości 18 pt.

Dopuszczalne wartości:liczba całkowita z zakresu od 5 do 72.

FontStyle

Styl czcionki. Za pomocą tego parametru można dobrać styl czcionki użytej do wyświetlenia wartości kodu kreskowego i opisu typu kodu. Parametr może być kombinacją takich stylów czcionki jak: pogrubienie (bold), kursywa (italic), podkreślenie(underline) i przekreślenie (strikeout).

Wartość domyślna:'FontStyle=;'

Domyślny styl czcionki jest pustym łańcuchem, co oznacza, że czcionka nie będzie modyfikowana.

Przykład:'FontStype=bold,italic;'

Podanie takiego parametru spowoduje narysowanie tekstu z użyciem pogrubionej kursywy.

Dopuszczalne wartości:kombinacja napisów: bold, italic, underline, strikeout lub pusty łańcuch.

ShowCode

Parametr określający, czy zostanie wyświetlony tekst będący czytelną dla człowieka wartością kodu kreskowego.

Wartość domyślna:'ShowCode=true;'

Domyślnie wartość kodu kreskowego jest zawsze wyświetlana.

Przykład:'ShowCode=false;'

Podanie takiego parametru spowoduje, że wartość kodu kreskowego nie bedzie wyświetlana.

Dopuszczalne wartości:łańcuch tekstowy true lub false. Wartość true oznacza, że wartość kodu zostanie wyświetlona, a wartość false oznacza, że nie będzie wyświetlana.

ShowType

Flaga określająca, czy zostanie wyświetlony typ kodu kreskowego. Ustawienie tego parametru na wartość true spowoduje wyświetlenie nazwy typu kodu obok jego wartości. Wyświetlenie typu kodu jest opcjonalne i nie jest wymagane normami dotyczącymi kodów kreskowych.

Wartość domyślna:'ShowType=false;'

Domyślnie typ kodu nie jest wyświetlany.

Przykład:'ShowType=true;'

Podanie takiego parametru spowoduje wypisanie typu kodu kreskowego.

Dopuszczalne wartości:łańcuch tekstowy true lub false. Wartość true oznacza, że typ kodu zostanie wyświetlony, a wartość false oznacza, że nie będzie wyświetlony.

ShowFrame

Flaga określająca, czy zostanie narysowana ramka wokół kodu kreskowego. Rozmiar ramki jest zdefiniowny prostokątem rysowania podanym w parametrze Rect.

Wartość domyślna:'ShowFrame=true;'

Domyślnie ramka jest rysowana.

Przykład:'ShowFrame=false;'

Podanie takiego parametru spowoduje wyłączenie rysowania ramki wokół kodu kreskowego.

Dopuszczalne wartości:łańcuch tekstowy true lub false. Wartość true oznacza, że ramka zostanie narysowana, a wartość false oznacza, że ramka nie będzie rysowana.

CheckSum

Flaga automatycznego wyliczania sumy kontrolnej. Niektóre kody kreskowe wymagają zastosowania sumy kontrolnej. Jeżeli ten parametr ma wartość true, to suma kontrolna będzie wyliczana automatycznie. W takim przypadku nie należy w wartości kodu umieszczać znaku sumy kontrolnej. W przeciwnym razie aplikacja musi sama wyliczyć znak sumy kontrolnej i dołączyć go do podawanej wartości kodu.

Wartość domyślna:'CheckSum=true;'

Domyślnie suma kontrolna jest wyliczana automatycznie.

Przykład:'CheckSum=false;'

Podanie takiego parametru spowoduje wyłączenie wyliczania sumy kontrolnej.

Dopuszczalne wartości:łańcuch tekstowy true lub false. Wartość true oznacza, że suma kontrolna będzie wyliczana, a wartość false oznacza, że suma nie będzie wyliczana.

HorzAlign

Wyrównanie w poziomie rysunku kodu kreskowego względem prostokąta rysowania podanego w parametrze Rect. Wartość left spowoduje, że kod kreskowy będzie dosunięty do lewej krawędzi tego prostokąta, right - do prawej krawędzi, a center spowoduje jego wyśrodkowanie. Prostokąt rysowania nie jest prostokątem obcinania i jeśli nawet obszar prostokąta będzie mniejszy niż rozmiar rysunku kodu kreskowego, to kod zostanie poprawnie narysowany.

Wartość domyślna:'HorzAlign=center;'

Domyślnie rysunek kodu kreskowego jest wyśrodkowany w poziomie względem prostokąta rysowania.

Przykład:'HorzAlign=right;'

Podanie takiego parametru spowoduje wyrównanie rysunku kodu do prawej krawędzi prostokąta rysowania.

Dopuszczalne wartości:łańcuch tekstowy center, left lub right.

VertAlign

Wyrównanie w pionie rysunku kodu kreskowego względem prostokąta rysowania podanego w parametrze Rect. Wartość top spowoduje, że kod kreskowy będzie dosunięty do górnej krawędzi tego prostokąta, bottom - do dolnej krawędzi, a center spowoduje jego wyśrodkowanie. Prostokąt rysowania nie jest prostokątem obcinania i jeśli nawet obszar prostokąta będzie mniejszy niż rozmiar rysunku kodu kreskowego, to kod zostanie poprawnie narysowany.

Wartość domyślna:'VertAlign=center;'

Domyślnie rysunek kodu kreskowego jest wyśrodkowany w pionie względem prostokąta rysowania.

Przykład:'VertAlign=bottom;'

Podanie takiego parametru spowoduje wyrównanie rysunku kodu do dolnej krawędzi prostokąta rysowania.

Dopuszczalne wartości:łańcuch tekstowy center, top lub bottom.