YCCBmpPlaneFileSave (ImageKit Control/File Method)

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

[Visual Basic] [ Boolean = ]imagekitcontrolname.File.YCCBmpPlaneFileSave(YFileName As String, CrFileName As String, CbFileName As String, ImageHandle As LONG_PTR)

[Visual C++] [ BOOL = ]imagekitcontrolname.GetFile().YCCBmpPlaneFileSave(LPCTSTR YFileName, LPCTSTR CrFileName, LPCTSTR CbFileName, LONG_PTR ImageHandle)

[VB.NET] [ Boolean = ]imagekitcontrolname.File.YCCBmpPlaneFileSave(YFileName As String, CrFileName As String, CbFileName As String, ImageHandle As Integer(x86) or Long(x64))

[C#.NET] [ bool = ]imagekitcontrolname.File.YCCBmpPlaneFileSave(string YFileName, string CrFileName, string CbFileName, int(x86) or long(x64) ImageHandle)

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

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 (nonzero) if successful. Returns False (0) 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.

Differences from the ImageKit7/8 ActiveX

The ImageHandle argument type has changed.