disp_imageT_disp_imageDispImageDispImagedisp_image (Operator)

Name

disp_imageT_disp_imageDispImageDispImagedisp_image — Ausgeben von Grauwertdaten.

Signatur

Beschreibung

disp_imagedisp_imageDispImageDispImageDispImagedisp_image gibt die Grauwerte von einem Bild auf dem Ausgabefenster aus. Es werden dabei diejenigen Grauwerte verwendet, die innerhalb des Definitionsbereiches (set_comprise(::WindowHandle,'object':)set_comprise(WindowHandle,"object")SetComprise(WindowHandle,"object")SetComprise(WindowHandle,"object")SetComprise(WindowHandle,"object")set_comprise(WindowHandle,"object")) oder des gesamten Bildes (set_comprise(::WindowHandle,'image':)set_comprise(WindowHandle,"image")SetComprise(WindowHandle,"image")SetComprise(WindowHandle,"image")SetComprise(WindowHandle,"image")set_comprise(WindowHandle,"image")) liegen. Voreingestellt ist, dass nur die definierten Grauwerte verwendet werden.

Bei der Ausgabe von Graubildern wird die Anzahl der Graustufen i.a. reduziert. Dies ist durch die Tatsache bedingt, dass noch Farben für die Darstellung von Grafiken (z.B. set_colorset_colorSetColorSetColorSetColorset_color) und den Window-Manager reserviert werden müssen. Zudem stehen abhängig von den auf der Ausgabemaschine verfügbaren Bitplanes häufig weniger als 256 Farben (acht Bitplanes) zur Verfügung. Die Anzahl der tatsächlich für die Ausgabe von Graustufen reservierten „Farben“ kann mittels get_systemget_systemGetSystemGetSystemGetSystemget_system abgefragt und vor dem Öffnen des ersten Fensters mittels set_systemset_systemSetSystemSetSystemSetSystemset_system auch verändert werden. Für 8 Bitplanes sind beispielsweise 200 reale Graustufen voreingestellt.

Die Reduktion der Anzahl der Graustufen ist unproblematisch, solange nur Grauwertinformation ausgegeben wird, da der Mensch 256 verschiedenen Graustufen ohnehin nicht unterscheiden kann. Sind jedoch bestimmte Grauwerte für die Speicherung von Regioneninformation verwendet worden (was nicht der Vorgehensweise von HALCON entspricht), so kann dies bei der Darstellung zu Verwechslungen führen, da somit unterschiedliche Zahlenwerte mit dem gleichen Grauwert auf dem Bildschirm abgebildet werden. Sollten derartige Bilder vorliegen, empfiehlt es sich, den Operator label_to_regionlabel_to_regionLabelToRegionLabelToRegionLabelToRegionlabel_to_region zu verwenden, um das Bild mit den Markierungen in HALCON-Objekte umzuwandeln.

Werden Bilder vom Typ int2, int4, int8, real oder complex ausgegeben, so wird zunächst der kleinste und der größte Grauwert bestimmt. Für Bilder vom Typ complex basiert diese Berechnung auf dem entsprechenden Leistungsspektrum. Danach werden die Bildpunkte auf die zur Verfügung stehende Anzahl von Graustufen (abhängig von der Ausgabemaschine, ca. 200) skaliert. Hierbei kann es vorkommen, dass einige Pixelwerte extrem andere Werte als alle übrigen haben. Dies führt dazu, dass entweder ein ganz weißes oder schwarzes Bild auf dem Fenster erscheint. Um festzustellen, ob es sich um ein binäres Bild handelt, kann man z.B. min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGraymin_max_gray verwenden. Gegebenenfalls kann das Bild vor der Ausgabe mit scale_imagescale_imageScaleImageScaleImageScaleImagescale_image und convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeConvertImageTypeconvert_image_type in der gewünschten Weise angepasst werden.

Achtung

Wurde bei set_paintset_paintSetPaintSetPaintSetPaintset_paint ein falscher Ausgabemodus gesetzt, dann erfolgt die Fehlermeldung erst bei disp_imagedisp_imageDispImageDispImageDispImagedisp_image.

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

* Output of a gray image:
read_image(Image,'monkey')
disp_image(Image,WindowHandle)

/* Output of a gray image: */
read_image(&Image,"monkey");
T_disp_image(Image,WindowHandle);

* Output of a gray image:
read_image(Image,'monkey')
disp_image(Image,WindowHandle)

* Output of a gray image:
read_image(Image,'monkey')
disp_image(Image,WindowHandle)

* Output of a gray image:
read_image(Image,'monkey')
disp_image(Image,WindowHandle)

Ergebnis

Falls das übergebene Bild definierte Werte enthält und ein gültiger Ausgabemodus eingestellt ist, dann liefert disp_imagedisp_imageDispImageDispImageDispImagedisp_image den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window, set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb, set_lutset_lutSetLutSetLutSetLutset_lut, set_hsiset_hsiSetHsiSetHsiSetHsiset_hsi, scale_imagescale_imageScaleImageScaleImageScaleImagescale_image, convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeConvertImageTypeconvert_image_type, min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGraymin_max_gray

Alternativen

disp_objdisp_objDispObjDispObjDispObjdisp_obj, disp_colordisp_colorDispColorDispColorDispColordisp_color

Siehe auch

open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window, reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDbreset_obj_db, set_paintset_paintSetPaintSetPaintSetPaintset_paint, set_lutset_lutSetLutSetLutSetLutset_lut, paint_graypaint_grayPaintGrayPaintGrayPaintGraypaint_gray, scale_imagescale_imageScaleImageScaleImageScaleImagescale_image, convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeConvertImageTypeconvert_image_type, dump_windowdump_windowDumpWindowDumpWindowDumpWindowdump_window

Modul

Foundation