Inverts the colors in the class object's bitmap, making it like a photographic negative.


#include "ltwrappr.h"

virtual L_INT LBitmap::Invert(uFlags = 0)


L_UINT32 uFlags

Reserved for future use. Must be 0.


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


This function can also be used to invert the color of a 1-bit image, making the black white and the white black.

This function originally works on the image source data, but if the image has a LUT, the function will work on the LUT.

To use this function with source data for an image that has LUT:

  1. Set the LBitmapBase::EnableUseLUT to FALSE.

  2. Call this function.

  3. After applying the function, set the LBitmapBase::EnableUseLUT back to TRUE.


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

This function supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.

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.

Invert Function - Before

Invert Function - Before

Invert Function - After

Invert Function - After

View additional platform support for this Invert function.

Required DLLs and Libraries


Win32, x64.

See Also




L_INT LBitmap__InvertExample() 
   L_INT nRet; 
   LBitmap LeadBitmap; 
   nRet =LeadBitmap.Load(MAKE_IMAGE_PATH(TEXT("image1.cmp")), 0,ORDER_BGR); 
   if(nRet !=SUCCESS) 
      return nRet; 
   nRet =LeadBitmap.Invert(); 
   if(nRet !=SUCCESS) 
      return nRet; 
   return SUCCESS; 
Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C++ Class Library Help