get_region_indexget_region_indexGetRegionIndexGetRegionIndex (Operator)

Name

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

Signatur

get_region_index(Regions : : Row, Column : Index)

Beschreibung

get_region_indexget_region_indexGetRegionIndexGetRegionIndexGetRegionIndex 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_objSelectObjSelectObjSelectObj 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.

Defaultwert: 100

Typischer Wertebereich: Row Row Row Row row (lin)

ColumnColumnColumnColumncolumn (input_control) point.x → (integer)

Spaltenindex des Testpunktes.

Defaultwert: 100

Typischer 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_indexGetRegionIndexGetRegionIndexGetRegionIndex 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>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionConnectionConnection

Alternativen

select_region_pointselect_region_pointSelectRegionPointSelectRegionPointSelectRegionPoint

Siehe auch

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbutton, get_mpositionget_mpositionGetMpositionGetMpositionGetMposition, test_region_pointtest_region_pointTestRegionPointTestRegionPointTestRegionPoint

Modul

Foundation

Operatoren