Name
distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXld — Calculate the pointwise distance from one contour to another.
The operator distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXldDistanceContoursXld calculates for each point in
ContourFromContourFromContourFromContourFromcontourFrom the minimal distance to the contours in
ContourToContourToContourToContourTocontourTo.
The operator returns the contour ContourOutContourOutContourOutContourOutcontourOut which consists of
ContourFromContourFromContourFromContourFromcontourFrom containing the computed distances in the
attribute 'distance'"distance""distance""distance""distance".
The distances can be accessed by querying the attribute
'distance'"distance""distance""distance""distance" with the operator get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld.
The parameter
ModeModeModeModemode determines which distances are calculated for each point
in ContourFromContourFromContourFromContourFromcontourFrom:
'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point" calculates the minimal distance to the base
points of ContourToContourToContourToContourTocontourTo.
In contrast, 'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment" calculates the minimum
distance to the contour segments in ContourToContourToContourToContourTocontourTo (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"
suggests itself for an accurate result, whereas
'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 ContourFromContourFromContourFromContourFromcontourFrom, and n the number
of points in ContourToContourToContourToContourTocontourTo, then distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXldDistanceContoursXld
has complexity O(mlog(n)) for '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".
In case the template contour ContourToContourToContourToContourTocontourTo is repeatedly used, the
operators create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXldCreateDistanceTransformXld and
apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldApplyDistanceTransformXld can be used as an alternative to
distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXldDistanceContoursXld. For further details, please refer to
the documentation of create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXldCreateDistanceTransformXld.
- 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"
List of values: '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"
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_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld,
segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXldSegmentContourAttribXld
apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldApplyDistanceTransformXld,
distance_ccdistance_ccDistanceCcDistanceCcDistanceCc,
distance_cc_mindistance_cc_minDistanceCcMinDistanceCcMinDistanceCcMin
Foundation