LBitmap::OtsuThreshold

#include "ltwrappr.h"

virtual L_INT LBitmap::OtsuThreshold(nClusters)

L_INT nClusters;

the number of colors in the output image.

Performs image segmentation and color reduction using Otsu clustering on grayscale images.

Parameter Description
nClusters The number of colors in the output image. Possible values are range from from 2 to 255.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function works only with grayscale images. If the input image is colored it will be converted to a grayscale image.

Otsu clustering is performed by making each cluster as compact as possible so as to minimize overlap. If one adjusts a threshold one way, the spread of one cluster gets larger and the spread for the second cluster gets smaller. Different threshold values are tried until the one is found which produces the minimum combined spread.

Otsu thresholding is typically used as a way to binarize an image. It is best when used on an image that has a bimodal histogram (Clusters = 2).

This function can only process entire images. It does not support regions.

This function supports 8 and 16-bit grayscale images.

Required DLLs and Libraries

LTDIS
LTFIL
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:

LBitmap::LevelsetBitmapRgn, LBitmap::LambdaConnectedness, LBitmap::ShrinkWrapTool, LBitmap::WatershedBitmap, LBitmap::KMeansBitmapSegmentation, LBitmap::GWireGetMinPath, Class Members

Example

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName 
#if defined (LEADTOOLS_V19_OR_LATER) 
L_INT LBitmap__OtsuThresholdExample(L_VOID) 
{ 
   L_INT nRet ; 
   LBitmap LeadBitmap ; 
   nRet = LeadBitmap.Load(MAKE_IMAGE_PATH(TEXT("ImageProcessingDemo\\NaturalFruits.jpg")), 0,ORDER_BGR); 
   if(nRet !=SUCCESS) 
      return nRet ; 
   nRet = LeadBitmap.OtsuThreshold(4); 
   return SUCCESS ; 
} 
#endif // LEADTOOLS_V19_OR_LATER 

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Raster Imaging C++ Class Library Help