CMYKBmpPlaneFileSave (ImageKit Control/FileIO Method)

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

[C++Builder] [ bool = ]imagekitcontrolname->FileIO->CMYKBmpPlaneFileSave(const UnicodeString CFileName, const UnicodeString MFileName, const UnicodeString YFileName, const UnicodeString KFileName, NativeUInt ImageHandle)

[Delphi] [ Boolean = ]imagekitcontrolname.FileIO.CMYKBmpPlaneFileSave(const CFileName: string; const MFileName: string; const YFileName: string; const KFileName: string; ImageHandle: THandle)

[Delphi] [ Boolean = ]imagekitcontrolname.FileIO.CMYKBmpPlaneFileSave(const CFileName: string; const MFileName: string; const YFileName: string; const KFileName: string)

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 if successful. Returns False 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 is not used or when it 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.