HALCON Website / HALCON Operator-Referenz / Regionen / Generierung
KlassenKlassenKlassenKlassen | | | | Operatoren

gen_ellipsegen_ellipseGenEllipsegen_ellipseGenEllipseGenEllipse (Operator)

Name

gen_ellipsegen_ellipseGenEllipsegen_ellipseGenEllipseGenEllipse — Erzeugen einer Ellipse.

Signatur

gen_ellipse( : Ellipse : Row, Column, Phi, Radius1, Radius2 : )

Herror gen_ellipse(Hobject* Ellipse, double Row, double Column, double Phi, double Radius1, double Radius2)

Herror T_gen_ellipse(Hobject* Ellipse, const Htuple Row, const Htuple Column, const Htuple Phi, const Htuple Radius1, const Htuple Radius2)

Herror gen_ellipse(Hobject* Ellipse, const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2)

HRegion HRegion::GenEllipse(const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2)

HRegionArray HRegionArray::GenEllipse(const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2)

void GenEllipse(HObject* Ellipse, const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2)

void HRegion::GenEllipse(const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2)

void HRegion::GenEllipse(double Row, double Column, double Phi, double Radius1, double Radius2)

void HOperatorSetX.GenEllipse(
[out] IHUntypedObjectX** Ellipse, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Phi, [in] VARIANT Radius1, [in] VARIANT Radius2)

void HRegionX.GenEllipse(
[in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Phi, [in] VARIANT Radius1, [in] VARIANT Radius2)

static void HOperatorSet.GenEllipse(out HObject ellipse, HTuple row, HTuple column, HTuple phi, HTuple radius1, HTuple radius2)

void HRegion.GenEllipse(HTuple row, HTuple column, HTuple phi, HTuple radius1, HTuple radius2)

void HRegion.GenEllipse(double row, double column, double phi, double radius1, double radius2)

Beschreibung

gen_ellipsegen_ellipseGenEllipsegen_ellipseGenEllipseGenEllipse generiert eine oder mehrere Ellipsen mit dem Schwerpunkt (RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn), der Orientierung PhiPhiPhiPhiPhiphi und den Halbradien Radius1Radius1Radius1Radius1Radius1radius1 und Radius2Radius2Radius2Radius2Radius2radius2. Der Winkel wird in Bogenmaß bzgl. der x-Achse in mathematisch positivem Drehsinn angegeben. Es kann mehr als eine Region erzeugt werden, indem Tupel von Parameterwerten übergeben werden.

Der Schwerpunkt muss innerhalb der Bildkoordinaten liegen. Das Koordinatensystem läuft von (0,0) (linkes oberes Eck) bis (Width-1,Height-1). Siehe hierzu auch get_systemget_systemGetSystemget_systemGetSystemGetSystem und reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb. Falls die Ellipse über den Bildrand reicht, wird je nach dem Wert des Systemflags 'clip_region' (set_systemset_systemSetSystemset_systemSetSystemSetSystem) die Ellipse auf das aktuelle Bildformat beschnitten.

Parallelisierung

Parameter

EllipseEllipseEllipseEllipseEllipseellipse (output_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject *

Erzeugte Ellipse(n).

RowRowRowRowRowrow (input_control)  ellipse.center.y(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Zeilenindex des Schwerpunktes.

Defaultwert: 200.0

Wertevorschläge: 0.0, 10.0, 20.0, 50.0, 100.0, 256.0, 300.0, 400.0

Typischer Wertebereich: 1.0 ≤ Row Row Row Row Row row ≤ 1024.0 (lin)

Minimale Schrittweite: 1.0

Empfohlene Schrittweite: 10.0

ColumnColumnColumnColumnColumncolumn (input_control)  ellipse.center.x(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Spaltenindex des Schwerpunktes.

Defaultwert: 200.0

Wertevorschläge: 0.0, 10.0, 20.0, 50.0, 100.0, 256.0, 300.0, 400.0

Typischer Wertebereich: 1.0 ≤ Column Column Column Column Column column ≤ 1024.0 (lin)

Minimale Schrittweite: 1.0

Empfohlene Schrittweite: 10.0

PhiPhiPhiPhiPhiphi (input_control)  ellipse.angle.rad(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Orientierung des längeren Radius (Radius1).

Defaultwert: 0.0

Wertevorschläge: -1.178097, -0.785398, -0.392699, 0.0, 0.392699, 0.785398, 1.178097

Typischer Wertebereich: -1.178097 ≤ Phi Phi Phi Phi Phi phi ≤ 1.178097 (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.1

Radius1Radius1Radius1Radius1Radius1radius1 (input_control)  ellipse.radius1(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Längerer Radius.

Defaultwert: 100.0

Wertevorschläge: 2.0, 5.0, 10.0, 20.0, 50.0, 100.0, 256.0, 300.0, 400.0

Typischer Wertebereich: 1.0 ≤ Radius1 Radius1 Radius1 Radius1 Radius1 radius1 ≤ 1024.0 (lin)

Minimale Schrittweite: 1.0

Empfohlene Schrittweite: 10.0

Restriktion: Radius1 > 0

Radius2Radius2Radius2Radius2Radius2radius2 (input_control)  ellipse.radius2(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Kürzerer Radius.

Defaultwert: 60.0

Wertevorschläge: 1.0, 2.0, 4.0, 5.0, 10.0, 20.0, 50.0, 100.0, 256.0, 300.0, 400.0

Typischer Wertebereich: 1.0 ≤ Radius2 Radius2 Radius2 Radius2 Radius2 radius2 ≤ 1024.0 (lin)

Minimale Schrittweite: 1.0

Empfohlene Schrittweite: 10.0

Restriktion: Radius2 > 0 && Radius2 <= Radius1

Beispiel (HDevelop)

read_image (Image, 'fabrik')
gen_ellipse (Ellipse, 200, 200, rad(10), 160, 90)
reduce_domain (Image, Ellipse, ImageReduced)
dev_clear_window ()
dev_display (ImageReduced)

Beispiel (C)

open_window(0,0,-1,-1,"root","visible","",&WindowHandle);
set_insert(WindowHandle,"xor");
do {
  get_mbutton(WindowHandle,&Row,&Column,&Button);
  gen_ellipse(&Ellipse,(double)Row,(double)Column,Column / 300.0,
         (Row % 100)+1.0,(Column % 50) + 1.0);
  disp_region(Ellipse,WindowHandle);
  clear_obj(Ellipse);
} while(Button != 1);

Beispiel (HDevelop)

read_image (Image, 'fabrik')
gen_ellipse (Ellipse, 200, 200, rad(10), 160, 90)
reduce_domain (Image, Ellipse, ImageReduced)
dev_clear_window ()
dev_display (ImageReduced)

Beispiel (HDevelop)

read_image (Image, 'fabrik')
gen_ellipse (Ellipse, 200, 200, rad(10), 160, 90)
reduce_domain (Image, Ellipse, ImageReduced)
dev_clear_window ()
dev_display (ImageReduced)

Beispiel (HDevelop)

read_image (Image, 'fabrik')
gen_ellipse (Ellipse, 200, 200, rad(10), 160, 90)
reduce_domain (Image, Ellipse, ImageReduced)
dev_clear_window ()
dev_display (ImageReduced)

Beispiel (HDevelop)

read_image (Image, 'fabrik')
gen_ellipse (Ellipse, 200, 200, rad(10), 160, 90)
reduce_domain (Image, Ellipse, ImageReduced)
dev_clear_window ()
dev_display (ImageReduced)

Komplexität

Laufzeitkomplexität: O(Radius1Radius1Radius1Radius1Radius1radius1 * 2)

Speicherplatzkomplexität (Byte): O(Radius1Radius1Radius1Radius1Radius1radius1 * 8)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gen_ellipsegen_ellipseGenEllipsegen_ellipseGenEllipseGenEllipse den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt. Das Clipping am aktuellen Bildformat wird durch set_system('clip_region',<'true'/'false'>)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">) festgelegt.

Nachfolger

paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain

Alternativen

gen_circlegen_circleGenCirclegen_circleGenCircleGenCircle, gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilled, draw_ellipsedraw_ellipseDrawEllipsedraw_ellipseDrawEllipseDrawEllipse

Siehe auch

disp_ellipsedisp_ellipseDispEllipsedisp_ellipseDispEllipseDispEllipse, set_shapeset_shapeSetShapeset_shapeSetShapeSetShape, smallest_circlesmallest_circleSmallestCirclesmallest_circleSmallestCircleSmallestCircle, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH