L_MrcCreateNewSegment

#include "ltsgm.h"

L_LTSGM_API L_INT L_MrcCreateNewSegment(hSegment, pBitmap, pSegment)

HSEGMENTATION hSegment;	segmentation handle
pBITMAPHANDLE pBitmap;	pointer to a bitmap handle
pSEGMENTDATA pSegment;	pointer to a structure

Manually adds a new segment and sets the segment information.

Parameter	Description
hSegment	An existing segmentation handle. This handle is obtained by calling the L_MrcStartBitmapSegmentation function.
pBitmap	Pointer to the bitmap in which the segment will be created.
pSegment	Pointer to the SEGMENTDATA structure that contains the segment information.

Returns

>= 0	Index of the newly added segment. The function was successful.
< 0	An error occurred. Refer to Return Codes.

Comments

Use this function to manually add a new segment using the coordinates and type specified in pSegment.

Call the L_MrcStartBitmapSegmentation function before using any of the segmentation functions. When the handle to the segmentation is no longer needed, free it by calling the L_MrcStopBitmapSegmentation function.

Required DLLs and Libraries

LTSGM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Example

Manual segmentation example.

L_INT MrcCreateNewSegmentExample(pBITMAPHANDLE pBitmap) 
{ 
   L_INT          nRet; 
   HSEGMENTATION  hSegmentation; 
   SEGMENTDATA    Segment; 
   /* start the segmentation process */ 
   nRet = L_MrcStartBitmapSegmentation (&hSegmentation, pBitmap, RGB(255, 255, 255), RGB(0, 0, 0)); 
   if (nRet != SUCCESS) 
      return nRet; 
   memset(&Segment, 0, sizeof(SEGMENTDATA)); 
   Segment.uStructSize = sizeof(SEGMENTDATA); 
   SetRect(&Segment.rcBitmapSeg, 20, 20, 60, 60); 
   Segment.uType = SEGTYPE_PICTURE; 
   /* Create a new segment */ 
   nRet = L_MrcCreateNewSegment(hSegmentation, pBitmap, &Segment); 
   if (nRet < 0) 
      return nRet; 
   /* End the segmentation process */ 
   nRet = L_MrcStopBitmapSegmentation (hSegmentation); 
   if (nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
}

Help Version 19.0.2017.10.27

Functions:	L_MrcStartBitmapSegmentation, L_MrcStopBitmapSegmentation, L_MrcEnumSegments, L_MrcSaveSegmentation, L_MrcLoadSegmentation, L_MrcCopySegmentationHandle, L_MrcSegmentBitmap
Topics:	Manual Segmentation
	MRC Bitmap Functions: Manual Segmentation