query_colorT_query_colorQueryColorQueryColor (Operator)

Name

query_colorT_query_colorQueryColorQueryColor — Abfragen aller im Fenster darstellbaren Farbnamen.

Signatur

query_color( : : WindowHandle : Colors)

Beschreibung

query_colorquery_colorQueryColorQueryColorQueryColor gibt für das Ausgabefenster die Namen aller Farben aus, die bei der Darstellung von Regionen (disp_regiondisp_regionDispRegionDispRegionDispRegion, disp_polygondisp_polygonDispPolygonDispPolygonDispPolygon, disp_circledisp_circleDispCircleDispCircleDispCircle, etc.) verwendet werden können. Diese können mit dem Operator set_colorset_colorSetColorSetColorSetColor gesetzt werden. Bei einem S/W-Bildschirm liefert query_colorquery_colorQueryColorQueryColorQueryColor die Werte 'black' und 'white'. Diese beiden „Farben“ stehen bei jedem Bildschirm zur Verfügung. Bei Bildschirmen mit Graustufen werden auch einige Grautöne angegeben (z.B.: 'dim gray'). Bei Bildschirmen mit Farbtabellen wird eine Liste von darstellbaren Farben zurückgeliefert. Per Default beginnt das Tupel der Farben dabei mit S/W, gefolgt von den drei Grundfarben ('red','green','blue') und einigen Grautönen. Eine Liste aller dem System bekannten Farben erhält man dazu mit dem Aufruf query_all_colors(::WindowHandle:Colors )query_all_colors(WindowHandle,Colors )QueryAllColors(WindowHandle,Colors )QueryAllColors(WindowHandle,Colors )QueryAllColors(WindowHandle,Colors ). Genau diese Liste wird übrigens bei Bildschirmen mit Echtfarbenausgabe auch von query_colorquery_colorQueryColorQueryColorQueryColor ausgegeben. Dies sind natürlich nicht alle Farben, die dargestellt werden können. Diese müssen dann mit set_rgbset_rgbSetRgbSetRgbSetRgb oder set_hsiset_hsiSetHsiSetHsiSetHsi direkt gewählt werden. Werden Farbnamen verwendet, die HALCON zwar bekannt sind, aber auf dem Rechner nicht darstellbar sind, dann wählt HALCON eine ähnliche Farbe aus (und erzeugt keine Fehlermeldung), falls set_checkset_checkSetCheckSetCheckSetCheck mit dem Parameter 'color' aufgerufen wird.

Ausführungsinformationen

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

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → (handle)

Fenster-Handle.

ColorsColorsColorsColorscolors (output_control) string-array → (string)

Namen der Farben.

Beispiel (HDevelop)

open_window(0,0,-1,-1,'root','invisible','',WindowHandle)
query_color(WindowHandle,Colors)
close_window(WindowHandle)
fwrite_string (FileHandle, ['Displayable colors: ',Colors])

Ergebnis

query_colorquery_colorQueryColorQueryColorQueryColor liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt

Nachfolger

set_colorset_colorSetColorSetColorSetColor, disp_regiondisp_regionDispRegionDispRegionDispRegion

Siehe auch

query_all_colorsquery_all_colorsQueryAllColorsQueryAllColorsQueryAllColors, set_colorset_colorSetColorSetColorSetColor, disp_regiondisp_regionDispRegionDispRegionDispRegion, open_windowopen_windowOpenWindowOpenWindowOpenWindow

Modul

Foundation

Operatoren