Barcode-Grafiken aus der eigenen Anwendung generieren - Developer Edition

Unseren Barcode-Generator gibt es in zwei verschiedenen Editionen: Standard und Developer. Die Developer Edition beinhaltet den vollständigen Funktionsumfang der Standard Edition und erlaubt es zusätzlich, das Programm aus anderen Anwendungen heraus aufzurufen, um Barcode-Grafiken im Hintergrund zu generieren. Beim Anwender werden dabei grundlegende Kenntnisse einer geeigneten Programmiersprache vorausgesetzt.

Die Schnittstelle

Schnittstelle ist eine ausführbare Datei Namens bcvc.exe (Barcode Vectorizer Command Line), welche sich im Installationsordner des Programms befindet. Hilfe zur Benutzung erhalten Sie durch einen parameterlosen Aufruf dieser Datei von der Kommandozeile:

Barcode Vectorizer - Konsole

Syntax

Syntax: bcvc [options] BarcodeNumber DesignFile OutputFile
Beispiel: bcvc -hres=600 -vres=600 -colorspace=cmyk "123456" design.bcvp output.eps
Die drei Parameter BarcodeNumber, DesignFile und OutputFile können bei Bedarf - etwa wenn sie Leerzeichen enthalten - jeweils in Anführungszeichen gesetzt werden. Das Ziel-Grafikformat ermittelt das Programm automatisch aus der Dateiendung von OutputFile. Zulässig sind die Dateiendungen: .pdf .eps .svg .png .bmp .jpg .jpeg. Die Datei DesignFile muss im Vorfeld über die GUI angefertigt worden sein und fungiert als Vorlage.

Zusammen mit der Barcode-Nummer kann - bei Barcode-Typen, bei denen dies vorgesehen ist - optional eine Add-On-Nummer übermittelt werden. Dazu muss Letztere getrennt durch ein #-Zeichen hinter die Erstere geschrieben werden. Beispiel:
1234567890128#12345

Als [options] stehen folgende Parameter zur Verfügung:
-hres und -vres - Horizontale und vertikale Auflösung (dpi) für die zu generierende Grafik. Die beiden Parameter sind optional für Vektorformate, vorgeschrieben für Pixelformate.

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

-colorspace - RGB (Standardwert) oder CMYK. Der Parameter ist optional und wird ignoriert, falls das Zielformat ein anderes ist als PDF oder EPS.

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

Fehlerbehandlung

Beim Beenden liefert die Kommandozeilen-Schnittstelle einen sogenannten Exit Code zurück (in der Programmierung von Batch-Dateien auch als ERRORLEVEL bezeichnet). Der Exit Code ist im Allgemeinen eine Ganzzahl, welche Auskunft darüber gibt, auf welche Weise und mit welchem Ergebnis ein Programm beendet wurde. Programmiersprachen, welche in der Lage sind, (externe) Prozesse zu starten, stellen idR. auch Funktionen bzw. Methoden zum Abfragen des Exit Code nach Beendigung eines Prozesses zur Verfügung. Ein aufrufendes Programm kann sich dieser Funktionen bedienen, um auf mögliche Zustände/Fehler angemessen zu reagieren.

Folgende Exit Codes kann Barcode Vectorizer zurückliefern:
0 - Barcode-Grafik wurde generiert - Programm erfolgreich beendet.
1 - Ungültige Anzahl von Parametern.
11 - "-hres" muss eine Ganzzahl größer als 0 sein.
12 - "-hres"-Parameter ist erforderlich, da Pixelformat (PNG, BMP, JPG).
13 - "-vres" muss eine Ganzzahl größer als 0 sein.
14 - "-vres"-Parameter ist erforderlich, da Pixelformat (PNG, BMP, JPG).
18 - "-tiffres" muss größer oder gleich 0 sein.
20 - Etwas anderes als RGB oder CMYK wurde als "-colorspace" übergeben.
30 - "-designindex" muss eine Ganzzahl zwischen 1 und 20 sein.
31 - "-designindex" ist größer als die tatsächliche Anzahl 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 mit dem vorliegenden Barcode-Typ nicht darstellbar.
70 - Nicht genügend Arbeitsspeicher, evtl. ist die Auflösung unrealistisch hoch gewählt.

Abschließendes

Unter Windows lässt sich per Abfrage der Registry der Ort ermitteln, an dem das Programm installiert ist sowie etliche weitere Informationen. Der Schlüssel dazu lautet:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\
CurrentVersion\Uninstall\bcv7f791796fe94af55094ccc34e19b8be7_is1
Hinweis: Es kann leider nicht gänzlich ausgeschlossen werden, dass sich dieser Schlüssel sowie etwaige Unterschlüssel mit einer zukünftigen Programmversion ändern. (Z.B. aufgrund einer Portierung des Programms auf 64 Bit oder eines Austausches des Installationsprogramms.) Bitte behalten Sie dies bei eventuellen Updates daher sinnvollerweise im Auge.
SOFTWARE :: Barcode ForgeBarcode VectorizerSoftware-DownloadDeveloper EditionBarcode-TypenGS1-128 / EAN-128NeuerungenNewsletter Genius1A Bildsauger
NAVIGATION :: StartseiteBestellenSupportKundenAGBImpressum
© 2005-2021 by Viktor Wedel Software Design