Barcode API: Grafiken aus eigener Applikation erzeugen

Barcode Vectorizer gibt es in zwei Editionen: Standard und Pro. Letztere Edition erweitert das Programm unter anderem um die Möglichkeit (API), hochwertige Barcode-Grafiken aus der eigenen Applikation zu generieren.

Barcode Generator API – Die Schnittstelle

Die Schnittstelle besteht aus einer ausführbaren Datei mit dem Namen bcvc.exe, welche sich im Installationsordner des Programms befindet. Hilfe zur Benutzung erhalten Sie durch einen parameterlosen Aufruf dieser Datei von der Kommandozeile:

Syntax

Syntax: bcvc.exe [options] BarcodeNumber DesignFile OutputFile
Beispiel: bcvc.exe -hres=600 -vres=600 -colorspace=cmyk "123456" design.bcvp output.eps

Die drei Parameter BarcodeNumber, DesignFile und OutputFile müssen jeweils in Anführungszeichen gesetzt sein, wenn sie Leerzeichen enthalten. Das Ziel-Grafikformat ermittelt die API automatisch aus der Dateiendung von OutputFile. Unterstützt werden die Dateiendungen .pdf .eps .svg .png .bmp .jpg. Die Datei DesignFile verweist auf die im GUI-Modus angefertigte Vorlage.

Zusammen mit der Barcode-Nummer kann für Barcode-Typen der UPC-Familie optional eine Add-On-Nummer übermittelt werden. Diese wird durch ein #-Zeichen getrennt hinter die Hauptnummer geschrieben. Beispiel für eine EAN-13 (GTIN-13) mit Add-On 5:

4013456367128#12345

Als [options] stehen folgende Parameter zur Verfügung:

-hres und -vres – Horizontale und vertikale Auflösung (dpi) für die zu generierende Grafik. Diese Parameter sind optional für Vektorformate und erforderlich für Rasterformate.

-tiffres – Nur für EPS: Auflösung (dpi) für die eingebettete TIFF-Vorschau. Default-Wert ist 240, bei 0 wird eine EPS-Datei ohne Vorschau generiert.

-colorspace – RGB (default) oder CMYK. Das CMYK-Farbmodell wird ausschließlich von den Grafikformaten PDF und EPS unterstützt.

-designindex – Index (Ordnungsnummer) der Vorlage innerhalb von "DesignFile". Optionaler Parameter, Default-Wert ist 1.

-silent – Unterdrückt alle Meldungen während der Ausführung. Dieser Parameter erfordert keinen Wert.

Fehlerbehandlung

Die API liefert beim Beenden einen Exit Code zurück – auch bekannt als ERRORLEVEL in der Programmierung von Batch-Dateien. Dieser Exit Code ist eine Ganzzahl, die Auskunft darüber gibt, wie und mit welchem Ergebnis ein Programm beendet wurde. Programmiersprachen, die externe Prozesse starten können, bieten in der Regel Funktionen oder Methoden, um den Exit Code nach Abschluss eines Prozesses abzufragen. Ein aufrufendes Programm kann diese Funktionen verwenden, um auf mögliche Zustände und Fehler angemessen zu reagieren.

Exit Codes:

0 – Generierung der Barcode-Grafik erfolgreich abgeschlossen.
1 – Ungültige Anzahl von Parametern (Hilfe wird angezeigt).
11 – "-hres" muss eine Ganzzahl größer als 0 sein.
12 – "-hres"-Parameter ist erforderlich, da Rasterformat (PNG, BMP, JPG).
13 – "-vres" muss eine Ganzzahl größer als 0 sein.
14 – "-vres"-Parameter ist erforderlich, da Rasterformat (PNG, BMP, JPG).
18 – "-tiffres" muss größer oder gleich 0 sein.
20 – Ungültiger Wert für "-colorspace"; es muss entweder RGB oder CMYK sein.
21 – Das CMYK-Farbmodell wird vom gewählten Grafikformat nicht unterstützt.
30 – "-designindex" muss eine Ganzzahl zwischen 1 und 20 sein.
31 – "-designindex" überschreitet die tatsächliche Anzahl der Vorlagen in "DesignFile".
40 – "DesignFile" nicht gefunden.
41 – Fehler beim Lesen von "DesignFile".
50 – "OutputFile" besitzt keine der unterstützten Dateiendungen.
51 – Verzeichnis für "OutputFile" existiert nicht.
52 – Fehler beim Schreiben von "OutputFile".
60 – Barcode-Nummer ist nicht darstellbar / ungültig.
70 – Nicht genügend Arbeitsspeicher, evtl. ist die Auflösung unrealistisch hoch gewählt.

Bei Exit Code 60 wird als textuelle Fehlermeldung immer die genaue Ursache angegeben, warum die Barcode-Nummer nicht darstellbar ist.