attach_background_to_window
— Setzen des Hintergrundbildes eines HALCON-Fensters.
attach_background_to_window(Image : : WindowHandle : )
attach_background_to_window
setzt das Hintergrundbild Image
des HALCON-Fensters WindowHandle
. Das Eingabebild wird kopiert,
so dass es sicher wieder gelöscht werden kann.
Das Hintergrundbild wird sofort im HALCON-Fenster angezeigt, wenn
attach_background_to_window
aufgerufen wird. Alle HALCON-Objekte,
die bisher in diesem Fenster angezeigt wurden, werden auch weiterhin
dargestellt. Somit wird der bisherige Fensterinhalt nicht überschrieben.
Der Fensterinhalt wird in der folgenden Reihenfolge dargestellt: Zuerst
das Hintergrundbild, dann HALCON-Objekte und anschließend die
Zeichenobjekte. Somit wird ein Zeichenobjekt immer an der obersten Ebene
dargestellt.
Das Fenster wird für jede Benutzerinteraktion innerhalb des Fensters
und jeden Aufruf von disp_obj
aktualisiert.
HALCON-Objekte können durch einen Aufruf von clear_window
entfernt werden.
Das Hintergrundbild kann mit dem Operator detach_background_from_window
wieder von dem Fenster entfernt werden.
Es sollte kein Operator, der auf die Event-Queue des HALCON-Fensters
zugreift, wie z.B. get_mbutton
oder read_char
,
verwendet werden, solange Zeichenobjekte ans Fenster anhgehängt sind.
Sie stehen im Gegensatz zu der Interaktion mit Zeichenobjekten, da sie
aktiv auf die Eventloop des Fensters zugreifen.
Außerdem sollte keiner der blockierenden Operatoren draw_rectangle1
,
draw_rectangle2
, draw_region
, draw_xld
oder
draw_circle
zusammen mit der Event-Funktionalität verwendet werden,
da sie die Interaktion mit Zeichenobjekten verhindern.
Image
(input_object) singlechannelimage →
object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
Hintergrundbild.
WindowHandle
(input_control) window →
(handle)
Fenster-Handle.
attach_background_to_window
liefert den Wert 2 (H_MSG_TRUE), falls das Fenster
gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt.
Foundation