get_contour_global_attrib_xldT_get_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXld (Operator)

Name

get_contour_global_attrib_xldT_get_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXld — Auslesen von globalen Attributen einer XLD-Kontur.

Signatur

get_contour_global_attrib_xld(Contour : : Name : Attrib)

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

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

HTuple HXLDCont::GetContourGlobalAttribXld(const HTuple& Name) const

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

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

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

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

HTuple HXLDCont.GetContourGlobalAttribXld(HTuple name)

HTuple HXLDCont.GetContourGlobalAttribXld(string name)

Beschreibung

get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldGetContourGlobalAttribXld liefert für die XLD-Kontur ContourContourContourContourcontour den Wert des global definierten Attributs mit Namen NameNameNameNamename im Parameter AttribAttribAttribAttribattrib zurück. Globale Attribute sind für eine gesamte Kontur definierte, zusätzliche Werte. Welche globalen Attribute für eine Kontur definiert sind, kann mit query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXld abgefragt werden.

Die folgende Aufzählung enthält Informationen über die verschiedenen globalen Attribute und die Operatoren, mit welchen sie einer Kontur hinzugefügt werden:

'bright_dark'"bright_dark""bright_dark""bright_dark""bright_dark"

Der Typ des Hell-Dunkel-Übergangs wird für jede Ausgabe-Kontur im Attribut 'bright_dark'"bright_dark""bright_dark""bright_dark""bright_dark" gespeichert. Das Attribut bekommt den Wert 1.0, wenn an der Verbindungslinie ein Übergang von hell nach dunkel stattfindet (von links nach rechts, in Blickrichtung vom Anfangs- zum Endpunkt), umgekehrt entspricht der Wert 0.0.

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

connect_grid_pointsconnect_grid_pointsConnectGridPointsConnectGridPointsConnectGridPoints

Beispielkonturen (rot und grün) entlang von Kanten eines Entzerrungsgitters (Richtung von Start- zu Endpunkt durch Pfeil angedeutet). Der Typ des Hell-Dunkel-Übergangs, der im Attribut 'bright_dark'"bright_dark""bright_dark""bright_dark""bright_dark" gespeichert ist, ist 1.0 für rote und 0.0 für grüne Konturen.
'cont_approx'"cont_approx""cont_approx""cont_approx""cont_approx"

Die Unterscheidung, ob eine Ausgabekontur bestenfalls durch ein Liniensegment oder einen Kreis- oder Ellipsenbogen approximiert wird, erfolgt über das globale Konturattribut 'cont_approx'"cont_approx""cont_approx""cont_approx""cont_approx". Falls 'cont_approx'"cont_approx""cont_approx""cont_approx""cont_approx"=-1, ist ein Liniensegment , falls 'cont_approx'"cont_approx""cont_approx""cont_approx""cont_approx"=0 ein Ellipsenbogen und falls 'cont_approx'"cont_approx""cont_approx""cont_approx""cont_approx"=1 ein Kreisbogen am besten dazu geeignet.

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

segment_contours_xldsegment_contours_xldSegmentContoursXldSegmentContoursXldSegmentContoursXld

'is_hole'"is_hole""is_hole""is_hole""is_hole"

Für Konturen, die Löcher umschließen, wird das globale Attribut 'is_hole'"is_hole""is_hole""is_hole""is_hole" auf 1 gesetzt, ansonsten auf 0.

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

symm_difference_closed_contours_xldsymm_difference_closed_contours_xldSymmDifferenceClosedContoursXldSymmDifferenceClosedContoursXldSymmDifferenceClosedContoursXld, difference_closed_contours_xlddifference_closed_contours_xldDifferenceClosedContoursXldDifferenceClosedContoursXldDifferenceClosedContoursXld, intersection_closed_contours_xldintersection_closed_contours_xldIntersectionClosedContoursXldIntersectionClosedContoursXldIntersectionClosedContoursXld, union2_closed_contours_xldunion2_closed_contours_xldUnion2ClosedContoursXldUnion2ClosedContoursXldUnion2ClosedContoursXld

Durch die Anwendung verschiedener Mengenoperatoren auf Konturen wird das globale Konturattribut 'is_hole'"is_hole""is_hole""is_hole""is_hole" für die Ausgabe-Kontur(en) definiert. Im obigen Beispiel werden für zwei Kontur-Sets (rot und grün) Mengenoperationen durchgeführt. Schließen die resultierenden Konturen ein Loch ein (blau) ist 'is_hole'"is_hole""is_hole""is_hole""is_hole" 1.0, andernfalls ist 'is_hole'"is_hole""is_hole""is_hole""is_hole" 0.0 (orange).
'regr_dev_dist'"regr_dev_dist""regr_dev_dist""regr_dev_dist""regr_dev_dist"

'regr_dev_dist'"regr_dev_dist""regr_dev_dist""regr_dev_dist""regr_dev_dist" [px] gibt die Standardabweichung des euklidischen Abstands zwischen den Stützpunkten der Kontur und der Regressionsgeraden an (siehe Bild unten).

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

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

'regr_dist'"regr_dist""regr_dist""regr_dist""regr_dist"

'regr_dist'"regr_dist""regr_dist""regr_dist""regr_dist" [px] gibt den minimalen euklidischen Abstand der Regressionsgerade vom Ursprung des Bildkoordinatensystems an (siehe Bild unten).

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

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

'regr_mean_dist'"regr_mean_dist""regr_mean_dist""regr_mean_dist""regr_mean_dist"

'regr_mean_dist'"regr_mean_dist""regr_mean_dist""regr_mean_dist""regr_mean_dist" [px] gibt den Mittelwert der euklidischen Abstände zwischen den Stützpunkten der Kontur und der Regressionsgeraden an (siehe Bild unten).

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

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

'regr_norm_col'"regr_norm_col""regr_norm_col""regr_norm_col""regr_norm_col"

'regr_norm_col'"regr_norm_col""regr_norm_col""regr_norm_col""regr_norm_col" [px] entspricht der Spaltenkoordinate des normierten Normalenvektors der Regressionsgeraden, wobei der Normalenvektor vom Ursprung des Bildkoordinatensystems Richtung Regressionsgerade zeigt (siehe Bild unten).

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

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

'regr_norm_row'"regr_norm_row""regr_norm_row""regr_norm_row""regr_norm_row"

'regr_norm_row'"regr_norm_row""regr_norm_row""regr_norm_row""regr_norm_row" [px] entspricht der Zeilenkoordinate des normierten Normalenvektors der Regressionsgeraden, wobei der Normalenvektor vom Ursprung des Bildkoordinatensystems Richtung Regressionsgerade zeigt (siehe Bild unten).

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

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

Skizze der Attribute 'regr_dist'"regr_dist""regr_dist""regr_dist""regr_dist", 'regr_norm_col'"regr_norm_col""regr_norm_col""regr_norm_col""regr_norm_col" und 'regr_norm_row'"regr_norm_row""regr_norm_row""regr_norm_row""regr_norm_row" für die lineare Regression einer XLD Kontur (rot). 'regr_mean_dist'"regr_mean_dist""regr_mean_dist""regr_mean_dist""regr_mean_dist" und 'regr_dev_dist'"regr_dev_dist""regr_dev_dist""regr_dev_dist""regr_dev_dist" werden aus den Distanzen (schwarze Pfeile) zwischen den Stützpunkten der Kontur und der Regressionsgeraden (durchgezogene schwarze Linie) berechnet.

Ausführungsinformationen

Parameter

ContourContourContourContourcontour (input_object)  xld_cont objectHXLDContHXLDContHobject

Eingabe-Kontur.

NameNameNameNamename (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Name des Attributs.

Defaultwert: 'regr_norm_row' "regr_norm_row" "regr_norm_row" "regr_norm_row" "regr_norm_row"

Wertevorschläge: 'regr_norm_row'"regr_norm_row""regr_norm_row""regr_norm_row""regr_norm_row", 'regr_norm_col'"regr_norm_col""regr_norm_col""regr_norm_col""regr_norm_col", 'regr_mean_dist'"regr_mean_dist""regr_mean_dist""regr_mean_dist""regr_mean_dist", 'regr_dev_dist'"regr_dev_dist""regr_dev_dist""regr_dev_dist""regr_dev_dist", 'cont_approx'"cont_approx""cont_approx""cont_approx""cont_approx", 'bright_dark'"bright_dark""bright_dark""bright_dark""bright_dark", 'is_hole'"is_hole""is_hole""is_hole""is_hole"

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, segment_contours_xldsegment_contours_xldSegmentContoursXldSegmentContoursXldSegmentContoursXld

Nachfolger

fit_circle_contour_xldfit_circle_contour_xldFitCircleContourXldFitCircleContourXldFitCircleContourXld, fit_ellipse_contour_xldfit_ellipse_contour_xldFitEllipseContourXldFitEllipseContourXldFitEllipseContourXld, fit_line_contour_xldfit_line_contour_xldFitLineContourXldFitLineContourXldFitLineContourXld, fit_rectangle2_contour_xldfit_rectangle2_contour_xldFitRectangle2ContourXldFitRectangle2ContourXldFitRectangle2ContourXld

Siehe auch

query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXld, get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld, query_contour_attribs_xldquery_contour_attribs_xldQueryContourAttribsXldQueryContourAttribsXldQueryContourAttribsXld

Modul

Foundation