MblobAllocFeatureList()函数

Synopsis

Allocate a blob analysis feature list.

Format

MIL_ID MblobAllocFeatureList(SystemId, FeatureListIdPtr)

MIL_ID SystemId; System identifier
MIL_ID *FeatureListIdPtr; Storage location for feature list identifier

Description

This function allocates a feature list. The feature list holds the feature(s) to be calculated by MblobCalculate. You must specify which feature(s) to calculate, using MblobSelectFeature, MblobSelectFeret, and MblobSelectMoment. Immediately after allocation, no features are selected in the feature list. When the feature list 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 FeatureListIdPtr parameter specifies the address of the variable in which the feature list identifier will be written. Since the MblobAllocFeatureList function also returns the feature list identifier, you can set this parameter to M_NULL.

Returned value

The returned value is the feature list identifier that you will use to select features to be calculated.

See also

MblobSelectFeature, MblobSelectMoment, MblobSelectFeret, MblobCalculate, MblobFreeSynopsis

Allocate a blob analysis feature list.

Format

MIL_ID MblobAllocFeatureList(SystemId, FeatureListIdPtr)

MIL_ID SystemId; System identifier
MIL_ID *FeatureListIdPtr; Storage location for feature list identifier

Description

This function allocates a feature list. The feature list holds the feature(s) to be calculated by MblobCalculate. You must specify which feature(s) to calculate, using MblobSelectFeature, MblobSelectFeret, and MblobSelectMoment. Immediately after allocation, no features are selected in the feature list. When the feature list 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 FeatureListIdPtr parameter specifies the address of the variable in which the feature list identifier will be written. Since the MblobAllocFeatureList function also returns the feature list identifier, you can set this parameter to M_NULL.

Returned value

The returned value is the feature list identifier that you will use to select features to be calculated.

See also

MblobSelectFeature, MblobSelectMoment, MblobSelectFeret, MblobCalculate, MblobFree