get_region_runsT_get_region_runsGetRegionRunsGetRegionRunsget_region_runs (Operator)

Name

get_region_runsT_get_region_runsGetRegionRunsGetRegionRunsget_region_runs — Zugriff auf die Lauflängenkodierung einer Region.

Signatur

get_region_runs(Region : : : Row, ColumnBegin, ColumnEnd)

Beschreibung

get_region_runsget_region_runsGetRegionRunsGetRegionRunsGetRegionRunsget_region_runs gibt die Regionendaten in Form von Sehnentupeln aus. Die Sehnendarstellung entsteht, indem man eine Region zeilenweise mit aufsteigender Zeilenzahl (= von „oben“ nach „unten“) untersucht. Jede Zeile wird von links nach rechts durchlaufen (aufsteigende Spaltenzahl). Dabei werden alle Anfangs- und Endpunkte von Regionenabschnitten (= Sehnen) gespeichert. Eine Region lässt sich somit durch eine Folge von Sehnen beschreiben, wobei eine Sehne durch Zeilennummer, Anfangs- und Endpunkte (Spaltennummer) definiert ist. get_region_runsget_region_runsGetRegionRunsGetRegionRunsGetRegionRunsget_region_runs liefert die drei Komponenten der Sehnen in Form von Tupeln. Bei einer leeren Region werden drei leere Tupel zurückgegeben.

Achtung

Es darf nur eine Region übergeben werden.

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

RegionRegionRegionRegionregionregion (input_object) region → object

Auszugebende Region.

RowRowRowRowrowrow (output_control) chord.y-array → (integer)

Zeilennummern der Sehnen.

ColumnBeginColumnBeginColumnBeginColumnBegincolumnBegincolumn_begin (output_control) chord.x1-array → (integer)

Spaltennummern der Anfangspunkte der Sehnen.

Parameteranzahl: ColumnBegin == Row

ColumnEndColumnEndColumnEndColumnEndcolumnEndcolumn_end (output_control) chord.x2-array → (integer)

Spaltennummern der Endpunkte der Sehnen.

Parameteranzahl: ColumnEnd == Row

Ergebnis

get_region_runsget_region_runsGetRegionRunsGetRegionRunsGetRegionRunsget_region_runs liefert normalerweise den Wert TRUE. Wird mehr als eine Region übergeben, wird eine Fehlerbehandlung ausgelöst. 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.

Vorgänger

thresholdthresholdThresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionConnectionconnection

Alternativen

get_region_pointsget_region_pointsGetRegionPointsGetRegionPointsGetRegionPointsget_region_points

Siehe auch

copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj, gen_region_runsgen_region_runsGenRegionRunsGenRegionRunsGenRegionRunsgen_region_runs

Modul

Foundation

Operatoren