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'"black""black""black""black""black" und 'white'"white""white""white""white""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'"dim gray""dim gray""dim gray""dim gray""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'"red""red""red""red""red", 'green'"green""green""green""green""green", 'blue'"blue""blue""blue""blue""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. Dazu muss jedoch (set_check(::'~color':)set_check("~color")SetCheck("~color")SetCheck("~color")SetCheck("~color")set_check("~color") ) gesetzt sein.

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 2 (H_MSG_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