memory_block_to_imageT_memory_block_to_imageMemoryBlockToImageMemoryBlockToImagememory_block_to_image (算子名称)

名称

memory_block_to_imageT_memory_block_to_imageMemoryBlockToImageMemoryBlockToImagememory_block_to_image — Read an image from a memory block with different file formats.

参数签名

描述

The operator memory_block_to_imagememory_block_to_imageMemoryBlockToImageMemoryBlockToImageMemoryBlockToImagememory_block_to_image reads image data from the indicated memory block MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle and generates the image ImageImageImageImageimageimage.

The formats JPEG and PNG can be read. The file formats are recognized by the internal structure of the memory block. In case of colored images an image with three color channels is created, the red channel being stored in the first, the green channel in the second and the blue channel in the third component (channel number).

For the PNG image format binary alpha channels are interpreted as domains. Otherwise, the domain of the generated image object (all pixels of the matrix) is chosen maximal.

注意

If CMYK or YCCK JPEG memory blocks are read, HALCON assumes that these follow the Adobe Photoshop convention that the CMYK channels are stored inverted, i.e., 0 represents 100% ink coverage, rather than 0% ink as one would expect. The images are converted to RGB images using this convention. If the JPEG memory block does not follow this convention, but stores the CMYK channels in the usual fashion, invert_imageinvert_imageInvertImageInvertImageInvertImageinvert_image must be called after reading the image.

If PNG images that contain an alpha channel are read, the alpha channel is returned as the second or fourth channel of the output image, unless the alpha channel contains exactly two different gray values, in which case a one or three channel image with a reduced domain is returned, in which the points in the domain correspond to the points with the higher gray value in the alpha channel.

运行信息

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

参数表

结果

If the parameters are correct the operator memory_block_to_imagememory_block_to_imageMemoryBlockToImageMemoryBlockToImageMemoryBlockToImagememory_block_to_image returns the value 2 ( H_MSG_TRUE) . Otherwise an exception is raised.

可能的前置算子

read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockReadMemoryBlockread_memory_block, deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTupledeserialize_tuple

可能的后置算子

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

模块

Foundation