select_xld_pointselect_xld_pointSelectXldPointSelectXldPoint (Operator)

Name

select_xld_pointselect_xld_pointSelectXldPointSelectXldPoint — Auswahl aller Konturen oder Polygone, die einen übergebenen Punkt enthalten.

Signatur

Beschreibung

select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint selektiert alle Konturen oder Polygone aus XLDsXLDsXLDsXLDsXLDs, die den Testpunkt (RowRowRowRowrow,ColumnColumnColumnColumncolumn) enthalten. Es kann vorkommen, dass mehr als eine Kontur oder Polygon den Punkt enthält, falls sich die Konturen oder Polygone überlappen. In diesem Fall werden all diese Konturen oder Polygone ausgegeben. Falls keine Konturen oder Polygone den angegebenen Punkt enthalten, wird ein leeres Objekt ausgegeben. Es wird vorausgesetzt, dass die Konturen oder Polygone geschlossen sind. Ist das nicht der Fall, werden sie künstlich geschlossen. Dennoch sollte darauf geachtet werden, dass nur sinnvolle, geschlossene Konturen und Polygone in XLDsXLDsXLDsXLDsXLDs übergeben werden, indem vorab select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXld mit dem Parameter 'closed'"closed""closed""closed""closed" aufgerufen wird.

Achtung

Liegt der Testpunkt direkt auf einer Kontur bzw. einem Polygon, ist das Ergebnis von select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint unvorhersagbar, d.h. die Kontur bzw. das Polygon wird in Abhängigkeit von Faktoren wie der Orientierung der Kontur bzw. des Polygons zu DestXLDsDestXLDsDestXLDsDestXLDsdestXLDs hinzugefügt oder nicht. Weiterhin ist zu beachten, dass bei großer Nähe des Punktes zu den Kontur- bzw. Polygonseiten eine verlässliche Klassifikation durch numerische Ungenauigkeiten praktisch ausgeschlossen ist.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Automatisch parallelisiert auf Tupelebene.

Parameter

Ergebnis

select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingabekonturen oder -polygone 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. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXld, close_contours_xldclose_contours_xldCloseContoursXldCloseContoursXldCloseContoursXld, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPix

Alternativen

test_xld_pointtest_xld_pointTestXldPointTestXldPointTestXldPoint

Modul

Foundation