add_image

Herror ::add_image ( Hobject Image1, Hobject Image2, Hobject *ImageResult, const HTuple &Mult, const HTuple &Add ) HImage HImage::AddImage ( const HImageArray &Image2, const HTuple &Mult, const HTuple &Add ) const HImageArray HImageArray::AddImage ( const HImageArray &Image2, const HTuple &Mult, const HTuple &Add ) const

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) `->` Hobject: HImage(Array) ( byte / int1 / int2 / int4 / real / direction / cyclic / complex )
Image(s) 1.

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

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

`Mult` (input_control)	number `->` HTuple.double / long
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 `->` HTuple.double / long
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 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.

Alternatives

::sub_image, ::mult_image

See also

::sub_image, ::mult_image

Module

Image filters