query_colorT_query_colorquery_colorQueryColorQueryColor (Operator)

Name

query_colorT_query_colorquery_colorQueryColorQueryColor — Query all color names displayable in the window.

Signature

Description

query_colorquery_colorquery_colorQueryColorQueryColor returns the names of all colors that are usable for region output (disp_regiondisp_regiondisp_regionDispRegionDispRegion, disp_polygondisp_polygondisp_polygonDispPolygonDispPolygon, disp_circledisp_circledisp_circleDispCircleDispCircle, etc.). On a b/w screen query_colorquery_colorquery_colorQueryColorQueryColor returns 'black' and 'white'. These two “colors” are displayable on any screen. In addition to 'black' and 'white' several gray values (e.g. 'dim gray') are returned on screens capable of gray values. A list of all displayable colors is returned for screens with color lookup table. The returned tuple of colors begins with b/w, followed by the three primaries ('red','green','blue') and several gray values. Before opening the first window it is furthermore possible to define the color list with set_system(::'graphic_colors',...:)set_system("graphic_colors",...)set_system("graphic_colors",...)SetSystem("graphic_colors",...)SetSystem("graphic_colors",...). query_all_colors(::WindowHandle:Colors )query_all_colors(WindowHandle,Colors )query_all_colors(WindowHandle,Colors )QueryAllColors(WindowHandle,Colors )QueryAllColors(WindowHandle,Colors ) returns a list of all available colors for the set_system(::'graphic_colors',...:)set_system("graphic_colors",...)set_system("graphic_colors",...)SetSystem("graphic_colors",...)SetSystem("graphic_colors",...) call. For screens with truecolor output the same list is returned by query_colorquery_colorquery_colorQueryColorQueryColor. The list of available colors (to HALCON ) must not be confused with the list of displayable colors. For screens with truecolor output the available colors are only a small subset of the displayable colors. Colors that are not directly available to HALCON can be chosen manually with set_rgbset_rgbset_rgbSetRgbSetRgb or set_hsiset_hsiset_hsiSetHsiSetHsi. If colors are chosen that are known to HALCON but cannot be displayed, HALCON can choose a similar color. To use this faeture, set_check(::'~color':) must be set.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
• Processed without parallelization.

Parameters

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

Htuple  Colors, WindowHandleTuple ;
open_window(0,0,-1,-1,0,"invisible","",&WindowHandle);
create_tuple(&WindowHandleTuple,1) ;
set_i(WindowHandleTuple, WindowHandle, 0) ;
T_query_color(WindowHandleTuple,&Colors);
close_window(WindowHandle);
for (i=0; i<length_tuple(Colors); i++)
  printf("Farbe #%s = %s\n",i,get_s(Colors,i));

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

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

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

Result

query_colorquery_colorquery_colorQueryColorQueryColor returns 2 (H_MSG_TRUE), if the window is valid. Otherwise an exception is raised.

Possible Successors

set_colorset_colorset_colorSetColorSetColor, disp_regiondisp_regiondisp_regionDispRegionDispRegion

See also

query_all_colorsquery_all_colorsquery_all_colorsQueryAllColorsQueryAllColors, set_colorset_colorset_colorSetColorSetColor, disp_regiondisp_regiondisp_regionDispRegionDispRegion, open_windowopen_windowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowopen_textwindowOpenTextwindowOpenTextwindow

Module

Foundation