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_imageMemoryBlockToImageMemoryBlockToImagememory_block_to_image liest die angegebenen Bilddaten aus dem Speicherblock MemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle und erzeugt daraus das Bild ImageImageImageimageimage.

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

Vorgänger

read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block, deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupledeserialize_tuple

Nachfolger

disp_imagedisp_imageDispImageDispImagedisp_image, thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, count_channelscount_channelsCountChannelsCountChannelscount_channels, decompose3decompose3Decompose3Decompose3decompose3, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormclass_ndim_norm, gauss_filtergauss_filterGaussFilterGaussFiltergauss_filter, fill_interlacefill_interlaceFillInterlaceFillInterlacefill_interlace, zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizezoom_image_size, zoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactorzoom_image_factor, crop_partcrop_partCropPartCropPartcrop_part, write_imagewrite_imageWriteImageWriteImagewrite_image, rgb1_to_grayrgb1_to_grayRgb1ToGrayRgb1ToGrayrgb1_to_gray

Siehe auch

image_to_memory_blockimage_to_memory_blockImageToMemoryBlockImageToMemoryBlockimage_to_memory_block

Modul

Foundation