get_region_chain — Kontur von einem Objekt als Kettencode.
get_region_chain ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt.
get_region_chain gibt die Kontur einer Region aus.
Eine Kontur ist eine Folge
von Punkten, die die Umrandung der Region beschreiben.
Die Kontur „liegt auf“ der Region.
Sie beginnt bei der kleinsten Zeilennummer;
in dieser Zeile bei dem Punkt mit dem größten Spaltenindex.
Der Umlauf erfolgt im Uhrzeigersinn.
Hohlflächen der Region werden ignoriert.
Der Richtungscode (Kettencode) ist wie folgt definiert:
3 2 1
4 * 0
5 6 7
get_region_chain liefert den Code in Form eines Tupels ab.
Bei einer leeren Region sind die Parameter Row und
Column gleich Null und Chain ist das leere Tupel.
Hohlflächen der Region werden ignoriert. Es darf nur eine Region übergeben werden und die muss genau eine Zusammenhangskomponente haben.
Region (input_object) region → object
Zu transformierende Region.
Row (output_control) chain.begin.y → (integer)
Zeile des Startpunktes.
Column (output_control) chain.begin.x → (integer)
Spalte des Startpunktes.
Chain (output_control) chain.code-array → (integer)
Richtungscode der Kontur (ab Startpunkt).
Typischer Wertebereich: 0
≤
Chain
≤
7
get_region_chain liefert normalerweise den Wert 2 (H_MSG_TRUE).
Wird mehr als eine Zusammenhangskomponente übergeben,
wird ein Exception ausgelöst.
Das Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden) lässt
sich mittels set_system('no_object_result',<Result>)
festlegen.
Das Verhalten bei leerer Region (die Region ist die leere Menge)
wird mit set_system('empty_region_result',<Result>) bestimmt.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
sobel_amp,
threshold,
skeleton,
edges_image,
gen_rectangle1,
gen_circle
approx_chain,
approx_chain_simple
copy_obj,
get_region_contour,
get_region_polygon
Foundation