test_xld_pointtest_xld_pointTestXldPointtest_xld_pointTestXldPointTestXldPoint (Operator)

Name

test_xld_pointtest_xld_pointTestXldPointtest_xld_pointTestXldPointTestXldPoint — Test, ob ein(e) oder mehrere Konturen oder Polygone einen oder mehrere gegebene Punkte umschließen.

Signatur

Beschreibung

test_xld_pointtest_xld_pointTestXldPointtest_xld_pointTestXldPointTestXldPoint prüft, ob ein Testpunkt (RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn) von einer Kontur oder einem Polygon XLDXLDXLDXLDXLDXLD eingeschlossen wird und liefert das Ergebnis in IsInsideIsInsideIsInsideIsInsideIsInsideisInside zurück. Ist der Testpunkt von der Kontur bzw. dem Polygon eingeschlossen, so ist der Rückgabewert 1, sonst 0. Werden mehr als ein Testpunkt und/oder mehr als eine Kontur/Polygon übergeben, dann werden die Ergebnisse in Tupeln abgespeichert. Im Falle von einem Testpunkt und mehreren Konturen/Polygonen zeigt das (i-1)-te Element des Ergebnistupels IsInsideIsInsideIsInsideIsInsideIsInsideisInside, ob der Punkt von der i-ten Kontur oder dem i-ten Polygon eingeschlossen ist. Im Falle von mehreren Testpunkten und einer Kontur/Polygon zeigt das i-te Element des Ergebnistupels IsInsideIsInsideIsInsideIsInsideIsInsideisInside, ob der i-te Punkt von der Kontur/Polygon eingeschlossen ist. Im Falle von mehreren Testpunkten und mehreren Konturen/Polygonen zeigt das (i-1)-te Element des Ergebnistupels IsInsideIsInsideIsInsideIsInsideIsInsideisInside, ob der (i-1)-te Punkt von der i-ten Kontur oder dem i-ten Polygon eingeschlossen ist (Die Indizes unterscheiden sich, da die Indizierung des Ergebnistupels im Gegensatz zur Indizierung von Objekttupeln bei 0 beginnt). Die Anzahl der Testpunkte muss dabei gleich der Anzahl der Konturen/Polygone sein. 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 XLDXLDXLDXLDXLDXLD übergeben werden.

Achtung

Liegt ein Testpunkt direkt auf der Kontur bzw. dem Polygon, ist das Ergebnis von test_xld_pointtest_xld_pointTestXldPointtest_xld_pointTestXldPointTestXldPoint unvorhersagbar, d.h. 0 oder 1 wird in Abhängigkeit von Faktoren wie der Orientierung der Kontur bzw. des Polygons zurückgegeben. 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.

Parallelisierung

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Ergebnis

test_xld_pointtest_xld_pointTestXldPointtest_xld_pointTestXldPointTestXldPoint liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe nicht leer ist. Das Verhalten bei leerer Eingabe lässt sich mittels set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("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_xldSelectContoursXldselect_contours_xldSelectContoursXldSelectContoursXld, close_contours_xldclose_contours_xldCloseContoursXldclose_contours_xldCloseContoursXldCloseContoursXld, threshold_sub_pixthreshold_sub_pixThresholdSubPixthreshold_sub_pixThresholdSubPixThresholdSubPix

Modul

Foundation