This method saves a raster image into seperate RGB planes. The saved images are in BMP format

[Visual Basic]   [ Boolean = ]imagekitcontrolname.File.RGBBmpPlaneFileSave(RedFileName As String, GreenFileName As String, BlueFileName As String, ImageHandle As LONG_PTR)
[Visual C++]     [ BOOL = ]imagekitcontrolname.GetFile().RGBBmpPlaneFileSave(LPCTSTR RedFileName, LPCTSTR GreenFileName, LPCTSTR BlueFileName, LONG_PTR ImageHandle)
[VB.NET]   [ Boolean = ]imagekitcontrolname.File.RGBBmpPlaneFileSave(RedFileName As String, GreenFileName As String, BlueFileName As String, ImageHandle As Integer(x86) or Long(x64))
[C#.NET]   [ bool = ]imagekitcontrolname.File.RGBBmpPlaneFileSave(string RedFileName, string GreenFileName, string BlueFileName, int(X86) or long(x64) ImageHandle)

(x86) refers to the 32 bit version, (x64) refers to the 64 bit version.

Parameters

Name Explanation
RedFileName The filename of the saved R plane image
GreenFileName The filename of the saved G plane image
BlueFileName The filename of the saved B plane image
ImageHandle The image handle of the image to be saved in 3 seperate RGB planes

Return Value

Returns True (nonzero) if successful. Returns False (0) if unsuccessful.

Explanation

The RGBBmpPlaneFileSave method saves a raster image into seperate RGB planes. The saved images are in BMP format.

 

When the ImageHandle parameter contains a valid image handle

The image set in the ImageHandle parameter will be saved as three seperate images each corresponding to the various RGB planes.

When the ImageHandle parameter contains 0

The image referred to by the LayerNo property (either the image set in the ImageHandle property or the image set in the Layer(LayerNo).ImageHandle property as the case may be) will be saved as three seperate images each corresponding to the various RGB planes.

Note: When the LayerNo property is -1, the image set in the ImageHandle property is enabled. When the LayerNo property has values from 0 to 99, the image set in the Layer(LayerNo).ImageHandle property is enabled.

The input image (that image set in the ImageHandle parameter) must be 24 bit color. The output images (corresponding to the various RGB planes) will be 8 bit grayscale.

Differences between ImageKit7/8

The ImageHandle argument type has changed.

The ImageKit10 ActiveX is a product created by Newtone Corporation