open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow (Operator)

Name

open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow — Öffnen eines Textfensters.

Warnung

open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt. Neue Applikationen sollten stattdessen den Operator open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow verwenden.

Signatur

Beschreibung

open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow öffnet ein neues Textfenster, das zur Aus- und Eingabe von Text, sowie für die Ausgabe von Bildern verwendet werden kann. Unter Verwendung der logischen Fensternummer WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle können alle Ausgaben (write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString, read_stringread_stringReadStringread_stringReadStringReadString, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, etc.) auf dieses Fenster geleitet werden.

Textfenster besitzen neben dem Mauscursor auch einen Textcursor, der die aktuelle Schreibposition bezeichnet (genauer: die linke untere Ecke des auszugebenden Strings ohne Berücksichtigung der Unterlängen). Seine Position wird durch einen Unterstrich (oder eine andere Form) angezeigt (die Anzeige dieser Position kann aber auch ausgeschaltet sein (= Defaulteinstellung); vgl. set_tshapeset_tshapeSetTshapeset_tshapeSetTshapeSetTshape). Mit den Operatoren set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition und get_tpositionget_tpositionGetTpositionget_tpositionGetTpositionGetTposition kann die Position gesetzt bzw. abgefragt werden.

Beim Öffnen eines Textfensters wird die Cursorposition auf (H,0) gesetzt, wobei H die Höhe des Defaultfonts abzüglich der Unterlängen angibt. Der Cursor wird aber nicht angezeigt. Die Ausgabe beginnt also beim Schreiben in der linken oberen Ecke des Fensters.

Die Farben für den Hintergrund und den Bildrand können mit query_colorquery_colorQueryColorquery_colorQueryColorQueryColor abgefragt werden. Dies kann auch mit einem Fenster vom Typ 'invisible' durchgeführt werden. Das Clipping von Texten bei der Ausgabe (write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString) an den Fensterrändern kann mit set_check(::'~text':) eingeschaltet werden, d.h. es wird dann keine Fehlermeldung mehr erzeugt, falls der Text über den Rand des Fensters hinausragt.

Der Ursprung des Koordinatensystems des Fensters liegt in der linken oberen Ecke (Koordinaten: (0,0)). Nach unten nimmt der Zeilenindex zu (maximal: HeightHeightHeightHeightHeightheight-1), nach rechts steigt der Spaltenindex (maximal: WidthWidthWidthWidthWidthwidth-1) an.

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.

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_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow ü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 der Schrift (write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString, read_stringread_stringReadStringread_stringReadStringReadString) wird mit set_colorset_colorSetColorset_colorSetColorSetColor, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi oder set_grayset_graySetGrayset_graySetGraySetGray festgelegt. Mit set_insertset_insertSetInsertset_insertSetInsertSetInsert wird bestimmt, wie der Text (bzw. die Graphik) mit dem Inhalt des Bildwiederholspeichers verknüpft wird. Hierbei kann z.B. mit set_insertset_insertSetInsertset_insertSetInsertSetInsert(::'not':) erreicht werden, dass nach zweimaligem Schreiben des Textes an der gleichen Position die Schrift wieder beseitigt wird.

Normalerweise wird jede Ausgabe (z.B. mit write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, 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 eine 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 das Fenster von anderen Fenstern überlappt wird. Dies ist jedoch nicht in allen Fällen notwendig: Wenn man ein Textfenster z.B. als Vaterfenster für andere Fenster verwendet, 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.

Unterschied: Graphikfenster - Textfenster

• Im Gegensatz zu Graphikfenstern (open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow) können für Textfenster mehr Parameter (Farbe, Rand) beim Öffnen festgelegt werden.

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

• Die Ausgabe von Bildern, Regionen und Graphiken wird bei Textfenstern an den Rändern „geclippt“, während bei Graphikfenstern „gezoomt“ wird.

• Das Koordinatensystem (z.B. bei get_mbuttonget_mbuttonGetMbuttonget_mbuttonGetMbuttonGetMbutton oder get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition) ist unabhängig von der Bildgröße immer in Bildschirmkoordinaten. Die maximalen Koordinaten entsprechen also der Größe des Fensters minus 1. Im Gegensatz dazu wird bei Graphikfenstern (open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow) immer ein Koordinatensystem verwendet, das dem Bildformat entspricht.

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

'visible':

Dies ist der normale Modus für Textfenster: 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, BorderWidthBorderWidthBorderWidthBorderWidthBorderWidthborderWidth, BorderColorBorderColorBorderColorBorderColorBorderColorborderColor, BackgroundColorBackgroundColorBackgroundColorBackgroundColorBackgroundColorbackgroundColor 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 und 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. Die Parameter BorderColorBorderColorBorderColorBorderColorBorderColorborderColor und BackgroundColorBackgroundColorBackgroundColorBackgroundColorBackgroundColorbackgroundColor sind hier ohne Bedeutung. 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 Graphik ist auf dem Bildschirm nicht sichtbar, wird jedoch im Speicher gepuffert. Die Parameter RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn, BorderWidthBorderWidthBorderWidthBorderWidthBorderWidthborderWidth, BorderColorBorderColorBorderColorBorderColorBorderColorborderColor, BackgroundColorBackgroundColorBackgroundColorBackgroundColorBackgroundColorbackgroundColor 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 Bildauschnitten 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 zum 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_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)

open_textwindow(0,0,900,600,1,"black","slate blue","root","visible",
                "",&WindowHandle1) ;
open_textwindow(10,10,300,580,3,"red","blue",Father,"visible",
                "",&WindowHandle2) ;
open_window(10,320,570,580,Father,"visible","",&WindowHandle) ;
set_color(WindowHandle,"red") ;
read_image(&Image,"monkey") ;
disp_image(Image,WindowHandle) ;
create_tuple(&String,1) ;
do {
  get_mposition(WindowHandle,&Row,&Column,&Button) ;
  get_grayval(Image,Row,Column,&Gray) ;
  sprintf(buf,"Position( %d,%d ) ",Row,Column) ;
  set_s(String,buf,0) ;
  T_fwrite_string(String) ;
  new_line(WindowHandle) ;
}
while(Button < 4) ;
close_window(WindowHandle) ;
clear_obj(Image) ;

open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)

open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)

open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)

open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow 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

Alternativen

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Siehe auch

write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString, read_stringread_stringReadStringread_stringReadStringReadString, new_linenew_lineNewLinenew_lineNewLineNewLine, get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents, get_tpositionget_tpositionGetTpositionget_tpositionGetTpositionGetTposition, 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

Modul

Foundation