Operator Reference

HALCON Operator Reference / Tools / Geometry
ClassesClasses | | Operators

apply_distance_transform_xldT_apply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldapply_distance_transform_xld (Operator)

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

Signature

apply_distance_transform_xld(Contour : ContourOut : DistanceTransformID : )

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

void ApplyDistanceTransformXld(const HObject& Contour, HObject* ContourOut, const HTuple& DistanceTransformID)

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

static void HOperatorSet.ApplyDistanceTransformXld(HObject contour, out HObject contourOut, HTuple distanceTransformID)

HXLDCont HXLDDistTrans.ApplyDistanceTransformXld(HXLDCont contour)

def apply_distance_transform_xld(contour: HObject, distance_transform_id: HHandle) -> HObject

Description

The operator apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldapply_distance_transform_xld determines for each point in ContourContourContourcontourcontour the minimal distance to the reference contour using its XLD distance transform DistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformIDdistance_transform_id. The returned contour ContourOutContourOutContourOutcontourOutcontour_out consists of ContourContourContourcontourcontour with the attribute 'distance'"distance""distance""distance""distance" containing the calculated distances. They can be accessed by querying the attribute 'distance'"distance""distance""distance""distance" with get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld. See the operator reference of get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld for further information about contour attributes.

Note that the distances depend on the parameters of create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXldcreate_distance_transform_xld: 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""point_to_point""point_to_point""point_to_point" or 'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment". For further details please refer to the documentation of create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXldcreate_distance_transform_xld.

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

ContourContourContourcontourcontour (input_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject

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

ContourOutContourOutContourOutcontourOutcontour_out (output_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject *

Copy of ContourContourContourcontourcontour containing the distances as an attribute.

DistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformIDdistance_transform_id (input_control)  xld_dist_trans → HXLDDistTrans, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (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.

Possible Predecessors

create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXldcreate_distance_transform_xld, read_distance_transform_xldread_distance_transform_xldReadDistanceTransformXldReadDistanceTransformXldread_distance_transform_xld, deserialize_distance_transform_xlddeserialize_distance_transform_xldDeserializeDistanceTransformXldDeserializeDistanceTransformXlddeserialize_distance_transform_xld, set_distance_transform_xld_paramset_distance_transform_xld_paramSetDistanceTransformXldParamSetDistanceTransformXldParamset_distance_transform_xld_param

Possible Successors

get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld, segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXldsegment_contour_attrib_xld

Alternatives

distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXlddistance_contours_xld

See also

get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld, set_distance_transform_xld_paramset_distance_transform_xld_paramSetDistanceTransformXldParamSetDistanceTransformXldParamset_distance_transform_xld_param, write_distance_transform_xldwrite_distance_transform_xldWriteDistanceTransformXldWriteDistanceTransformXldwrite_distance_transform_xld, serialize_distance_transform_xldserialize_distance_transform_xldSerializeDistanceTransformXldSerializeDistanceTransformXldserialize_distance_transform_xld, clear_distance_transform_xldclear_distance_transform_xldClearDistanceTransformXldClearDistanceTransformXldclear_distance_transform_xld

Module

Foundation

ClassesClasses | | Operators