create_drawing_object_lineT_create_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLine (Operator)
Name
create_drawing_object_lineT_create_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLine — Erzeugen einer Linie, die interaktiv verändert werden kann.
Signatur
Beschreibung
create_drawing_object_linecreate_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLineCreateDrawingObjectLine erzeugt eine Linie, die interaktiv durch
den Benutzer modifiziert werden kann. Die Linie ist definiert durch die
Koordinaten Row1Row1Row1Row1row1, Column1Column1Column1Column1column1, Row2Row2Row2Row2row2 und Column2Column2Column2Column2column2
des ersten und zweiten Linienpunkts.
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.
Es gibt zwei mögliche Transformationen für ein Linien-Zeichenobjekt:
Verändern der Länge und Verschieben.
Ein Linienpunkt kann durch Ziehen am Punktanfasser verschoben und
damit auch die Länge verändert werden. Die Linie selbst kann durch
Ziehen am Mittelpunkt der Linie verschoben werden.
Im Gegensatz zum Operator draw_linedraw_lineDrawLineDrawLineDrawLine 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
Row1Row1Row1Row1row1 (input_control) line.begin.y → HTupleHTupleHtuple (real) (double) (double) (double)
Zeilenkoordinate des ersten Punktes der Linie.
Defaultwert: 100
Column1Column1Column1Column1column1 (input_control) line.begin.x → HTupleHTupleHtuple (real) (double) (double) (double)
Spaltenkoordinate des ersten Punktes der Linie.
Defaultwert: 100
Row2Row2Row2Row2row2 (input_control) line.end.y → HTupleHTupleHtuple (real) (double) (double) (double)
Zeilenkoordinate des zweiten Punktes der Linie.
Defaultwert: 200
Column2Column2Column2Column2column2 (input_control) line.end.x → HTupleHTupleHtuple (real) (double) (double) (double)
Spaltenkoordinate des zweiten Punktes der Linie.
Defaultwert: 200
DrawIDDrawIDDrawIDDrawIDdrawID (output_control) drawing_object → HDrawingObject, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Zeichenobjekts.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert create_drawing_object_linecreate_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLineCreateDrawingObjectLine
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
Alternativen
draw_linedraw_lineDrawLineDrawLineDrawLine,
draw_line_moddraw_line_modDrawLineModDrawLineModDrawLineMod,
create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXld
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_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXld
Modul
Foundation