CImCombine:MmClipRange

The MmClipRange method creates an image who's pixel values are the range of values at each point among all images, after excluding the 1 highest and 1 lowest value at each point. Each pixel in the output image is the range of values at the same location in all the images of the CImageSet. This method makes a smoother result than the Range method by excluding the most extreme high and low pixels from the result. Depending upon the images and the application, you may or may not wish to normalize the images before computing the range.

Syntax

CImage = CImCombine:MmClipRange( CImageSet )

bullet.gif    CImageSet contains the collection of images to be combined.

bullet.gif    CImage is a new image created by this method.

bullet.gif    On success, this method returns a new CImage.

bullet.gif    On failure, this method returns nil.

Example

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

C = new_imcombine()

-- create a CImCombine object

R = new_rect(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 normalization statistic

C:SetNormMethod("scale")

-- scale to normalize the image set

I = C:MmClipRange( S )

-- combine the image set and return a new image

I:Display()

-- show the new image

C:delete()

-- when done with S, remove it from memory

Related Topics

CImCombine class

CImageSet class

CImage class

CRect class


Mira Pro x64 Script User's Guide, v.8.80 Copyright Ⓒ 2025 Mirametrics, Inc. All Rights Reserved.