Operator Reference

HALCON Operator Reference / Segmentation / Topography

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

plateaus_centerplateaus_centerPlateausCenterPlateausCenterplateaus_center (Operator)

plateaus_centerplateaus_centerPlateausCenterPlateausCenterplateaus_center — Detect the centers of all gray value plateaus.

Signature

plateaus_center(Image : Plateaus : : )

Herror plateaus_center(const Hobject Image, Hobject* Plateaus)

Herror T_plateaus_center(const Hobject Image, Hobject* Plateaus)

void PlateausCenter(const HObject& Image, HObject* Plateaus)

HRegion HImage::PlateausCenter() const

static void HOperatorSet.PlateausCenter(HObject image, out HObject plateaus)

HRegion HImage.PlateausCenter()

def plateaus_center(image: HObject) -> HObject

Description

plateaus_centerplateaus_centerPlateausCenterPlateausCenterplateaus_center extracts all points from ImageImageImageimageimage with a gray value greater or equal to the gray value of its neighbors (8-neighborhood) and returns them in PlateausPlateausPlateausplateausplateaus. If more than one of these points are connected (plateau), their center of gravity is returned. Each plateau center is returned as a separate region.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.

Parameters

ImageImageImageimageimage (input_object)  singlechannelimage(-array) → objectHImageHObjectHObjectHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real)

Input image.

PlateausPlateausPlateausplateausplateaus (output_object)  region-array → objectHRegionHObjectHObjectHobject *

Centers of gravity of the extracted plateaus as regions (one region for each plateau).

Example (C++)

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main (int argc, char *argv[])
{
  if (argc != 2)
  {
    cout << "Usage : " << argv[0] << " <name of image>" << endl;
    return (-1);
  }

  HImage   image (argv[1]);
  HWindow  win;

  image.Display (win);

  HImage       cres = image.CornerResponse (5, 0.04);
  HRegionArray maxi = cres.PlateausCenter ();

  win.SetColored (12);
  maxi.Display (win);
  win.Click ();

  return (0);
}

Example (C)

read_image(&Image,"fabrik");
corner_responce(Image,&CornerResp,5,0.04);
plateaus_center(CornerResp,&Maxima);
set_colored(WindowHandle,12);
disp_region(Maxima,WindowHandle);
T_area_center(Maxima,NULL,&Row,&Col);

Example (C++)

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main (int argc, char *argv[])
{
  if (argc != 2)
  {
    cout << "Usage : " << argv[0] << " <name of image>" << endl;
    return (-1);
  }

  HImage   image (argv[1]);
  HWindow  win;

  image.Display (win);

  HImage       cres = image.CornerResponse (5, 0.04);
  HRegionArray maxi = cres.PlateausCenter ();

  win.SetColored (12);
  maxi.Display (win);
  win.Click ();

  return (0);
}

Example (C++)

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main (int argc, char *argv[])
{
  if (argc != 2)
  {
    cout << "Usage : " << argv[0] << " <name of image>" << endl;
    return (-1);
  }

  HImage   image (argv[1]);
  HWindow  win;

  image.Display (win);

  HImage       cres = image.CornerResponse (5, 0.04);
  HRegionArray maxi = cres.PlateausCenter ();

  win.SetColored (12);
  maxi.Display (win);
  win.Click ();

  return (0);
}

Possible Predecessors

binomial_filterbinomial_filterBinomialFilterBinomialFilterbinomial_filter, gauss_filtergauss_filterGaussFilterGaussFiltergauss_filter, smooth_imagesmooth_imageSmoothImageSmoothImagesmooth_image

Possible Successors

area_centerarea_centerAreaCenterAreaCenterarea_center, get_region_pointsget_region_pointsGetRegionPointsGetRegionPointsget_region_points, select_shapeselect_shapeSelectShapeSelectShapeselect_shape

Alternatives

plateausplateausPlateausPlateausplateaus, nonmax_suppression_ampnonmax_suppression_ampNonmaxSuppressionAmpNonmaxSuppressionAmpnonmax_suppression_amp, local_maxlocal_maxLocalMaxLocalMaxlocal_max

See also

monotonymonotonyMonotonyMonotonymonotony, topographic_sketchtopographic_sketchTopographicSketchTopographicSketchtopographic_sketch, corner_responsecorner_responseCornerResponseCornerResponsecorner_response, texture_lawstexture_lawsTextureLawsTextureLawstexture_laws

Module

Foundation

---

ClassesClasses | | Operators