LBitmapBase::ClearNegativePixels

#include "ltwrappr.h"

virtual L_INT LBitmapBase::ClearNegativePixels(void)

Sets all of the class object's bitmap pixels with negative color values to 0.

Returns

Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.

Comments

If ELO_SIGNED flag has been set using LOADFILEOPTION, before a file is loaded, the bitmap may contain negative pixel values and LEADTOOLS will paint/process the image incorrectly. In order to use this bitmap correctly, you must call LBitmapBase::ClearNegativePixels. If the ELO_SIGNED flag has not been set, all negative pixels are cleared internally, during the load process. Since some TIFF files are saved with negative values for pixel colors, you should call LBitmapBase::ClearNegativePixels if, after loading a bitmap, LBitmapBase::IsPixelsSigned returns TRUE.

LBitmapBase::ClearNegativePixels does nothing if LBitmapBase::IsPixelsSigned returns FALSE.

💡 TIP

Call LBitmapBase::ClearNegativePixels right after LBitmapBase::Load or LFile::Load.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

L_INT LBitmapBase__ClearNegativePixelsExample() 
{ 
   L_INT nRet; 
   LBitmapBase MyBitmap; 
 
   MyBitmap.SetFileName(MAKE_IMAGE_PATH(TEXT("signed-test.tif")));  
   nRet =MyBitmap.Load(); 
   if(nRet !=SUCCESS) 
      return nRet; 
 
   if(MyBitmap.IsPixelsSigned()) 
   { 
      nRet =MyBitmap.ClearNegativePixels(); 
      if(nRet !=SUCCESS) 
         return nRet; 
   } 
   else 
      return FAILURE;  
 
   return SUCCESS; 
} 
Help Version 21.0.2021.4.8
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C++ Class Library Help