get_region_chainT_get_region_chainGetRegionChainGetRegionChainget_region_chain (Operator)

Name

get_region_chainT_get_region_chainGetRegionChainGetRegionChainget_region_chain — Kontur von einem Objekt als Kettencode.

Warnung

get_region_chainget_region_chainGetRegionChainGetRegionChainGetRegionChainget_region_chain ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt.

Signatur

get_region_chain(Region : : : Row, Column, Chain)

Beschreibung

get_region_chainget_region_chainGetRegionChainGetRegionChainGetRegionChainget_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_chainget_region_chainGetRegionChainGetRegionChainGetRegionChainget_region_chain liefert den Code in Form eines Tupels ab. Bei einer leeren Region sind die Parameter RowRowRowRowrowrow und ColumnColumnColumnColumncolumncolumn gleich Null und ChainChainChainChainchainchain ist das leere Tupel.

Achtung

Hohlflächen der Region werden ignoriert. Es darf nur eine Region übergeben werden und die muss genau eine Zusammenhangskomponente haben.

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

Zu transformierende Region.

RowRowRowRowrowrow (output_control) chain.begin.y → (integer)

Zeile des Startpunktes.

ColumnColumnColumnColumncolumncolumn (output_control) chain.begin.x → (integer)

Spalte des Startpunktes.

ChainChainChainChainchainchain (output_control) chain.code-array → (integer)

Richtungscode der Kontur (ab Startpunkt).

Typischer Wertebereich: 0 ≤ Chain Chain Chain Chain chain chain ≤ 7

Ergebnis

get_region_chainget_region_chainGetRegionChainGetRegionChainGetRegionChainget_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>)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. Das Verhalten bei leerer Region (die Region ist die leere Menge) wird mit set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>) bestimmt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

sobel_ampsobel_ampSobelAmpSobelAmpSobelAmpsobel_amp, thresholdthresholdThresholdThresholdThresholdthreshold, skeletonskeletonSkeletonSkeletonSkeletonskeleton, edges_imageedges_imageEdgesImageEdgesImageEdgesImageedges_image, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1, gen_circlegen_circleGenCircleGenCircleGenCirclegen_circle

Nachfolger

approx_chainapprox_chainApproxChainApproxChainApproxChainapprox_chain, approx_chain_simpleapprox_chain_simpleApproxChainSimpleApproxChainSimpleApproxChainSimpleapprox_chain_simple

Siehe auch

copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj, get_region_contourget_region_contourGetRegionContourGetRegionContourGetRegionContourget_region_contour, get_region_polygonget_region_polygonGetRegionPolygonGetRegionPolygonGetRegionPolygonget_region_polygon

Modul

Foundation