Synopsis
Allocate a blob analysis result buffer.
Format
MIL_ID MblobAllocResult(SystemId, BlobResIdPtr)
MIL_ID SystemId; | System identifier |
MIL_ID *BlobResIdPtr; | Storage location for blob analysis result buffer identifier |
Description
This function allocates a result buffer used to store blob analysis results.
Each blob creates a separate result entry in the blob analysis result buffer. You can retrieve blob analysis results from a result buffer, using MblobGetResult or MblobGetResultSingle. Use the latter to obtain results for a single blob. For more specific results, you can call MblobGetLabeland MblobGetRuns. When the result buffer is no longer required, release it, using MblobFree.
The SystemId parameter specifies the system on which the feature list will be allocated. This parameter must be set to a valid system identifier, M_DEFAULT_HOST or M_DEFAULT. To use the default Host system of the current MIL application, specify M_DEFAULT_HOST. If you specify M_DEFAULT, MIL will select the most appropriate system on which to allocate the buffer (it can be the Host system or any already allocated system).
The BlobResIdPtr parameter specifies the address of the variable in which the blob analysis result buffer identifier is to be written. Since the MblobAllocResult function also returns the blob analysis result buffer identifier, you can set this parameter to M_NULL.
The default processing modes for the result buffer are as follows:
Processing Mode | Default Value |
M_BLOB_IDENTIFY | M_INDIVIDUAL |
M_LATTICE | M_8_CONNECTED |
M_FOREGROUND_VALUE | M_NONZERO |
M_NUMBER_OF_FERETS | 8 |
M_PIXEL_ASPECT_RATIO | 1.0 |
M_IDENTIFIER_TYPE | M_GRAYSCALE |
Use MblobControl to change these values if necessary.
Returned value
The returned value is a blob analysis result buffer identifier that you will use in calculations and results inquiry.
See also
MblobFree, MblobControl, MblobCalculate, MblobGetNumber, MblobGetResult, MblobGetResultSingle, MblobGetLabel, MblobGetRuns