LBitmap::ChannelMix

#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.

Platforms

Win32, x64.

See Also

Functions:

LBitmap::AdjustTint. LBitmap::ColorHalfTone, LBitmap::ConvertToColoredGray, LBitmap::BalanceColors, LBitmapBase::GrayScale, LBitmap::GrayScaleExt, LBitmapBase::IsGrayScale

Topics:

Correcting Colors

 

Raster Image Functions: Modifying Intensity Values

 

Color Halftones and Halftone Images

 

Raster Image Functions: Working with Color Halftones, Halftones, and Grayscale Images

 

Raster Image Functions: Correcting Colors

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 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Raster Imaging C++ Class Library Help