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

create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCirclecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircle (Operator)

Name

create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCirclecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircle — Erzeugen eines Kreises, der interaktiv verändert werden kann.

Signatur

create_drawing_object_circle( : : Row, Column, Radius : DrawID)

Herror create_drawing_object_circle(double Row, double Column, double Radius, Hlong* DrawID)

Herror T_create_drawing_object_circle(const Htuple Row, const Htuple Column, const Htuple Radius, Htuple* DrawID)

Herror create_drawing_object_circle(const HTuple& Row, const HTuple& Column, const HTuple& Radius, Hlong* DrawID)

void HDrawingObject::CreateDrawingObjectCircle(const HTuple& Row, const HTuple& Column, const HTuple& Radius)

void CreateDrawingObjectCircle(const HTuple& Row, const HTuple& Column, const HTuple& Radius, HTuple* DrawID)

void HDrawingObject::HDrawingObject(double Row, double Column, double Radius)

void HDrawingObject::CreateDrawingObjectCircle(double Row, double Column, double Radius)

void HOperatorSetX.CreateDrawingObjectCircle(
[in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Radius, [out] VARIANT* DrawID)

void HDrawingObjectX.CreateDrawingObjectCircle(
[in] double Row, [in] double Column, [in] double Radius)

static void HOperatorSet.CreateDrawingObjectCircle(HTuple row, HTuple column, HTuple radius, out HTuple drawID)

public HDrawingObject(double row, double column, double radius)

void HDrawingObject.CreateDrawingObjectCircle(double row, double column, double radius)

Beschreibung

create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCirclecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircle erstellt einen Kreis, der in einem HALCON-Fenster interaktiv vom Benutzer modifiziert werden kann. Der Kreis wird duch die Koordinaten RowRowRowRowRowrow und ColumnColumnColumnColumnColumncolumn des Mittelpunkts und den Radius RadiusRadiusRadiusRadiusRadiusradius definiert.

Diese Parameter können mit dem Operator get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParams abgerufen werden. Das entsprechende HALCON-Objekt kann mit get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconic 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_paramsSetDrawingObjectParamsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParams zu finden.

Um das Zeichenobjekt interaktiv abändern zu können, muss es zunächst mit attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow an ein existierendes Fenster angehängt werden. Nähere Informationen sind in der Dokumentation zu attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow 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_circleDrawCircledraw_circleDrawCircleDrawCircle blockieren die Interaktionen mit einem Zeichenobjekt den aufrufenden Thread nicht.

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

Parallelisierung

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)  circle.center.y → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Zeilenkoordinate des Mittelpunktes.

Defaultwert: 100

ColumnColumnColumnColumnColumncolumn (input_control)  circle.center.x → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Spaltenkoordinate des Mittelpunktes.

Defaultwert: 100

RadiusRadiusRadiusRadiusRadiusradius (input_control)  circle.radius → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Radius des Kreises.

Defaultwert: 80

DrawIDDrawIDDrawIDDrawIDDrawIDdrawID (output_control)  drawing_object → HDrawingObject, HTupleHTupleHDrawingObject, HTupleHDrawingObjectX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des Zeichenobjekts.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCirclecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircle den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Nachfolger

attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow, get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParams, get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconic

Alternativen

draw_circledraw_circleDrawCircledraw_circleDrawCircleDrawCircle, draw_regiondraw_regionDrawRegiondraw_regionDrawRegionDrawRegion, create_drawing_object_circle_sectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSector, create_drawing_object_ellipsecreate_drawing_object_ellipseCreateDrawingObjectEllipsecreate_drawing_object_ellipseCreateDrawingObjectEllipseCreateDrawingObjectEllipse, create_drawing_object_ellipse_sectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSector

Siehe auch

create_drawing_object_rectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1, create_drawing_object_rectangle2create_drawing_object_rectangle2CreateDrawingObjectRectangle2create_drawing_object_rectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2, create_drawing_object_ellipsecreate_drawing_object_ellipseCreateDrawingObjectEllipsecreate_drawing_object_ellipseCreateDrawingObjectEllipseCreateDrawingObjectEllipse, create_drawing_object_circle_sectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSector, create_drawing_object_ellipse_sectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSector, create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXld

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH