open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow (Operator)

Name

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow — Öffnen eines Graphikfensters.

Signatur

Beschreibung

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow öffnet ein neues Fenster, das zur Ausgabe von Grauwertdaten, Regionen, Graphik sowie für Textausgabe verwendet werden kann. Alle Ausgaben (disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_imagedisp_imageDispImagedisp_imageDispImageDispImage, etc.) werden auf dieses Fenster geleitet, wenn dieselbe logische Fensternummer WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle verwendet wird.

Der Hintergrund des erzeugten Fensters wird schwarz vorbesetzt und es hat einen weißen Rand von 2 Pixel Breite (siehe set_window_attr(::'border_width',<Breite>:)set_window_attr("border_width",<Breite>)SetWindowAttr("border_width",<Breite>)set_window_attr("border_width",<Breite>)SetWindowAttr("border_width",<Breite>)SetWindowAttr("border_width",<Breite>)).

Einem Fenster werden bestimmte Parameter für die Aufbereitung der auszugebenenden Daten zugeordnet, die bei der eigentlichen Ausgabe (z.B. mit disp_imagedisp_imageDispImagedisp_imageDispImageDispImage oder disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion) berücksichtigt werden. Diese Parameter werden aber nicht von der Ausgabeprozedur, sondern von „Konfigurationsprozeduren“ festgelegt. Will man z.B. die Farbe Rot für die Ausgabe von Regionen setzen, so muss vor dem Befehl disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion der Aufruf set_color(::WindowHandle,'red':)set_color(WindowHandle,"red")SetColor(WindowHandle,"red")set_color(WindowHandle,"red")SetColor(WindowHandle,"red")SetColor(WindowHandle,"red") erfolgen. Diese Parameter werden immer für das Fenster mit der logischen Fensternummer WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle gesetzt und bleiben dem Fenster solange zugeordnet, bis sie überschrieben werden. Es stehen u.a. folgende Konfigurationsprozeduren zur Verfügung:

• Grauwertausgabe: set_paintset_paintSetPaintset_paintSetPaintSetPaint, set_lutset_lutSetLutset_lutSetLutSetLut

• Regionen: set_colorset_colorSetColorset_colorSetColorSetColor, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi, set_grayset_graySetGrayset_graySetGraySetGray, set_shapeset_shapeSetShapeset_shapeSetShapeSetShape, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, set_insertset_insertSetInsertset_insertSetInsertSetInsert, set_line_styleset_line_styleSetLineStyleset_line_styleSetLineStyleSetLineStyle, set_drawset_drawSetDrawset_drawSetDrawSetDraw

• Bildausschnitt: set_partset_partSetPartset_partSetPartSetPart

• Text: set_fontset_fontSetFontset_fontSetFontSetFont

Die aktuell gesetzten Werte können mit Operatoren wie get_shapeget_shapeGetShapeget_shapeGetShapeGetShape abgefragt werden. Da einige Parameter durch die Hardware (Auflösung/Farben) bestimmt werden, kann man mit Operatoren wie query_colorquery_colorQueryColorquery_colorQueryColorQueryColor die aktuell verfügbaren Ressourcen abfragen.

Der Ursprung des Koordinatensystems des Fensters liegt in der linken oberen Ecke (Koordinaten: (0,0)). Nach unten nimmt der Zeilenindex zu (maximal: Bildhöhe - 1), nach rechts steigt der Spaltenindex (maximal: Bildbreite - 1) an. Es ist zu beachten, dass der Wertebereich des Koordinatensystems unabhängig von der Fenstergröße ist. Er wird nur durch das Bildformat (siehe reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb) festgelegt.

Der Parameter MachineMachineMachineMachineMachinemachine gibt den Namen des Rechners an, auf dem das Fenster geöffnet werden soll. Im Falle von X-Window wird bei TCP-IP nur der Name, bei DEC-Net wird noch ein Doppelpunkt hinter den Namen gesetzt. Der „Server“ bzw. der „Screen“ wird nicht mit angegeben. Übergibt man den leeren String, so wird die Environmentvariable DISPLAY zur Festlegung des Zielrechners verwendet. Hierbei wird der Name in der üblichen Syntax <Host>:0.0 angegeben.

Mit dem Parameter FatherWindowFatherWindowFatherWindowFatherWindowFatherWindowfatherWindow kann für die Fenstertypen 'WIN32-Window', 'X-Window' und 'Cocoa' das Vaterfenster für das zu öffnende Fenster angegeben werden. Ist die Kontrolle 'father' mittels set_checkset_checkSetCheckset_checkSetCheckSetCheck eingeschaltet, so muss FatherWindowFatherWindowFatherWindowFatherWindowFatherWindowfatherWindow ein HALCON-Fenster sein, andernfalls (set_check('~father')) kann es auch ein Betriebssystem-Fenster sein. Wird für FatherWindowFatherWindowFatherWindowFatherWindowFatherWindowfatherWindow der Wert 0 oder 'root' übergeben, so ist der Desktop (Windows) bzw. das Root-Fenster (unixartige Systeme) das Vaterfenster. In diesem Fall ist die Einstellung der Kontrolle 'father' mittels set_checkset_checkSetCheckset_checkSetCheckSetCheck nicht relevant. Der Aufrufer muss sicherstellen, dass FatherWindowFatherWindowFatherWindowFatherWindowFatherWindowfatherWindow ein gültiges Fensterhandle ist und dass dieses nicht zerstört wird, solange das eingebettete HALCON Fenster verwendet wird.

Für die Parameter WidthWidthWidthWidthWidthwidth und HeightHeightHeightHeightHeightheight kann der Wert „-1“ als Größe verwendet werden. Dies bedeutet, dass der entsprechende Wert automatisch bestimmt werden soll. Dies ist insbesondere dann von Bedeutung, wenn das Pixelverhältnis nicht gleich 1.0 ist (siehe set_systemset_systemSetSystemset_systemSetSystemSetSystem). Wird einer der beiden Parameter als „-1“ angegeben, so wird er durch die Größe bestimmt, die sich aus dem Pixelverhältnis ergibt. Werden beide Paramater mit „-1“ festgelegt, so werden sie auf das maximale Bildformat gesetzt (weitergehende Informationen zum maximalen Bildformat finden sich in der Beschreibung von get_systemget_systemGetSystemget_systemGetSystemGetSystem unter „width“ und „height“).

Die Position und Größe des Fensters kann sich im Laufe des Programms ändern. Dies kann zum einen mit set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents erfolgen, aber auch durch externe Eingriffe (Windowmanager) hervorgerufen werden. Für den zweiten Fall ist der Operator set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents vorgesehen.

Dem Fenster wird beim Öffnen ein sog. Defaultfont zugeordnet. Dieser wird für Operatoren wie write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString verwendet und kann mit set_fontset_fontSetFontset_fontSetFontSetFont nach dem Aufruf von open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow überschrieben werden. Es ist jedoch auch möglich, den Defaultfont mit dem Aufruf set_system(::'default_font',<Fontname>:)set_system("default_font",<Fontname>)SetSystem("default_font",<Fontname>)set_system("default_font",<Fontname>)SetSystem("default_font",<Fontname>)SetSystem("default_font",<Fontname>) vor dem Öffnen eines Fensters (und auch aller weiteren) festzulegen (siehe hierzu auch query_fontquery_fontQueryFontquery_fontQueryFontQueryFont).

Die Farbe für Graphik und Schrift, die für Ausgabeprozeduren wie disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion oder disp_circledisp_circleDispCircledisp_circleDispCircleDispCircle verwendet wird, wird mit set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi oder set_grayset_graySetGrayset_graySetGraySetGray festgelegt. Mit set_insertset_insertSetInsertset_insertSetInsertSetInsert wird eingestellt, wie die Graphik mit dem Inhalt des Bildwiederholspeichers verknüpft wird. Hierbei kann z.B. mit set_insert(::'not':)set_insert("not")SetInsert("not")set_insert("not")SetInsert("not")SetInsert("not") erreicht werden, dass nach zweimaligem Zeichnen eines Kreises an der gleichen Position dieser wieder beseitigt wird.

Normalerweise wird jede Ausgabe (z.B. disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_imagedisp_imageDispImagedisp_imageDispImageDispImage, disp_circledisp_circleDispCircledisp_circleDispCircleDispCircle, etc.) in ein Fenster durch einen sog. „Flush“ abgeschlossen. Dies bewirkt, dass die Daten nach Beendigung der Ausgabeprozedur auf dem Bildschirm vollständig sichtbar werden. Dies ist aber nicht in allen Fällen erforderlich, insbesondere dann, wenn ständig Ausgaben erfolgen, oder ein Maus-Prozedur aktiv ist. Hier ist es günstiger (d.h. schneller) wenn die Daten gepuffert werden, bis genügend Daten vorhanden sind. Dieses Verhalten kann durch den Aufruf von set_system(::'flush_graphic','false':)set_system("flush_graphic","false")SetSystem("flush_graphic","false")set_system("flush_graphic","false")SetSystem("flush_graphic","false")SetSystem("flush_graphic","false") eingestellt werden.

Der Inhalt von Fenstern wird (falls die Treibersoftware dies unterstützt) gesichert; d.h. er bleibt erhalten auch wenn es von anderen Fenstern überlappt wurde. Dies ist jedoch nicht in allen Fällen notwendig. Wenn der Inhalt eines Fensters ständig neu aufgebaut wird (copy_rectanglecopy_rectangleCopyRectanglecopy_rectangleCopyRectangleCopyRectangle), so kann für dieses der Sicherungsmechanismus abgestellt und damit der hierfür nötige Speicher eingespart werden. Dies geschieht mit dem Aufruf von set_system(::'backing_store','false':)set_system("backing_store","false")SetSystem("backing_store","false")set_system("backing_store","false")SetSystem("backing_store","false")SetSystem("backing_store","false") vor dem Öffnen des Fensters. Durch dieses Vorgehen wird nicht nur Speicher, sondern auch Rechenzeit gespart, was beispielsweise für die Ausgabe von Videoclips von Bedeutung ist (siehe copy_rectanglecopy_rectangleCopyRectanglecopy_rectangleCopyRectangleCopyRectangle).

Für die Ausgabe von Graphik (disp_imagedisp_imageDispImagedisp_imageDispImageDispImage,disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, etc.) kann mit dem Operator set_partset_partSetPartset_partSetPartSetPart das Fenster so eingestellt werden, dass es einen logischen Ausschnitt des Bildformates darstellt. Dies hat insbesondere zur Folge, dass von Bildern und Regionen lediglich dieser Ausschnitt (entsprechend vergrößert) ausgegeben wird.

Unterschied: Graphikfenster - Textfenster

• Bei Graphikfenstern ist das Layout nicht so variabel handhabbar wie bei Textfenstern.

• Nur Textfenster können zum Einlesen von Benutzerdaten verwendet werden (read_stringread_stringReadStringread_stringReadStringReadString).

• Bei der Ausgabe von Bildern, Regionen und Graphiken wird bei Graphikfenstern „gezoomt“: Unabhängig von Größe und Seitenverhältnis des Fensters werden die Bilder so transformiert, dass sie füllend in dem Fenster ausgegeben werden. Bei Textfenstern dagegen wird die Größe des Fensters bei der Ausgabe nicht beachtet (nur falls Clipping nötig ist).

• Bei Graphikfenstern ist das Koordinatensystem des Fensters immer gleich dem Koordinatensystem des Bildformates, während bei Textfenstern das Koordinatensystem unabhängig von der Bildgröße immer den Bildschirmkoordinaten entspricht.

Der Parameter ModeModeModeModeModemode legt den Modus des Fensters fest. Dieser kann folgende Werte annehmen:

'visible':

Dies ist der normale Modus für Graphikfenster: Das Fenster wird entsprechend den Parametern erzeugt und alle Ein- und Ausgaben sind möglich.

'invisible':

Unsichtbare Fenster werden nicht auf dem Bildschirm dargestellt. Die Parameter RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn und FatherWindowFatherWindowFatherWindowFatherWindowFatherWindowfatherWindow sind ohne Bedeutung. Ausgaben auf diese Fenster haben keine Wirkung. Eingaben (read_stringread_stringReadStringread_stringReadStringReadString, Maus, etc.) sind nicht möglich. Diese Fenster werden verwendet, wenn man Darstellungsparameter für ein Ausgabegerät abfragen möchte, ohne ein (sichtbares) Fenster zu öffnen. Übliche Anfragen sind z.B. query_colorquery_colorQueryColorquery_colorQueryColorQueryColor oder get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents.

'transparent':

Diese Fenster sind durchsichtig: Das Fenster selbst ist nicht sichtbar (Rand und Hintergrund), jedoch sind alle sonstigen Operationen möglich und alle Ausgaben werden dargestellt. Eine übliche Verwendung für diesen Modus ist die Erzeugung von Maus-sensitiven Bereichen.

'buffer':

Dies sind ebenfalls nicht sichtbare Fenster. Die Ausgabe von Bildern, Regionen und Graphiken ist auf dem Bildschirm nicht sichtbar, wird jedoch im Speicher gepuffert. Die Parameter RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn und FatherWindowFatherWindowFatherWindowFatherWindowFatherWindowfatherWindow sind ohne Bedeutung. Puffer-Fenster verwendet man beispielsweise, wenn man Ausgaben (im Hintergrund) vorbereitet und schließlich mit copy_rectanglecopy_rectangleCopyRectanglecopy_rectangleCopyRectangleCopyRectangle in ein sichtbares Fenster kopiert. Eine andere Anwendung wäre die schnelle Verarbeitung von Bildausschnitten bei interaktiven Manipulationen. Texteingaben und Mausinteraktion ist mit dem Modus 'buffer' nicht möglich.

Achtung

Es ist zu beachten, dass die Parameter RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn, WidthWidthWidthWidthWidthwidth und HeightHeightHeightHeightHeightheight durch das Ausgabegerät beschränkt sind. Wird ein Vaterfenster (FatherWindowFatherWindowFatherWindowFatherWindowFatherWindowfatherWindow < > 'root') angegeben, dann sind die Koordinaten relativ zu diesem Fenster.

Parallelisierung

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

open_window(0,0,400,-1,'root','visible','',WindowHandle)
read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
write_string(WindowHandle,'File, fabrik')
new_line(WindowHandle)
get_mbutton(WindowHandle,_,_,_)
set_lut(WindowHandle,'temperature')
set_color(WindowHandle,'blue')
write_string(WindowHandle,'temperature')
new_line(WindowHandle)
write_string(WindowHandle,'Draw Rectangle')
new_line(WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
new_line(WindowHandle)

open_window(0,0,400,-1,"root","visible","",&WindowHandle) ;
read_image(&Image,"fabrik") ;
disp_image(Image,WindowHandle) ;
write_string(WindowHandle,"File: fabrik") ;
new_line(WindowHandle) ;
get_mbutton(WindowHandle,NULL,NULL,NULL) ;
set_lut(WindowHandle,"temperature") ;
set_color(WindowHandle,"blue") ;
write_string(WindowHandle,"temperature") ;
new_line(WindowHandle) ;
write_string(WindowHandle,"Draw Rectangle") ;
new_line(WindowHandle) ;
draw_rectangle1(WindowHandle,&Row1,&Column1,&Row2,&Column2) ;
set_part(Row1,Column1,Row2,Column2) ;
disp_image(Image,WindowHandle) ;
new_line(WindowHandle) ;

open_window(0,0,400,-1,'root','visible','',WindowHandle)
read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
write_string(WindowHandle,'File, fabrik')
new_line(WindowHandle)
get_mbutton(WindowHandle,_,_,_)
set_lut(WindowHandle,'temperature')
set_color(WindowHandle,'blue')
write_string(WindowHandle,'temperature')
new_line(WindowHandle)
write_string(WindowHandle,'Draw Rectangle')
new_line(WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
new_line(WindowHandle)

open_window(0,0,400,-1,'root','visible','',WindowHandle)
read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
write_string(WindowHandle,'File, fabrik')
new_line(WindowHandle)
get_mbutton(WindowHandle,_,_,_)
set_lut(WindowHandle,'temperature')
set_color(WindowHandle,'blue')
write_string(WindowHandle,'temperature')
new_line(WindowHandle)
write_string(WindowHandle,'Draw Rectangle')
new_line(WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
new_line(WindowHandle)

open_window(0,0,400,-1,'root','visible','',WindowHandle)
read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
write_string(WindowHandle,'File, fabrik')
new_line(WindowHandle)
get_mbutton(WindowHandle,_,_,_)
set_lut(WindowHandle,'temperature')
set_color(WindowHandle,'blue')
write_string(WindowHandle,'temperature')
new_line(WindowHandle)
write_string(WindowHandle,'Draw Rectangle')
new_line(WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
new_line(WindowHandle)

open_window(0,0,400,-1,'root','visible','',WindowHandle)
read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
write_string(WindowHandle,'File, fabrik')
new_line(WindowHandle)
get_mbutton(WindowHandle,_,_,_)
set_lut(WindowHandle,'temperature')
set_color(WindowHandle,'blue')
write_string(WindowHandle,'temperature')
new_line(WindowHandle)
write_string(WindowHandle,'Draw Rectangle')
new_line(WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
new_line(WindowHandle)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb

Nachfolger

set_colorset_colorSetColorset_colorSetColorSetColor, query_window_typequery_window_typeQueryWindowTypequery_window_typeQueryWindowTypeQueryWindowType, get_window_typeget_window_typeGetWindowTypeget_window_typeGetWindowTypeGetWindowType, set_window_typeset_window_typeSetWindowTypeset_window_typeSetWindowTypeSetWindowType, get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition, set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, set_tshapeset_tshapeSetTshapeset_tshapeSetTshapeSetTshape, set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents, get_window_extentsget_window_extentsGetWindowExtentsget_window_extentsGetWindowExtentsGetWindowExtents, query_colorquery_colorQueryColorquery_colorQueryColorQueryColor, set_checkset_checkSetCheckset_checkSetCheckSetCheck, set_systemset_systemSetSystemset_systemSetSystemSetSystem

Siehe auch

disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_imagedisp_imageDispImagedisp_imageDispImageDispImage, disp_colordisp_colorDispColordisp_colorDispColorDispColor, set_lutset_lutSetLutset_lutSetLutSetLut, query_colorquery_colorQueryColorquery_colorQueryColorQueryColor, set_colorset_colorSetColorset_colorSetColorSetColor, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi, set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel, set_grayset_graySetGrayset_graySetGraySetGray, set_partset_partSetPartset_partSetPartSetPart, set_part_styleset_part_styleSetPartStyleset_part_styleSetPartStyleSetPartStyle, query_window_typequery_window_typeQueryWindowTypequery_window_typeQueryWindowTypeQueryWindowType, get_window_typeget_window_typeGetWindowTypeget_window_typeGetWindowTypeGetWindowType, set_window_typeset_window_typeSetWindowTypeset_window_typeSetWindowTypeSetWindowType, get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition, set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents, get_window_extentsget_window_extentsGetWindowExtentsget_window_extentsGetWindowExtentsGetWindowExtents, set_window_attrset_window_attrSetWindowAttrset_window_attrSetWindowAttrSetWindowAttr, set_checkset_checkSetCheckset_checkSetCheckSetCheck, set_systemset_systemSetSystemset_systemSetSystemSetSystem

Modul

Foundation