get_region_indexget_region_indexGetRegionIndexGetRegionIndexget_region_index (Operator)

Name

get_region_indexget_region_indexGetRegionIndexGetRegionIndexget_region_index — Ermitteln des Index aller Regionen, die einen übergebenen Punkt enthalten.

Signatur

get_region_index(Regions : : Row, Column : Index)

Beschreibung

get_region_indexget_region_indexGetRegionIndexGetRegionIndexget_region_index liefert den Index aller Regionen in RegionsRegionsRegionsregionsregions (Wertebereich 1 bis n), die den Testpunkt (RowRowRowrowrow,ColumnColumnColumncolumncolumn) enthalten, d.h.: Die zurückgegebenen Indizes können z.B. in select_objselect_objSelectObjSelectObjselect_obj verwendet werden, um die Regionen, die den Testpunkt enthalten, zu selektieren.

Achtung

Es kann vorkommen, dass mehr als eine Region den Punkt enthält, falls sich die Regionen überlappen. In diesem Fall werden all diese Regionen ausgegeben. Falls keine Region den angegebenen Punkt enthält, wird das leere Tupel (=keine Region) ausgegeben.

Ausführungsinformationen

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

Parameter

RegionsRegionsRegionsregionsregions (input_object) region-array → object

Zu untersuchende Regionen.

RowRowRowrowrow (input_control) point.y → (integer)

Zeilenindex des Testpunktes.

Default: 100

Wertebereich: Row Row Row row row (lin)

ColumnColumnColumncolumncolumn (input_control) point.x → (integer)

Spaltenindex des Testpunktes.

Default: 100

Wertebereich: Column Column Column column column (lin)

IndexIndexIndexindexindex (output_control) integer(-array) → (integer)

Index der Regionen die den Testpunkt enthalten.

Komplexität

Sei F die Fläche einer Region und N die Anzahl der Regionen, dann beträgt die Laufzeitkomplexität im Mittel O(ln(sqrt(F)) * N).

Ergebnis

get_region_indexget_region_indexGetRegionIndexGetRegionIndexget_region_index liefert den Wert 2 ( H_MSG_TRUE) , falls die Parameter korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingaberegionen 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>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionconnection

Alternativen

select_region_pointselect_region_pointSelectRegionPointSelectRegionPointselect_region_point

Siehe auch

get_mbuttonget_mbuttonGetMbuttonGetMbuttonget_mbutton, get_mpositionget_mpositionGetMpositionGetMpositionget_mposition, test_region_pointtest_region_pointTestRegionPointTestRegionPointtest_region_point

Modul

Foundation

Operatoren