Skip to content

apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldapply_distance_transform_xldT_apply_distance_transform_xld🔗

Short description🔗

apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldapply_distance_transform_xldT_apply_distance_transform_xld — Determine the pointwise distance of two contours using an XLD distance transform.

Signature🔗

apply_distance_transform_xld( xld_cont Contour, out xld_cont ContourOut, xld_dist_trans DistanceTransformID )apply_distance_transform_xld( Contour : ContourOut : DistanceTransformID : )void ApplyDistanceTransformXld( const HObject& Contour, HObject* ContourOut, const HTuple& DistanceTransformID )static void HOperatorSet.ApplyDistanceTransformXld( HObject contour, out HObject contourOut, HTuple distanceTransformID )def apply_distance_transform_xld( contour: HObject, distance_transform_id: HHandle ) -> HObject

Herror T_apply_distance_transform_xld( const Hobject Contour, Hobject* ContourOut, const Htuple DistanceTransformID )

HXLDCont HXLDDistTrans::ApplyDistanceTransformXld( const HXLDCont& Contour ) const

HXLDCont HXLDDistTrans.ApplyDistanceTransformXld( HXLDCont contour )

Description🔗

The operator apply_distance_transform_xldApplyDistanceTransformXld determines for each point in Contourcontourcontour the minimal distance to the reference contour using its XLD distance transform DistanceTransformIDdistanceTransformIDdistance_transform_id. The returned contour ContourOutcontourOutcontour_out consists of Contourcontourcontour with the attribute 'distance'"distance" containing the calculated distances. They can be accessed by querying the attribute 'distance'"distance" with get_contour_attrib_xldGetContourAttribXld. See the operator reference of get_contour_attrib_xldGetContourAttribXld for further information about contour attributes.

Note that the distances depend on the parameters of create_distance_transform_xldCreateDistanceTransformXld: The distances are clipped to the maximum distance specified by the parameter MaxDistance. The parameter Mode determines whether the distances are calculated 'point_to_point'"point_to_point" or 'point_to_segment'"point_to_segment". For further details please refer to the documentation of create_distance_transform_xldCreateDistanceTransformXld.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters🔗

Contourcontourcontour (input_object) xld_cont(-array) → objectobjectHObjectHXLDContHObjectHobject

Contour(s) for whose points the distances are calculated.

ContourOutcontourOutcontour_out (output_object) xld_cont(-array) → objectobjectHObjectHXLDContHObjectHobject *

Copy of Contourcontourcontour containing the distances as an attribute.

DistanceTransformIDdistanceTransformIDdistance_transform_id (input_control) xld_dist_trans → (handle)(handle)HTuple (HHandle)HXLDDistTrans, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the XLD distance transform of the reference contour.

Result🔗

If all parameters are correct, the operator returns the value 2 (H_MSG_TRUE). Otherwise, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

create_distance_transform_xldCreateDistanceTransformXld, read_distance_transform_xldReadDistanceTransformXld, deserialize_distance_transform_xldDeserializeDistanceTransformXld, set_distance_transform_xld_paramSetDistanceTransformXldParam

Possible successors

get_contour_attrib_xldGetContourAttribXld, segment_contour_attrib_xldSegmentContourAttribXld

Alternatives

distance_contours_xldDistanceContoursXld

See also

get_contour_attrib_xldGetContourAttribXld, set_distance_transform_xld_paramSetDistanceTransformXldParam, write_distance_transform_xldWriteDistanceTransformXld, serialize_distance_transform_xldSerializeDistanceTransformXld, clear_distance_transform_xldClearDistanceTransformXld

Module🔗

Foundation