CMYKBmpPlaneFileSave (ImageKit Control/File Method)

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

[Visual Basic] [ Boolean = ]imagekitcontrolname.File.CMYKBmpPlaneFileSave(CFileName As String, MFileName As String, YFileName As String, KFileName As String, ImageHandle As LONG_PTR)

[Visual C++] [ BOOL = ]imagekitcontrolname.GetFile().CMYKBmpPlaneFileSave(LPCTSTR CFileName, LPCTSTR MFileName, LPCTSTR YFileName, LPCTSTR KFileName, LONG_PTR ImageHandle)

[VB.NET] [ Boolean = ]imagekitcontrolname.File.CMYKBmpPlaneFileSave(CFileName As String, MFileName As String, YFileName As String, KFileName As String, ImageHandle As Integer(x86) or Long(x64))

[C#.NET] [ bool = ]imagekitcontrolname.File.CMYKBmpPlaneFileSave(string CFileName, string MFileName, string YFileName, string KFileName, int(x86) or long(x64) ImageHandle)

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

Parameters

Name	Explanation
CFileName	The filename of the saved C plane image
MFileName	The filename of the saved M plane image
YFileName	The filename of the saved Y plane image
KFileName	The filename of the saved K plane image
ImageHandle	The image handle of the image to be saved in 4 seperate CMYK planes

Return Value

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

Explanation

The CMYKBmpPlaneFileSave method saves a raster image into seperate CMYK 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 four seperate images each corresponding to the various CMYK 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 four seperate images each corresponding to the various CMYK 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 CMYK planes) will be 8 bit grayscale.

Differences between ImageKit7/8

The ImageHandle argument type has changed.