sub__ ( ImageMinuend, ImageSubtrahend : ImageSub : Mult, Add : )

Subtract two images.

The operator sub__ subtracts two images. The gray values (g1,g2) g' := (g1 - g2) * Mult + Add


Parameters

ImageMinuend (input_object)
image(-array) -> object : byte / int1 / int2 / int4 / real / direction / cyclic / complex
Minuend

ImageSubtrahend (input_object)
image(-array) -> object : byte / int1 / int2 / int4 / real / direction / cyclic / complex
Subtrahend

ImageSub (output_object)
image(-array) -> object : byte / int1 / int2 / int4 / real / direction / cyclic / complex
Image containing the result.

Mult (input_control)
number -> real / integer
Correction factor
Default value: 1.0
Suggested values: 0.0, 1.0, 2.0, 3.0, 4.0
Range of values: -255.0 <= Mult <= 255.0
Minimum increment: 0.001
Recommended increment: 0.1

Add (input_control)
number -> real / integer
Correction value
Default value: 128.0
Suggested values: 0.0, 128.0, 256.0
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:::)>
sub__(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

mult__, add__, sub__


See also

add__, mult__



Copyright © 1996-1997 MVTec Software GmbH