CImCombine:RgbMerge

The RgbMerge method creates a new RGB color image by merging R, G, and B channel images from the first 3 members of a CImageSet. Since all 3 images must have the same column and row dimensions, you may wish to use the DimEq method to test them before merging.

Syntax

CImage = CImCombine:RgbMerge( CImageSet )

CImageSet contains images for the R, G, and B channels, with the R image at index 1, G at index 2, and B at index 3.

On success, this method returns the merged RGB image as a new CImage.

On failure, this method returns nil.

Example

Suppose that 3 CImage objects exist with names R, G, andB. The following script creates a CImageSet and then merges these images into an RGB image:

S = new_imageset()	-- create an image set to hold the images
S:Append(R)	-- add R channel image to the image set at index 1
S:Append(G)	-- add G channel image to the image set at index 2
S:Append(B)	-- add B channel image to the image set at index 3
C = new_imcombine()	-- create a CImCombine object
I = C:RgbMerge( S )	-- merge the channels and return the new RGB CImage
S:delete()	-- delete S if no longer needed
C:delete()	-- delete C if no longer needed

Syntax

Example

Related Topics