set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXld (Operator)

Name

set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldset_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_xldSetDrawingObjectXldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXld substitutes the XLD currently contained in the draw object by the new ContourContourContourContourContourcontour. The contour must contain at least two points, so that the interaction as described in create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXld is possible.

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

Parallelization

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

Parameters

ContourContourContourContourContourcontour (input_object) xld_cont → object

XLD contour.

DrawIDDrawIDDrawIDDrawIDDrawIDdrawID (input_control) drawing_object → (integer)

Handle of the drawing object.

Result

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

Possible Predecessors

create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXld

Possible Successors

attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow, clear_drawing_objectclear_drawing_objectClearDrawingObjectclear_drawing_objectClearDrawingObjectClearDrawingObject

Alternatives

create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXld

Module

Foundation

Operators