Operator Reference

HALCON Operator Reference / Graphics / Object
ClassesClasses | | Operators

attach_background_to_windowT_attach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindowattach_background_to_window (Operator)

attach_background_to_windowT_attach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindowattach_background_to_window — Attach a background image to a HALCON window.

Signature

attach_background_to_window(Image : : WindowHandle : )

Herror T_attach_background_to_window(const Hobject Image, const Htuple WindowHandle)

void AttachBackgroundToWindow(const HObject& Image, const HTuple& WindowHandle)

void HWindow::AttachBackgroundToWindow(const HImage& Image) const

static void HDrawingObject::AttachBackgroundToWindow(const HImage& Image, const HWindow& WindowHandle)

static void HOperatorSet.AttachBackgroundToWindow(HObject image, HTuple windowHandle)

void HWindow.AttachBackgroundToWindow(HImage image)

static void HDrawingObject.AttachBackgroundToWindow(HImage image, HWindow windowHandle)

def attach_background_to_window(image: HObject, window_handle: HHandle) -> None

Description

This operator attaches the background image passed in ImageImageImageimageimage to a HALCON window defined in WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle. The input image is copied. Thus it can be freed safely.

The background image is instantly displayed in the HALCON window when calling attach_background_to_windowattach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindowattach_background_to_window. All HALCON objects that were previously displayed in the window will still be displayed when calling this operator. Thus the previous window content will not be overwritten.

The window contents are displayed in the following order: first the background image, then HALCON objects, and finally the drawing objects. Thus, the drawing object is displayed always on top. Note that the window will be redrawn for each user interaction within the window and each call of set_partset_partSetPartSetPartset_part. HALCON objects can be deleted from the window with clear_windowclear_windowClearWindowClearWindowclear_window.

The background image can be removed from the window with the operator detach_background_from_windowdetach_background_from_windowDetachBackgroundFromWindowDetachBackgroundFromWindowdetach_background_from_window.

Attention

Note that using any synchronous operator which actively probe the event queue, e.g., get_mbuttonget_mbuttonGetMbuttonGetMbuttonget_mbutton or read_charread_charReadCharReadCharread_char, will conflict with the interaction with the drawing objects. In case the state of the cursor has to be read, please refer to the documentation of your framework of choice for an appropriate, non-invasive alternative.

Furthermore, the event based functionality should not be used together with the former blocking operators draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1draw_rectangle1, draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2draw_rectangle2, draw_regiondraw_regionDrawRegionDrawRegiondraw_region, draw_xlddraw_xldDrawXldDrawXlddraw_xld or draw_circledraw_circleDrawCircleDrawCircledraw_circle. They conflict with the event based functionality, since they actively fetch all events sent to the HALCON window.

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

ImageImageImageimageimage (input_object)  singlechannelimage → objectHImageHObjectHObjectHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Background image.

WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control)  window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

Result

If the window exists and the specified parameters are correct attach_background_to_windowattach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindowattach_background_to_window returns 2 ( H_MSG_TRUE) . If necessary an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowopen_window

Possible Successors

detach_background_from_windowdetach_background_from_windowDetachBackgroundFromWindowDetachBackgroundFromWindowdetach_background_from_window

Module

Foundation

ClassesClasses | | Operators