| MIL 10 Reference
| Customize Help
| Save Settings

MblobSelectFeret


See also
Availability
Not available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
None.
MblobSelectFeature
MblobSelectMoment
Synopsis
Add Feret angle to the feature list.
Syntax
void MblobSelectFeret(
MIL_ID FeatureListId, //in
MIL_DOUBLE Angle //in
)
Description

This function specifies the angle of the general Feret to calculate if M_GENERAL_FERET (or one of its contact points) has been added to the feature list. The Feret diameter is then calculated at the specified angle, using MblobCalculate(). Results for this calculation can be obtained using MblobGetResult() or MblobGetResultSingle(), specifying M_GENERAL_FERET as the feature.

Note, the Feret diameters at 0° and 90° are calculated more efficiently if you select the features M_FERET_X and M_FERET_Y, respectively, using MblobSelectFeature(), instead of specifying them as a general Feret.

Note that if you don't explicitly add M_GENERAL_FERET to the feature list before calling this function, M_GENERAL_FERET will be added automatically.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
FeatureListId

Specifies the identifier of the feature list buffer.

Angle

Specifies the angle, in degrees, to be used for calculating the general Feret. It overrides any previous angle specified for the general Feret in this feature list.

function map For specifying the angle to be used in calculating the general Feret
CollapseValue Description
Collapse 0.0 <= Value <= 90.0 +

Specifies the angle, in degrees, to be used for the calculation of the general Feret.
Combination constants for 0.0 <= Value <= 90.0.

You can add one of the following values to the above-mentioned value to set the sorting key.

To select the general Feret as a sorting key for the result retrieval, add the following sorting values to the Angle parameter:

function map For selecting a sorting key
CollapseCombination value Description
Collapse M_NO_SORT

Removes the specified sorting key.
Collapse M_SORTn_DOWN

Specifies the feature as the n th sorting key (in descending order), where n stands for an integer between 1 and 3.
Collapse M_SORTn_UP

Specifies the feature as the n th sorting key (in ascending order), where n stands for an integer between 1 and 3.
Compilation information
Header Include mil.h.
Library Use mil.lib; milblob.lib.
DLL Requires mil.dll; milblob.dll.
NO SORT SORTn DOWN SORTn UP