L_SetKaufmannRgnBitmap

#include "l_bitmap.h"

L_LTIMGCOR_API L_INT L_SetKaufmannRgnBitmap(pBitmap, pKaufmannProcBitmap, nRadius, nMinInput, nMaxInput, nRgnThreshold, ptRgnStart, bRemoveHoles, puPixelsCount, uCombineMode, uFlags);

Sets a Kaufmann region based on the color value at the specified point.

Returns

Comments

This function gets the color value of the point, specified in ptRgnStart, in the bitmap referenced in pBitmap. Using this color value as a starting point and the value specified in nRgnThreshold as an ending point, this function grows a region. Since noise affects the region growing process, enhancement procedures, such as Gaussian blur, are performed prior to obtaining the color from the specified point and growing the region, to improve the process. When this function returns, the pKaufmannProcBitmap contains the data from pBitmap, enhanced using the internal enhancing procedures, and the resulting region. This region is drawn on the image in pBitmap, but pBitmap itself is not changed. The area of the resulting region can be used to calculate the Kaufmann ratio (size of the corpus callosum / size of the brain sphere).

To calculate the Kaufmann ratio do the following:

For more information on how to calculate the brain ratio refer to the example below.

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

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 in the Document and Medical Imaging 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.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Example

#if defined (LEADTOOLS_V16_OR_LATER)
 L_INT SetKaufmannRgnBitmapExample(HWND hWnd)
{
   L_INT nRet;
   POINT pt; 
   L_SIZE_T uFirstPixelCount; 
   L_SIZE_T uSecondPixelCount; 
   L_TCHAR szText[MAX_PATH];
   BITMAPHANDLE Bitmap; 

   /* Load a bitmap at its own bits per pixel  */
   nRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("ImageProcessingDemo\\Image3.cmp")), &Bitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGRORGRAY, NULL, NULL); 
   if(nRet !=SUCCESS)
      return nRet;

   pt.x = BITMAPWIDTH(&Bitmap) >> 1; 
   pt.y = BITMAPHEIGHT(&Bitmap) >> 1; 

   // Converting the bitmap into 8 bit gray scale bitmap
   nRet = L_GrayScaleBitmap(&Bitmap, 8); 
   if(nRet !=SUCCESS)
      return nRet;

   // apply the function in order to get the pixels count of the first region. 
   nRet = L_SetKaufmannRgnBitmap(&Bitmap, NULL, 21, 54, 110, 13, pt, FALSE, &uFirstPixelCount, L_RGN_SET, 0); 
   if(nRet !=SUCCESS)
      return nRet;

   // apply the function once more. 
   nRet = L_SetKaufmannRgnBitmap(&Bitmap, NULL, 29, 51, 229, 207, pt, TRUE, &uSecondPixelCount, L_RGN_SET, 0); 
   if(nRet !=SUCCESS)
      return nRet;

   // print the ratio between the first and the second region. 
   _stprintf_s(szText,MAX_PATH,TEXT("%.3f"),uFirstPixelCount * 1.0 / uSecondPixelCount); 
    MessageBox(hWnd,szText, MAKE_IMAGE_PATH(TEXT("Ratio")), MB_OK); 
    nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Result.BMP")), &Bitmap, FILE_BMP, 24, 0, NULL);
    if(nRet !=SUCCESS)
       return nRet;
    //free bitmap 
    if(Bitmap.Flags.Allocated)  
      L_FreeBitmap(&Bitmap);  
   return SUCCESS;
}
#else
 L_INT SetKaufmannRgnBitmapExample(HWND hWnd)
{
   L_INT nRet;
   POINT pt; 
   L_SIZE_T uFirstPixelCount; 
   L_SIZE_T uSecondPixelCount; 
   L_TCHAR szText[MAX_PATH];
   BITMAPHANDLE Bitmap; 

   /* Load a bitmap at its own bits per pixel  */
   nRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("ImageProcessingDemo\\Image3.cmp")), &Bitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGRORGRAY, NULL, NULL); 
   if(nRet !=SUCCESS)
      return nRet;

   pt.x = BITMAPWIDTH(&Bitmap) >> 1; 
   pt.y = BITMAPHEIGHT(&Bitmap) >> 1; 

   // Converting the bitmap into 8 bit gray scale bitmap
   nRet = L_GrayScaleBitmap(&Bitmap, 8); 
   if(nRet !=SUCCESS)
      return nRet;

   // apply the function in order to get the pixels count of the first region. 
   nRet = L_SetKaufmannRgnBitmap(&Bitmap, NULL, 21, 54, 110, 13, pt, FALSE, &uFirstPixelCount, L_RGN_SET); 
   if(nRet !=SUCCESS)
      return nRet;

   // apply the function once more. 
   nRet = L_SetKaufmannRgnBitmap(&Bitmap, NULL, 29, 51, 229, 207, pt, TRUE, &uSecondPixelCount, L_RGN_SET); 
   if(nRet !=SUCCESS)
      return nRet;

   // print the ratio between the first and the second region. 
   _stprintf_s(szText,MAX_PATH,TEXT("%.3f"),uFirstPixelCount * 1.0 / uSecondPixelCount); 
    MessageBox(hWnd,szText, MAKE_IMAGE_PATH(TEXT("Ratio")), MB_OK); 
    nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Ratio")), &Bitmap, FILE_BMP, 24, 0, NULL);
    if(nRet !=SUCCESS)
       return nRet;
    //free bitmap 
    if(Bitmap.Flags.Allocated)  
      L_FreeBitmap(&Bitmap);  
   return SUCCESS;
}
#endif // LEADTOOLS_V16_OR_LATER