create_drawing_object_circleT_create_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircle (Operator)
Name
create_drawing_object_circleT_create_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircle — Erzeugen eines Kreises, der interaktiv verändert werden kann.
Signatur
Herror T_create_drawing_object_circle(const Htuple Row, const Htuple Column, const Htuple Radius, Htuple* DrawID)
Beschreibung
create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircleCreateDrawingObjectCircle erstellt einen Kreis, der in einem
HALCON-Fenster interaktiv vom Benutzer modifiziert werden kann.
Der Kreis wird duch die Koordinaten RowRowRowRowrow und ColumnColumnColumnColumncolumn des
Mittelpunkts und den Radius RadiusRadiusRadiusRadiusradius 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.
Es gibt zwei mögliche
Transformationen für ein Kreis-Zeichenobjekt: Verändern der Größe und
Verschieben.
Der Kreis kann durch Ziehen am Mittelpunkt verschoben
werden. Durch Ziehen am Kreisbogen kann die Größe des Kreises
angepasst werden.
Im Gegensatz zum Operator draw_circledraw_circleDrawCircleDrawCircleDrawCircle 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
RowRowRowRowrow (input_control) circle.center.y → HTupleHTupleHtuple (real) (double) (double) (double)
Zeilenkoordinate des Mittelpunktes.
Defaultwert: 100
ColumnColumnColumnColumncolumn (input_control) circle.center.x → HTupleHTupleHtuple (real) (double) (double) (double)
Spaltenkoordinate des Mittelpunktes.
Defaultwert: 100
RadiusRadiusRadiusRadiusradius (input_control) circle.radius → HTupleHTupleHtuple (real) (double) (double) (double)
Radius des Kreises.
Defaultwert: 80
DrawIDDrawIDDrawIDDrawIDdrawID (output_control) drawing_object → HDrawingObject, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Zeichenobjekts.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircleCreateDrawingObjectCircle
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_circledraw_circleDrawCircleDrawCircleDrawCircle,
draw_regiondraw_regionDrawRegionDrawRegionDrawRegion,
create_drawing_object_circle_sectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSector,
create_drawing_object_ellipsecreate_drawing_object_ellipseCreateDrawingObjectEllipseCreateDrawingObjectEllipseCreateDrawingObjectEllipse,
create_drawing_object_ellipse_sectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSector
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