set_grayset_graySetGrayset_graySetGraySetGray (Operator)

Name

set_grayset_graySetGrayset_graySetGraySetGray — Setzen eines Grauwertes für die Regionenausgabe.

Signatur

Beschreibung

set_grayset_graySetGrayset_graySetGraySetGray gibt an, dass Regionen in bestimmten Grauwerten (GrayValuesGrayValuesGrayValuesGrayValuesGrayValuesgrayValues) dargestellt werden sollen. Unter einem Grauwert wird hier der Bereich der Farbtabelle verstanden, der für die Darstellung von Grauwertdaten (disp_imagedisp_imageDispImagedisp_imageDispImageDispImage mit set_paint(::WindowHandle,'gray':)set_paint(WindowHandle,"gray")SetPaint(WindowHandle,"gray")set_paint(WindowHandle,"gray")SetPaint(WindowHandle,"gray")SetPaint(WindowHandle,"gray")) verwendet wird. Hierbei handelt es sich um die Einträge der Farbtabelle, die von set_lutset_lutSetLutset_lutSetLutSetLut modifiziert werden. Unter einem „Grauwert“ ist die Farbe zu verstehen, in der ein Bildpunkt mit dem gleichen Wert dargestellt wird (was nicht notwendigerweise ein Grauton ist). Weiterhin ist zu beachten, dass sich die Farbe der Grafik, deren Aussehen mit set_grayset_graySetGrayset_graySetGraySetGray festgelegt wurde, beim Laden einer neuen Farbtabelle i.A. ändern wird.

Wird ein Grauton als Grafikfarbe benötigt (d.h. keine Farbänderung durch set_lutset_lutSetLutset_lutSetLutSetLut), so kann dieser z.B. mit set_color(::WindowHandle,'gray':)set_color(WindowHandle,"gray")SetColor(WindowHandle,"gray")set_color(WindowHandle,"gray")SetColor(WindowHandle,"gray")SetColor(WindowHandle,"gray") gesetzt werden.

Wird ein einziger Grauwert angegeben, dann erfolgen alle Ausgaben in diesem Grauwert. Wird ein Tupel von Werten übergeben, dann erfolgt die Darstellung der Tupel von Regionen und geometrischen Objekten modulo dieser Grauwerte. Der erste Kreis im Beispiel (s.u.) wird in dem Grauwert 100, der zweite in dem Grauwert 200 und der dritte wieder in dem Grauwert 100 ausgegeben. Bei jedem Aufruf einer Ausgabeprozedur wird mit dem ersten Grauwert 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 dem ersten Grauwert. Dies gilt auch für Objekte, die aus mehreren Zusammenhangskomponenten bestehen.

Der Aufruf des Operators (set_grayset_graySetGrayset_graySetGraySetGray, set_colorset_colorSetColorset_colorSetColorSetColor, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi) überschreibt die Werte, die vorher gesetzt wurden. Je nach Geräteeigenschaft können nicht alle Grauwerte dargestellt werden. Der Wertebereich des Parameters GrayValuesGrayValuesGrayValuesGrayValuesGrayValuesgrayValues (0..255) wird entsprechend auf die darstellbaren Graustufen abgebildet. In jedem Fall wird der Grauwert 0 als schwarz und der Grauwert 255 als weiß dargestellt. Mit dem Operator query_grayquery_grayQueryGrayquery_grayQueryGrayQueryGray können die darstellbaren Grauwerte abgefragt werden. Außerdem besteht die Möglichkeit, vor dem Öffnen des ersten Fensters auf der Ausgabemaschine mittels set_system(::'num_gray_*',...:)set_system("num_gray_*",...)SetSystem("num_gray_*",...)set_system("num_gray_*",...)SetSystem("num_gray_*",...)SetSystem("num_gray_*",...) die Zahl der tatsächlich dargestellten Graustufen zu verändern. Mit dem Aufruf: set_check(::'~color':) wird HALCON aufgefordert keine Fehlermeldung zu erzeugen, falls eine Grauwert verwendet wurde, der auf dem Bildschirm nicht darstellbar ist, sondern eine Näherung für diesen Wert zu suchen.

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_gray(WindowHandle,[100,200])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

Htuple GrayValues ;
create_tuple(&GrayValues,2) ;
set_i(GrayValues,100,0) ;
set_i(GrayValues,200,0) ;
T_set_gray(WindowHandle,GrayValues) ;
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_gray(WindowHandle,[100,200])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

set_gray(WindowHandle,[100,200])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

set_gray(WindowHandle,[100,200])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

set_gray(WindowHandle,[100,200])
disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])

Ergebnis

set_grayset_graySetGrayset_graySetGraySetGray liefert den Wert 2 (H_MSG_TRUE), falls der angegebene Grauwert darstellbar und das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Nachfolger

disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion

Siehe auch

get_pixelget_pixelGetPixelget_pixelGetPixelGetPixel, set_colorset_colorSetColorset_colorSetColorSetColor

Modul

Foundation