union2_closed_contours_xldunion2_closed_contours_xldUnion2ClosedContoursXldUnion2ClosedContoursXldunion2_closed_contours_xld (Operator)

Name

union2_closed_contours_xldunion2_closed_contours_xldUnion2ClosedContoursXldUnion2ClosedContoursXldunion2_closed_contours_xld — Berechnen der Vereinigungsmenge von geschlossenen Konturen.

Signatur

union2_closed_contours_xld(Contours1, Contours2 : ContoursUnion : : )

Herror union2_closed_contours_xld(const Hobject Contours1, const Hobject Contours2, Hobject* ContoursUnion)

Herror T_union2_closed_contours_xld(const Hobject Contours1, const Hobject Contours2, Hobject* ContoursUnion)

void Union2ClosedContoursXld(const HObject& Contours1, const HObject& Contours2, HObject* ContoursUnion)

HXLDCont HXLDCont::Union2ClosedContoursXld(const HXLDCont& Contours2) const

static void HOperatorSet.Union2ClosedContoursXld(HObject contours1, HObject contours2, out HObject contoursUnion)

HXLDCont HXLDCont.Union2ClosedContoursXld(HXLDCont contours2)

def union2_closed_contours_xld(contours_1: HObject, contours_2: HObject) -> HObject

Beschreibung

Der Operator union2_closed_contours_xldunion2_closed_contours_xldUnion2ClosedContoursXldUnion2ClosedContoursXldUnion2ClosedContoursXldunion2_closed_contours_xld berechnet die Vereinigungsmenge der von den geschlossenen Eingabekonturen umgebenen Regionen. Der Rand dieser Vereinigungsmenge wird in ContoursUnionContoursUnionContoursUnionContoursUnioncontoursUnioncontours_union zurückgegeben.

Wenn die einzelnen Eingabekonturen nicht geschlossen sind, werden sie automatisch durch Verbinden von Anfangs- und Endpunkt geschlossen.

Intern werden zuerst die Regionen, die von den Konturen Contours1Contours1Contours1Contours1contours1contours_1 bzw. Contours2Contours2Contours2Contours2contours2contours_2 umschlossen sind, getrennt voneinander bestimmt (siehe unten). Danach wird die Vereinigungsmenge der beiden sich ergebenden Regionen berechnet.

Im folgenden werden die beiden Eingabekonturen als Menge von Rändern der zu schneidenden Regionen betrachtet. Jede dieser Mengen besteht aus einer beliebigen Anzahl von Rändern (die einzelnen Konturen aus Contours1Contours1Contours1Contours1contours1contours_1 bzw. Contours2Contours2Contours2Contours2contours2contours_2). Jeder Rand kann konvex oder konkav sein und sich selbst schneiden. Löcher können durch Verschachtelung der Ränder gebildet werden.

Die von allen Rändern einer solchen Menge von Rändern umschlossene Region ist durch die sogenannte Even-Odd-Rule definiert. Sie besteht also aus der Menge aller Punkte, die folgende Eigenschaft besitzen: Die Strecke, die man durch Verbinden des Punktes mit einem außerhalb der Region liegenden Referenzpunkt erhält, schneidet eine ungerade Anzahl von Rändern.

Anschaulich bedeutet dies, dass ein Rand, der vollständig innerhalb eines anderen Randes liegt, ein Loch in der Region erzeugt, die durch den ersten Rand umschlossen ist. Analog dazu wird auch der Überlappungsbereich zweier Regionen als "Loch" betrachtet, d.h., er gehört nicht zu der Region, die von den beiden Rändern umschlossen wird. Die Region, die von einem Rand umschlossen wird, ist dabei unabhängig von der Umlaufrichtung des Randes.

Ein sich selbst schneidender Rand kann entweder am Schnittpunkt aufgetrennt werden oder er wird so angeordnet, dass er sich selbst am Schnittpunkt berührt. Die sich ergebenden Ränder werden als unabhängige Ränder betrachtet.

Die resultierenden Konturen ContoursUnionContoursUnionContoursUnionContoursUnioncontoursUnioncontours_union werden automatisch in Konturen, die Regionen umschließen, und Konturen, die Löcher umschließen, klassifiziert. Diese Information wird im globalen Attribut 'is_hole'"is_hole""is_hole""is_hole""is_hole""is_hole" gespeichert. Siehe get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldGetContourGlobalAttribXldget_contour_global_attrib_xld für weitere Details zu globalen Konturattributen.

Aufeinanderfolgende Punkte, die sich in Zeilen- und Spaltenrichtung um weniger als 1e-06 Pixel unterscheiden, werden als ein Punkt angesehen.

Ausführungsinformationen

Parameter

Contours1Contours1Contours1Contours1contours1contours_1 (input_object)  xld_cont(-array) objectHXLDContHObjectHXLDContHobject

Konturen, die die erste Region umschließen.

Contours2Contours2Contours2Contours2contours2contours_2 (input_object)  xld_cont(-array) objectHXLDContHObjectHXLDContHobject

Konturen, die die zweite Region umschließen.

ContoursUnionContoursUnionContoursUnionContoursUnioncontoursUnioncontours_union (output_object)  xld_cont(-array) objectHXLDContHObjectHXLDContHobject *

Konturen, die die Vereinigungsmenge umschließen.

Ergebnis

union2_closed_contours_xldunion2_closed_contours_xldUnion2ClosedContoursXldUnion2ClosedContoursXldUnion2ClosedContoursXldunion2_closed_contours_xld liefert den Wert 2 (H_MSG_TRUE) wenn alle Parameter korrekt sind. Andernfalls wird eine Fehlerbehandlung durchgeführt

Vorgänger

gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld, zero_crossing_sub_pixzero_crossing_sub_pixZeroCrossingSubPixZeroCrossingSubPixZeroCrossingSubPixzero_crossing_sub_pix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPixthreshold_sub_pix

Alternativen

union2union2Union2Union2Union2union2

Siehe auch

difference_closed_contours_xlddifference_closed_contours_xldDifferenceClosedContoursXldDifferenceClosedContoursXldDifferenceClosedContoursXlddifference_closed_contours_xld, symm_difference_closed_contours_xldsymm_difference_closed_contours_xldSymmDifferenceClosedContoursXldSymmDifferenceClosedContoursXldSymmDifferenceClosedContoursXldsymm_difference_closed_contours_xld, intersection_closed_contours_xldintersection_closed_contours_xldIntersectionClosedContoursXldIntersectionClosedContoursXldIntersectionClosedContoursXldintersection_closed_contours_xld, union2_closed_polygons_xldunion2_closed_polygons_xldUnion2ClosedPolygonsXldUnion2ClosedPolygonsXldUnion2ClosedPolygonsXldunion2_closed_polygons_xld

Modul

Foundation