HALCON 17.12 / HALCON Operator Reference / Legacy / Segmentation
ClassesClasses | | Operators

expand_lineexpand_lineExpandLineExpandLine (Operator)

Name

expand_lineexpand_lineExpandLineExpandLine — Expand a region starting at a given line.

Warning

expand_lineexpand_lineExpandLineExpandLineExpandLine is obsolete and is only provided for reasons of backward compatibility.

Signature

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

Herror expand_line(const Hobject Image, Hobject* RegionExpand, const Hlong Coordinate, const char* ExpandType, const char* RowColumn, double Threshold)

Herror T_expand_line(const Hobject Image, Hobject* RegionExpand, const Htuple Coordinate, const Htuple ExpandType, const Htuple RowColumn, const Htuple Threshold)

void ExpandLine(const HObject& Image, HObject* RegionExpand, const HTuple& Coordinate, const HTuple& ExpandType, const HTuple& RowColumn, const HTuple& Threshold)

HRegion HImage::ExpandLine(Hlong Coordinate, const HString& ExpandType, const HString& RowColumn, const HTuple& Threshold) const

HRegion HImage::ExpandLine(Hlong Coordinate, const HString& ExpandType, const HString& RowColumn, double Threshold) const

HRegion HImage::ExpandLine(Hlong Coordinate, const char* ExpandType, const char* RowColumn, double Threshold) const

static void HOperatorSet.ExpandLine(HObject image, out HObject regionExpand, HTuple coordinate, HTuple expandType, HTuple rowColumn, HTuple threshold)

HRegion HImage.ExpandLine(int coordinate, string expandType, string rowColumn, HTuple threshold)

HRegion HImage.ExpandLine(int coordinate, string expandType, string rowColumn, double threshold)

Description

expand_lineexpand_lineExpandLineExpandLineExpandLine 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 ThresholdThresholdThresholdThresholdthreshold from the mean gray value along the line (ExpandTypeExpandTypeExpandTypeExpandTypeexpandType = 'mean'"mean""mean""mean""mean") or from the previously added gray value (ExpandTypeExpandTypeExpandTypeExpandTypeexpandType = 'gradient'"gradient""gradient""gradient""gradient").

Execution Information

Parameters

ImageImageImageImageimage (input_object)  singlechannelimage(-array) → objectHImageHImageHobject (byte)

Input image.

RegionExpandRegionExpandRegionExpandRegionExpandregionExpand (output_object)  region(-array) → objectHRegionHRegionHobject *

Extracted segments.

CoordinateCoordinateCoordinateCoordinatecoordinate (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row or column coordinate.

Default value: 256

Suggested values: 16, 64, 128, 200, 256, 300, 400, 511

Restriction: Coordinate >= 0

ExpandTypeExpandTypeExpandTypeExpandTypeexpandType (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Stopping criterion.

Default value: 'gradient' "gradient" "gradient" "gradient" "gradient"

List of values: 'gradient'"gradient""gradient""gradient""gradient", 'mean'"mean""mean""mean""mean"

RowColumnRowColumnRowColumnRowColumnrowColumn (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Segmentation mode (row or column).

Default value: 'row' "row" "row" "row" "row"

List of values: 'column'"column""column""column""column", 'row'"row""row""row""row"

ThresholdThresholdThresholdThresholdthreshold (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

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 Threshold Threshold Threshold threshold ≤ 255.0 (lin)

Minimum increment: 1.0

Recommended increment: 1.0

Restriction: Threshold >= 0.0 && Threshold <= 255.0

Example (C++ (HALCON 5.0-10.0))

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

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

Example (C)

read_image(&Image,"fabrik");
gauss_filter(Image,&Gauss,5);
expand_line(Gauss,&Reg,100,"mean","row",5.0);
set_colored(WindowHandle,12);
disp_region(Maxima,WindowHandle);

Example (C++ (HALCON 5.0-10.0))

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

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

Example (C++ (HALCON 5.0-10.0))

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

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

Example (C++ (HALCON 5.0-10.0))

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

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

Possible Predecessors

binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter, smooth_imagesmooth_imageSmoothImageSmoothImageSmoothImage, anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionAnisotropicDiffusion, median_imagemedian_imageMedianImageMedianImageMedianImage, affine_trans_imageaffine_trans_imageAffineTransImageAffineTransImageAffineTransImage, rotate_imagerotate_imageRotateImageRotateImageRotateImage

Possible Successors

intersectionintersectionIntersectionIntersectionIntersection, openingopeningOpeningOpeningOpening, closingclosingClosingClosingClosing

Alternatives

regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanRegiongrowingMean, expand_grayexpand_grayExpandGrayExpandGrayExpandGray, expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefExpandGrayRef

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH