YCCBmpPlaneFileSave (ImageKit Control/FileIO Method)

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

[C++Builder] [ bool = ]imagekitcontrolname->FileIO->YCCBmpPlaneFileSave(const UnicodeString YFileName, const UnicodeString CrFileName, const UnicodeString CbFileName, NativeUInt ImageHandle)

[C++Builder] [ bool = ]imagekitcontrolname->FileIO->YCCBmpPlaneFileSave(const UnicodeString YFileName, const UnicodeString CrFileName, const UnicodeString CbFileName)

[Delphi] [ Boolean = ]imagekitcontrolname.FileIO.YCCBmpPlaneFileSave(const YFileName: string; const CrFileName: string; const CbFileName: string; ImageHandle: THandle)

[Delphi] [ Boolean = ]imagekitcontrolname.FileIO.YCCBmpPlaneFileSave(const YFileName: string; const CrFileName: string; const CbFileName: string)

Parameters

Name	Explanation
YFileName	The filename of the saved Y plane image
CrFileName	The filename of the saved Cr plane image
CbFileName	The filename of the saved Cb plane image
ImageHandle	The image handle of the image to be saved in 4 seperate YCrCb planes

Return Value

Returns True if successful. Returns False if unsuccessful.

Explanation

The YCCBmpPlaneFileSave method saves a raster image into seperate YCrCb 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 YCrCb 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 YCrCb 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 YCrCb planes) will be 8 bit grayscale.