clear_surface_matching_resultclear_surface_matching_resultclear_surface_matching_resultClearSurfaceMatchingResultClearSurfaceMatchingResult (Operator)

Name

clear_surface_matching_resultclear_surface_matching_resultclear_surface_matching_resultClearSurfaceMatchingResultClearSurfaceMatchingResult — Free the memory of a surface matching result.

Signature

clear_surface_matching_result( : : SurfaceMatchingResultID : )

Description

The operator clear_surface_matching_resultclear_surface_matching_resultclear_surface_matching_resultClearSurfaceMatchingResultClearSurfaceMatchingResult frees the memory of a surface matching result that was created by find_surface_modelfind_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModel or refine_surface_model_poserefine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPose. After calling clear_surface_matching_resultclear_surface_matching_resultclear_surface_matching_resultClearSurfaceMatchingResultClearSurfaceMatchingResult, the result can no longer be used. The handle SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID becomes invalid.

Parallelization

Multithreading type: exclusive (runs in parallel only with independent operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID (input_control) surface_matching_result(-array) → (integer)

Handle of the surface matching result.

If the handle of the result is valid, the operator clear_surface_matching_resultclear_surface_matching_resultclear_surface_matching_resultClearSurfaceMatchingResultClearSurfaceMatchingResult returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

Alternatives

clear_all_surface_matching_resultsclear_all_surface_matching_resultsclear_all_surface_matching_resultsClearAllSurfaceMatchingResultsClearAllSurfaceMatchingResults

Module

3D Metrology

Table of Contents / 3D Matching / Surface-Based

Operators

HALCON Reference Manual 10.0.2