HALCON Reference Manual 10.0.2
Table of Contents / Tools / Lines ClassesClassesClasses | | | Operators

select_linesT_select_linesselect_linesSelectLinesSelectLines (Operator)

Name

select_linesT_select_linesselect_linesSelectLinesSelectLines — Select lines according to various criteria.

Signature

select_lines( : : RowBeginIn, ColBeginIn, RowEndIn, ColEndIn, Feature, Operation, Min, Max : RowBeginOut, ColBeginOut, RowEndOut, ColEndOut)

Herror T_select_lines(const Htuple RowBeginIn, const Htuple ColBeginIn, const Htuple RowEndIn, const Htuple ColEndIn, const Htuple Feature, const Htuple Operation, const Htuple Min, const Htuple Max, Htuple* RowBeginOut, Htuple* ColBeginOut, Htuple* RowEndOut, Htuple* ColEndOut)

Herror select_lines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const HTuple& Feature, const HTuple& Operation, const HTuple& Min, const HTuple& Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut)

void HOperatorSetX.SelectLines(
[in] VARIANT RowBeginIn, [in] VARIANT ColBeginIn, [in] VARIANT RowEndIn, [in] VARIANT ColEndIn, [in] VARIANT Feature, [in] VARIANT Operation, [in] VARIANT Min, [in] VARIANT Max, [out] VARIANT* RowBeginOut, [out] VARIANT* ColBeginOut, [out] VARIANT* RowEndOut, [out] VARIANT* ColEndOut)

VARIANT HMiscX.SelectLines(
[in] VARIANT RowBeginIn, [in] VARIANT ColBeginIn, [in] VARIANT RowEndIn, [in] VARIANT ColEndIn, [in] VARIANT Feature, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max, [out] VARIANT* ColBeginOut, [out] VARIANT* RowEndOut, [out] VARIANT* ColEndOut)

static void HOperatorSet.SelectLines(HTuple rowBeginIn, HTuple colBeginIn, HTuple rowEndIn, HTuple colEndIn, HTuple feature, HTuple operation, HTuple min, HTuple max, out HTuple rowBeginOut, out HTuple colBeginOut, out HTuple rowEndOut, out HTuple colEndOut)

static void HMisc.SelectLines(HTuple rowBeginIn, HTuple colBeginIn, HTuple rowEndIn, HTuple colEndIn, HTuple feature, string operation, HTuple min, HTuple max, out HTuple rowBeginOut, out HTuple colBeginOut, out HTuple rowEndOut, out HTuple colEndOut)

static void HMisc.SelectLines(HTuple rowBeginIn, HTuple colBeginIn, HTuple rowEndIn, HTuple colEndIn, string feature, string operation, string min, string max, out HTuple rowBeginOut, out HTuple colBeginOut, out HTuple rowEndOut, out HTuple colEndOut)

Description

The operator select_linesselect_linesselect_linesSelectLinesSelectLines chooses lines according to various criteria. For every input line the indicated features (FeatureFeatureFeatureFeaturefeature) are calculated. If each (OperationOperationOperationOperationoperation = 'and') or at least one (OperationOperationOperationOperationoperation = 'or') of the calculated features is within the given limits (MinMinMinMinmin,MaxMaxMaxMaxmax) the line is transferred into the output. 

Condition:   Min_i <= Feature_i(Line) <= Max_i

Possible values for FeatureFeatureFeatureFeaturefeature:

'length'

(Euclidean) length of the line

'row'

Line index of the center

'column'

Column index of the center

'phi'

Orientation of the line (-pi/2 < phi <= pi/2)

Attention

If only one feature is used the value of OperationOperationOperationOperationoperation is meaningless. Several features are processed according to the sequence in which they are passed.

Parallelization

Parameters

RowBeginInRowBeginInRowBeginInRowBeginInrowBeginIn (input_control)  line.begin.y-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Row coordinates of the starting points of the input lines.

ColBeginInColBeginInColBeginInColBeginIncolBeginIn (input_control)  line.begin.x-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column coordinates of the starting points of the input lines.

RowEndInRowEndInRowEndInRowEndInrowEndIn (input_control)  line.end.y-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Row coordinates of the ending points of the input lines.

ColEndInColEndInColEndInColEndIncolEndIn (input_control)  line.end.x-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column coordinates of the ending points of the input lines.

FeatureFeatureFeatureFeaturefeature (input_control)  string(-array) → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Features to be used for selection.

Default value: 'length' "length" "length" "length" "length"

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

OperationOperationOperationOperationoperation (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Desired combination of the features.

Default value: 'and' "and" "and" "and" "and"

List of values: 'and'"and""and""and""and", 'or'"or""or""or""or"

MinMinMinMinmin (input_control)  string(-array) → HTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)

Lower limits of the features or 'min'.

Default value: 'min' "min" "min" "min" "min"

MaxMaxMaxMaxmax (input_control)  string(-array) → HTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)

Upper limits of the features or 'max'.

Default value: 'max' "max" "max" "max" "max"

RowBeginOutRowBeginOutRowBeginOutRowBeginOutrowBeginOut (output_control)  line.begin.y-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Row coordinates of the starting points of the output lines.

ColBeginOutColBeginOutColBeginOutColBeginOutcolBeginOut (output_control)  line.begin.x-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column coordinates of the starting points of the output lines.

RowEndOutRowEndOutRowEndOutRowEndOutrowEndOut (output_control)  line.end.y-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Row coordinates of the ending points of the output lines.

ColEndOutColEndOutColEndOutColEndOutcolEndOut (output_control)  line.end.x-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column coordinates of the ending points of the output lines.

Result

The operator select_linesselect_linesselect_linesSelectLinesSelectLines returns the value 2 (H_MSG_TRUE) if the parameter values are correct. Otherwise an exception is raised.

Possible Predecessors

sobel_ampsobel_ampsobel_ampSobelAmpSobelAmp, edges_imageedges_imageedges_imageEdgesImageEdgesImage, thresholdthresholdthresholdThresholdThreshold, hysteresis_thresholdhysteresis_thresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold, split_skeleton_regionsplit_skeleton_regionsplit_skeleton_regionSplitSkeletonRegionSplitSkeletonRegion, split_skeleton_linessplit_skeleton_linessplit_skeleton_linesSplitSkeletonLinesSplitSkeletonLines

Possible Successors

set_line_widthset_line_widthset_line_widthSetLineWidthSetLineWidth, disp_linedisp_linedisp_lineDispLineDispLine

Alternatives

line_orientationline_orientationline_orientationLineOrientationLineOrientation, line_positionline_positionline_positionLinePositionLinePosition, partition_linespartition_linespartition_linesPartitionLinesPartitionLines

See also

partition_linespartition_linespartition_linesPartitionLinesPartitionLines, select_lines_longestselect_lines_longestselect_lines_longestSelectLinesLongestSelectLinesLongest, detect_edge_segmentsdetect_edge_segmentsdetect_edge_segmentsDetectEdgeSegmentsDetectEdgeSegments, select_shapeselect_shapeselect_shapeSelectShapeSelectShape

Module

Foundation

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