imadd

Add two images or add constant to image

Syntax

Z = imadd(X,Y)

Description

Z = imadd(X,Y) adds each element in array X with the corresponding element in array Y and returns the sum in the corresponding element of the output array Z.

If X is an integer array, elements in the output that exceed the range of the integer type are truncated, and fractional values are rounded.

Examples

Add Two uint8 Arrays

This example shows how to add two uint8 arrays with truncation for values that exceed 255.

X = uint8([ 255 0 75; 44 225 100]);
Y = uint8([ 50 50 50; 50 50 50 ]);
Z = imadd(X,Y)

Z = 2x3 uint8 matrix

   255    50   125
    94   255   150

Add Two Images and Specify Output Class

Read two grayscale uint8 images into the workspace.

I = imread('rice.png');
J = imread('cameraman.tif');

Add the images. Specify the output as type uint16 to avoid truncating the result.

K = imadd(I,J,'uint16');

Display the result.

imshow(K,[])

Add a Constant to an Image

Read an image into the workspace.

I = imread('rice.png');

Add a constant to the image.

J = imadd(I,50);

Display the original image and the result.

imshow(I)

figure
imshow(J)

Input Arguments

X — First array

real, nonsparse, numeric or logical array

First array, specified as a real, nonsparse, numeric or logical array of any dimension.

Y — Second array

real, nonsparse, numeric or logical array

Second array to be added to X, specified as a real, nonsparse, numeric or logical array. Y either has the same size and class as X, or Y is a scalar of type double.

Output Arguments

Z — Sum

numeric array

Sum, returned as a numeric array of the same size as X. Z is the same class as X unless X is logical, in which case Z is data type double. If X is an integer array, elements of the output that exceed the range of the integer type are truncated, and fractional values are rounded.