boundaryboundaryBoundaryBoundary (Operator)

Name

boundaryboundaryBoundaryBoundary — Reduzieren einer Region auf deren Rand.

Signatur

Beschreibung

boundaryboundaryBoundaryBoundaryBoundary berechnet für jede Eingaberegion in RegionRegionRegionRegionregion die Kontur und gibt diese in RegionBorderRegionBorderRegionBorderRegionBorderregionBorder zurück. Der Parameter BoundaryTypeBoundaryTypeBoundaryTypeBoundaryTypeboundaryType bestimmt die Art der Randerzeugung.

Die Berechnung der Kontur wird mit Hilfe morphologischer Operationen durchgeführt. Die Ergebnisregionen bestehen nur aus einem minimalen Rand der Eingaberegionen. Dabei hängt die Position des Randes vom Parameter BoundaryTypeBoundaryTypeBoundaryTypeBoundaryTypeboundaryType ab, für den die folgenden Werte möglich sind:

• 'inner'"inner""inner""inner""inner": Die Kontur liegt innerhalb der Eingaberegionen.

• 'inner_filled'"inner_filled""inner_filled""inner_filled""inner_filled": Die Kontur liegt innerhalb der Eingaberegionen, Hohlflächen der Eingaberegionen werden unterdrückt. Aufgrund der Algorithmen-Optimierung kann es leichte Abweichung geben zwischen den so erhaltenen Konturen und den entsprechenden Konturen die mit 'inner_filled'"inner_filled""inner_filled""inner_filled""inner_filled" erhalten wurden.

• 'outer'"outer""outer""outer""outer": Die Kontur liegt ein Pixel ausserhalb der Eingaberegionen.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Automatisch parallelisiert auf Tupelebene.

Parameter

#include "HalconCpp.h"
using namespace Halcon;

main()
{
  HWindow  w;
  HRegion  circ1 = HRegion::GenCircle (20, 10, 10.5);

  circ1.Display (w);
  w.Click ();

  HRegion marg1 = circ1.Boundary ("inner");
  w.SetColor ("red");
  marg1.Display (w);
  w.Click ();

  return(0);
}

/* Intersections of two circles: */
gen_circle(&Circle1,200.0,100.0,100.5);
gen_circle(&Circle2,200.0,150.0,100.5);
boundary(Circle1,&Margin1,"inner");
boundary(Circle2,&Margin2,"inner");
intersection(Margin1,Margin2,&Intersections);
connection(Intersections,&Single);
T_area_center(Single,NULL,&Rows,&Columns);

/* simulation of Mode 'inner' */
void inner(Hobject Region, Hobject *Border)
{
  Hobject  Smaller;
  erosion_circle(Region,&Smaller,1.5);
  difference(Region,Smaller,Border);
}

#include "HalconCpp.h"
using namespace Halcon;

main()
{
  HWindow  w;
  HRegion  circ1 = HRegion::GenCircle (20, 10, 10.5);

  circ1.Display (w);
  w.Click ();

  HRegion marg1 = circ1.Boundary ("inner");
  w.SetColor ("red");
  marg1.Display (w);
  w.Click ();

  return(0);
}

#include "HalconCpp.h"
using namespace Halcon;

main()
{
  HWindow  w;
  HRegion  circ1 = HRegion::GenCircle (20, 10, 10.5);

  circ1.Display (w);
  w.Click ();

  HRegion marg1 = circ1.Boundary ("inner");
  w.SetColor ("red");
  marg1.Display (w);
  w.Click ();

  return(0);
}

#include "HalconCpp.h"
using namespace Halcon;

main()
{
  HWindow  w;
  HRegion  circ1 = HRegion::GenCircle (20, 10, 10.5);

  circ1.Display (w);
  w.Click ();

  HRegion marg1 = circ1.Boundary ("inner");
  w.SetColor ("red");
  marg1.Display (w);
  w.Click ();

  return(0);
}

Komplexität

Sei A die Fläche einer Eingaberegion, dann ist die Laufzeitkomplexität für ein Objekt:

Ergebnis

Bei korrekter Parametrisierung liefert die Funktion boundaryboundaryBoundaryBoundaryBoundary den Wert 2 (H_MSG_TRUE). Das Funktionsverhalten für die beiden Fälle leere und keine Eingaberegion lässt sich wie folgt kontrollieren:

• keine Region: set_system('no_object_result',<RegionResult>)

• leere Region: set_system('empty_region_result',<RegionResult>)

Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionConnectionConnection, union1union1Union1Union1Union1, watershedswatershedsWatershedsWatershedsWatersheds, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNorm

Nachfolger

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, select_shapeselect_shapeSelectShapeSelectShapeSelectShape, area_centerarea_centerAreaCenterAreaCenterAreaCenter, connectionconnectionConnectionConnectionConnection

Alternativen

dilation_circledilation_circleDilationCircleDilationCircleDilationCircle, erosion_circleerosion_circleErosionCircleErosionCircleErosionCircle, differencedifferenceDifferenceDifferenceDifference

Siehe auch

fill_upfill_upFillUpFillUpFillUp

Modul

Foundation