div_imageDivImageDivImagediv_imagediv_image

HALCON ScriptCpp++.NETPythonC

Short description

div_imageDivImageDivImagediv_imagediv_image — Divide two images.

Signature

div_image( image Image1, image Image2, out image ImageResult, number Mult, number Add )void DivImage( const HObject& Image1, const HObject& Image2, HObject* ImageResult, const HTuple& Mult, const HTuple& Add )static void HOperatorSet.DivImage( HObject image1, HObject image2, out HObject imageResult, HTuple mult, HTuple add )def div_image( image_1: HObject, image_2: HObject, mult: Union[int, float], add: Union[int, float] ) -> HObject

Herror div_image( const Hobject Image1, const Hobject Image2, Hobject* ImageResult, double Mult, double Add )

Herror T_div_image( const Hobject Image1, const Hobject Image2, Hobject* ImageResult, const Htuple Mult, const Htuple Add )

HImage HImage::DivImage( const HImage& Image2, const HTuple& Mult, const HTuple& Add ) const

HImage HImage::DivImage( const HImage& Image2, double Mult, double Add ) const

HImage HImage.DivImage( HImage image2, HTuple mult, HTuple add )

HImage HImage.DivImage( HImage image2, double mult, double add )

Description

The operator div_imageDivImage divides two images. The gray values (g1,g2) of the input images (Image1image1image_1) are transformed as follows: g’ := g1 / g2 * Mult + Add If an overflow or an underflow occurs the values are clipped. For a division by zero the result is set to zero.

* Several images can be processed in one call. In this case both input parameters contain the same number of images which are then processed in pairs. An output image is generated for every pair.

div_imageDivImage can be executed on an OpenCL device for byte, int1, int2, uint2, int4, real and complex images. However, since for OpenCL 1.0 only single precision floating point is supported for all devices, and not all rounding modes are supported, the OpenCL implementation can produce slightly different results from the scalar implementation.

Execution information

Execution information

• Supports OpenCL compute devices.

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).

• Multithreading scope: global (may be called from any thread).

• Automatically parallelized on domain level.

Parameters

Image1image1image_1 (input_object) (multichannel-)image(-array) → object (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*)HObject (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*)HImage (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*)HObject (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*)Hobject (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*) *allowed for compute devices

Image(s) 1.

Image2image2image_2 (input_object) (multichannel-)image(-array) → object (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*)HObject (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*)HImage (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*)HObject (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*)Hobject (byte* / int1* / int2* / uint2* / int4* / int8 / real* / complex*) *allowed for compute devices

Image(s) 2.

ImageResultimageResultimage_result (output_object) (multichannel-)image(-array) → object (byte / int1 / int2 / uint2 / int4 / int8 / real / complex)HObject (byte / int1 / int2 / uint2 / int4 / int8 / real / complex)HImage (byte / int1 / int2 / uint2 / int4 / int8 / real / complex)HObject (byte / int1 / int2 / uint2 / int4 / int8 / real / complex)Hobject * (byte / int1 / int2 / uint2 / int4 / int8 / real / complex)

Result image(s) by the division.

Multmultmult (input_control) number → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[int, float]Htuple (double / Hlong)

Factor for gray range adaption.

Default: 255255
Suggested values: 0.1, 0.2, 0.5, 1.0, 2.0, 3.0, 10, 100, 500, 10000.1, 0.2, 0.5, 1.0, 2.0, 3.0, 10, 100, 500, 1000
Value range: -1000 ≤ Mult ≤ 1000
Minimum increment: 0.001
Recommended increment: 1

Addaddadd (input_control) number → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[int, float]Htuple (double / Hlong)

Value for gray range adaption.

Default: 00
Suggested values: 0.0, 128.0, 256.0, 10250.0, 128.0, 256.0, 1025
Value range: -1000 ≤ Add ≤ 1000
Minimum increment: 0.01
Recommended increment: 1.0

Example

(HDevelop)

read_image(Image1,'fabrik')
dev_display (Image1)
read_image(Image2,'monkey')
dev_display (Image2)
div_image (Image1, Image2, Result, 200, 10)
dev_display (Result)

(C)

read_image(&Image1,"fabrik")\;
disp_image(Image1,WindowHandle)\;
read_image(&Image2,"monkey")\;
disp_image(Image2,WindowHandle)\;
div_image(Image1,Image2,&Result,200.0,10.0)\;
disp_image(Result,WindowHandle)\;

Result

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

Combinations with other operators

Combinations

Alternatives

add_imageAddImage, sub_imageSubImage, mult_imageMultImage

See also

add_imageAddImage, sub_imageSubImage, mult_imageMultImage

Module

Foundation