Skip to content

read_distance_transform_xldread_distance_transform_xldReadDistanceTransformXldReadDistanceTransformXldread_distance_transform_xldT_read_distance_transform_xld🔗

Short description🔗

read_distance_transform_xldread_distance_transform_xldReadDistanceTransformXldReadDistanceTransformXldread_distance_transform_xldT_read_distance_transform_xld — Read an XLD distance transform from a file.

Signature🔗

read_distance_transform_xld( filename.write FileName, out xld_dist_trans DistanceTransformID )read_distance_transform_xld( : : FileName : DistanceTransformID )void ReadDistanceTransformXld( const HTuple& FileName, HTuple* DistanceTransformID )static void HOperatorSet.ReadDistanceTransformXld( HTuple fileName, out HTuple distanceTransformID )def read_distance_transform_xld( file_name: str ) -> HHandle

Herror T_read_distance_transform_xld( const Htuple FileName, Htuple* DistanceTransformID )

void HXLDDistTrans::HXLDDistTrans( const HString& FileName )

void HXLDDistTrans::HXLDDistTrans( const char* FileName )

void HXLDDistTrans::HXLDDistTrans( const wchar_t* FileName ) (Windows only)

public HXLDDistTrans( string fileName )

void HXLDDistTrans::ReadDistanceTransformXld( const HString& FileName )

void HXLDDistTrans::ReadDistanceTransformXld( const char* FileName )

void HXLDDistTrans::ReadDistanceTransformXld( const wchar_t* FileName ) (Windows only)

void HXLDDistTrans.ReadDistanceTransformXld( string fileName )

Description🔗

read_distance_transform_xldReadDistanceTransformXld reads an XLD distance transform which previously has been stored with write_distance_transform_xldWriteDistanceTransformXld from the file given by FileNamefileNamefile_name and returns the handle DistanceTransformIDdistanceTransformIDdistance_transform_id. The default HALCON extension for the XLD distance transform is 'hdtc'.

get_distance_transform_xld_contourGetDistanceTransformXldContour can be used to get the reference contour that was used to build the XLD distance transform DistanceTransformIDdistanceTransformIDdistance_transform_id.

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.

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters🔗

FileNamefileNamefile_name (input_control) filename.write → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Name of the file.

File extension: .hdtc

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

Handle of the XLD distance transform.

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 successors

apply_distance_transform_xldApplyDistanceTransformXld, get_distance_transform_xld_contourGetDistanceTransformXldContour, get_distance_transform_xld_paramGetDistanceTransformXldParam

See also

write_distance_transform_xldWriteDistanceTransformXld, serialize_distance_transform_xldSerializeDistanceTransformXld, deserialize_distance_transform_xldDeserializeDistanceTransformXld, create_distance_transform_xldCreateDistanceTransformXld, set_distance_transform_xld_paramSetDistanceTransformXldParam, clear_distance_transform_xldClearDistanceTransformXld

Module🔗

Foundation