add_image

add_image ( Image1, Image2 : ImageResult : Mult, Add : )

Add two images.

The operator add_image adds two images. The gray values (g1,g2) of the input images (Image1 and Image2) are transformed as follows:

                g' := (g1 + g2) * Mult + Add

Parameters

`Image1` (input_object)	(multichannel-)image(-array) `->` object : byte / int1 / int2 / uint2 / int4 / real / direction / cyclic / complex
Image(s) 1.

`Image2` (input_object)	(multichannel-)image(-array) `->` object : byte / int1 / int2 / uint2 / int4 / real / direction / cyclic / complex
Image(s) 2.

`ImageResult` (output_object)	(multichannel-)image(-array) `->` object : byte / int1 / int2 / uint2 / int4 / real / direction / cyclic / complex
Result image(s) by the addition.

`Mult` (input_control)	number `->` real / integer
Factor for gray value adaption.
Default value: 0.5
Suggested values: 0.2, 0.4, 0.6, 0.8, 1.0, 1.5, 2.0, 3.0, 5.0
Typical range of values: `-255.0 <= Mult <= 255.0`
Minimum increment: 0.001
Recommended increment: 0.1

`Add` (input_control)	number `->` real / integer
Value for gray value range adaption.
Default value: 0
Suggested values: 0, 64, 128, 255, 512
Typical range of values: `-512.0 <= Add <= 512.0`
Minimum increment: 0.01
Recommended increment: 1.0

Example

read_image(Image0,"fabrik")
disp_image(Image0,WindowHandle)
read_image(Image1,"Affe")
disp_image(Image1,WindowHandle)
add_image(Image0,Image1,Result,2.0,10.0)
disp_image(Result,WindowHandle)

Result

The operator add_image 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 handling is raised.

Parallelization Information

add_image is reentrant and automatically parallelized (on tuple level, channel level, domain level).

Alternatives

sub_image, mult_image

See also

sub_image, mult_image

Module

Image filters