HALCON Website / HALCON Operator-Referenz / XLD / Merkmale
KlassenKlassen | | Operatoren

get_contour_attrib_xldT_get_contour_attrib_xldGetContourAttribXldGetContourAttribXld (Operator)

Name

get_contour_attrib_xldT_get_contour_attrib_xldGetContourAttribXldGetContourAttribXld — Auslesen von Punktattributen einer XLD-Kontur.

Signatur

get_contour_attrib_xld(Contour : : Name : Attrib)

Herror T_get_contour_attrib_xld(const Hobject Contour, const Htuple Name, Htuple* Attrib)

void GetContourAttribXld(const HObject& Contour, const HTuple& Name, HTuple* Attrib)

HTuple HXLDCont::GetContourAttribXld(const HString& Name) const

HTuple HXLDCont::GetContourAttribXld(const char* Name) const

HTuple HXLDCont::GetContourAttribXld(const wchar_t* Name) const   (Nur Windows)

static void HOperatorSet.GetContourAttribXld(HObject contour, HTuple name, out HTuple attrib)

HTuple HXLDCont.GetContourAttribXld(string name)

Beschreibung

get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld liefert für die XLD-Kontur ContourContourContourContourcontour den Wert des für jeden Punkt der Kontur definierten Attributs mit Namen NameNameNameNamename im Parameter AttribAttribAttribAttribattrib zurück. Punktattribute sind für jeden Konturpunkt definierte, zusätzliche Werte und beschreiben lokale Eigenschaften. Welche Punktattribute für eine Kontur definiert sind, kann mit query_contour_attribs_xldquery_contour_attribs_xldQueryContourAttribsXldQueryContourAttribsXldQueryContourAttribsXld abgefragt werden.

Die folgende Aufzählung enthält Informationen über die verschiedenen Punktattribute und die Operatoren, mit welchen sie einer Kontur hinzufügen werden (für Ausnahmen siehe die entsprechende Operatorenreferenz):

'angle'"angle""angle""angle""angle"

Die Richtung der Normalenvektoren einer Kontur wird durch 'angle'"angle""angle""angle""angle" [rad] beschrieben (siehe Bild unten). Dabei sind die Vektoren so orientiert, dass sie auf die rechte Seite der Kontur zeigen (Blickrichtung entlang der Kontur von Start- nach Endpunkt). Die Winkel sind bezüglich der Zeilenachse gegen den Uhrzeigersinn gegeben.

Das Attribut 'angle'"angle""angle""angle""angle" wird durch folgende Operatoren hinzugefügt:

edges_color_sub_pixedges_color_sub_pixEdgesColorSubPixEdgesColorSubPixEdgesColorSubPix, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix, lines_colorlines_colorLinesColorLinesColorLinesColor, lines_facetlines_facetLinesFacetLinesFacetLinesFacet, lines_gausslines_gaussLinesGaussLinesGaussLinesGauss

'response'"response""response""response""response"

'response'"response""response""response""response" gibt die Magnitude des Gradienten einer Kante an (siehe Bild unten).

Das Attribut 'response'"response""response""response""response" wird durch folgende Operatoren hinzugefügt:

edges_color_sub_pixedges_color_sub_pixEdgesColorSubPixEdgesColorSubPixEdgesColorSubPix, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix, lines_colorlines_colorLinesColorLinesColorLinesColor, lines_facetlines_facetLinesFacetLinesFacetLinesFacet, lines_gausslines_gaussLinesGaussLinesGaussLinesGauss

'width_right'"width_right""width_right""width_right""width_right"

Die Linienbreite rechts der Kontur (Blickrichtung entlang der Kontur von Start- nach Endpunkt) wird durch 'width_right'"width_right""width_right""width_right""width_right" [px] beschrieben (siehe Bild unten).

Das Attribut 'width_right'"width_right""width_right""width_right""width_right" wird durch folgende Operatoren hinzugefügt:

lines_colorlines_colorLinesColorLinesColorLinesColor, lines_gausslines_gaussLinesGaussLinesGaussLinesGauss

'width_left'"width_left""width_left""width_left""width_left"

Die Linienbreite links der Kontur (Blickrichtung entlang der Kontur von Start- nach Endpunkt) wird durch 'width_left'"width_left""width_left""width_left""width_left" [px] beschrieben (siehe Bild unten).

Das Attribut 'width_left'"width_left""width_left""width_left""width_left" wird durch folgende Operatoren hinzugefügt:

lines_colorlines_colorLinesColorLinesColorLinesColor, lines_gausslines_gaussLinesGaussLinesGaussLinesGauss

(1) (2) (3)
Darstellung verschiedener Attribute einer Kontur (rot). Der Startpunkt der Kontur ist mit einem weißen Kreuz markiert. (1) Die Normalenvektoren (gelb) einer Kontur werden im Winkel 'angle'"angle""angle""angle""angle" (bezüglich der Zeilenachse) dargestellt, (2) Verhalten des Attributs 'response'"response""response""response""response" entlang einer Kontur, und (3) Visualisierung der Linienbreiten 'width_right'"width_right""width_right""width_right""width_right" (gelb) und 'width_left'"width_left""width_left""width_left""width_left" (grün).
'edge_direction'"edge_direction""edge_direction""edge_direction""edge_direction"

Gibt die Richtung der Kante (nicht der Kontur), berechnet aus den Grauwertgradienten in Spalten- und Zeilenrichtung, an. Die Winkel sind bezüglich der Zeilenachse gegen den Uhrzeigersinn gegeben.

Das Attribut 'edge_direction'"edge_direction""edge_direction""edge_direction""edge_direction" [rad] wird durch folgende Operatoren hinzugefügt:

edges_color_sub_pixedges_color_sub_pixEdgesColorSubPixEdgesColorSubPixEdgesColorSubPix, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix

Das Attribut 'edge_direction'"edge_direction""edge_direction""edge_direction""edge_direction" beschreibt die Vektoren (gelb) in Kantenrichtung für jeden Punkt der Kontur (rot).
'asymmetry'"asymmetry""asymmetry""asymmetry""asymmetry"

Das Attribut 'asymmetry'"asymmetry""asymmetry""asymmetry""asymmetry" beschreibt das Verhältnis der Grauwertgradienten zu beiden Seiten der Kontur. Befindet sich der asymmetrische Bereich, d.h. der Bereich mit dem schwächeren Gradienten zur rechten Seite der Linie (Blickrichtung von Start- zu Zielpunkt), so hat 'asymmetry'"asymmetry""asymmetry""asymmetry""asymmetry" einen positiven Wert. Befindet sich der schwächere Gradient links der Linie, ist der Wert negativ (siehe Bild unten).

Das Attribut 'asymmetry'"asymmetry""asymmetry""asymmetry""asymmetry" wird durch folgenden Operator hinzugefügt:

lines_gausslines_gaussLinesGaussLinesGaussLinesGauss

'contrast'"contrast""contrast""contrast""contrast"

Der Kontrast einer Kontur beschreibt die Grauwertunterschiede zwischen der extrahierten Linie und dem lokalen Hintergrund. Das Attribut 'contrast'"contrast""contrast""contrast""contrast" ist positiv wenn die Linie heller als der Hintergrund ist, für dunklere Linien auf hellerem Grund ist der Wert negativ (siehe Bild unten).

Das Attribut 'contrast'"contrast""contrast""contrast""contrast" wird durch folgenden Operator hinzugefügt:

lines_gausslines_gaussLinesGaussLinesGaussLinesGauss

(1)
(2)
Verhalten der Attribute (1) 'asymmetry'"asymmetry""asymmetry""asymmetry""asymmetry" und (2) 'contrast'"contrast""contrast""contrast""contrast" einer Kontur entlang einer Bildstruktur (der Startpunkt der Kontur ist mit einem weißen Kreuz markiert).
'distance'"distance""distance""distance""distance"

'distance'"distance""distance""distance""distance" [px] gibt den minimalen Abstand zu den Stützpunkten beziehungsweise den Segmenten (je nach Berechnungsmodus) einer Referenzkontur an.

Das Attribut 'distance'"distance""distance""distance""distance" wird durch folgende Operatoren hinzugefügt:

apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldApplyDistanceTransformXld, distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXldDistanceContoursXld

(1) (2)
(1) Abstand ('distance'"distance""distance""distance""distance") einer Kontur (rot) zu den Stützpunkten einer Referenzkontur (grün) und (2) Abstand 'distance'"distance""distance""distance""distance" zu den Segmenten einer Referenzkontur.

Für Informationen über globale Konturrattribute siehe get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldGetContourGlobalAttribXld.

Ausführungsinformationen

Parameter

ContourContourContourContourcontour (input_object)  xld_cont → objectHXLDContHXLDContHobject

Eingabe-Kontur.

NameNameNameNamename (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Name des Attributs.

Defaultwert: 'angle' "angle" "angle" "angle" "angle"

Wertevorschläge: 'angle'"angle""angle""angle""angle", 'edge_direction'"edge_direction""edge_direction""edge_direction""edge_direction", 'width_right'"width_right""width_right""width_right""width_right", 'width_left'"width_left""width_left""width_left""width_left", 'response'"response""response""response""response", 'contrast'"contrast""contrast""contrast""contrast", 'asymmetry'"asymmetry""asymmetry""asymmetry""asymmetry", 'distance'"distance""distance""distance""distance"

AttribAttribAttribAttribattrib (output_control)  real-array → HTupleHTupleHtuple (real) (double) (double) (double)

Zurückgeliefertes Attribut.

Vorgänger

lines_gausslines_gaussLinesGaussLinesGaussLinesGauss, lines_facetlines_facetLinesFacetLinesFacetLinesFacet, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix, distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXldDistanceContoursXld, apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldApplyDistanceTransformXld

Siehe auch

query_contour_attribs_xldquery_contour_attribs_xldQueryContourAttribsXldQueryContourAttribsXldQueryContourAttribsXld, get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldGetContourGlobalAttribXld, query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXld

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH