L_OtsuThreshold

#include "Ltimgcor.h"

L_LTIMGCOR_API L_INT L_OtsuThreshold(pBitmap, nClusters)

pBITMAPHANDLE pBitmap;	pointer to the bitmap handle
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
pBitmap	Pointer to the bitmap handle referencing the bitmap to be converted.
nClusters	The number of colors in the output image. Valid values range 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 a color image, 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 command supports 8- and 16-bit grayscale images and 24- and 32-bit colored images.

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, Linux.

Example

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName 
L_INT OtsuThresholdExample(L_VOID) 
{ 
   L_INT nRet; 
   BITMAPHANDLE LeadBitmap;   /* Bitmap handle to hold the loaded image. */ 
   /* Load the bitmap, keeping the bits per pixel of the file */ 
   nRet = L_LoadBitmap (MAKE_IMAGE_PATH(TEXT("ImageProcessingDemo\\NaturalFruits.jpg")), &LeadBitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); 
   if(nRet != SUCCESS) 
      return nRet ; 
   nRet = L_OtsuThreshold(&LeadBitmap, 4); 
   nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Result.BMP")), &LeadBitmap, FILE_BMP, 24, 0, NULL); 
   if(nRet !=SUCCESS) 
      return nRet; 
   //free bitmap 
   if(LeadBitmap.Flags.Allocated) 
      L_FreeBitmap(&LeadBitmap); 
   return SUCCESS ; 
}

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 API Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

Functions:	L_LevelsetBitmapRgn, L_LambdaConnectedness, L_ShrinkWrapTool, L_WatershedBitmap, L_KMeansBitmapSegmentation, L_GWireGetMinPath
Topics:	Raster Image Functions: Doing Color Expansion or Reduction
	Raster Image Functions: Image Analysis
	Processing an Image
	Grayscale Images