sort_region
— Sorting of regions with respect to their relative position.
sort_region(Regions : SortedRegions : SortMode, Order, RowOrCol : )
The operator sort_region
sorts the regions
with respect to their relative position.
All sorting methods with the exception of 'character'
use one point of the region. With the help of the parameter
RowOrCol
= 'row' these points will be
sorted according to their row and then according to their
column. By using 'column' , the column value will
be used first.
The following values are available for the parameter
SortMode
:
The regions are treated like characters, which can be read
horizontally or vertically. They are sorted according
to the reading direction given by RowOrCol
with
the following specifications:
'row' : Regarded as rows, the reading direction is firstly from left to right and then from top to bottom. This sorting mode requires the adjacent rows to either not overlap or have an overlap of less than 25%.
'column' : Regarded as columns, the reading direction is firstly from top to bottom and then from left to right. This sorting mode requires the adjacent columns to either not overlap or have an overlap of less than 25%.
Note that in case Order
is set to 'false' ,
the characters are sorted in a reversed order to the one
described above.
The point with the lowest column value in the first row of the region.
The point with the highest column value in the last row of the region.
Upper left corner of the surrounding rectangle.
Upper right corner of the surrounding rectangle.
Lower left corner of the surrounding rectangle.
Lower right corner of the surrounding rectangle.
The parameter Order
determines whether the
sorting order is increasing or decreasing: using
'true' the order will be increasing, using
'false' the order will be decreasing.
Regions
(input_object) region-array →
object
Regions to be sorted.
SortedRegions
(output_object) region-array →
object
Sorted regions.
SortMode
(input_control) string →
(string)
Kind of sorting.
Default value: 'first_point'
List of values: 'character' , 'first_point' , 'last_point' , 'lower_left' , 'lower_right' , 'upper_left' , 'upper_right'
Order
(input_control) string →
(string)
Increasing or decreasing sorting order.
Default value: 'true'
List of values: 'false' , 'true'
RowOrCol
(input_control) string →
(string)
Sorting first with respect to row, then to column.
Default value: 'row'
List of values: 'column' , 'row'
If the parameters are correct, the operator
sort_region
returns the value 2 (H_MSG_TRUE).
Otherwise an exception will be raised.
do_ocr_multi_class_mlp
,
do_ocr_single_class_mlp
Foundation