CogPMRedLinePattern GrainLimitFine Property Cognex VisionPro 9.25 SR1
Gets or sets the fine granularity limit. This is the minimum amount of subsampling that will be applied to the input image when PMRedLine searchs for instances of your pattern. If GrainLimitFineAutoSelect is "true" this granularity limit will be recomputed automatically when the pattern is trained, overwriting the previous value.

Namespace: Cognex.VisionPro.PMRedLine
Assembly: Cognex.VisionPro.PMRedLine (in Cognex.VisionPro.PMRedLine.dll) Version: 93.1.0.0
Syntax

public double GrainLimitFine { get; set; }

Property Value

Type: Double
The fine granularity limit. Default value is one.
Events

Event TypeReason
ICogChangedEvent Changed Fires when this property changes. The following state flags may be affected:
ICogChangedEvent Changed Fires when this property changes and the coarse granularity limit is also changed. The following state flags may be affected:
Exceptions

ExceptionCondition
ArgumentOutOfRangeException The supplied value is less than one.
Remarks

PMRedLine employs a multi-resolution search strategy: the tool will subsample your input image multiple times as it searches for instances of your pattern. The maximum amount of subsampling is specified by the coarse granularity limit. The minimum amount is specified by the fine granularity limit. Neither limit can be less than one.

The fine granularity limit must be less than or equal to the coarse granularity limit. Setting it to a value larger than the coarse granularity limit also sets the coarse limit to the new value.

If GrainLimitFineAutoSelect is "true" the fine granularity limit will be recomputed, and overwritten, whenever the pattern is trained. The computed value will never be larger than the coarse granularity limit.

If you change this value on a trained pattern object, the pattern will become untrained.

See Also