HALCON Website / HALCON Operator-Referenz / Tools / Geometrie
KlassenKlassenKlassenKlassen | | | | Operatoren

create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld (Operator)

Name

create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld — Erzeugen einer XLD-Distanztransformation.

Signatur

create_distance_transform_xld(Contour : : Mode, MaxDistance : DistanceTransformID)

Herror create_distance_transform_xld(const Hobject Contour, const char* Mode, double MaxDistance, Hlong* DistanceTransformID)

Herror T_create_distance_transform_xld(const Hobject Contour, const Htuple Mode, const Htuple MaxDistance, Htuple* DistanceTransformID)

Herror create_distance_transform_xld(Hobject Contour, const HTuple& Mode, const HTuple& MaxDistance, Hlong* DistanceTransformID)

void CreateDistanceTransformXld(const HObject& Contour, const HTuple& Mode, const HTuple& MaxDistance, HTuple* DistanceTransformID)

void HXLDDistTrans::HXLDDistTrans(const HXLDCont& Contour, const HString& Mode, const HTuple& MaxDistance)

void HXLDDistTrans::HXLDDistTrans(const HXLDCont& Contour, const HString& Mode, double MaxDistance)

void HXLDDistTrans::HXLDDistTrans(const HXLDCont& Contour, const char* Mode, double MaxDistance)

void HXLDDistTrans::CreateDistanceTransformXld(const HXLDCont& Contour, const HString& Mode, const HTuple& MaxDistance)

void HXLDDistTrans::CreateDistanceTransformXld(const HXLDCont& Contour, const HString& Mode, double MaxDistance)

void HXLDDistTrans::CreateDistanceTransformXld(const HXLDCont& Contour, const char* Mode, double MaxDistance)

void HOperatorSetX.CreateDistanceTransformXld(
[in] IHUntypedObjectX* Contour, [in] VARIANT Mode, [in] VARIANT MaxDistance, [out] VARIANT* DistanceTransformID)

void HXLDDistTransX.CreateDistanceTransformXld(
[in] IHXLDContX* Contour, [in] BSTR Mode, [in] VARIANT MaxDistance)

static void HOperatorSet.CreateDistanceTransformXld(HObject contour, HTuple mode, HTuple maxDistance, out HTuple distanceTransformID)

public HXLDDistTrans(HXLDCont contour, string mode, HTuple maxDistance)

public HXLDDistTrans(HXLDCont contour, string mode, double maxDistance)

void HXLDDistTrans.CreateDistanceTransformXld(HXLDCont contour, string mode, HTuple maxDistance)

void HXLDDistTrans.CreateDistanceTransformXld(HXLDCont contour, string mode, double maxDistance)

Beschreibung

create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld erzeugt die XLD-Distanztransformation der Referenzkontur ContourContourContourContourContourcontour und liefert das entstandene Handle in DistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformID zurück.

Ist die XLD-Distanztransformation erzeugt, so berechnet der Operator apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld punktweise Abstände von Testkonturen zur Referenzkontur ContourContourContourContourContourcontour. Genauer: Für jeden Punkt einer Testkontur wird sein minimaler Abstand zu den in ContourContourContourContourContourcontour übergebenen Konturen berechnet.

Der Parameter ModeModeModeModeModemode legt fest, welche Abstände in apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld berechnet werden: 'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point""point_to_point" berechnet den minimalen Abstand zu den Stützpunkten von ContourContourContourContourContourcontour. Dagegen berechnet 'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment""point_to_segment" den minimalen Abstand zu den Kontursegmenten von ContourContourContourContourContourcontour (siehe auch nachstehende Abbildung).

Die gestrichelten Linien stellen dar, welcher Abstand ausgehend von Punkt 1 der Testkontur links berechnet wird. Abstand entspricht dem Modus 'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point""point_to_point", und Abstand dem Modus 'point_to_segment'. Der grau unterlegte Bereich stellt die Fläche innerhalb von MaxDistanceMaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance um die Referenzkontur dar, für die Abstandswerte berechnet werden. Der Abstand von Punkt 2 der Testkontur würde auf MaxDistanceMaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance gesetzt werden, da er außerhalb dieses Bereichs liegt.

Der Parameter MaxDistanceMaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance legt den maximalen Abstand von der Referenzkontur ContourContourContourContourContourcontour fest, der von Interesse ist. Falls der Abstand eines Punktes der Testkontur zur Referenzkontur MaxDistanceMaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance übersteigt, so wird der Ausgabe-Abstand von apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld auf MaxDistanceMaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance gesetzt.

create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld und apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld stellen eine Alternative zu distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld dar, falls die Referenzkontur wiederholt verwendet wird. create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld speichert für jeden Pixel in einer relevanten Fläche um ContourContourContourContourContourcontour seine nächsten Punkte oder Segmente (abhängig von ModeModeModeModeModemode) der Referenzkontur ContourContourContourContourContourcontour. Damit kann apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld Abstände sehr schnell berechnen, fast unabhängig von der Anzahl Punkte oder Segmente der Referenzkontur, von ModeModeModeModeModemode und der Lage der Punkte der Testkontur. Allerdings kann das Erstellen der XLD-Distanztransformation einige Sekunden oder Minuten in Anspruch nehmen, abhängig von der Anzahl Punkte oder Segmente der Referenzkontur und der relevanten Fläche um ContourContourContourContourContourcontour, die durch MaxDistanceMaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance beeinflusst wird. create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld ist schneller, falls ModeModeModeModeModemode auf 'point_to_point' gesetzt wird.

get_distance_transform_xld_contourget_distance_transform_xld_contourGetDistanceTransformXldContourget_distance_transform_xld_contourGetDistanceTransformXldContourGetDistanceTransformXldContour und get_distance_transform_xld_paramget_distance_transform_xld_paramGetDistanceTransformXldParamget_distance_transform_xld_paramGetDistanceTransformXldParamGetDistanceTransformXldParam können verwendet werden, um die Referenzkontur und Parameter der XLD-Distanztransformation DistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformID zurückzubekommen.

Parallelisierung

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

ContourContourContourContourContourcontour (input_object)  xld_cont(-array) → objectHXLDContHXLDContHXLDContHXLDContXHobject

Referenzkontur(en).

ModeModeModeModeModemode (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Berechne die Distanz zu Punkten ('point_to_point') oder zu ganzen Segmenten ('point_to_segment').

Defaultwert: 'point_to_point' "point_to_point" "point_to_point" "point_to_point" "point_to_point" "point_to_point"

Werteliste: 'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point""point_to_point", 'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment""point_to_segment"

MaxDistanceMaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance (input_control)  real → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Maximaler interessierender Abstand.

Defaultwert: 20.0

DistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformID (output_control)  xld_dist_trans → HXLDDistTrans, HTupleHTupleHXLDDistTrans, HTupleHXLDDistTransX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle der XLD-Distanztransformation der Kontur(en).

Ergebnis

Sind die Parameterwerte korrekt, dann liefert der Operator den Wert 2 (H_MSG_TRUE), sonst eine Fehlermeldung.

Nachfolger

apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld, write_distance_transform_xldwrite_distance_transform_xldWriteDistanceTransformXldwrite_distance_transform_xldWriteDistanceTransformXldWriteDistanceTransformXld, serialize_distance_transform_xldserialize_distance_transform_xldSerializeDistanceTransformXldserialize_distance_transform_xldSerializeDistanceTransformXldSerializeDistanceTransformXld, clear_distance_transform_xldclear_distance_transform_xldClearDistanceTransformXldclear_distance_transform_xldClearDistanceTransformXldClearDistanceTransformXld

Siehe auch

distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld, get_distance_transform_xld_contourget_distance_transform_xld_contourGetDistanceTransformXldContourget_distance_transform_xld_contourGetDistanceTransformXldContourGetDistanceTransformXldContour, read_distance_transform_xldread_distance_transform_xldReadDistanceTransformXldread_distance_transform_xldReadDistanceTransformXldReadDistanceTransformXld, deserialize_distance_transform_xlddeserialize_distance_transform_xldDeserializeDistanceTransformXlddeserialize_distance_transform_xldDeserializeDistanceTransformXldDeserializeDistanceTransformXld, get_distance_transform_xld_paramget_distance_transform_xld_paramGetDistanceTransformXldParamget_distance_transform_xld_paramGetDistanceTransformXldParamGetDistanceTransformXldParam, set_distance_transform_xld_paramset_distance_transform_xld_paramSetDistanceTransformXldParamset_distance_transform_xld_paramSetDistanceTransformXldParamSetDistanceTransformXldParam

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH