distance_cc_mindistance_cc_minDistanceCcMinDistanceCcMindistance_cc_min (算子名称)
名称
distance_cc_mindistance_cc_minDistanceCcMinDistanceCcMindistance_cc_min — Calculate the minimum distance between two contours.
参数签名
描述
distance_cc_mindistance_cc_minDistanceCcMinDistanceCcMinDistanceCcMindistance_cc_min calculates the minimum distance between
two contours Contour1Contour1Contour1Contour1contour1contour_1 and Contour2Contour2Contour2Contour2contour2contour_2.
The minimum distance is returned in DistanceMinDistanceMinDistanceMinDistanceMindistanceMindistance_min.
The parameter ModeModeModeModemodemode sets the type of computing the distance.
'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point""point_to_point" determines the distance between the closest
contour points, 'fast_point_to_segment'"fast_point_to_segment""fast_point_to_segment""fast_point_to_segment""fast_point_to_segment""fast_point_to_segment" calculates the
distance between the line segments adjacent to these points, and
'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment""point_to_segment" determines the actual minimum
distance between the contour segments.
While 'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point""point_to_point" and 'fast_point_to_segment'"fast_point_to_segment""fast_point_to_segment""fast_point_to_segment""fast_point_to_segment""fast_point_to_segment"
are efficient algorithms with a complexity of n*log(n),
'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment""point_to_segment" has quadratic complexity and thus
takes a longer time to execute, especially for contours with many line
segments.
注意
Both iconic input parameters must contain the same number of contours.
运行信息
- 多线程类型:可重入(与非独占操作符并行运行)。
- 多线程作用域:全局(可以从任何线程调用)。
- Automatically parallelized on internal data level.
参数表
Contour1Contour1Contour1Contour1contour1contour_1 (input_object) xld_cont(-array) → objectHXLDContHObjectHXLDContHobject
First input contour.
Contour2Contour2Contour2Contour2contour2contour_2 (input_object) xld_cont(-array) → objectHXLDContHObjectHXLDContHobject
Second input contour.
ModeModeModeModemodemode (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Distance calculation mode.
Default:
'fast_point_to_segment'
"fast_point_to_segment"
"fast_point_to_segment"
"fast_point_to_segment"
"fast_point_to_segment"
"fast_point_to_segment"
List of values:
'fast_point_to_segment'"fast_point_to_segment""fast_point_to_segment""fast_point_to_segment""fast_point_to_segment""fast_point_to_segment", '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"
DistanceMinDistanceMinDistanceMinDistanceMindistanceMindistance_min (output_control) number(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Minimum distance between the two contours.
例程 (C)
gen_contour_polygon_rounded_xld(Cont1, [0,100,100,0,0], [0,0,100,100,0],
[50,50,50,50,50], 0.5);
gen_contour_polygon_rounded_xld(Cont2, [41,91,91,41,41], [41,41,91,91,41],
[25,25,25,25,25], 0.5);
distance_cc_min(Cont1, Cont2, "fast_point_to_segment", &distance_min);
结果
distance_cc_mindistance_cc_minDistanceCcMinDistanceCcMinDistanceCcMindistance_cc_min returns 2 (
H_MSG_TRUE)
.
可替代算子
distance_scdistance_scDistanceScDistanceScDistanceScdistance_sc,
distance_pcdistance_pcDistancePcDistancePcDistancePcdistance_pc,
distance_ccdistance_ccDistanceCcDistanceCcDistanceCcdistance_cc,
distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXldDistanceContoursXlddistance_contours_xld
参考其它
distance_srdistance_srDistanceSrDistanceSrDistanceSrdistance_sr,
distance_prdistance_prDistancePrDistancePrDistancePrdistance_pr
模块
Foundation