select_lines T_select_lines SelectLines SelectLines select_lines (Operator)
select_lines T_select_lines SelectLines SelectLines select_lines
— Select lines according to various criteria.
Warning
select_lines select_lines SelectLines SelectLines select_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_lines select_lines SelectLines SelectLines select_lines
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' "and" "and" "and" "and" ) or at least one
(Operation Operation Operation operation operation
= 'or' "or" "or" "or" "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.
Condition:
Possible values for Feature Feature Feature feature feature
:
'length' "length" "length" "length" "length"
(Euclidean) length of the line
'row' "row" "row" "row" "row"
Line index of the center
'column' "column" "column" "column" "column"
Column index of the center
'phi' "phi" "phi" "phi" "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 row_begin_in
(input_control) line.begin.y-array →
HTuple Sequence[int] HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Row coordinates of the starting points of the
input lines.
ColBeginIn ColBeginIn ColBeginIn colBeginIn col_begin_in
(input_control) line.begin.x-array →
HTuple Sequence[int] HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Column coordinates of the starting points of the
input lines.
RowEndIn RowEndIn RowEndIn rowEndIn row_end_in
(input_control) line.end.y-array →
HTuple Sequence[int] HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Row coordinates of the ending points of the
input lines.
ColEndIn ColEndIn ColEndIn colEndIn col_end_in
(input_control) line.end.x-array →
HTuple Sequence[int] 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 MaybeSequence[str] HTuple Htuple (string) (string ) (HString ) (char* )
Features to be used for selection.
Default:
'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 str HTuple Htuple (string) (string ) (HString ) (char* )
Desired combination of the features.
Default:
'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 MaybeSequence[Union[int, float, str]] HTuple Htuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Lower limits of the features or 'min'.
Default:
'min'
"min"
"min"
"min"
"min"
Max Max Max max max
(input_control) string(-array) →
HTuple MaybeSequence[Union[int, float, str]] HTuple Htuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Upper limits of the features or 'max'.
Default:
'max'
"max"
"max"
"max"
"max"
RowBeginOut RowBeginOut RowBeginOut rowBeginOut row_begin_out
(output_control) line.begin.y-array →
HTuple Sequence[int] HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Row coordinates of the starting points of the
output lines.
ColBeginOut ColBeginOut ColBeginOut colBeginOut col_begin_out
(output_control) line.begin.x-array →
HTuple Sequence[int] HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Column coordinates of the starting points of the
output lines.
RowEndOut RowEndOut RowEndOut rowEndOut row_end_out
(output_control) line.end.y-array →
HTuple Sequence[int] HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Row coordinates of the ending points of the
output lines.
ColEndOut ColEndOut ColEndOut colEndOut col_end_out
(output_control) line.end.x-array →
HTuple Sequence[int] 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 select_lines
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 sobel_amp
,
edges_image edges_image EdgesImage EdgesImage edges_image
,
threshold threshold Threshold Threshold threshold
,
hysteresis_threshold hysteresis_threshold HysteresisThreshold HysteresisThreshold hysteresis_threshold
,
split_skeleton_region split_skeleton_region SplitSkeletonRegion SplitSkeletonRegion split_skeleton_region
,
split_skeleton_lines split_skeleton_lines SplitSkeletonLines SplitSkeletonLines split_skeleton_lines
Possible Successors
set_line_width set_line_width SetLineWidth SetLineWidth set_line_width
,
disp_line disp_line DispLine DispLine disp_line
Alternatives
line_orientation line_orientation LineOrientation LineOrientation line_orientation
,
line_position line_position LinePosition LinePosition line_position
,
partition_lines partition_lines PartitionLines PartitionLines partition_lines
See also
partition_lines partition_lines PartitionLines PartitionLines partition_lines
,
select_lines_longest select_lines_longest SelectLinesLongest SelectLinesLongest select_lines_longest
,
detect_edge_segments detect_edge_segments DetectEdgeSegments DetectEdgeSegments detect_edge_segments
,
select_shape select_shape SelectShape SelectShape select_shape
Module
Foundation