Name
distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld — Calculate the pointwise distance from one contour to another.
The operator distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld calculates for each point in
ContourFromContourFromContourFromContourFromContourFromcontourFrom the minimal distance to the contours in
ContourToContourToContourToContourToContourTocontourTo.
The operator returns the contour ContourOutContourOutContourOutContourOutContourOutcontourOut which consists of
ContourFromContourFromContourFromContourFromContourFromcontourFrom containing the computed distances in the
attribute 'distance'"distance""distance""distance""distance""distance".
The distances can be accessed by querying the attribute
'distance'"distance""distance""distance""distance""distance" with the operator get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldget_contour_attrib_xldGetContourAttribXldGetContourAttribXld.
The parameter
ModeModeModeModeModemode determines which distances are calculated for each point
in ContourFromContourFromContourFromContourFromContourFromcontourFrom:
'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point""point_to_point" calculates the minimal distance to the base
points of ContourToContourToContourToContourToContourTocontourTo.
In contrast, 'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment""point_to_segment" calculates the minimum
distance to the contour segments in ContourToContourToContourToContourToContourTocontourTo (see the figure
below).
Note that in many applications the mode 'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment""point_to_segment"
suggests itself for an accurate result, whereas
'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point""point_to_point" is considerably faster.
If m is the number of points in ContourFromContourFromContourFromContourFromContourFromcontourFrom, and n the number
of points in ContourToContourToContourToContourToContourTocontourTo, then distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld
has complexity O(mlog(n)) for 'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point""point_to_point", and O(mn) for
'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment""point_to_segment".
In case the template contour ContourToContourToContourToContourToContourTocontourTo is repeatedly used, the
operators create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld and
apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld can be used as an alternative to
distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld. For further details, please refer to
the documentation of create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Contours for whose points the distances are
calculated.
Contours to which the distances are
calculated to.
Compute the distance to points ('point_to_point')
or to entire segments ('point_to_segment').
Default value:
'point_to_point'
"point_to_point"
"point_to_point"
"point_to_point"
"point_to_point"
"point_to_point"
List of values: 'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point""point_to_point", 'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment""point_to_segment"
If all parameters are correct, the operator returns the
value 2 (H_MSG_TRUE). Otherwise, an exception is raised.
get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldget_contour_attrib_xldGetContourAttribXldGetContourAttribXld,
segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXld
apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld,
distance_ccdistance_ccDistanceCcdistance_ccDistanceCcDistanceCc,
distance_cc_mindistance_cc_minDistanceCcMindistance_cc_minDistanceCcMinDistanceCcMin
Foundation