LBitmap::ColorThreshold

#include "ltwrappr.h"

virtual L_INT LBitmap::ColorThreshold (uColorSpace, pCompData)

Using any one of eight color spaces, resets those bitmap’s pixel component values that fall inside or outside of a specified range.

Returns

Comments

This function is similar to the LBuffer::ConvertColorSpace function but provides greater flexibility by allowing the specification of a range and different options for handling those values that fall outside of the range. Please note that every color space component may have a different range.

This function works as follows:

This function works for 1, 2, 3, … 8,16, 24, 32, 48 and 64-bit color bitmaps and can support regions for 24 and 48-bit bitmaps. If a 24 or 48-bit bitmap has a region the effect will be applied on the region only.

One structure is used for each color component. The order is considered to be the same as in the CLTH_xxx_SPACE name. For example, for CLTH_RGB_SPACE:

pCompData[0] structure is used for the Blue component

pCompData[1] structure is used for the Green component

pCompData[2] structure is used for the Red component

The pCompData[0].uStructSize must be set to sizeof(COMPDATA) before calling this function. For an array of structures, only the first structure in the array needs to have uStructSize member set.

To update a status bar or detect a user interrupt during execution of this function, refer to LBase::EnableStatusCallback.

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.

Required DLLs and Libraries

See Also

Example

void TestFunction(LBitmap *pLeadBitmap) 
{
   COMPDATA          pCompData[3]; 
   L_INT                     nI; 

   pCompData[0].uStructSize = sizeof(COMPDATA); 
   for (nI = 0; nI < 3; nI++)
   {
       pCompData[nI].nMinRange = 128; 
       pCompData[nI].nMaxRange = 255; 
       pCompData[nI].uFlags = 0; 
   }

   /* Apply color Threshold effect on the image*/
   pLeadBitmap->ColorThreshold(CLTH_RGB_SPACE,  pCompData); 

}