plateaus_center

plateaus_center ( Image : Plateaus : : )

Detect the centers of all gray value plateaus.

plateaus_center extracts all points from Image with a gray value greater or equal to the gray value of its neighbors (8-neighborhood) and returns them in Plateaus. 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.

Parameters

`Image` (input_object)	image(-array) `->` object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real
Input image.

`Plateaus` (output_object)	region-array `->` object
Centers of gravity of the extracted plateaus as regions (one region for each plateau).

Example (Syntax: C++)

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

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);
}

Parallelization Information

plateaus_center is reentrant and automatically parallelized (on tuple level).

Possible Predecessors

gauss_image, smooth_image

Possible Successors

area_center, get_region_points, select_shape

Alternatives

plateaus, nonmax_suppression_amp, local_max

Module

Foundation