#include "l_bitmap.h"
L_LTIMGCOR_API L_INT EXT_FUNCTION L_AutoSegmentBitmap(pBitmap, pRect, uFlags)
pBITMAPHANDLE pBitmap; |
/* pointer to the bitmap */ |
L_RECT* pRect; |
/* pointer to rectangle specifying area to perform segmentation on */ |
L_UINT32 uFlags; |
/* flags */ |
Performs automated segmentation of a rectangular area in the image specified by the user. The result is applied to the image as a region.
Parameter |
Description |
pBitmap |
Pointer to the bitmap handle referencing the bitmap to be changed. |
pRect |
Pointer to Windows RECT structure that specifies the part of the bitmap to perform the segmentation on. |
uFlags |
Reserved for future use. Must be 0. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function was designed specifically for CT/MRI images, to segment regions of cancer clusters.
It is preferred that pRect points to a rectangle that includes all of the objects that need to be selected. Failure to do so will result in a partial selection of the object as the function will only segment inside the specified rectangle.
Do not select more than the object 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 resultant region is no longer needed, it should be freed by calling L_FreeBitmapRgn.
Required DLLs and Libraries
LTIMGCOR For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Platforms
Win32, x64.
See Also
Functions: |
L_SetBitmapRgnColor, L_HolesRemovalBitmapRgn, L_FreeBitmapRgn |
Topics: |
|
|
Example
This example loads a bitmap and applies the L_AutoSegmentBitmap function to it
#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName #if defined (LEADTOOLS_V17_OR_LATER) 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("ImageProcessingDemo\\Image3.cmp")), &LeadBitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); if(nRet != SUCCESS) return nRet; //Specify rectangle parameters rcRect.left = 100; rcRect.top = 100; rcRect.right = 50; 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 */ #if defined (LEADTOOLS_V16_OR_LATER) nRet = L_ChangeBitmapIntensity(&LeadBitmap,500, 0); #else nRet = L_ChangeBitmapIntensity(&LeadBitmap,500); #endif /* Free the region */ L_FreeBitmapRgn(&LeadBitmap); return SUCCESS; } #endif