Available in LEADTOOLS Imaging Pro, Vector, Document, and Medical Imaging toolkits. |
#include "ltwrappr.h"
virtual L_INT LBitmap::ChannelMix(pRedFactor, pGreenFactor, pBlueFactor, uFlags = 0)
pCOLORDATA pRedFactor; |
/* pointer to a structure */ |
pCOLORDATA pGreenFactor; |
/* pointer to a structure */ |
pCOLORDATA pBlueFactor; |
/* pointer to a structure */ |
L_UINT32 uFlags; |
/* flags */ |
Redistributes the RGB values of the specified bitmap, using the values stored in the specified structures.
Parameter |
Description |
pRedFactor |
Pointer to a COLORDATA structure that contains the values to use for redistributing the bitmap's red values. |
pGreenFactor |
Pointer to a COLORDATA structure that contains the values to use for redistributing the bitmap's green values. |
pBlueFactor |
Pointer to a COLORDATA structure that contains the values to use for redistributing the bitmap's blue values. |
uFlags |
Reserved for future use. Must be 0. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function is used to rebalance the colors in a bitmap. It can be used to make color adjustments and corrections.
This function supports 1-, 2-, 3-, 4-, 5-, 6-, 7-, 8-, 24- and 48-bit bitmaps and can support regions for 24- and 48-bit bitmaps. If the bitmap has a region, the effect will be applied on the region only.
This function does not support signed data images. It returns the error code ERROR_SIGNED_DATA_NOT_SUPPORTED if a signed data image is passed to this function.
This function does not support 32-bit grayscale images. It returns the error code ERROR_GRAY32_UNSUPPORTED if a 32-bit grayscale image is passed to this function.
Required DLLs and Libraries
LTIMGCLR For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Win32, x64.
See Also
Example
The following example applies the LBitmap::ChannelMix function to it:
L_INT LBitmap__ChannelMixExample(LAnimationWindow *BitmapWindow) { COLORDATA RedFact, GreenFact, BlueFact; RedFact.uStructSize = sizeof(COLORDATA); GreenFact.uStructSize = sizeof(COLORDATA); BlueFact.uStructSize = sizeof(COLORDATA); RedFact.nRedFactor = 250; RedFact.nGreenFactor = 255; RedFact.nBlueFactor = 222; RedFact.nConstant = 0; GreenFact.nRedFactor = 100; GreenFact.nGreenFactor = 0; GreenFact.nBlueFactor = 250; GreenFact.nConstant = 0; BlueFact.nRedFactor = 5; BlueFact.nGreenFactor = 0; BlueFact.nBlueFactor = 0; BlueFact.nConstant = 0; return BitmapWindow->ChannelMix( &RedFact, &GreenFact, &BlueFact); }