Zum Hauptinhalt springen
Mit diesem Objekt können Sie die Parameter für die Erkennung von Barcode-Blöcken anpassen. Jeder Barcode-Block im Layout besitzt ein eigenes untergeordnetes Objekt vom Typ BarcodeParams. Außerdem wird dieses Objekt als Unterobjekt des Objekts PageAnalysisParams an die Funktionen von ABBYY FineReader Engine zur Layoutanalyse und -erkennung übergeben. Die Erkennungsfunktionen verwenden die in den untergeordneten Objekten vom Typ BarcodeParams der Barcode-Blöcke festgelegten Parameter für die Barcode-Erkennung und nicht die im Unterobjekt des an diese Funktionen übergebenen Objekts PageAnalysisParams angegebenen. Jedes Mal, wenn während der Layoutanalyse ein Barcode-Block erstellt wird, werden die Eigenschaften seines untergeordneten Objekts vom Typ BarcodeParams mit den Werten der Eigenschaften des BarcodeParams-Objekts initialisiert, das an die Layoutanalysefunktion übergeben wurde. Die Eigenschaften eines Barcode-Blocks, der mithilfe der Methode AddNew des Objekts Layout erstellt wird, werden auf sinnvolle Standardwerte gesetzt. Informationen zum jeweiligen Standardwert finden Sie in der Beschreibung der entsprechenden Eigenschaft. Nützliche Empfehlungen zur Barcode-Verarbeitung finden Sie unter Barcodes erkennen. Das BarcodeParams-Objekt ist ein persistentes Objekt. Das bedeutet, dass der aktuelle Zustand des Objekts in einem persistenten Speicher abgelegt werden kann. Später kann das Objekt erneut erstellt werden, indem sein Zustand aus dem persistenten Speicher gelesen wird. Die folgenden Methoden ermöglichen die Persistenz des Objekts: Linux: SaveToFile und LoadFromFile Windows: SaveToFile, LoadFromFile, SaveToMemory und LoadFromMemory.

Eigenschaften

,read-only

Returns the Engine object.

Specifies whether the barcodes checking classifier can be used. This classifier verifies if there are barcodes on the image.

This property does not work with the postal barcodes.

The default value of this property is TRUE.

The value of this property is an OR superposition of theenumeration constants which denote the types of barcode orientation. For example, if it is set to BO_Left_To_Right | BO_Down_To_Top, ABBYY FineReader Engine will presume that barcode blocks may be oriented either from left to right or from down to top, ignoring all other variants.

By default, this property is set to BO_Autodetect, i.e., ABBYY FineReader Engine will detect the barcode orientation automatically.

The value of this property is an OR superposition of theenumeration constants which denote the types of barcodes. For example, if it is set to BT_EAN13 | BT_EAN8, ABBYY FineReader Engine will try to recognize barcode blocks in eitherEAN 13 or EAN 8standard, ignoring all other variants.

By default, this property is set to BT_Autodetect, i.e., ABBYY FineReader Engine will detect the barcode type automatically.

The default value allows detecting barcodes of all supported types. However, we recommend excludingIATA 2 of 5,Interleaved 2 of 5, andMatrix 2 of 5barcode types unless you are certain that they will occur on your images. Barcodes of these types do not have a checksum and can therefore be mistakenly found on image areas that do not actually contain any barcodes.

Diese Eigenschaft wird zur Erkennung vonPDF417,Aztec,Data Matrix,QR Code,MaxiCodeBarcodes verwendet, die nicht den Barcode-Spezifikationen entsprechen. Verwenden Sie diese Eigenschaft nicht für Barcodes, die gemäß den Barcode-Spezifikationen erstellt wurden. Manche Barcodedrucker verwenden andere Codepages als die in den Spezifikationen vorgeschriebenen. Verwenden Sie in diesem Fall diese Eigenschaft, um die Codepage anzugeben, die der Barcodedrucker beim Erstellen des Barcodes verwendet hat. In den meisten Fällen ist dies die Codepage des Betriebssystems, unter dem der Barcodedrucker betrieben wurde.

The following code pages are required by the specifications:
  • for PDF417 — DOS United States (437) (CP_US_MSDOS)
  • for Aztec, DataMatrix, QR Code, MaxiCode — ISO Latin 1 (8859-1) (CP_Latin_ISO)

The property is used to convert recognized data to a Unicode string.

Standardmäßig ist diese Eigenschaft auf CP_Null gesetzt, d. h., es wird die von der Spezifikation geforderte Codepage verwendet.

Diese Eigenschaft ist nur fürPDF417,Aztec,Data Matrix,QR CodeBarcodes relevant, die Binärdaten kodieren. Die Eigenschaft bestimmt, wie Binärdaten im erkannten Text dargestellt werden.

Wenn diese Eigenschaft auf TRUE gesetzt ist, werden die in einem Barcode kodierten Binärdaten als Folge von Hexadezimalwerten der entsprechenden Bytes gespeichert. Ist diese Eigenschaft FALSE, werden die Binärdaten mithilfe der in der Eigenschaft CodePage angegebenen Codepage in einen Unicode-String umgewandelt.

Bei Barcode-Symbolen, die Binärdaten entsprechen, ist die EigenschaftIBarcodeSymbol::IsBinaryDataauf TRUE gesetzt.

Standardmäßig ist der Wert dieser Eigenschaft FALSE.

Gibt an, ob der zu erkennende Barcode als Barcode desselben Typs, jedoch mit Prüfsumme, interpretiert werden soll. Diese Eigenschaft ist nur für Barcodes der TypenCode 39,Interleaved 2 of 5,Codabar, undMatrix 2 of 5verfügbar.

Obwohl Codabar keine Prüfziffer besitzt, verwendet ABBYY FineReader Engine einen Algorithmus zur Berechnung von Prüfziffern gemäß Modulo 16. Die Prüfziffer wird wie folgt berechnet: Jedem Codabar-Zeichen ist ein Wert zugeordnet. Die Summe aller Zeichenwerte wird gebildet, einschließlich der Start- und Stoppzeichen. Das Datenzeichen, dessen Wert addiert zu dieser Summe ein Vielfaches von 16 ergibt, ist die Prüfziffer.

Standardmäßig ist diese Eigenschaft auf FALSE gesetzt.

Diese Eigenschaft ist veraltet und wird in zukünftigen Versionen entfernt.

Der Wert dieser Eigenschaft ist eine ODER-Verknüpfung der Enumerationskonstanten von. Diese Eigenschaft ist nur für Barcodes der TypenEAN 8, 13,UPC-A, undUPC-Everfügbar. Wenn sie beispielsweise auf BS_Void | BS_2Digits gesetzt ist, versucht ABBYY FineReader Engine, Barcode-Blöcke entweder ohne Zusatzbarcode oder mit einem 2-stelligen Zusatzbarcode zu erkennen.

Standardmäßig ist diese Eigenschaft auf BS_Autodetect gesetzt, d. h., ABBYY FineReader Engine erkennt den Typ des Zusatzbarcodes automatisch.

Methoden

NameBeschreibung
CopyFromInitialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.
LoadFromFileStellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory <Note> : Nur unter Windows. </Note>Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.
SaveToFileSpeichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory <Note> : Nur unter Windows. </Note>Speichert den Inhalt des Objekts im globalen Speicher.
BarcodeParams Objektdiagramm

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der Methode CreateBarcodeParams des Objekts Engine.

Eingabeparameter

Dieses Objekt wird als Eingabeparameter an folgende Methoden übergeben:

Siehe auch

Barcodes erkennen Barcode-Typen Parameter für die Vorverarbeitung, Analyse, Erkennung und Synthese abstimmen Arbeiten mit Eigenschaften