create_drawing_object_xldT_create_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXld (Operator)

Name

create_drawing_object_xldT_create_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXld — Erzeugen einer Kontur, die interaktiv verändert werden kann.

Signatur

create_drawing_object_xld( : : Row, Column : DrawID)

Beschreibung

create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXld erzeugt eine XLD-Kontur, die interaktiv in einem HALCON-Fenster verändert werden kann. Die Kontur ist durch die Koordinaten RowRowRowRowrow und ColumnColumnColumnColumncolumn ihrer Punkte definiert.

Diese Parameter können mit dem Operator get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParamsGetDrawingObjectParams abgerufen werden. Das entsprechende HALCON-Objekt kann mit get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconicGetDrawingObjectIconic abgefragt werden. Zusätzlich zu den Parametern verfügt jedes Zeichenobjekt über Attribute, die dessen grafische Darstellung in einem HALCON-Fenster festlegen. Nähere Informationen zu den verfügbaren Attributen sind in der Dokumentation zu set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsSetDrawingObjectParams zu finden.

Um das Zeichenobjekt interaktiv abändern zu können, muss es zunächst mit attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindow an ein existierendes Fenster angehängt werden. Nähere Informationen sind in der Dokumentation zu attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindow zu finden. Weitere Punkte können durch einen Linksklick auf das Fenster hinzugefügt werden. Wenn auf einem Kontursegment zwischen zwei nachfolgenden Punkten geklickt wird, wird der neue Punkt zwischen diesen Punkten hinzugefügt. Jeder Konturpunkt kann durch Ziehen an dessen Anfasser verschoben werden. Ein einzelner Konturpunkt kann gelöscht werden, indem er auf einen benachbarten, direkt verbundenen Konturpunkt gezogen wird. Die Kontur kann geschlossen werden, indem der letzte Punkt auf den ersten Konturpunkt gesetzt wird. Die ganze Kontur kann durch Ziehen am Anfasser des Mittelpunktes verschoben werden. Zusätzlich ist es auch möglich mit set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXldSetDrawingObjectXld einem Zeichenobjekt eine neue Kontur zuzuweisen.

Im Gegensatz zum Operator draw_xlddraw_xldDrawXldDrawXldDrawXld blockieren die Interaktionen nicht den aufrufenden Thread.

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.

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

RowRowRowRowrow (input_control) coordinates.y-array → (real / integer)

Zeilen-Koordinaten des Polygons.

Defaultwert: [100,200,200,100]

Wertevorschläge: 0, 10, 20, 50, 100, 200, 500

ColumnColumnColumnColumncolumn (input_control) coordinates.x-array → (real / integer)

Spalten-Koordinaten des Polygons.

Defaultwert: [100,100,200,200]

Wertevorschläge: 0, 10, 20, 50, 100, 200, 500

DrawIDDrawIDDrawIDDrawIDdrawID (output_control) drawing_object → (handle)

Handle des Zeichenobjekts.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXld den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Nachfolger

attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindow, get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParamsGetDrawingObjectParams, get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconicGetDrawingObjectIconic, set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXldSetDrawingObjectXld

Alternativen

draw_xlddraw_xldDrawXldDrawXldDrawXld, draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldMod, draw_regiondraw_regionDrawRegionDrawRegionDrawRegion

Siehe auch

create_drawing_object_rectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1, create_drawing_object_rectangle2create_drawing_object_rectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2, create_drawing_object_ellipsecreate_drawing_object_ellipseCreateDrawingObjectEllipseCreateDrawingObjectEllipseCreateDrawingObjectEllipse, create_drawing_object_circle_sectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSector, create_drawing_object_ellipse_sectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSector, create_drawing_object_linecreate_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLineCreateDrawingObjectLine, create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircleCreateDrawingObjectCircle

Modul

Foundation

Operatoren