CogPMRedLinePattern GrainLimitCoarse Property Cognex VisionPro 9.24
Gets or sets the coarse granularity limit. This is the maximum amount of subsampling that will be applied to the input image when PMRedLine searchs for instances of your pattern. If GrainLimitCoarseAutoSelect 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: 91.0.0.0
Syntax

public double GrainLimitCoarse { get; set; }

Property Value

Type: Double
The coarse granularity limit. Default value is two.
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 fine 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 coarse granularity limit must be greater than or equal to the fine granularity limit. Setting it to a value smaller than the fine granularity limit also sets the fine limit to the new value.

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

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

See Also