1次エッジ検出クラス(箱指定)

Namespace: FVIL.Edge
Assembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)

Syntax

C#
[SerializableAttribute]
public class CFviBoxEdge : CFviEdge
Visual Basic
<SerializableAttribute>
Public Class CFviBoxEdge
	Inherits CFviEdge

Remarks

指定された箱上を走査して、画像データのエッジ検出を行うクラスです。


概要:

指定した箱を、 Number によって指定された数に分割して検出線を設定し、 それぞれの検出線上におけるエッジを計測します。 検出線の方向は、 ScanDirection によって指定され、 下図のように設定されます。

検出箱は Angle パラメータにて指定された角度だけ傾けて設定されます。 回転中心は Center パラメータで指定できます。 Center は検出箱の左上からの相対値となります。


【微分値作成方法】

本クラスは濃度投影を取得後、微分フィルタパラメータ( Len, Foot )に指定されたフィルタに従って微分データを作成します。 微分フィルタについては、 CFviEdgeFilter クラスの説明をご参照ください。 また、このクラスでは、微分値の取得の際にエッジ極性を使用します。 エッジ極性については、 EdgeDirection をご参照ください。


【サブピクセル値計算】

このクラスでのサブピクセル値計算は、閾値の設定により変化します。


◆ 閾値が 1~255 の場合

初めて閾値を超えた微分値位置と、 その前後(Around 個)の範囲の微分データに対して、 2次曲線近似を行います。 この近似2次曲線が Threshold に指定された値となる位置 (y=Threshold との交点)をサブピクセル位置とします。 交点が2つになる場合は、「初めて閾値を超えた微分値位置」に、より近い方を採用します。 但し、以下の場合はエラーとなります。

  • 2次曲線近似が出来なかった場合 -
  • Around 個分を足した範囲が微分データの範囲を超えてしまった場合 -
  • 近似2次曲線が y = Threshold と交わらなかった場合 -

◆ 閾値が -1 の場合

最大微分位置の前後で、( 最大微分値 * MaxThreshold / 100 ) を超える部分に、 更に前後(Around 個)のデータを加えた範囲における重み付き平均をサブピクセル値として求めます。 但し、この重み付き平均を求める範囲が、微分データの範囲を超えてしまった場合はエラーとなります。


関連:

要求する入出力画像数:
項目定数
入力画像1SrcImageCount フィールド
出力画像0DstImageCount フィールド

処理対象画像の条件:

処理対象の画像は下記の条件を満たしている必要が有ります。

  • 画像種別が FVIL.ImageType.UC8 である事 -
  • チャネル数が 1 である事 -

計測位置の設定:

計測位置の設定には、下記のプロパティを使用します。 計測位置が画像領域を超える場合は実行時にエラーとなります。
但し、画像の右端にパディングがある場合は、 画像の水平サイズを僅かに超えてもパラメータエラーとならない場合があります。 その場合は、画像右端とパディングの境界部分を誤検出する可能性があります。


検出結果:

検出結果は Result に格納されます。 検出結果から単一のエッジデータ (CFviEdgeData) を取得するには、 GetData(Int32) を使用してください。 エッジを1つも検出できなかった場合は、FVIL.ErrorCode.NOT_FOUND を通知します。

検出プロパティ内容範囲
Positionエッジ位置座標(画像座標)
×Valueエッジ強度-
×Directionエッジ極性方向-
×Angleエッジの勾配-
×Feature特徴量-

初期値と範囲:
プロパティ初期値範囲
Box0,0-100,100 Angle=0 Center=0,0画像の左上を 0,0 とする絶対座標
Number3 (本)3~
ScanDirectionFVIL.ScanDirection.RightScanDirection に定義された定数
Threshold-1-1,1~255
LineWidth0 (画素)0~
EdgeDirectionFVIL.Edge.Direction.BrightToDarkDirection に定義された定数
Len00~
Foot11~
Around2 (画素)0~
MaxThreshold75 (%)1~100

Examples


処理結果:


ソースコード:
C# Copy imageCopy
//    $Revision: 1.3 $

using System;
using System.Collections.Generic;
using System.Text;
using System.Drawing;
using fvalgcli;    // FvPluginXXXX attribute requires fvalgcli

namespace User.SampleCode
{
    public partial class Edge
    {
        /// <summary>
        /// エッジ検出 (矩形)
        /// </summary>
        [FvPluginExecute]
        public void BoxEdge()
        {
            // 1) インスタンスの準備.
            FVIL.Edge.CFviBoxEdge    parser = new FVIL.Edge.CFviBoxEdge();
            FVIL.Data.CFviImage    src = new FVIL.Data.CFviImage();

            // 2) 処理対象画像の取り込み.
            FVIL.File.Function.LoadImageFile(Defs.TestImageDir + "/disk_cd_01.png", src, FVIL.PixelMode.Unpacking);

            // 3) 処理対象画像の有効性検査.
            if( FVIL.ErrorCode._SUCCESS != FVIL.Edge.CFviBoxEdge.CheckValidity( src ) )
                return;

            // 4) 画像処理準備.
            parser.SrcImages[0] = src;

            // 5) パラメータ設定.
            parser.Box = new FVIL.Data.CFviRectangle(128,93, 187,147);
            parser.Number = 6;
            parser.LineWidth = 0;
            parser.Threshold = -1;
            parser.ScanDirection = FVIL.ScanDirection.Down;
            parser.EdgeDirection = FVIL.Edge.Direction.BrightToDark;
            parser.Foot = 1;
            parser.Len = 1;

            // 6) 画像処理実行.
            parser.Execute();

            // E) 確認用.
            {
                // 画像表示の準備.
                FVIL.GDI.CFviDisplay display = new FVIL.GDI.CFviDisplay();
                display.Image = src;
                display.DisplayRect = src.Window;

                // オーバレイの生成.
                FVIL.GDI.CFviOverlay pOverlay0 = new FVIL.GDI.CFviOverlay();
                pOverlay0.Scaling = true;
                display.Overlays.Add(pOverlay0);

                // 描画: 計測位置.
                {
                    // 矩形.
                    FVIL.GDI.CFviGdiRectangle rect = new FVIL.GDI.CFviGdiRectangle( parser.Box );
                    rect.Ed = new FVIL.Data.CFviPoint(rect.Ed.X + 1, rect.Ed.Y + 1);
                    rect.Pen.Color = System.Drawing.Color.FromArgb(0,0,255);    // 青.

                    double width = (parser.Box.Width+1) / parser.Number;

                    // 検出線.
                    List<FVIL.GDI.CFviGdiLineSegment> lines = new List<FVIL.GDI.CFviGdiLineSegment>();
                    for(int i=0 ; i<=parser.Number ; i++)
                    {
                        FVIL.GDI.CFviGdiLineSegment    ls = new FVIL.GDI.CFviGdiLineSegment();
                        // 下向きの線分.
                        ls.St = new FVIL.Data.CFviPoint(parser.Box.St.X + width * i, parser.Box.St.Y + 1);
                        ls.Ed = new FVIL.Data.CFviPoint(parser.Box.St.X + width * i, parser.Box.Ed.Y + 1);
                        ls.Pen.Color = System.Drawing.Color.FromArgb(255,255,0);    // 黄.
                        lines.Add( ls );
                    }

                    // 追加.
                    pOverlay0.Figures.Add( rect );
                    for(int i=0 ; i<lines.Count ; i++)
                        pOverlay0.Figures.Add( lines[i] );
                }

                // 描画: 検出位置.
                for (int i = 0; i < (parser.Result.Count); i++)
                {
                    FVIL.Edge.CFviEdgeData edge = parser.Result[i];

                    // +マーク
                    FVIL.GDI.CFviGdiPoint position = new FVIL.GDI.CFviGdiPoint( edge.Position );
                    position.Size = new Size( 3, 3 );
                    position.Style = FVIL.GDI.FigureStyle.Cross;
                    position.Pen.Color = Color.FromArgb(255,0,0);    // 赤.

                    // 追加.
                    pOverlay0.Figures.Add( position );
                }

                // 保存.
                FVIL.Data.CFviImage canvas = new FVIL.Data.CFviImage();
                display.SaveImage( canvas, display.DisplayRect, 1.0 );
                FVIL.File.Function.SaveImageFile(Defs.ResultDir + "/Edge.BoxEdge.png", canvas);
            }
        }
    };
}


Visual Basic Copy imageCopy
'    $Revision: 1.1 $

Imports System.Collections.Generic
Imports System.Text
Imports System.Drawing
Imports fvalgcli
' FvPluginXXXX attribute requires fvalgcli
Namespace SampleCode
    Public Partial Class Edge
        ''' <summary>
        ''' エッジ検出 (矩形)
        ''' </summary>
        <FvPluginExecute> _
        Public Sub BoxEdge()
            ' 1) インスタンスの準備.
            Dim parser As New FVIL.Edge.CFviBoxEdge()
            Dim src As New FVIL.Data.CFviImage()

            ' 2) 処理対象画像の取り込み.
            FVIL.File.[Function].LoadImageFile(Defs.TestImageDir & "/disk_cd_01.png", src, FVIL.PixelMode.Unpacking)

            ' 3) 処理対象画像の有効性検査.
            If FVIL.ErrorCode._SUCCESS <> FVIL.Edge.CFviBoxEdge.CheckValidity(src) Then
                Return
            End If

            ' 4) 画像処理準備.
            parser.SrcImages(0) = src

            ' 5) パラメータ設定.
            parser.Box = New FVIL.Data.CFviRectangle(128, 93, 187, 147)
            parser.Number = 6
            parser.LineWidth = 0
            parser.Threshold = -1
            parser.ScanDirection = FVIL.ScanDirection.Down
            parser.EdgeDirection = FVIL.Edge.Direction.BrightToDark
            parser.Foot = 1
            parser.Len = 1

            ' 6) 画像処理実行.
            parser.Execute()

            ' E) 確認用.
            If True Then
                ' 画像表示の準備.
                Dim display As New FVIL.GDI.CFviDisplay()
                display.Image = src
                display.DisplayRect = src.Window

                ' オーバレイの生成.
                Dim pOverlay0 As New FVIL.GDI.CFviOverlay()
                pOverlay0.Scaling = True
                display.Overlays.Add(pOverlay0)

                ' 描画: 計測位置.
                If True Then
                    ' 矩形.
                    Dim rect As New FVIL.GDI.CFviGdiRectangle(parser.Box)
                    rect.Ed = New FVIL.Data.CFviPoint(rect.Ed.X + 1, rect.Ed.Y + 1)
                    rect.Pen.Color = System.Drawing.Color.FromArgb(0, 0, 255)
                    ' 青.
                    Dim width As Double = (parser.Box.Width + 1) / parser.Number

                    ' 検出線.
                    Dim lines As New List(Of FVIL.GDI.CFviGdiLineSegment)()
                    For i As Integer = 0 To parser.Number
                        Dim ls As New FVIL.GDI.CFviGdiLineSegment()
                        ' 下向きの線分.
                        ls.St = New FVIL.Data.CFviPoint(parser.Box.St.X + width * i, parser.Box.St.Y + 1)
                        ls.Ed = New FVIL.Data.CFviPoint(parser.Box.St.X + width * i, parser.Box.Ed.Y + 1)
                        ls.Pen.Color = System.Drawing.Color.FromArgb(255, 255, 0)
                        ' 黄.
                        lines.Add(ls)
                    Next

                    ' 追加.
                    pOverlay0.Figures.Add(rect)
                    For i As Integer = 0 To lines.Count - 1
                        pOverlay0.Figures.Add(lines(i))
                    Next
                End If

                ' 描画: 検出位置.
                For i As Integer = 0 To (parser.Result.Count) - 1
                    Dim edge As FVIL.Edge.CFviEdgeData = parser.Result(i)

                    ' +マーク
                    Dim position As New FVIL.GDI.CFviGdiPoint(edge.Position)
                    position.Size = New Size(3, 3)
                    position.Style = FVIL.GDI.FigureStyle.Cross
                    position.Pen.Color = Color.FromArgb(255, 0, 0)
                    ' 赤.
                    ' 追加.
                    pOverlay0.Figures.Add(position)
                Next

                ' 保存.
                Dim canvas As New FVIL.Data.CFviImage()
                display.SaveImage(canvas, display.DisplayRect, 1.0)
                FVIL.File.[Function].SaveImageFile(Defs.ResultDir & "/Edge.BoxEdge.png", canvas)
            End If
        End Sub
    End Class
End Namespace

Inheritance Hierarchy

System..::..Object
FVIL..::..CFviObject
FVIL..::..CFviImageParser
FVIL.Edge..::..CFviEdge
FVIL.Edge..::..CFviBoxEdge

See Also