HALCON Reference Manual 10.0.2
Table of Contents / Segmentation / Topography ClassesClassesClasses | | | Operators

lowlandslowlandslowlandsLowlandsLowlands (Operator)

Name

lowlandslowlandslowlandsLowlandsLowlands — Detect all gray value lowlands.

Signature

lowlands(Image : Lowlands : : )

Herror lowlands(const Hobject Image, Hobject* Lowlands)

Herror T_lowlands(const Hobject Image, Hobject* Lowlands)

Herror lowlands(Hobject Image, Hobject* Lowlands)

HRegionArray HImage::Lowlands() const

HRegionArray HImageArray::Lowlands() const

void HOperatorSetX.Lowlands(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*Lowlands)

IHRegionX* HImageX.Lowlands()

static void HOperatorSet.Lowlands(HObject image, out HObject lowlands)

HRegion HImage.Lowlands()

Description

lowlandslowlandslowlandsLowlandsLowlands extracts all points from ImageImageImageImageimage with a gray value less or equal to the gray value of its neighbors (8-neighborhood) and returns them in LowlandsLowlandsLowlandsLowlandslowlands. Each lowland is returned as a separate region.

Parallelization

Parameters

ImageImageImageImageimage (input_object)  image(-array) objectHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real)

Image to be processed.

LowlandsLowlandsLowlandsLowlandslowlands (output_object)  region-array objectHRegionHRegionArrayHRegionXHobject *

Extracted lowlands as regions (one region for each lowland).

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 mins = cres.Lowlands ();

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

  return (0);
}

Example (C)

read_image(&Image,"fabrik");
corner_responce(Image,&CornerResp,5,0.04);
lowlands(CornerResp,&Minima);
set_colored(WindowHandle,12);
disp_region(Minima,WindowHandle);
T_area_center(Minima,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 mins = cres.Lowlands ();

  win.SetColored (12);
  mins.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 mins = cres.Lowlands ();

  win.SetColored (12);
  mins.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 mins = cres.Lowlands ();

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

  return (0);
}

Possible Predecessors

binomial_filterbinomial_filterbinomial_filterBinomialFilterBinomialFilter, gauss_imagegauss_imagegauss_imageGaussImageGaussImage, smooth_imagesmooth_imagesmooth_imageSmoothImageSmoothImage

Possible Successors

area_centerarea_centerarea_centerAreaCenterAreaCenter, get_region_pointsget_region_pointsget_region_pointsGetRegionPointsGetRegionPoints, select_shapeselect_shapeselect_shapeSelectShapeSelectShape

Alternatives

lowlands_centerlowlands_centerlowlands_centerLowlandsCenterLowlandsCenter, gray_skeletongray_skeletongray_skeletonGraySkeletonGraySkeleton, local_minlocal_minlocal_minLocalMinLocalMin

See also

monotonymonotonymonotonyMonotonyMonotony, topographic_sketchtopographic_sketchtopographic_sketchTopographicSketchTopographicSketch, corner_responsecorner_responsecorner_responseCornerResponseCornerResponse, texture_lawstexture_lawstexture_lawsTextureLawsTextureLaws

Module

Foundation


Table of Contents / Segmentation / Topography ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH