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_indexGetRegionIndexGetRegionIndexGetRegionIndexget_region_index liefert den Index aller Regionen in RegionsRegionsRegionsRegionsregionsregions (Wertebereich 1 bis n), die den Testpunkt (RowRowRowRowrowrow,ColumnColumnColumnColumncolumncolumn) enthalten, d.h.: Die zurückgegebenen Indizes können z.B. in select_objselect_objSelectObjSelectObjSelectObjselect_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

RegionsRegionsRegionsRegionsregionsregions (input_object) region-array → object

Zu untersuchende Regionen.

RowRowRowRowrowrow (input_control) point.y → (integer)

Zeilenindex des Testpunktes.

Defaultwert: 100

Typischer Wertebereich: Row Row Row Row row row (lin)

ColumnColumnColumnColumncolumncolumn (input_control) point.x → (integer)

Spaltenindex des Testpunktes.

Defaultwert: 100

Typischer Wertebereich: Column Column Column Column column column (lin)

IndexIndexIndexIndexindexindex (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_indexGetRegionIndexGetRegionIndexGetRegionIndexget_region_index liefert den Wert 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>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionConnectionconnection

Alternativen

select_region_pointselect_region_pointSelectRegionPointSelectRegionPointSelectRegionPointselect_region_point

Siehe auch

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton, get_mpositionget_mpositionGetMpositionGetMpositionGetMpositionget_mposition, test_region_pointtest_region_pointTestRegionPointTestRegionPointTestRegionPointtest_region_point

Modul

Foundation

Operatoren