HALCON Website / HALCON Operator-Referenz / Graphik / Objekt
KlassenKlassen | | Operatoren

create_drawing_object_linecreate_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLine (Operator)

Name

create_drawing_object_linecreate_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLine — Erzeugen einer Linie, die interaktiv verändert werden kann.

Signatur

create_drawing_object_line( : : Row1, Column1, Row2, Column2 : DrawID)

Herror create_drawing_object_line(double Row1, double Column1, double Row2, double Column2, Hlong* DrawID)

Herror T_create_drawing_object_line(const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2, Htuple* DrawID)

void CreateDrawingObjectLine(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, HTuple* DrawID)

void HDrawingObject::CreateDrawingObjectLine(double Row1, double Column1, double Row2, double Column2)

static void HOperatorSet.CreateDrawingObjectLine(HTuple row1, HTuple column1, HTuple row2, HTuple column2, out HTuple drawID)

void HDrawingObject.CreateDrawingObjectLine(double row1, double column1, double row2, double column2)

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.

Da während der Ausführung von create_drawing_object_linecreate_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLineCreateDrawingObjectLine und der nachfolgenden Operatoren interne Strukturen angelegt werden, muss das Zeichenobjekt wieder mit clear_drawing_objectclear_drawing_objectClearDrawingObjectClearDrawingObjectClearDrawingObject freigegeben werden, sobald es nicht mehr benötigt wird.

Ausführungsinformationen

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 (integer) (IntPtr) (Hlong) (Hlong)

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

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 17.12 Copyright © 1996-2017 MVTec Software GmbH