max_imagemax_imageMaxImageMaxImagemax_image (Operator)

Name

max_imagemax_imageMaxImageMaxImagemax_image — Calculate the maximum of two images pixel by pixel.

Signature

max_image(Image1, Image2 : ImageMax : : )

Herror max_image(const Hobject Image1, const Hobject Image2, Hobject* ImageMax)

Herror T_max_image(const Hobject Image1, const Hobject Image2, Hobject* ImageMax)

void MaxImage(const HObject& Image1, const HObject& Image2, HObject* ImageMax)

HImage HImage::MaxImage(const HImage& Image2) const

static void HOperatorSet.MaxImage(HObject image1, HObject image2, out HObject imageMax)

HImage HImage.MaxImage(HImage image2)

def max_image(image_1: HObject, image_2: HObject) -> HObject

Description

max_imagemax_imageMaxImageMaxImageMaxImagemax_image calculates the maximum of the images Image1Image1Image1Image1image1image_1 and Image2Image2Image2Image2image2image_2 (pixel by pixel). The result is stored in the image ImageMaxImageMaxImageMaxImageMaximageMaximage_max. The resulting image has the same pixel type as the input image. If several (pairs of) images are processed in one call, every i-th image from Image1Image1Image1Image1image1image_1 is compared to the i-th image from Image2Image2Image2Image2image2image_2. Thus the number of images in both input parameters must be the same. An output image is generated for every input pair.

max_imagemax_imageMaxImageMaxImageMaxImagemax_image can be executed on an OpenCL device for byte, int1, int2, uint2, int4, real, direction, and cyclic images.

Attention

The two input images must be of the same type and size.

Execution Information

Parameters

Image1Image1Image1Image1image1image_1 (input_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject (byte* / int1* / int2* / uint2* / int4* / int8 / real* / direction* / cyclic*) *allowed for compute devices

Image(s) 1.

Image2Image2Image2Image2image2image_2 (input_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject (byte* / int1* / int2* / uint2* / int4* / int8 / real* / direction* / cyclic*) *allowed for compute devices

Image(s) 2.

ImageMaxImageMaxImageMaxImageMaximageMaximage_max (output_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject * (byte / int1 / int2 / uint2 / int4 / int8 / real / direction / cyclic)

Result image(s) by the maximization.

Example (HDevelop)

read_image(Image1,'monkey')
read_image(Image2,'fabrik')
max_image(Image1,Image2,Max)
dev_display (Max)

Example (C)

read_image(&Image1,"monkey");
read_image(&Image2,"fabrik");
max_image(Image1,Image2,&Max);
disp_image(Max,WindowHandle);

Example (HDevelop)

read_image(Image1,'monkey')
read_image(Image2,'fabrik')
max_image(Image1,Image2,Max)
dev_display (Max)

Example (HDevelop)

read_image(Image1,'monkey')
read_image(Image2,'fabrik')
max_image(Image1,Image2,Max)
dev_display (Max)

Example (HDevelop)

read_image(Image1,'monkey')
read_image(Image2,'fabrik')
max_image(Image1,Image2,Max)
dev_display (Max)

Result

If the parameter values are correct the operator max_imagemax_imageMaxImageMaxImageMaxImagemax_image returns the value 2 (H_MSG_TRUE). The behavior in case of empty input (no input images available) is set via the operator set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary an exception is raised.

See also

min_imagemin_imageMinImageMinImageMinImagemin_image

Module

Foundation