CImCombine:Sum

CImCombine:Sum

The Sum method merges the pixel values using the sum of values at each location.

Syntax

CImage = CImCombine:Sum( CImageSet )

CImageSet contains the collection of images to be combined.
CImage is a new image created by this method.
On success, this method returns a new CImage.
On failure, this method returns nil.

Remarks

Each pixel in the output image is the sum of values at the same location in all the images of the CImageSet. This method is related to the Mean method, but differing by the ratio of the number of images. Normalization is used to remove offsets between the images prior to combining.

Example

Suppose a CImageSet named S exists. The following script fragment combines the images by the Sum method after normalizing their luminance by the median statistic computed inside the central 10% of the image:

C = CImCombine:new()	-- create a CImCombine object
R = CRect:new(10,50,10,50)	-- central 10% of the image
C:SetRelRect( R )	-- specify CImage and CRect to measure
C:SetNormStat("median")	-- use the median as the statistic
C:SetNormMethod("scale")	-- scale to normalize the image set
I = C:Sum( S )	-- combine image set and return new image
I:Display()	-- show the new image
C:delete()	-- when done with S, remove from memory