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

Add two images.

The operator add__ 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)
image(-array) -> object : byte / int1 / int2 / int4 / real / direction / cyclic / complex
Image 1

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

ImageResult (output_object)
image(-array) -> object : byte / int1 / int2 / int4 / real / direction / cyclic / complex
Result of 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
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
Range of values: -512.0 <= Add <= 512.0
Minimum increment: 0.01
Recommended increment: 1.0


Example
read_image(:Image0:"fabrik":)>
disp_image(Image0:::)>
read_image(:Image1:"Affe":)>
disp_image(Image1:::)>
add__(Image0,Image1:Result:2.0,10.0:)>
disp_image(Result:::)>

Result

The operator add__ returns the value 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.


Alternatives

sub__, mult__


See also

sub__, mult__



Copyright © 1996-1997 MVTec Software GmbH