expand_line ( Image : RegionExpand : Coordinate, ExpandType, RowColumn, Threshold : )

Expand a region starting at a given line.

expand_line generates a region by expansion, starting at a given line (row or column). The expansion is terminated when the current gray value differs by more than Threshold from the mean gray value along the line (ExpandType = 'mean') or from the previously added gray value (ExpandType = 'gradient').


Parameters

Image (input_object)
image(-array) -> object : byte
Input image.

RegionExpand (output_object)
region(-array) -> object
Extracted segments.

Coordinate (input_control)
integer -> integer
Row or column coordinate.
Default value: 256
Suggested values: 16, 64, 128, 200, 256, 300, 400, 511
Restriction: Coordinate >= 0

ExpandType (input_control)
string -> string
Stopping criterion.
Default value: 'gradient'
List of values: 'gradient', 'mean'

RowColumn (input_control)
string -> string
Segmentation mode (row or column).
Default value: 'row'
List of values: 'row', 'column'

Threshold (input_control)
number -> real / integer
Threshold for the expansion.
Default value: 3.0
Suggested values: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 13.0, 17.0, 20.0, 30.0
Typical range of values: 1.0 <= Threshold <= 255.0 (lin)
Minimum increment: 1.0
Recommended increment: 1.0
Restriction: (Threshold >= 0.0) && (Threshold <= 255.0)


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

int main (int argc, char *argv[])
{
  HImage   image (argv[1]),
           gauss;
  HWindow  win;

  win.SetDraw ("margin");
  win.SetColored (12);

  image.Display (win);

  gauss = image.GaussImage (5);

  HRegionArray reg = gauss.ExpandLine (100, "mean", "row", 5.0);

  reg.Display (win);
  win.Click ();

  return (0);
}

Parallelization Information

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


Possible Predecessors

gauss_image, smooth_image, anisotropic_diffusion, median_image, affine_trans_image, rotate_image


Possible Successors

intersection, opening, closing


Alternatives

regiongrowing_mean, expand_gray, expand_gray_ref


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH