Performs automated segmentation of a rectangular area in the image specified by the user. The result is applied to the image as a region.


#include "l_bitmap.h"

L_LTIMGCOR_API L_INT EXT_FUNCTION L_AutoSegmentBitmap(pBitmap, pRect, uFlags)



Pointer to the bitmap handle referencing the bitmap to be changed.

L_RECT* pRect

Pointer to a Windows RECT structure that specifies the part of the bitmap to perform the segmentation on.

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 was designed specifically for CT/MRI images, to segment regions of cancer clusters.

Point pRect to a rectangle that includes all of the objects that need to be selected, since the function segments only what is inside the specified rectangle.

Do not select more than the objects you need to isolate and segment.

The rectangle must not exceed the borders of the image; otherwise the function will return an ERROR_INVALID_PARAMETER error and will not execute.

When the resulting region is no longer needed, it should be freed by calling L_FreeBitmapRgn.

Required DLLs and Libraries


Win32, x64, Linux.

See Also




This example loads a bitmap and applies the L_AutoSegmentBitmap function to it

L_INT AutoSegmentExample(L_VOID) 
   L_INT nRet; 
   BITMAPHANDLE LeadBitmap; /*Bitmap handle to hold the loaded image*/ 
   L_RECT rcRect; 	      /*Rectangle to specify area on Bitmap*/ 
   /* Load the bitmap, keeping the bits per pixel of the file */ 
   nRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("Image1.cmp")), &LeadBitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); 
   if (nRet != SUCCESS) 
      return nRet; 
   //Specify rectangle parameters  
   rcRect.left = 50; 
   rcRect.top = 100; 
   rcRect.right = 100; 
   rcRect.bottom = 150; 
   //Apply the AutoSegmentBitmap Function 
   nRet = L_AutoSegmentBitmap(&LeadBitmap, &rcRect, 0); 
   if (nRet != SUCCESS) 
      return nRet; 
   /* Lighten the region so that we will see it */ 
   nRet = L_ChangeBitmapIntensity(&LeadBitmap, 500, 0); 
   /* Free the region */ 
   return nRet; 

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

LEADTOOLS Raster Imaging C API Help

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