CImage:ExtractByte

The ExtractByte method creates a new image containing a byte plane from a numeric image. For example, this creates an image consisting of the high order byte of a ushort type image.

Syntax

CImage = CImage:ExtractByte( nPlane )

where

nPlane is the plane number, beginning at 1.

CImage is a new CImage object containing the extracted byte plane.

On success, this method returns a new CImage object.

On failure, this method returns nil.

Example

Suppose that a CImage I exists and has long data type. The following script creates 4 new images, one each for the 4 bytes of the original image pixels:

S = CImageSet:new()	-- create an image set to hold the images
for i=1, 4 do	-- do for each of the 3 channels
Iplane = I:ExtractByte(i)	-- extract the byte plane to a new image
S:Append( Iplane )	-- add to the end of the image set
end
I = S:GetImage(1)	-- retrieve the lowest order byte plane