MpatSetAngle()函数

Synopsis

Set the angular search control parameters of a model.

Format

void MpatSetAngle(ModelId, ControlType, ControlValue)

MIL_ID ModelId; Identifier of model to be affected
long ControlType; Type of control to set
double ControlValue; Value associated with control type

Description

This function sets the specified model’s angular search parameter.

The ModelId parameter specifies the identifier of the model for which to change the angular search parameter.

The ControlType and ControlValue parameters specify the type of control to set and the value to which to set it.

By default the ControlType M_SEARCH_ANGLE_MODE, is disabled and the search is done at 0° (no rotation). When enabled, the model is searched at angle, respecting all search control parameters, and the angle of the match producing the highest match score is returned.

The following ControlType/ControlValue combinations can be selected:

ControlType Control Value Description
M_SEARCH_ANGLE_MODE M_ENABLE or
M_DEFAULT (M_DISABLE)
Search at angle.
M_SEARCH_ANGLE 0.0° – 360.0° or
M_DEFAULT (0.0°)
see *
M_SEARCH_ANGLE_DELTA_NEG 0.0° – 180.0° or
M_DEFAULT (0.0°)
see *
M_SEARCH_ANGLE_DELTA_POS 0.0° – 180.0° or
M_DEFAULT (0.0°)
see *
* These angles determine the range of angles to cover in the search operation:
(M_SEARCH_ANGLE – M_SEARCH_ANGLE_DELTA_NEG) to
(M_SEARCH_ANGLE + M_SEARCH_ANGLE_DELTA_POS) inclusively,
starting at an angle close to M_SEARCH_ANGLE.
M_SEARCH_ANGLE_TOLERANCE 0.1° – 180.0° or M_DEFAULT The maximum angle at which a rotated model can be found and still meet the acceptance level (as set in MpatSetAcceptance).
When set to M_DEFAULT, tolerance is 5.0°.
M_SEARCH_ANGLE_ACCURACY 0.1° – 180.0°, M_DISABLE, or M_DEFAULT The desired precision of
the resulting angle.
When set to M_DISABLE or M_DEFAULT, equals the tolerance.
M_SEARCH_ANGLE_INTERPOLATION_MODE M_NEAREST_NEIGHBOR (M_DEFAULT), M_BILINEAR,
or M_BICUBIC
Determines the type of interpolation that is used when rotating the model.

See also

MpatSetAcceptance, MpatFindModel, MpatFindMultipleModel, MpatFindOrientation

《MpatSetAngle()函数》上有2条评论

评论已关闭。