F_VN_GradeBarcodeExp

Syntax

Definition:

FUNCTION F_VN_GradeBarcodeExp : HRESULT
VAR_INPUT
    ipSrcImage            : ITcVnImage;
    ipDecodedData         : Reference To  ITcVnContainer;
END_VAR
VAR_IN_OUT
    stCodeGrades          : TcVnCodeGrades1D;
END_VAR
VAR_INPUT
    eBarcodeType          : ETcVnBarcodeType;
    eSearchDirection      : ETcVnBarcodeSearchDirection;
    ipResultVisualization : Reference To  ITcVnImage;
    ipScanLineInfo        : Reference To  ITcVnContainer;
    ipContour             : Reference To  ITcVnContainer;
    hrPrev                : HRESULT;
END_VAR
VAR_OUTPUT
    fAngleDeg             : REAL;
END_VAR

 Inputs

 In/Outputs

 Outputs

 Return value

HRESULT

Weiterführende Informationen

Die Funktion F_VN_GradeBarcodeExp ist eine Expert-Variante von F_VN_GradeBarcode. Sie enthält zusätzliche Parameter.

Parameter

Eingangsbild

Das Eingangsbild ipSrcImage muss ein 1-kanaliges Bild mit Element-Typ USINT (8 Bit) sein. Das Eingangsbild darf nur den zu prüfenden Code, einschließlich der entsprechenden Ruhezonen, beinhalten. Der Strichcode muss horizontal oder vertikal ausgerichtet sein und darf keinen Text oder Leerraum auf mehr als 10% der Gesamthöhe ober- oder unterhalb aufweisen. Die Ruhezonen befinden sich bei horizontaler Ausrichtung links und rechts vom Code.

Um aussagekräftige Ergebnisse zu erzielen sind eine gleichmäßige Beleuchtung, nicht unter- oder überbelichtet, eine gute Fokussierung auf die Codeebene und eine dazu parallel ausgerichtete Bildsensorebene erforderlich. Weiterhin muss die Bildauflösung entsprechend der Strichstärke hoch genug sein. Bei Strichcodes sollte die minimale Strichbreite mit mindestens 3 Pixeln abgedeckt werden, um gute Ergebnisse zu erhalten.

Gelesene Daten

Die aus dem Code gelesenen Daten werden als String in dem Container ipDecodedData zurückgegeben. Der Container ist dabei vom Typ ContainerType_String_SINT. Wurde der Code erfolgreich gefunden und decodiert kann der Inhalt über die Funktion F_VN_ExportContainer_String in einen String exportiert werden.

hr := F_VN_ExportSubContainer_String(ipDecodedData, sText, nMaxLength, hr);

Unterschiedliche Dekodierergebnisse Die Dekodierung mit dem jeweiligen Referenzalgorithmus kann zu abweichenden Ergebnissen führen. Daher ist es möglich, dass der Codeinhalt von anderen Geräten oder Funktionen gelesen werden kann, der Referenzalgorithmus aber fehlschlägt.

Rückgabe der Qualitätsbewertung

Der Rückgabewert stCodeGrades vom Type TcVnCodeGrades1D enthält die ermittelten Einzelergebnisse und ein Gesamtsamtergebnis fOverall. Die Qualitätseinstufung erfolgt von 0 (sehr schlecht) bis 4 (sehr gut). Die Ergebnisse werden über mehrere Scanlinien gemittelt.

Parameter	Beschreibung
fDecode	Bewertet, ob der Code mit dem Referenzalgorithmus dekodiert werden konnte.
fSymbolContrast	Bewertet den globalen Symbolkontrast, d.h. die Differenz zwischen dem hellsten und dunkelsten Wert auf der gesamten Scanlinie.
fMinReflectance	Bewertet das Verhältnis vom dunkelsten zum hellsten Wert der Scanlinien.
fMinEdgeContrast	Bewertet den minimalen lokalen Kontrast benachbarter Elemente der Scanlinien.
fModulation	Bewertet das Verhältnis zwischen dem minimalen lokalen Kontrast und dem globalen Symbolkontrast.
fDefects	Bewertet Unregelmäßigkeiten innerhalb von Elementen und Ruhezonen.
fDecodability	Bewertet, wie verlässlich der Code mit dem Referenzalgorithmus dekodiert werden kann.
fOverall	Die Gesamtnote des Codes ist die niedrigste erreichte Note der Einzelprüfungen, gemittelt über alle Scanlinien. Führen verschiedene Scanlinien zu unterschiedlichen dekodierten Daten, ist die Gesamtnote 0.

Barcode-Typ

Der Parameter eBarcodeType definiert den Barcode-Typ, dessen Druckqualität beurteilt werden soll. Die folgenden Barcode-Typen aus dem Enum ETcVnBarcodeType werden unterstützt:

• TCVN_BT_CODE39
• TCVN_BT_CODE128
• TCVN_BT_EAN8
• TCVN_BT_EAN13
• TCVN_BT_ITF
• TCVN_BT_UPCA
• TCVN_BT_UPCE

Suchrichtung

Über eSearchDirection kann die Suchrichtung vorgegeben werden:

• Bei TCVN_BSD_ANY wird zunächst in horizontaler Richtung und anschließend in vertikaler Richtung gesucht.
• Bei TCVN_BSD_HORIZONTAL wird nur in horizontaler Richtung gesucht.
• Bei TCVN_BSD_VERTICAL wird nur in vertikaler Richtung gesucht.

Ergebnisdarstellung

ipResultVisualization gibt ein Bild mit der Visualisierung der Scanlinien und den jeweiligen Bewertungsergebnissen zurück. Die Linien sind entsprechend der einzelnen Bewertungen farblich kodiert: >= 3 als grün, >= 2 als hellblau, >= 1 als orange, < 1 als rot. Dieser Parameter ist optional und kann auf 0 gesetzt werden, wenn er nicht benötigt wird.

Scanlinien Informationen

ipScanLineInfo liefert zusätzliche Informationen über die einzelnen Scanlinien für eine detailliertere Auswertung zurück. Die Rückgabewerte sind vom Typ ContainerType_Vector_TcVnVector3_REAL und geben pro Scanlinie je nach Ausrichtung den Index der Bildreihe oder Bildspalte, die Gesamtnote und den ermittelten globalen Threshold an. Die einzelnen Linien können z. B. mit F_VN_PlotIntensityProfile visualisiert werden. Dieser Parameter ist optional und kann auf 0 gesetzt werden, wenn er nicht benötigt wird.

Position des Codes

Der Parameter ipContour gibt die Code-Eckpunkte, einschließlich der Ruhezone, als vier Konturpunkte vom Typ ContainerType_Vector_TcVnPoint2_DINT zurück. Die Berechnung basiert nur auf den Scanlinien, die dekodiert werden konnten. Die Kontur kann z.B. direkt mit F_VN_DrawContours gezeichnet oder mit den Funktionen zur Contour Analysis weiter analysiert werden. Dieser Parameter ist optional und kann auf 0 gesetzt werden, wenn er nicht benötigt wird.

Drehwinkel ^{(Rückgabewert)}

fAngleDeg gibt den Drehwinkel im Uhrzeigersinn in 90°-Schritten zurück.

Anwendung

Die Druckqualität von einem Barcode kann z.B. so ermittelt werden:

hr := F_VN_GradeBarcodeExp(
    ipSrcImage            := ipSrcImage,
    ipDecodedData         := ipDecodedData,
    stCodeGrades          := stCodeGrades,
    eBarcodeType          := eBarcodeType,
    eSearchDirection      := eSearchDirection,
    ipResultVisualization := ipResultVisualization,
    ipScanLineInfo        := ipScanLineInfo,
    ipContour             := ipContour,
    hrPrev                := hr,
    fAngleDeg             => fAngleDeg);

Required License

TC3 Vision Code Quality

System Requirements