get_region_runs — Zugriff auf die Lauflängenkodierung einer Region.
get_region_runs(Region : : : Row, ColumnBegin, ColumnEnd)
get_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_runs liefert die drei Komponenten der Sehnen in Form von
Tupeln. Bei einer leeren Region werden drei leere Tupel zurückgegeben.
Es darf nur eine Region übergeben werden.
Region (input_object) region → object
Auszugebende Region.
Row (output_control) chord.y-array → (integer)
Zeilennummern der Sehnen.
ColumnBegin (output_control) chord.x1-array → (integer)
Spaltennummern der Anfangspunkte der Sehnen.
Parameteranzahl: ColumnBegin == Row
ColumnEnd (output_control) chord.x2-array → (integer)
Spaltennummern der Endpunkte der Sehnen.
Parameteranzahl: ColumnEnd == Row
get_region_runs liefert normalerweise den Wert 2 (H_MSG_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>)
festlegen.
Foundation