set_colorset_colorSetColorset_colorSetColorSetColor (Operator)

Name

set_colorset_colorSetColorset_colorSetColorSetColor — Setzen der Ausgabefarbe(n).

Signatur

Beschreibung

set_colorset_colorSetColorset_colorSetColorSetColor setzt für das Ausgabefenster die Farbe(n), in der die Regionen dargestellt werden sollen. Ein Tupel aller verfügbaren Farben kann mit dem Operator query_colorquery_colorQueryColorquery_colorQueryColorQueryColor abgefragt werden. Darüberhinaus kann ColorColorColorColorColorcolor auch über ein RGB-Tripel in der Form '#rrggbb'"#rrggbb""#rrggbb""#rrggbb""#rrggbb""#rrggbb" gesetzt werden, wobei 'rr', 'gg' und 'bb' jeweils hexadezimale Zahlen zwischen '00' und 'ff' sind.

Die „Farben“ 'black' und 'white' sind für alle Bildschirme verfügbar. Werden Farben verwendet, die auf dem Bildschirm nicht darstellbar sind, so kann mit dem Aufruf von set_check(::'~color':) erreicht werden, dass HALCON eine Farbe für die Ausgabe verwendet, die der angegebenen möglichst ähnlich ist. Außerdem besteht die Möglichkeit, vor dem Öffnen des ersten Fensters mittels set_system(::'graphic_colors',...:)set_system("graphic_colors",...)SetSystem("graphic_colors",...)set_system("graphic_colors",...)SetSystem("graphic_colors",...)SetSystem("graphic_colors",...) die von HALCON zur Verfügung gestellten Graphikfarben selbst festzulegen. Wird eine einzige Farbe angegeben, dann erfolgen alle Ausgaben in dieser Farbe. Wird ein Tupel von Werten übergeben, dann erfolgt die Darstellung von Tupeln von Regionen und geometrischen Objekten modulo dieser Farben. Im Beispiel (s.u.) wird der erste Kreis in rot, der zweite in grün und der dritte wieder in rot ausgegeben. Bei jedem Aufruf einer Ausgabeprozedur wird mit der ersten Farbe begonnen. Es ist dabei zu beachten, dass es auf die Anzahl der Objekte ankommt, die bei einem Aufruf ausgegeben werden sollen: Wird immer nur ein Objekt pro Aufruf ausgegeben, dann erfolgt dies immer in der ersten Farbe. Dies gilt auch für Objekte, die aus mehreren Zusammenhangskomponenten bestehen.

Die gesetzte(n) Farbe(n) werden so lange verwendet, bis erneut set_colorset_colorSetColorset_colorSetColorSetColor,set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi oder set_grayset_graySetGrayset_graySetGraySetGray aufgerufen wird.

Verwendet wird dieser Darstellungsparameter bei Operatoren wie disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion,disp_linedisp_lineDispLinedisp_lineDispLineDispLine, disp_rectangle1disp_rectangle1DispRectangle1disp_rectangle1DispRectangle1DispRectangle1, disp_arrowdisp_arrowDispArrowdisp_arrowDispArrowDispArrow etc. Die Farbe wird aber auch bei der graphischen Darstellung von Grauwerten verwendet (z.B.: '3d_plot_lines','histogram', 'contourline', etc.; siehe hierzu set_paintset_paintSetPaintset_paintSetPaintSetPaint).

Parallelisierung

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

Parameter

set_color(WindowHandle,['red','green'])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

Htuple Colors, WindowHandleTuple ;
create_tuple(Colors,2) ;
set_s(Colors,"red",0) ;
set_s(Colors,"green",1) ;
create_tuple(&WindowHandleTuple,1) ;
set_i(WindowHandleTuple, WindowHandle,0) ;
T_set_color(WindowHandleTuple,Colors) ;
disp_circle(WindowHandle,(double)100.0,(double)200.0,(double)100.0) ;
disp_circle(WindowHandle,(double)200.0,(double)300.0,(double)100.0) ;
disp_circle(WindowHandle,(double)300.0,(double)100.0,(double)100.0) ;

set_color(WindowHandle,['red','green'])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

set_color(WindowHandle,['red','green'])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

set_color(WindowHandle,['red','green'])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

set_color(WindowHandle,['red','green'])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

Ergebnis

set_colorset_colorSetColorset_colorSetColorSetColor liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist und für dieses die angegebene Farbe(n) darstellbar sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

query_colorquery_colorQueryColorquery_colorQueryColorQueryColor

Nachfolger

disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion

Alternativen

set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi

Siehe auch

get_rgbget_rgbGetRgbget_rgbGetRgbGetRgb, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, set_fixset_fixSetFixset_fixSetFixSetFix, set_paintset_paintSetPaintset_paintSetPaintSetPaint

Modul

Foundation