Name
select_shape_xldselect_shape_xldSelectShapeXldselect_shape_xldSelectShapeXldSelectShapeXld — Select contours or polygons using shape features.
Herror select_shape_xld(const Hobject XLD, Hobject* SelectedXLD, const char* Features, const char* Operation, double Min, double Max)
Herror T_select_shape_xld(const Hobject XLD, Hobject* SelectedXLD, const Htuple Features, const Htuple Operation, const Htuple Min, const Htuple Max)
void SelectShapeXld(const HObject& XLD, HObject* SelectedXLD, const HTuple& Features, const HTuple& Operation, const HTuple& Min, const HTuple& Max)
HXLD HXLD::SelectShapeXld(const HTuple& Features, const HString& Operation, const HTuple& Min, const HTuple& Max) const
HXLD HXLD::SelectShapeXld(const HString& Features, const HString& Operation, double Min, double Max) const
HXLD HXLD::SelectShapeXld(const char* Features, const char* Operation, double Min, double Max) const
HXLDCont HXLDCont::SelectShapeXld(const HTuple& Features, const HString& Operation, const HTuple& Min, const HTuple& Max) const
HXLDCont HXLDCont::SelectShapeXld(const HString& Features, const HString& Operation, double Min, double Max) const
HXLDCont HXLDCont::SelectShapeXld(const char* Features, const char* Operation, double Min, double Max) const
HXLDPoly HXLDPoly::SelectShapeXld(const HTuple& Features, const HString& Operation, const HTuple& Min, const HTuple& Max) const
HXLDPoly HXLDPoly::SelectShapeXld(const HString& Features, const HString& Operation, double Min, double Max) const
HXLDPoly HXLDPoly::SelectShapeXld(const char* Features, const char* Operation, double Min, double Max) const
HXLDPara HXLDPara::SelectShapeXld(const HTuple& Features, const HString& Operation, const HTuple& Min, const HTuple& Max) const
HXLDPara HXLDPara::SelectShapeXld(const HString& Features, const HString& Operation, double Min, double Max) const
HXLDPara HXLDPara::SelectShapeXld(const char* Features, const char* Operation, double Min, double Max) const
HXLDModPara HXLDModPara::SelectShapeXld(const HTuple& Features, const HString& Operation, const HTuple& Min, const HTuple& Max) const
HXLDModPara HXLDModPara::SelectShapeXld(const HString& Features, const HString& Operation, double Min, double Max) const
HXLDModPara HXLDModPara::SelectShapeXld(const char* Features, const char* Operation, double Min, double Max) const
HXLDExtPara HXLDExtPara::SelectShapeXld(const HTuple& Features, const HString& Operation, const HTuple& Min, const HTuple& Max) const
HXLDExtPara HXLDExtPara::SelectShapeXld(const HString& Features, const HString& Operation, double Min, double Max) const
HXLDExtPara HXLDExtPara::SelectShapeXld(const char* Features, const char* Operation, double Min, double Max) const
void HOperatorSetX.SelectShapeXld(
[in] IHUntypedObjectX* XLD, [out] IHUntypedObjectX** SelectedXLD, [in] VARIANT Features, [in] VARIANT Operation, [in] VARIANT Min, [in] VARIANT Max)
IHXLDX* HXLDX.SelectShapeXld(
[in] VARIANT Features, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max)
IHXLDX* HXLDContX.SelectShapeXld(
[in] VARIANT Features, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max)
IHXLDX* HXLDPolyX.SelectShapeXld(
[in] VARIANT Features, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max)
IHXLDX* HXLDParaX.SelectShapeXld(
[in] VARIANT Features, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max)
IHXLDX* HXLDModParaX.SelectShapeXld(
[in] VARIANT Features, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max)
IHXLDX* HXLDExtParaX.SelectShapeXld(
[in] VARIANT Features, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max)
static void HOperatorSet.SelectShapeXld(HObject XLD, out HObject selectedXLD, HTuple features, HTuple operation, HTuple min, HTuple max)
HXLD HXLD.SelectShapeXld(HTuple features, string operation, HTuple min, HTuple max)
HXLD HXLD.SelectShapeXld(string features, string operation, double min, double max)
HXLDCont HXLDCont.SelectShapeXld(HTuple features, string operation, HTuple min, HTuple max)
HXLDCont HXLDCont.SelectShapeXld(string features, string operation, double min, double max)
HXLDPoly HXLDPoly.SelectShapeXld(HTuple features, string operation, HTuple min, HTuple max)
HXLDPoly HXLDPoly.SelectShapeXld(string features, string operation, double min, double max)
HXLDPara HXLDPara.SelectShapeXld(HTuple features, string operation, HTuple min, HTuple max)
HXLDPara HXLDPara.SelectShapeXld(string features, string operation, double min, double max)
HXLDModPara HXLDModPara.SelectShapeXld(HTuple features, string operation, HTuple min, HTuple max)
HXLDModPara HXLDModPara.SelectShapeXld(string features, string operation, double min, double max)
HXLDExtPara HXLDExtPara.SelectShapeXld(HTuple features, string operation, HTuple min, HTuple max)
HXLDExtPara HXLDExtPara.SelectShapeXld(string features, string operation, double min, double max)
The operator select_shape_xldselect_shape_xldSelectShapeXldselect_shape_xldSelectShapeXldSelectShapeXld selects contours or polygons
according to their shape. For each input contour or polygon in
XLDXLDXLDXLDXLDXLD the indicated features (FeaturesFeaturesFeaturesFeaturesFeaturesfeatures) are
calculated. If each (OperationOperationOperationOperationOperationoperation = 'and') or at least one
(OperationOperationOperationOperationOperationoperation = 'or') of the calculated features is within the
limits (MinMinMinMinMinmin,MaxMaxMaxMaxMaxmax) the contour respectively polygon
is copied into the output.
The parameters MinMinMinMinMinmin and MaxMaxMaxMaxMaxmax can be set to
'min'"min""min""min""min""min" or 'max'"max""max""max""max""max" in order to leave bottom and top limits,
respectively, open.
Possible values for FeaturesFeaturesFeaturesFeaturesFeaturesfeatures:
(all features can be used with polygons as well)
- 'area':
Area of the contour
(see area_center_xldarea_center_xldAreaCenterXldarea_center_xldAreaCenterXldAreaCenterXld)
- 'area_points':
Area of the contour points
(see area_center_points_xldarea_center_points_xldAreaCenterPointsXldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld)
- 'row':
Row index of the center of gravity
(see area_center_xldarea_center_xldAreaCenterXldarea_center_xldAreaCenterXldAreaCenterXld)
- 'column':
Column index of the center of gravity
(see area_center_xldarea_center_xldAreaCenterXldarea_center_xldAreaCenterXldAreaCenterXld)
- 'row_points':
Row index of the center of gravity of the contour
points (see area_center_points_xldarea_center_points_xldAreaCenterPointsXldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld)
- 'column_points':
Column index of the center of gravity of the contour
points (see area_center_points_xldarea_center_points_xldAreaCenterPointsXldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld)
- 'width':
Width of the contour
- 'height':
Height of the contour
- 'row1':
Row coordinate of upper left corner
(see smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)
- 'column1':
Column coordinate of upper left corner
(see smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)
- 'row2':
Row coordinate of lower right corner
(see smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)
- 'column2':
Column coordinate of lower right corner
(see smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)
- 'circularity':
Circularity (see circularity_xldcircularity_xldCircularityXldcircularity_xldCircularityXldCircularityXld)
- 'compactness':
Compactness (see compactness_xldcompactness_xldCompactnessXldcompactness_xldCompactnessXldCompactnessXld)
- 'contlength':
Total length of contour
(see length_xldlength_xldLengthXldlength_xldLengthXldLengthXld)
- 'convexity':
Convexity (see convexity_xldconvexity_xldConvexityXldconvexity_xldConvexityXldConvexityXld)
- 'ra':
Major radius of the equivalent ellipse
(see elliptic_axis_xldelliptic_axis_xldEllipticAxisXldelliptic_axis_xldEllipticAxisXldEllipticAxisXld)
- 'rb':
Minor radius of the equivalent ellipse
(see elliptic_axis_xldelliptic_axis_xldEllipticAxisXldelliptic_axis_xldEllipticAxisXldEllipticAxisXld)
- 'phi':
Orientation of the equivalent ellipse
(see elliptic_axis_xldelliptic_axis_xldEllipticAxisXldelliptic_axis_xldEllipticAxisXldEllipticAxisXld)
- 'ra_points':
Major radius of the equivalent ellipse of the
contour points (see elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld)
- 'rb_points':
Minor radius of the equivalent ellipse of the
contour points (see elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld)
- 'phi_points':
Orientation of the equivalent ellipse of the
contour points (see elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld)
- 'anisometry:'
Anisometry (see eccentricity_xldeccentricity_xldEccentricityXldeccentricity_xldEccentricityXldEccentricityXld)
- 'anisometry_points:'
Anisometry of the contour points
(see eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXld)
- 'bulkiness:'
Bulkiness (see eccentricity_xldeccentricity_xldEccentricityXldeccentricity_xldEccentricityXldEccentricityXld)
- 'struct_factor:'
Structure factor
(see eccentricity_xldeccentricity_xldEccentricityXldeccentricity_xldEccentricityXldEccentricityXld)
- 'outer_radius':
Radius of smallest enclosing circle
(see smallest_circle_xldsmallest_circle_xldSmallestCircleXldsmallest_circle_xldSmallestCircleXldSmallestCircleXld)
- 'max_diameter':
Maximum diameter of the contour
(see diameter_xlddiameter_xldDiameterXlddiameter_xldDiameterXldDiameterXld)
- 'orientation':
Orientation of the contour
(see orientation_xldorientation_xldOrientationXldorientation_xldOrientationXldOrientationXld)
- 'orientation_points':
Orientation of the contour points
(see orientation_points_xldorientation_points_xldOrientationPointsXldorientation_points_xldOrientationPointsXldOrientationPointsXld)
- 'rect2_phi':
Orientation of the smallest surrounding rectangle
(see smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2Xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld)
- 'rect2_len1':
Half the length of the smallest surrounding
rectangle
(see smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2Xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld)
- 'rect2_len2':
Half the width of the smallest surrounding
rectangle
(see smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2Xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld)
- 'moments_m11', 'moments_m20', 'moments_m02':
Geometric moments of the contour
(see moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)
- 'moments_m11_points', 'moments_m20_points', 'moments_m02_points':
Geometric moments of the contour points
(see moments_points_xldmoments_points_xldMomentsPointsXldmoments_points_xldMomentsPointsXldMomentsPointsXld)
If only one feature (FeaturesFeaturesFeaturesFeaturesFeaturesfeatures) is used the value of
OperationOperationOperationOperationOperationoperation is meaningless. Several features are processed in
the sequence in which they are entered.The use of some features
requires that the input contour respectively polygon must not intersect
itself, otherwise the results are not meaningful (Whether the input contour
or polygon intersects itself or not can be determined with
test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld).
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Contours or polygons to be examined.
Contours or polygons fulfilling the condition(s).
Shape features to be checked.
Default value:
'area'
"area"
"area"
"area"
"area"
"area"
List of values: 'anisometry'"anisometry""anisometry""anisometry""anisometry""anisometry", 'anisometry_points'"anisometry_points""anisometry_points""anisometry_points""anisometry_points""anisometry_points", 'area'"area""area""area""area""area", 'area_points'"area_points""area_points""area_points""area_points""area_points", 'bulkiness'"bulkiness""bulkiness""bulkiness""bulkiness""bulkiness", 'circularity'"circularity""circularity""circularity""circularity""circularity", 'column'"column""column""column""column""column", 'column1'"column1""column1""column1""column1""column1", 'column2'"column2""column2""column2""column2""column2", 'column_points'"column_points""column_points""column_points""column_points""column_points", 'compactness'"compactness""compactness""compactness""compactness""compactness", 'contlength'"contlength""contlength""contlength""contlength""contlength", 'convexity'"convexity""convexity""convexity""convexity""convexity", 'height'"height""height""height""height""height", 'max_diameter'"max_diameter""max_diameter""max_diameter""max_diameter""max_diameter", 'moments_m02'"moments_m02""moments_m02""moments_m02""moments_m02""moments_m02", 'moments_m02_points'"moments_m02_points""moments_m02_points""moments_m02_points""moments_m02_points""moments_m02_points", 'moments_m11'"moments_m11""moments_m11""moments_m11""moments_m11""moments_m11", 'moments_m11_points'"moments_m11_points""moments_m11_points""moments_m11_points""moments_m11_points""moments_m11_points", 'moments_m20'"moments_m20""moments_m20""moments_m20""moments_m20""moments_m20", 'moments_m20_points'"moments_m20_points""moments_m20_points""moments_m20_points""moments_m20_points""moments_m20_points", 'orientation'"orientation""orientation""orientation""orientation""orientation", 'orientation_points'"orientation_points""orientation_points""orientation_points""orientation_points""orientation_points", 'outer_radius'"outer_radius""outer_radius""outer_radius""outer_radius""outer_radius", 'phi'"phi""phi""phi""phi""phi", 'phi_points'"phi_points""phi_points""phi_points""phi_points""phi_points", 'ra'"ra""ra""ra""ra""ra", 'ra_points'"ra_points""ra_points""ra_points""ra_points""ra_points", 'rb'"rb""rb""rb""rb""rb", 'rb_points'"rb_points""rb_points""rb_points""rb_points""rb_points", 'rect2_len1'"rect2_len1""rect2_len1""rect2_len1""rect2_len1""rect2_len1", 'rect2_len2'"rect2_len2""rect2_len2""rect2_len2""rect2_len2""rect2_len2", 'rect2_phi'"rect2_phi""rect2_phi""rect2_phi""rect2_phi""rect2_phi", 'row'"row""row""row""row""row", 'row1'"row1""row1""row1""row1""row1", 'row2'"row2""row2""row2""row2""row2", 'row_points'"row_points""row_points""row_points""row_points""row_points", 'struct_factor'"struct_factor""struct_factor""struct_factor""struct_factor""struct_factor", 'width'"width""width""width""width""width"
Operation type between the individual 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) real(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*) (double / Hlong / BSTR) (double / Hlong / char*)
Lower limits of the features or 'min'.
Default value: 150.0
Typical range of values: 0.0
≤
Min
Min
Min
Min
Min
min
≤
99999.0
Minimum increment: 0.001
Recommended increment: 1.0
MaxMaxMaxMaxMaxmax (input_control) real(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*) (double / Hlong / BSTR) (double / Hlong / char*)
Upper limits of the features or 'max'.
Default value: 99999.0
Typical range of values: 0.0
≤
Max
Max
Max
Max
Max
max
≤
99999.0
Minimum increment: 0.001
Recommended increment: 1.0
Restriction: Max >= Min
The operator select_shape_xldselect_shape_xldSelectShapeXldselect_shape_xldSelectShapeXldSelectShapeXld returns the value 2 (H_MSG_TRUE) if the
input is not empty. The behavior in case of empty input (no input
objects available) is set via the operator
set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an
exception is raised.
gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXld,
edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix,
threshold_sub_pixthreshold_sub_pixThresholdSubPixthreshold_sub_pixThresholdSubPixThresholdSubPix,
gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXld,
test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld
shape_trans_xldshape_trans_xldShapeTransXldshape_trans_xldShapeTransXldShapeTransXld,
count_objcount_objCountObjcount_objCountObjCountObj
area_center_xldarea_center_xldAreaCenterXldarea_center_xldAreaCenterXldAreaCenterXld,
area_center_points_xldarea_center_points_xldAreaCenterPointsXldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld,
circularity_xldcircularity_xldCircularityXldcircularity_xldCircularityXldCircularityXld,
compactness_xldcompactness_xldCompactnessXldcompactness_xldCompactnessXldCompactnessXld,
convexity_xldconvexity_xldConvexityXldconvexity_xldConvexityXldConvexityXld,
elliptic_axis_xldelliptic_axis_xldEllipticAxisXldelliptic_axis_xldEllipticAxisXldEllipticAxisXld,
elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld,
eccentricity_xldeccentricity_xldEccentricityXldeccentricity_xldEccentricityXldEccentricityXld,
eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXld,
smallest_circle_xldsmallest_circle_xldSmallestCircleXldsmallest_circle_xldSmallestCircleXldSmallestCircleXld,
smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld,
smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2Xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld,
diameter_xlddiameter_xldDiameterXlddiameter_xldDiameterXldDiameterXld,
orientation_xldorientation_xldOrientationXldorientation_xldOrientationXldOrientationXld,
orientation_points_xldorientation_points_xldOrientationPointsXldorientation_points_xldOrientationPointsXldOrientationPointsXld,
moments_xldmoments_xldMomentsXldmoments_xldMomentsXldMomentsXld,
moments_points_xldmoments_points_xldMomentsPointsXldmoments_points_xldMomentsPointsXldMomentsPointsXld,
select_objselect_objSelectObjselect_objSelectObjSelectObj
Foundation