segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXld (Operator)

Name

segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXld — Segment XLD contour parts whose local attributes fulfill given conditions.

Signature

Description

segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXld segments the contour in ContourContourContourContourContourcontour into contour parts ContourPartContourPartContourPartContourPartContourPartcontourPart. The segmentation of the contour depends on the values of its attributes AttributeAttributeAttributeAttributeAttributeattribute (see the possible values for AttributeAttributeAttributeAttributeAttributeattribute below). The operator checks which attribute values lie within the given limits (MinMinMinMinMinmin, MaxMaxMaxMaxMaxmax) and returns the corresponding contour segments with its attributes in ContourPartContourPartContourPartContourPartContourPartcontourPart.

If OperationOperationOperationOperationOperationoperation is set to 'and', each of the given attributes must lie within the limits. If OperationOperationOperationOperationOperationoperation is set to 'or', at least one of the attributes has to be within the limits. The attributes are processed in the same order as they are given in AttributeAttributeAttributeAttributeAttributeattribute. If only one attribute is used, the value of OperationOperationOperationOperationOperationoperation is ignored. 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 limit, respectively, open.

Note that not all attributes are defined in all contours per default. Which attributes are defined for a contour depends on how the contour was instantiated, and whether some operations have been previously performed on it. For example, the attributes 'width_right' and 'width_left' are only defined, if the contour was created with the operator lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss. Likewise, the attribute 'distance' is only present if the distances to some other contour was previously calculated with distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld or apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld.

Condition:

Possible values for AttributeAttributeAttributeAttributeAttributeattribute:

'edge_direction':

Edge direction (see edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix for details)

'angle':

Angle of the direction perpendicular to the contour (see edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix or lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss for details)

'response':

Magnitude of the second derivative (see edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix or lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss for details)

'width_right':

Line width to the right of the line (see lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss for details)

'width_left':

Line width to the left of the line (see lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss for details)

'contrast':

Contrast of the line point (see lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss for details)

'asymmetry':

Asymmetry of the line point (see lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss for details)

'distance':

Minimal pointwise distance to a reference contour (see distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld or apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld for details)

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Example (HDevelop)

read_image (Image, 'fabrik')
edges_sub_pix (Image, Edges, 'canny', 1, 20, 40)
* select 'vertical' edges:
segment_contour_attrib_xld (Edges, ContourPart, 'edge_direction', \
                            'and', rad(90-20), rad(90+20))

Result

The operator segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXld 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.

Possible Predecessors

lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss, edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix, apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld, distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld

Possible Successors

fit_line_contour_xldfit_line_contour_xldFitLineContourXldfit_line_contour_xldFitLineContourXldFitLineContourXld, fit_ellipse_contour_xldfit_ellipse_contour_xldFitEllipseContourXldfit_ellipse_contour_xldFitEllipseContourXldFitEllipseContourXld, fit_circle_contour_xldfit_circle_contour_xldFitCircleContourXldfit_circle_contour_xldFitCircleContourXldFitCircleContourXld, fit_rectangle2_contour_xldfit_rectangle2_contour_xldFitRectangle2ContourXldfit_rectangle2_contour_xldFitRectangle2ContourXldFitRectangle2ContourXld

See also

split_contours_xldsplit_contours_xldSplitContoursXldsplit_contours_xldSplitContoursXldSplitContoursXld, get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXld, query_contour_attribs_xldquery_contour_attribs_xldQueryContourAttribsXldquery_contour_attribs_xldQueryContourAttribsXldQueryContourAttribsXld, get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldget_contour_attrib_xldGetContourAttribXldGetContourAttribXld

Module

Foundation