morph_hat ( Region, StructElement : RegionMorphHat : : )

Compute the union of bottom_hat and top_hat.

morph_hat computes the union of the regions that are removed by an opening operation with the regions that are added by a closing operation. Hence this is the union of the results of top_hat and bottom_hat. The position of StructElement does not influence the result.

Structuring elements (StructElement) can be generated with operators such as gen_circle, gen_rectangle1, gen_rectangle2, gen_ellipse, draw_region, gen_region_polygon, gen_region_points, etc.


Attention

The individual regions are processed separately.


Parameters

Region (input_object)
region(-array) -> object
Regions to be processed.

StructElement (input_object)
region -> object
Structuring element (position-invariant).

RegionMorphHat (output_object)
region(-array) -> object
Union of top hat and bottom hat.


Example (Syntax: C++)
#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"

main()
{
  cout << "Reproduction of 'dilation_circle ()'" << endl;
  cout << "First = original image " << endl;
  cout << "Red   = after segmentation " << endl;
  cout << "Blue  = after erosion " << endl;

  HByteImage img("monkey");
  HWindow    w;

  HRegion      circ   = HRegion::GenCircle (10, 10, 1.5);
  HRegionArray regs   = (img >= 128).Connection();
  HRegionArray tophat = regs.TopHat (circ);
  HRegionArray bothat = regs.BottomHat (circ);
  HRegionArray unionX = tophat.Union2 (bothat);

                        img.Display (w);      w.Click ();
  w.SetColor ("red");   regs.Display (w);     w.Click ();
  w.SetColor ("blue");  tophat.Display (w);   w.Click ();
  w.SetColor ("green"); bothat.Display (w);   w.Click ();
  w.SetColor ("white"); unionX.Display (w);   w.Click ();

  return(0);
}

Result

morph_hat returns 2 (H_MSG_TRUE) if all parameters are correct. The behavior in case of empty or no input region can be set via:

  a) no region:    set_system('no_object_result',<RegionResult>)
  b) empty region: set_system('empty_region_result',<RegionResult>)
Otherwise, an exception is raised.


Parallelization Information

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


Possible Predecessors

threshold, regiongrowing, connection, union1, watersheds, class_ndim_norm, gen_circle, gen_ellipse, gen_rectangle1, gen_rectangle2, draw_region, gen_region_points, gen_struct_elements, gen_region_polygon_filled


Possible Successors

reduce_domain, select_shape, area_center, connection


Alternatives

top_hat, bottom_hat, union2


See also

opening, closing


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH