disp_imagedisp_imageDispImagedisp_imageDispImageDispImage (Operator)

Name

disp_imagedisp_imageDispImagedisp_imageDispImageDispImage — Ausgeben von Grauwertdaten.

Signatur

Beschreibung

disp_imagedisp_imageDispImagedisp_imageDispImageDispImage 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")set_comprise(WindowHandle,"object")SetComprise(WindowHandle,"object")SetComprise(WindowHandle,"object")) oder des gesamten Bildes (set_comprise(::WindowHandle,'image':)set_comprise(WindowHandle,"image")SetComprise(WindowHandle,"image")set_comprise(WindowHandle,"image")SetComprise(WindowHandle,"image")SetComprise(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 Tastsache bedingt, dass noch Farben für die Darstellung von Graphiken (z.B. set_colorset_colorSetColorset_colorSetColorSetColor) und den Windowmanager 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_systemGetSystemget_systemGetSystemGetSystem abgefragt und vor dem Öffnen des ersten Fensters mittels set_systemset_systemSetSystemset_systemSetSystemSetSystem 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_regionLabelToRegionlabel_to_regionLabelToRegionLabelToRegion 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_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray verwenden. Gegebenenfalls kann das Bild vor der Ausgabe mit scale_imagescale_imageScaleImagescale_imageScaleImageScaleImage und convert_image_typeconvert_image_typeConvertImageTypeconvert_image_typeConvertImageTypeConvertImageType in der gewünschten Weise angepasst werden.

Achtung

Wurde bei set_paintset_paintSetPaintset_paintSetPaintSetPaint ein falscher Ausgabemodus gesetzt, dann erfolgt die Fehlermeldung erst bei disp_imagedisp_imageDispImagedisp_imageDispImageDispImage.

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

* 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)

* 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_imageDispImagedisp_imageDispImageDispImage den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_lutset_lutSetLutset_lutSetLutSetLut, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi, scale_imagescale_imageScaleImagescale_imageScaleImageScaleImage, convert_image_typeconvert_image_typeConvertImageTypeconvert_image_typeConvertImageTypeConvertImageType, min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray

Alternativen

disp_objdisp_objDispObjdisp_objDispObjDispObj, disp_colordisp_colorDispColordisp_colorDispColorDispColor

Siehe auch

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow, reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb, set_compriseset_compriseSetCompriseset_compriseSetCompriseSetComprise, set_paintset_paintSetPaintset_paintSetPaintSetPaint, set_lutset_lutSetLutset_lutSetLutSetLut, paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray, scale_imagescale_imageScaleImagescale_imageScaleImageScaleImage, convert_image_typeconvert_image_typeConvertImageTypeconvert_image_typeConvertImageTypeConvertImageType, dump_windowdump_windowDumpWindowdump_windowDumpWindowDumpWindow

Modul

Foundation