memory_block_to_imageT_memory_block_to_imageMemoryBlockToImageMemoryBlockToImagememory_block_to_image (Operator)

Name

memory_block_to_imageT_memory_block_to_imageMemoryBlockToImageMemoryBlockToImagememory_block_to_image — Einlesen eines Bildes aus einem Speicherblock mit unterschiedlichen Dateiformaten.

Signatur

Beschreibung

Der Operator memory_block_to_imagememory_block_to_imageMemoryBlockToImageMemoryBlockToImageMemoryBlockToImagememory_block_to_image liest die angegebenen Bilddaten aus dem Speicherblock MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle und erzeugt daraus das Bild ImageImageImageImageimageimage.

Die Formate JPEG und PNG können eingelesen werden. Die Dateiformate werden aufgrund der inneren Struktur des Speicherblocks erkannt. Bei Farbbildern wird ein Bild mit drei Farbkanälen erzeugt, wobei der Rotkanal in der ersten, der Grünkanal in der zweiten und der Blaukanal in der dritten Komponente (Kanalnummer) abgelegt wird.

Im Falle des PNG Bildformats werden binäre Alphakanäle als Domänen interpretiert. Ansonsten wird die Domäne des erzeugten Bildobjektes maximal (alle Bildpunkte der Matrix) gewählt.

Achtung

Falls CMYK oder YCCK JPEG Speicherblöcke gelesen werden, nimmt HALCON an, dass diese der Konvention von Adobe Photoshop folgen, gemäß der die CMYK-Kanäle invertiert gespeichert sind, d.h. 0 repräsentiert 100% Druckfarbe und nicht 0%, wie man es eigentlich erwarten würde. Die Bilder werden gemäß dieser Konvention in RGB-Bilder umgewandelt. Falls die JPEG Speicherblöcke nicht dieser Konvention folgen und die CMYK-Kanäle in der üblichen Weise abgespeichert sind, muss invert_imageinvert_imageInvertImageInvertImageInvertImageinvert_image nach dem Einlesen des Bildes aufgerufen werden.

Beim Lesen von PNG-Dateien mit Alphakanal wird der Alphakanal als zweiter bzw. vierter Kanal des Ausgabebildes zurückgegeben, außer der Alpha-Kanal enthält genau zwei verschiedene Grauwerte. In diesem Fall wird ein ein- oder dreikanaliges Bild mit eingeschränktem Definitionsbereich zurückgegeben, in dem die Punkte des Definitionsbereiches den Pixeln des Alpha-Kanals mit dem höheren der zwei Grauwerte entspricht.

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

Ergebnis

Sind die Parameter korrekt, dann liefert memory_block_to_imagememory_block_to_imageMemoryBlockToImageMemoryBlockToImageMemoryBlockToImagememory_block_to_image den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

disp_imagedisp_imageDispImageDispImageDispImagedisp_image, thresholdthresholdThresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, count_channelscount_channelsCountChannelsCountChannelsCountChannelscount_channels, decompose3decompose3Decompose3Decompose3Decompose3decompose3, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNormclass_ndim_norm, gauss_filtergauss_filterGaussFilterGaussFilterGaussFiltergauss_filter, fill_interlacefill_interlaceFillInterlaceFillInterlaceFillInterlacefill_interlace, zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizeZoomImageSizezoom_image_size, zoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactorZoomImageFactorzoom_image_factor, crop_partcrop_partCropPartCropPartCropPartcrop_part, write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image, rgb1_to_grayrgb1_to_grayRgb1ToGrayRgb1ToGrayRgb1ToGrayrgb1_to_gray

Siehe auch

image_to_memory_blockimage_to_memory_blockImageToMemoryBlockImageToMemoryBlockImageToMemoryBlockimage_to_memory_block

Modul

Foundation