HALCON Reference Manual 10.0.2
Table of Contents / Filters / Arithmetic ClassesClassesClasses | | | Operators

max_imagemax_imagemax_imageMaxImageMaxImage (Operator)

Name

max_imagemax_imagemax_imageMaxImageMaxImage — 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)

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

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

HImageArray HImageArray::MaxImage(const HImageArray& Image2) const

void HOperatorSetX.MaxImage(
[in] IHUntypedObjectX* Image1, [in] IHUntypedObjectX* Image2, [out] IHUntypedObjectX*ImageMax)

IHImageX* HImageX.MaxImage([in] IHImageX* Image2)

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

HImage HImage.MaxImage(HImage image2)

Description

max_imagemax_imagemax_imageMaxImageMaxImage calculates the maximum of the images Image1Image1Image1Image1image1 and Image2Image2Image2Image2image2 (pixel by pixel). The result is stored in the image ImageMaxImageMaxImageMaxImageMaximageMax. 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 Image1Image1Image1Image1image1 is compared to the i-th image from Image2Image2Image2Image2image2. Thus the number of images in both input parameters must be the same. An output image is generated for every input pair.

max_imagemax_imagemax_imageMaxImageMaxImage 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.

Parallelization

Parameters

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

Image(s) 1.

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

Image(s) 2.

ImageMaxImageMaxImageMaxImageMaximageMax (output_object)  (multichannel-)image(-array) objectHImageHImageHImageXHobject * (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)
disp_image(Max,WindowHandle)

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)
disp_image(Max,WindowHandle)

Example (HDevelop)

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)
disp_image(Max,WindowHandle)

Result

If the parameter values are correct the operator max_imagemax_imagemax_imageMaxImageMaxImage 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an exception is raised.

Alternatives

max_imagemax_imagemax_imageMaxImageMaxImage

See also

min_imagemin_imagemin_imageMinImageMinImage

Module

Foundation


Table of Contents / Filters / Arithmetic ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH