test_subset_regiontest_subset_regionTestSubsetRegionTestSubsetRegion (Operator)

Name

test_subset_regiontest_subset_regionTestSubsetRegionTestSubsetRegion — Test, ob eine Region in einer anderen enthalten ist.

Signatur

test_subset_region(Region1, Region2 : : : IsSubset)

Herror test_subset_region(const Hobject Region1, const Hobject Region2, Hlong* IsSubset)

Herror T_test_subset_region(const Hobject Region1, const Hobject Region2, Htuple* IsSubset)

void TestSubsetRegion(const HObject& Region1, const HObject& Region2, HTuple* IsSubset)

HTuple HRegion::TestSubsetRegion(const HRegion& Region2) const

static void HOperatorSet.TestSubsetRegion(HObject region1, HObject region2, out HTuple isSubset)

HTuple HRegion.TestSubsetRegion(HRegion region2)

Beschreibung

test_subset_regiontest_subset_regionTestSubsetRegionTestSubsetRegionTestSubsetRegion testet, ob Region1Region1Region1Region1region1 eine Untermenge von Region2Region2Region2Region2region2 ist und gibt das Ergebnis in IsSubsetIsSubsetIsSubsetIsSubsetisSubset zurück. Falls mehrere Regionen übergeben werden, muss die Anzahl der Regionen in Region1Region1Region1Region1region1 und Region2Region2Region2Region2region2 übereinstimmen. In diesem Fall wird in IsSubsetIsSubsetIsSubsetIsSubsetisSubset ein Tupel zurückgegeben, das genausoviele Elemente enthält, wie Region1Region1Region1Region1region1 und Region2Region2Region2Region2region2.

Die in HALCON verfügbaren ikonischen Objekte werden bei der Einleitung zu Kapitel Objekt vorgestellt.

Ausführungsinformationen

Parameter

Region1Region1Region1Region1region1 (input_object)  region(-array) objectHRegionHRegionHobject

Testregion.

Region2Region2Region2Region2region2 (input_object)  region(-array) objectHRegionHRegionHobject

Vergleichsregion.

Parameteranzahl: Region1 == Region2

IsSubsetIsSubsetIsSubsetIsSubsetisSubset (output_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Ist Region1Region1Region1Region1region1 in Region2Region2Region2Region2region2 enthalten?

Ergebnis

test_subset_regiontest_subset_regionTestSubsetRegionTestSubsetRegionTestSubsetRegion liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingabeobjekte vorhanden) lässt sich mittels set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Unterscheidet sich die Anzahl der Objekte, wird eine Fehlerbehandlung durchgeführt.

Alternativen

differencedifferenceDifferenceDifferenceDifference, area_centerarea_centerAreaCenterAreaCenterAreaCenter

Siehe auch

test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegionTestEqualRegion, compare_objcompare_objCompareObjCompareObjCompareObj

Modul

Foundation