LBitmap::ChannelMix

Summary

Redistributes the RGB values of the specified bitmap, using the values stored in the specified structures.

Syntax

#include "ltwrappr.h"

virtual L_INT LBitmap::ChannelMix(pRedFactor, pGreenFactor, pBlueFactor, uFlags = 0)

Parameters

pCOLORDATA pRedFactor

Pointer to a COLORDATA structure that contains the values to use for redistributing the bitmap's red values.

pCOLORDATA pGreenFactor

Pointer to a COLORDATA structure that contains the values to use for redistributing the bitmap's green values.

pCOLORDATA pBlueFactor

Pointer to a COLORDATA structure that contains the values to use for redistributing the bitmap's blue values.

L_UINT32 uFlags

Reserved for future use. Must be 0.

Returns

Value Meaning
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.

Channel Mixer Function - Before

Channel Mixer Function - Before

Channel Mixer Function - After

Channel Mixer Function - After

View additional platform support for this Channel Mixer function.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

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);  
} 

Help Version 22.0.2023.2.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.