create_drawing_object_rectangle1T_create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1 (Operator)
Name
create_drawing_object_rectangle1T_create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1 — Erzeugen eines achsenparallelen Rechtecks, das interaktiv
verändert werden kann.
Signatur
void CreateDrawingObjectRectangle1(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, HTuple* DrawID)
void HDrawingObject::HDrawingObject(double Row1, double Column1, double Row2, double Column2)
void HDrawingObject::CreateDrawingObjectRectangle1(double Row1, double Column1, double Row2, double Column2)
static void HOperatorSet.CreateDrawingObjectRectangle1(HTuple row1, HTuple column1, HTuple row2, HTuple column2, out HTuple drawID)
public HDrawingObject(double row1, double column1, double row2, double column2)
void HDrawingObject.CreateDrawingObjectRectangle1(double row1, double column1, double row2, double column2)
Beschreibung
create_drawing_object_rectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1 erzeugt ein achsenparalleles Rechteck,
das interaktiv in einem HALCON-Fenster modifiziert
werden kann. Das Rechteck ist durch die Koordinaten Row1Row1Row1Row1row1 und
Column1Column1Column1Column1column1 des linken oberen Eckpunkts und Row2Row2Row2Row2row2 und
Column2Column2Column2Column2column2 des rechten unteren Eckpunkts definiert.
Das erzeugte Rechteck wird in dem Handle DrawIDDrawIDDrawIDDrawIDdrawID zurückgeliefert.
Die 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 Rectangle1-Zeichenobjekt: Verändern der Größe und
Verschieben.
Das Rechteck kann durch Ziehen in der Mitte des Rechtecks verschoben
werden und durch Ziehen an den Anfassern an den Ecken vergrößert oder
verkleinert werden.
Im Gegensatz zum Operator draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1 blockieren die
Interaktionen mit einem Zeichenobjekt den aufrufenden Thread nicht.
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) rectangle.origin.y → HTupleHTupleHtuple (real) (double) (double) (double)
Zeilenkoordinate des linken oberen Eckpunkts.
Defaultwert: 100
Column1Column1Column1Column1column1 (input_control) rectangle.origin.x → HTupleHTupleHtuple (real) (double) (double) (double)
Spaltenkoordinate des linken oberen Eckpunkts.
Defaultwert: 100
Row2Row2Row2Row2row2 (input_control) rectangle.corner.y → HTupleHTupleHtuple (real) (double) (double) (double)
Zeilenkoordinate des rechten unteren Eckpunkts.
Defaultwert: 200
Column2Column2Column2Column2column2 (input_control) rectangle.corner.x → HTupleHTupleHtuple (real) (double) (double) (double)
Spaltekoordinate des rechten unteren Eckpunkts.
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_rectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1
den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
open_windowopen_windowOpenWindowOpenWindowOpenWindow
Nachfolger
disp_regiondisp_regionDispRegionDispRegionDispRegion,
set_coloredset_coloredSetColoredSetColoredSetColored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidth,
set_drawset_drawSetDrawSetDrawSetDraw,
set_insertset_insertSetInsertSetInsertSetInsert,
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindow
Alternativen
draw_rectangle1_moddraw_rectangle1_modDrawRectangle1ModDrawRectangle1ModDrawRectangle1Mod,
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2,
draw_regiondraw_regionDrawRegionDrawRegionDrawRegion
Siehe auch
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1,
draw_circledraw_circleDrawCircleDrawCircleDrawCircle,
draw_ellipsedraw_ellipseDrawEllipseDrawEllipseDrawEllipse,
set_insertset_insertSetInsertSetInsertSetInsert
Modul
Foundation