create_drawing_object_rectangle2T_create_drawing_object_rectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2create_drawing_object_rectangle2 (Operator)
Name
create_drawing_object_rectangle2T_create_drawing_object_rectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2create_drawing_object_rectangle2 — Erzeugen eines beliebig orientierten Rechtecks, das interaktiv
verändert werden kann.
Signatur
void CreateDrawingObjectRectangle2(const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Length1, const HTuple& Length2, HTuple* DrawID)
void HDrawingObject::HDrawingObject(double Row, double Column, double Phi, double Length1, double Length2)
void HDrawingObject::CreateDrawingObjectRectangle2(double Row, double Column, double Phi, double Length1, double Length2)
static void HOperatorSet.CreateDrawingObjectRectangle2(HTuple row, HTuple column, HTuple phi, HTuple length1, HTuple length2, out HTuple drawID)
public HDrawingObject(double row, double column, double phi, double length1, double length2)
void HDrawingObject.CreateDrawingObjectRectangle2(double row, double column, double phi, double length1, double length2)
Beschreibung
create_drawing_object_rectangle2create_drawing_object_rectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2create_drawing_object_rectangle2 erzeugt ein beliebig orientiertes Rechteck,
das in deinem HALCON-Fenster interaktiv durch den Benutzer verändert
werden kann. Das Rechteck ist durch die Koordinaten des Mittelpunkts,
RowRowRowRowrowrow und ColumnColumnColumnColumncolumncolumn, die Orientierung PhiPhiPhiPhiphiphi und
der Länge der Halbachsen Length1Length1Length1Length1length1length_1 und Length2Length2Length2Length2length2length_2 definiert.
Diese Parameter können mit dem Operator get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParamsGetDrawingObjectParamsget_drawing_object_params
abgerufen werden.
Das entsprechende HALCON-Objekt kann mit get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconicGetDrawingObjectIconicget_drawing_object_iconic
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_paramsSetDrawingObjectParamsSetDrawingObjectParamsSetDrawingObjectParamsset_drawing_object_params zu finden.
Um das Zeichenobjekt interaktiv abändern zu können, muss es zunächst
mit attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window an ein existierendes
Fenster angehängt werden. Nähere Informationen sind in der Dokumentation
zu attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window zu finden. Es gibt drei mögliche
Transformationen für ein Rectangle2-Zeichenobjekt: Verändern der Größe,
Verschieben und Rotieren.
Das Rechteck kann durch Ziehen am Mittelpunkt des Rechtecks verschoben
werden. Durch Ziehen an den Seitenanfassern kann die Größe des Rechtecks
angepasst werden. Die Orientierung kann durch Anfassen an einer
Seite senkrecht zur ersten Halbachse verändert werden.
Im Gegensatz zum Operator draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2 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
RowRowRowRowrowrow (input_control) rectangle2.center.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Zeilenkoordinate des Mittelpunktes.
Defaultwert: 150
ColumnColumnColumnColumncolumncolumn (input_control) rectangle2.center.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Spaltenkoordinate des Mittelpunktes.
Defaultwert: 150
PhiPhiPhiPhiphiphi (input_control) rectangle2.angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Orientierung der größeren Halbachse in Bogenmaß.
Defaultwert: 0
Length1Length1Length1Length1length1length_1 (input_control) rectangle2.hwidth → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Erste Halbachse.
Defaultwert: 100
Length2Length2Length2Length2length2length_2 (input_control) rectangle2.hheight → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Zweite Halbachse.
Defaultwert: 100
DrawIDDrawIDDrawIDDrawIDdrawIDdraw_id (output_control) drawing_object → HDrawingObject, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Zeichenobjekts.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert create_drawing_object_rectangle2create_drawing_object_rectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2create_drawing_object_rectangle2
den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
Nachfolger
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region,
set_coloredset_coloredSetColoredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width,
set_drawset_drawSetDrawSetDrawSetDrawset_draw,
set_insertset_insertSetInsertSetInsertSetInsertset_insert,
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window
Alternativen
draw_rectangle2_moddraw_rectangle2_modDrawRectangle2ModDrawRectangle2ModDrawRectangle2Moddraw_rectangle2_mod,
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2,
draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region
Siehe auch
gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2,
draw_circledraw_circleDrawCircleDrawCircleDrawCircledraw_circle,
draw_ellipsedraw_ellipseDrawEllipseDrawEllipseDrawEllipsedraw_ellipse,
set_insertset_insertSetInsertSetInsertSetInsertset_insert
Modul
Foundation