select_linesT_select_linesSelectLinesSelectLinesselect_lines (Operator)

Name

select_linesT_select_linesSelectLinesSelectLinesselect_lines — Select lines according to various criteria.

Warning

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

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)

void SelectLines(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)

static void HMisc::SelectLines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const HTuple& Feature, const HString& Operation, const HTuple& Min, const HTuple& Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut)

static void HMisc::SelectLines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const HString& Feature, const HString& Operation, const HString& Min, const HString& Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut)

static void HMisc::SelectLines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const char* Feature, const char* Operation, const char* Min, const char* Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut)

static void HMisc::SelectLines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const wchar_t* Feature, const wchar_t* Operation, const wchar_t* Min, const wchar_t* Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut)   (Windows only)

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)

def select_lines(row_begin_in: Sequence[int], col_begin_in: Sequence[int], row_end_in: Sequence[int], col_end_in: Sequence[int], feature: MaybeSequence[str], operation: str, min: MaybeSequence[Union[int, float, str]], max: MaybeSequence[Union[int, float, str]]) -> Tuple[Sequence[int], Sequence[int], Sequence[int], Sequence[int]]

Description

The operator select_linesselect_linesSelectLinesSelectLinesSelectLinesselect_lines chooses lines according to various criteria. For every input line the indicated features (FeatureFeatureFeatureFeaturefeaturefeature) are calculated. If each (OperationOperationOperationOperationoperationoperation = 'and'"and""and""and""and""and") or at least one (OperationOperationOperationOperationoperationoperation = 'or'"or""or""or""or""or") of the calculated features is within the given limits (MinMinMinMinminmin,MaxMaxMaxMaxmaxmax) the line is transferred into the output. The default values 'min'"min""min""min""min""min" and 'max'"max""max""max""max""max" of the parameters MinMinMinMinminmin and MaxMaxMaxMaxmaxmax are used to leave bottom and top limits, respectively, open.

Condition: Possible values for FeatureFeatureFeatureFeaturefeaturefeature:

'length'"length""length""length""length""length"

(Euclidean) length of the line

'row'"row""row""row""row""row"

Line index of the center

'column'"column""column""column""column""column"

Column index of the center

'phi'"phi""phi""phi""phi""phi"

Orientation of the line

Attention

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

Execution Information

Parameters

RowBeginInRowBeginInRowBeginInRowBeginInrowBeginInrow_begin_in (input_control)  line.begin.y-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinates of the starting points of the input lines.

ColBeginInColBeginInColBeginInColBeginIncolBeginIncol_begin_in (input_control)  line.begin.x-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinates of the starting points of the input lines.

RowEndInRowEndInRowEndInRowEndInrowEndInrow_end_in (input_control)  line.end.y-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinates of the ending points of the input lines.

ColEndInColEndInColEndInColEndIncolEndIncol_end_in (input_control)  line.end.x-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinates of the ending points of the input lines.

FeatureFeatureFeatureFeaturefeaturefeature (input_control)  string(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Features to be used for selection.

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

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

OperationOperationOperationOperationoperationoperation (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Desired combination of the features.

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

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

MinMinMinMinminmin (input_control)  string(-array) HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Lower limits of the features or 'min'.

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

MaxMaxMaxMaxmaxmax (input_control)  string(-array) HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Upper limits of the features or 'max'.

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

RowBeginOutRowBeginOutRowBeginOutRowBeginOutrowBeginOutrow_begin_out (output_control)  line.begin.y-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinates of the starting points of the output lines.

ColBeginOutColBeginOutColBeginOutColBeginOutcolBeginOutcol_begin_out (output_control)  line.begin.x-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinates of the starting points of the output lines.

RowEndOutRowEndOutRowEndOutRowEndOutrowEndOutrow_end_out (output_control)  line.end.y-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinates of the ending points of the output lines.

ColEndOutColEndOutColEndOutColEndOutcolEndOutcol_end_out (output_control)  line.end.x-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinates of the ending points of the output lines.

Result

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

Possible Predecessors

sobel_ampsobel_ampSobelAmpSobelAmpSobelAmpsobel_amp, edges_imageedges_imageEdgesImageEdgesImageEdgesImageedges_image, thresholdthresholdThresholdThresholdThresholdthreshold, hysteresis_thresholdhysteresis_thresholdHysteresisThresholdHysteresisThresholdHysteresisThresholdhysteresis_threshold, split_skeleton_regionsplit_skeleton_regionSplitSkeletonRegionSplitSkeletonRegionSplitSkeletonRegionsplit_skeleton_region, split_skeleton_linessplit_skeleton_linesSplitSkeletonLinesSplitSkeletonLinesSplitSkeletonLinessplit_skeleton_lines

Possible Successors

set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width, disp_linedisp_lineDispLineDispLineDispLinedisp_line

Alternatives

line_orientationline_orientationLineOrientationLineOrientationLineOrientationline_orientation, line_positionline_positionLinePositionLinePositionLinePositionline_position, partition_linespartition_linesPartitionLinesPartitionLinesPartitionLinespartition_lines

See also

partition_linespartition_linesPartitionLinesPartitionLinesPartitionLinespartition_lines, select_lines_longestselect_lines_longestSelectLinesLongestSelectLinesLongestSelectLinesLongestselect_lines_longest, detect_edge_segmentsdetect_edge_segmentsDetectEdgeSegmentsDetectEdgeSegmentsDetectEdgeSegmentsdetect_edge_segments, select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape

Module

Foundation