Polarity プロパティー

適用
ビジョンオブジェクト: ArcInspector、ArcFinder、Blob、BoxFinder、Contour、CornerFinder、DefectFinder、Edge、ImageOp、LineFinder、LineInspector, OCR

解説
Blob、ImageOp、OCRオブジェクトの場合、Polarityは、オブジェクトと背景の差を定義します。

Edge、LineFinder、ArcFinder、BoxFinder、CornerFinder、LineInspector、ArcInspectorオブジェクトの場合、Polarityは、エッジの方向を定義します。

DefectFinderの場合、検出する欠陥の極性を定義します。

用法

VGet  Sequence.Object.Polarity, var
VSet  Sequence.Object.Polarity, value

Sequence

シーケンス名かシーケンス名を示す文字列変数

Object

オブジェクト名かオブジェクト名を示す文字列変数。オブジェクトは指定されたシーケンスに存在していなければなりません。

var

プロパティーの値を示す整数変数

value

プロパティーの新しい値を示す整数または式

値

• Edge:

  • 1 - LightToDark
    • ビジョン定数: VISION_POLARITY_DARK
    • 明から暗になるエッジを検索します。
  • 2 - DarkToLight
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗から明になるエッジを検索します。
  • 3 - Both
    • ビジョン定数: VISION_POLARITY_BOTH
    • 明から暗になるエッジと、暗から明になるエッジの両方を検索します。

• Blob:

  • 1 - DarkOnLight
    • ビジョン定数: VISION_POLARITY_DARK
    • 明るい背景での暗いブローブを検索します。
  • 2 - LightOnDark
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗い背景での明るいブローブを検索します。

• ImageOp:

  • 1 - DarkOnLight
    • ビジョン定数: VISION_POLARITY_DARK
    • 暗いオブジェクトに対し操作を行います。
  • 2 - LightOnDark
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 明るいオブジェクトに対し操作を行います。

• LineFinder:

  • 1 - LightToDark
    • ビジョン定数: VISION_POLARITY_DARK
    • 明から暗になるエッジを検索します。
  • 2 - DarkToLight
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗から明になるエッジを検索します。
  • 3 - Both
    • ビジョン定数: VISION_POLARITY_BOTH
    • 明から暗になるエッジと、暗から明になるエッジの両方を検索します。

• ArcFinder:

  • 1 - LightToDark
    • ビジョン定数: VISION_POLARITY_DARK
    • 明から暗になるエッジを検索します。
  • 2 - DarkToLight
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗から明になるエッジを検索します。
  • 3 - Both
    • ビジョン定数: VISION_POLARITY_BOTH
    • 明から暗になるエッジと、暗から明になるエッジの両方を検索します。

• LineInspector:

  • 1 - LightToDark
    • ビジョン定数: VISION_POLARITY_DARK
    • 暗から明になるエッジを検索します。
  • 2 - DarkToLight
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗から明になるエッジを検索します。
  • 3 - Both
    • ビジョン定数: VISION_POLARITY_BOTH
    • 明から暗になるエッジと、暗から明になるエッジの両方を検索します。

• ArcInspector:

  • 1 - LightToDark
    • ビジョン定数: VISION_POLARITY_DARK
    • 明から暗になるエッジを検索します。
  • 2 - DarkToLight
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗から明になるエッジを検索します。
  • 3 - Both
    • ビジョン定数: VISION_POLARITY_BOTH
    • 明から暗になるエッジと、暗から明になるエッジの両方を検索します。

• OCR:

  • 1 - DarkOnLight
    • ビジョン定数: VISION_POLARITY_DARK
    • 明るい背景での暗い文字を検索します。
  • 2 - LightOnDark
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗い背景での明るい文字を検索します。

• BoxFinder:

  • 1 - LightToDark
    • ビジョン定数: VISION_POLARITY_DARK
    • 明から暗になるエッジを検索します。
  • 2 - DarkToLight
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗から明になるエッジを検索します。
  • 3 - Both
    • ビジョン定数: VISION_POLARITY_BOTH
    • 明から暗になるエッジと、暗から明になるエッジの両方を検索します。

• CornerFinder:

  • 1 - LightToDark
  • ビジョン定数: VISION_POLARITY_DARK
  • 明から暗になるエッジを検索します。
  • 2 - DarkToLight
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗から明になるエッジを検索します。
  • 3 - Both
    • ビジョン定数: VISION_POLARITY_BOTH
    • 明から暗になるエッジと、暗から明になるエッジの両方を検索します。

• Contour (Blobモード):

  • 1 - DarkOnLight
    • ビジョン定数: VISION_POLARITY_DARK
    • 明るい背景での暗いブローブを検索します。
  • 2 - LightOnDark
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗い背景での明るいブローブを検索します。

• Contour (Lineモード, Arcモード):

  • 1 - LightToDark
    • ビジョン定数: VISION_POLARITY_DARK
    • 明から暗になるエッジを検索します。
  • 2 - DarkToLight
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗から明になるエッジを検索します。

上記オブジェクトのデフォルト: 1

• DefectFinder:
  • 1 - DarkOnLight
    • ビジョン定数: VISION_POLARITY_DARK
    • 明るい背景での暗い欠陥を検索します。
  • 2 - LightOnDark
    • ビジョン定数: VISION_POLARITY_LIGHT
    • 暗い背景での明るい欠陥を検索します。
  • 3 - Both
    • ビジョン定数: VISION_POLARITY_BOTH
    • 明るい背景での暗い欠陥、暗い背景での明るい欠陥の両方を検索します。

DefectFinderのデフォルト: 3

詳細説明
Polarityプロパティーは、EdgeとBlobオブジェクトの主要なパラメーターを定義するので、これらのオブジェクトにとっては重要なプロパティーです。

Edgeツールの場合、Polarityは、エッジ検索の方向にしたがいエッジの明るさの移り変わりを定義します。

Blobオブジェクトの場合、Polarityはとても重要です。ビジョンシステムは、暗い背景での明るいオブジェクトを検索するのか、または明るい背景での暗いオブジェクトを検索するのか、指定する必要があります。Polarityプロパティーに適正な設定をしないと、Blobオブジェクトから不適切なリザルトが返ってきます。Blobオブジェクトが明るい背景での暗いオブジェクトを検出できるならば、その逆の暗い背景での明るいオブジェクトを検出することも可能です。

ThresholdHighとThresholdLowプロパティーも、ブローブ検索で効果の高いBlobオブジェクトツールです。詳しくは以下を参照してください。
ThresholdHigh プロパティー
ThresholdLow プロパティー

Contourオブジェクトの場合、ContourModeの設定によってPolarityの意味が異なります。

• ContourModeがBlobの場合: BlobオブジェクトのPolarityと同様にオブジェクトと背景の差を定義します。
• ContourModeがLine、またはArcの場合: EdgeツールのPolarityと同様にエッジの方向を定義します。

参照
Blobオブジェクト, Contourオブジェクト, DefectFinderオブジェクト, Direction プロパティー, Edgeオブジェクト, ImageOpオブジェクト, LineFinderオブジェクト, ArcFinderオブジェクト, LineInspectorオブジェクト, ArcInspectorオブジェクト, OCRオブジェクト, BoxFinderオブジェクト, CornerFinderオブジェクト, ThresholdLow プロパティー, ThresholdHigh プロパティー