query_colorT_query_colorQueryColorQueryColorquery_color (Operator)

Name

query_colorT_query_colorQueryColorQueryColorquery_color — Abfragen aller im Fenster darstellbaren Farbnamen.

Signatur

query_color( : : WindowHandle : Colors)

Beschreibung

query_colorquery_colorQueryColorQueryColorQueryColorquery_color gibt für das Ausgabefenster die Namen aller Farben aus, die bei der Darstellung von Regionen (disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region, disp_polygondisp_polygonDispPolygonDispPolygonDispPolygondisp_polygon, disp_circledisp_circleDispCircleDispCircleDispCircledisp_circle, etc.) verwendet werden können. Diese können mit dem Operator set_colorset_colorSetColorSetColorSetColorset_color gesetzt werden. Bei einem S/W-Bildschirm liefert query_colorquery_colorQueryColorQueryColorQueryColorquery_color 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 )query_all_colors(WindowHandle,Colors ). Genau diese Liste wird übrigens bei Bildschirmen mit Echtfarbenausgabe auch von query_colorquery_colorQueryColorQueryColorQueryColorquery_color ausgegeben. Dies sind natürlich nicht alle Farben, die dargestellt werden können. Diese müssen dann mit set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb oder set_hsiset_hsiSetHsiSetHsiSetHsiset_hsi 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_checkSetCheckSetCheckSetCheckset_check 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

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → (handle)

Fenster-Handle.

ColorsColorsColorsColorscolorscolors (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_colorQueryColorQueryColorQueryColorquery_color liefert den Wert TRUE, falls das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt

Nachfolger

set_colorset_colorSetColorSetColorSetColorset_color, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

Siehe auch

query_all_colorsquery_all_colorsQueryAllColorsQueryAllColorsQueryAllColorsquery_all_colors, set_colorset_colorSetColorSetColorSetColorset_color, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region, open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window

Modul

Foundation

Operatoren