set_drawing_object_xldT_set_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXld (Operator)

Name

set_drawing_object_xldT_set_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXld — Set the contour of an interactive draw XLD.

Signature

set_drawing_object_xld(Contour : : DrawID : )

Description

set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXldSetDrawingObjectXld substitutes the XLD currently contained in the draw object by the new ContourContourContourContourcontour. The contour must contain at least two points, so that the interaction as described in create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXld is possible.

In addition, if the drawing object DrawIDDrawIDDrawIDDrawIDdrawID is currently attached to a HALCON window, the window will be redrawn with each call of set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXldSetDrawingObjectXld.

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 → object

XLD contour.

DrawIDDrawIDDrawIDDrawIDdrawID (input_control) drawing_object → (handle)

Handle of the drawing object.

Result

set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXldSetDrawingObjectXld returns 2 (H_MSG_TRUE), if the DrawIDDrawIDDrawIDDrawIDdrawID is valid and ContourContourContourContourcontour is a contour consisting of at least two points. If necessary, an exception is raised.