set_gray
— Setzen eines Grauwertes für die Regionenausgabe.
set_gray( : : WindowHandle, GrayValues : )
set_gray
gibt an, dass Regionen in bestimmten Grauwerten
(GrayValues
) dargestellt werden sollen. Unter einem
Grauwert wird hier der Bereich der Farbtabelle verstanden, der für
die Darstellung von Grauwertdaten (disp_image
mit
set_paint(::WindowHandle,'gray':)
) verwendet wird. Hierbei handelt
es sich um die Einträge der Farbtabelle, die von
set_lut
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_gray
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_lut
), so kann dieser z.B. mit
set_color(::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_gray
,
set_color
, set_rgb
, set_hsi
)
überschreibt die Werte, die vorher gesetzt wurden. Je nach
Geräteeigenschaft können nicht alle Grauwerte dargestellt
werden. Der Wertebereich des Parameters GrayValues
(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_gray
können die darstellbaren Grauwerte abgefragt
werden. 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.
WindowHandle
(input_control) window →
(handle)
Fenster-Handle.
GrayValues
(input_control) integer(-array) →
(integer)
Grauwerte für Regionendarstellung.
Defaultwert: 255
Wertevorschläge: 0, 1, 2, 10, 16, 32, 64, 100, 120, 128, 250, 251, 252, 253, 254, 255
Typischer Wertebereich: 0
≤
GrayValues
≤
255
set_gray(WindowHandle,[100,200]) disp_circle(WindowHandle,[100,200,300],[200,300,100],[100,100,100])
set_gray
liefert den Wert 2 (H_MSG_TRUE), falls der angegebene Grauwert
darstellbar und das Fenster gültig ist.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
Foundation