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つになる場合は、「初めて閾値を超えた微分値位置」に、より近い方を採用します。 但し、以下の場合はエラーとなります。
◆ 閾値が -1 の場合
最大微分位置の前後で、( 最大微分値 * MaxThreshold / 100 ) を超える部分に、 更に前後(Around 個)のデータを加えた範囲における重み付き平均をサブピクセル値として求めます。 但し、この重み付き平均を求める範囲が、微分データの範囲を超えてしまった場合はエラーとなります。
関連:
- Threshold -
- Around -
- MaxThreshold -
要求する入出力画像数:
項目 | 数 | 定数 |
---|---|---|
入力画像 | 1 | SrcImageCount フィールド |
出力画像 | 0 | DstImageCount フィールド |
処理対象画像の条件:
処理対象の画像は下記の条件を満たしている必要が有ります。
- 画像種別が FVIL.ImageType.UC8 である事 -
- チャネル数が 1 である事 -
計測位置の設定:
計測位置の設定には、下記のプロパティを使用します。
計測位置が画像領域を超える場合は実行時にエラーとなります。
但し、画像の右端にパディングがある場合は、
画像の水平サイズを僅かに超えてもパラメータエラーとならない場合があります。
その場合は、画像右端とパディングの境界部分を誤検出する可能性があります。
検出結果:
検出結果は Result に格納されます。 検出結果から単一のエッジデータ (CFviEdgeData) を取得するには、 GetData(Int32) を使用してください。 エッジを1つも検出できなかった場合は、FVIL.ErrorCode.NOT_FOUND を通知します。
初期値と範囲:
プロパティ | 初期値 | 範囲 |
---|---|---|
Box | 0,0-100,100 Angle=0 Center=0,0 | 画像の左上を 0,0 とする絶対座標 |
Number | 3 (本) | 3~ |
ScanDirection | FVIL.ScanDirection.Right | ScanDirection に定義された定数 |
Threshold | -1 | -1,1~255 |
LineWidth | 0 (画素) | 0~ |
EdgeDirection | FVIL.Edge.Direction.BrightToDark | Direction に定義された定数 |
Len | 0 | 0~ |
Foot | 1 | 1~ |
Around | 2 (画素) | 0~ |
MaxThreshold | 75 (%) | 1~100 |
Examples
処理結果:
ソースコード:
C# | Copy |
---|---|
// $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 |
---|---|
' $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
FVIL..::..CFviObject
FVIL..::..CFviImageParser
FVIL.Edge..::..CFviEdge
FVIL.Edge..::..CFviBoxEdge