select_lines T_select_lines SelectLines SelectLines (Operator)
Name
select_lines T_select_lines SelectLines SelectLines
— Select lines according to various criteria.
Warning
select_lines select_lines SelectLines SelectLines SelectLines
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 )
Description
The operator select_lines select_lines SelectLines SelectLines SelectLines
chooses lines according to
various criteria. For every input line the indicated features
(Feature Feature Feature Feature feature
) are calculated. If each
(Operation Operation Operation Operation operation
= 'and') or at least one
(Operation Operation Operation Operation operation
= 'or') of the calculated features is within
the given limits (Min Min Min Min min
,Max Max Max Max max
) the line is
transferred into the output.
The default values 'min' "min" "min" "min" "min" and 'max' "max" "max" "max" "max" of the parameters
Min Min Min Min min
and Max Max Max Max max
are used to leave bottom and top limits,
respectively, open.
Possible values for Feature Feature Feature Feature feature
:
'length'
(Euclidean) length of the line
'row'
Line index of the center
'column'
Column index of the center
'phi'
Orientation of the line
Attention
If only one feature is used the value of Operation Operation Operation Operation operation
is
meaningless. Several features are processed according to the
sequence in which they are passed.
Execution Information
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.
Parameters
RowBeginIn RowBeginIn RowBeginIn RowBeginIn rowBeginIn
(input_control) line.begin.y-array →
HTuple HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Row coordinates of the starting points of the
input lines.
ColBeginIn ColBeginIn ColBeginIn ColBeginIn colBeginIn
(input_control) line.begin.x-array →
HTuple HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Column coordinates of the starting points of the
input lines.
RowEndIn RowEndIn RowEndIn RowEndIn rowEndIn
(input_control) line.end.y-array →
HTuple HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Row coordinates of the ending points of the
input lines.
ColEndIn ColEndIn ColEndIn ColEndIn colEndIn
(input_control) line.end.x-array →
HTuple HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Column coordinates of the ending points of the
input lines.
Feature Feature Feature Feature feature
(input_control) string(-array) →
HTuple HTuple Htuple (string) (string ) (HString ) (char* )
Features to be used for selection.
Default value:
'length'
"length"
"length"
"length"
"length"
List of values: 'column' "column" "column" "column" "column" , 'length' "length" "length" "length" "length" , 'phi' "phi" "phi" "phi" "phi" , 'row' "row" "row" "row" "row"
Operation Operation Operation Operation operation
(input_control) string →
HTuple HTuple Htuple (string) (string ) (HString ) (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"
Min Min Min Min min
(input_control) string(-array) →
HTuple HTuple Htuple (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"
Max Max Max Max max
(input_control) string(-array) →
HTuple HTuple Htuple (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"
RowBeginOut RowBeginOut RowBeginOut RowBeginOut rowBeginOut
(output_control) line.begin.y-array →
HTuple HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Row coordinates of the starting points of the
output lines.
ColBeginOut ColBeginOut ColBeginOut ColBeginOut colBeginOut
(output_control) line.begin.x-array →
HTuple HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Column coordinates of the starting points of the
output lines.
RowEndOut RowEndOut RowEndOut RowEndOut rowEndOut
(output_control) line.end.y-array →
HTuple HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Row coordinates of the ending points of the
output lines.
ColEndOut ColEndOut ColEndOut ColEndOut colEndOut
(output_control) line.end.x-array →
HTuple HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Column coordinates of the ending points of the
output lines.
Result
The operator select_lines select_lines SelectLines SelectLines SelectLines
returns the value 2 (H_MSG_TRUE) if the
parameter values are correct. Otherwise an exception is raised.
Possible Predecessors
sobel_amp sobel_amp SobelAmp SobelAmp SobelAmp
,
edges_image edges_image EdgesImage EdgesImage EdgesImage
,
threshold threshold Threshold Threshold Threshold
,
hysteresis_threshold hysteresis_threshold HysteresisThreshold HysteresisThreshold HysteresisThreshold
,
split_skeleton_region split_skeleton_region SplitSkeletonRegion SplitSkeletonRegion SplitSkeletonRegion
,
split_skeleton_lines split_skeleton_lines SplitSkeletonLines SplitSkeletonLines SplitSkeletonLines
Possible Successors
set_line_width set_line_width SetLineWidth SetLineWidth SetLineWidth
,
disp_line disp_line DispLine DispLine DispLine
Alternatives
line_orientation line_orientation LineOrientation LineOrientation LineOrientation
,
line_position line_position LinePosition LinePosition LinePosition
,
partition_lines partition_lines PartitionLines PartitionLines PartitionLines
See also
partition_lines partition_lines PartitionLines PartitionLines PartitionLines
,
select_lines_longest select_lines_longest SelectLinesLongest SelectLinesLongest SelectLinesLongest
,
detect_edge_segments detect_edge_segments DetectEdgeSegments DetectEdgeSegments DetectEdgeSegments
,
select_shape select_shape SelectShape SelectShape SelectShape
Module
Foundation