DetailLevel Property

Applies To
Vision Objects: Geometric

Description
Selects the level at which an edge is considered found during the geometric search.

Usage

VGet  Sequence.Object.DetailLevel, var
VSet  Sequence.Object.DetailLevel, value
Sequence
Name of a sequence or string variable containing a sequence name.
Object
Name of an object or string variable containing an object name. The object must exist in the specified sequence.
var
Integer variable that will contain the value of the property.
value
Integer value or expression for the new value of the property.

Values

  • 1 - Medium
    • Vision constant: VISION_DETAILLEVEL_MEDIUM
  • 2 - High
    • Vision constant: VISION_DETAILLEVEL_HIGH
  • 3 - Very High
    • Vision constant: VISION_DETAILLEVEL_VERYHIGH

Default: 1 - Medium

Remarks
The DetailLevel property determines what is considered an edge during the search. Edges are defined by the transition in grayscale value between adjacent pixels. The default level (Medium) offers a robust detection of active edges from images with contrast variation, noise, and non-uniform illumination. Nevertheless, in cases where objects of interest have a very low contrast compared to high contrast areas in the image, some low contrast edges can be missed. If your images contain low-contrast objects, a detail level setting of High should be used to ensure the detection of all important edges in the image. The Very High setting performs an exhaustive edge extraction, including very low contrast edges. However, it should be noted that this mode is very sensitive to noise.

The Smoothness property also affects how edges are extracted.

See Also
Geometric Object, Smoothness Property