1次元エッジ検出クラス(円弧上)
Namespace: FVIL.EdgeAssembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)
Syntax
C# |
---|
[SerializableAttribute] public class CFviArcEdge : CFviEdge |
Visual Basic |
---|
<SerializableAttribute> Public Class CFviArcEdge Inherits CFviEdge |
Remarks
指定された円弧上を走査して、画像データのエッジ検出を行うクラスです。
概要:
円弧の 始点角 と 終点角 は、 必ず 始点角<終点角 となるように指定してください。 この為、円弧の指定は必ず時計回りとなります。反時計回りとなる指定は出来ません。 また、角度は 0~360 の制限が有りませんので、360 をまたぐ円弧を指定する場合には、 始点角=180, 終点角=540 というように指定してください。
【エッジ位置探索法】
- 与えられた濃度データから、微分絶対値を求めます。 -
- 上記 1 の微分値の中で、最小値と最大値を求めます。 -
- 最小値と最大値の差が MinThreshold よりも小さかった場合はエラーとなります。 -
- 微分値が(最小値+(最大値-最小値)/2) を超える各山で重み付き平均を求め、サブピクセルエッジ位置を求めます。 -
- 並び替えモード が『エッジ強度順』の場合は、 4 で求めたエッジ位置を強度の大きい順に並べ替えます。 -
要求する入出力画像数:
項目 | 数 | 定数 |
---|---|---|
入力画像 | 1 | SrcImageCount フィールド |
出力画像 | 0 | DstImageCount フィールド |
処理対象画像の条件:
処理対象の画像は下記の条件を満たしている必要が有ります。
- 画像種別が FVIL.ImageType.UC8 である事 -
- チャネル数が 1 である事 -
計測位置の設定:
計測位置の設定には、下記のプロパティを使用します。
計測位置が画像領域を超える場合は実行時にエラーとなります。
但し、画像の右端にパディングがある場合は、
画像の水平サイズを僅かに超えてもパラメータエラーとならない場合があります。
その場合は、画像右端とパディングの境界部分を誤検出する可能性があります。
検出結果:
検出結果は Result に格納されます。 検出結果から単一のエッジデータ (CFviEdgeData) を取得するには、 GetData(Int32) を使用してください。 エッジを1つも検出できなかった場合は、FVIL.ErrorCode.NOT_FOUND を通知します。
初期値と範囲:
プロパティ | 初期値 | 範囲 |
---|---|---|
Center | 0,0 | 画像の左上を 0,0 とする絶対座標 |
Radius | 1 | 任意 |
AngleSt | 0 | 始点角<終点角 |
AngleEd | 360 | 始点角<終点角 |
MinThreshold | 1 | 1~ |
DetectMode | FVIL.Edge.DetectMode.Order | DetectMode に定義された定数 |
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 ArcEdge() { // 1) インスタンスの準備. FVIL.Edge.CFviArcEdge parser = new FVIL.Edge.CFviArcEdge(); 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.CFviArcEdge.CheckValidity( src ) ) return; // 4) 画像処理準備. parser.SrcImages[0] = src; // 5) パラメータ設定. parser.Center = new FVIL.Data.CFviPoint(156, 123); parser.Radius = 48; parser.AngleSt = new FVIL.Data.CFviAngle(230); parser.AngleEd = new FVIL.Data.CFviAngle(390); parser.MinThreshold = 1; parser.DetectMode = FVIL.Edge.DetectMode.Order; // 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.Data.CFviLineSegment ls = new FVIL.Data.CFviLineSegment(); // 中心. FVIL.GDI.CFviGdiPoint center = new FVIL.GDI.CFviGdiPoint( parser.Center ); center.Size = new Size( 3, 3 ); center.Style = FVIL.GDI.FigureStyle.Cross; center.Pen.Color = Color.FromArgb(0,0,255); // 青. // 円周. FVIL.GDI.CFviGdiCircle arc = new FVIL.GDI.CFviGdiCircle( new FVIL.Data.CFviCircle(parser.Center, parser.Radius) ); arc.Pen.Color = Color.FromArgb(255,255,0); // 黄. // 始点. ls.St = parser.Center; ls.Ed = new FVIL.Data.CFviPoint( ls.St.X+parser.Radius, ls.St.Y ); // 0°の線分. FVIL.GDI.CFviGdiLineSegment st = new FVIL.GDI.CFviGdiLineSegment( ls ); st.Pen.Color = Color.FromArgb(0,255,0); // 緑. st.Pen.Style = FVIL.GDI.PenStyle.Dot; // 点線. st.Angle = parser.AngleSt; // 傾き. // 終点. ls.St = parser.Center; ls.Ed = new FVIL.Data.CFviPoint( ls.St.X+parser.Radius, ls.St.Y ); // 0°の線分. FVIL.GDI.CFviGdiLineSegment ed = new FVIL.GDI.CFviGdiLineSegment( ls ); ed.Pen.Color = Color.FromArgb(0,255,0); // 緑. ed.Angle = parser.AngleEd; // 傾き. // 追加. pOverlay0.Figures.Add(center); pOverlay0.Figures.Add(arc); pOverlay0.Figures.Add(st); pOverlay0.Figures.Add(ed); } // 描画: 検出位置. 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.ArcEdge.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 ArcEdge() ' 1) インスタンスの準備. Dim parser As New FVIL.Edge.CFviArcEdge() 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.CFviArcEdge.CheckValidity(src) Then Return End If ' 4) 画像処理準備. parser.SrcImages(0) = src ' 5) パラメータ設定. parser.Center = New FVIL.Data.CFviPoint(156, 123) parser.Radius = 48 parser.AngleSt = New FVIL.Data.CFviAngle(230) parser.AngleEd = New FVIL.Data.CFviAngle(390) parser.MinThreshold = 1 parser.DetectMode = FVIL.Edge.DetectMode.Order ' 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 ls As New FVIL.Data.CFviLineSegment() ' 中心. Dim center As New FVIL.GDI.CFviGdiPoint(parser.Center) center.Size = New Size(3, 3) center.Style = FVIL.GDI.FigureStyle.Cross center.Pen.Color = Color.FromArgb(0, 0, 255) ' 青. ' 円周. Dim arc As New FVIL.GDI.CFviGdiCircle(New FVIL.Data.CFviCircle(parser.Center, parser.Radius)) arc.Pen.Color = Color.FromArgb(255, 255, 0) ' 黄. ' 始点. ls.St = parser.Center ls.Ed = New FVIL.Data.CFviPoint(ls.St.X + parser.Radius, ls.St.Y) ' 0°の線分. Dim st As New FVIL.GDI.CFviGdiLineSegment(ls) st.Pen.Color = Color.FromArgb(0, 255, 0) ' 緑. st.Pen.Style = FVIL.GDI.PenStyle.Dot ' 点線. st.Angle = parser.AngleSt ' 傾き. ' 終点. ls.St = parser.Center ls.Ed = New FVIL.Data.CFviPoint(ls.St.X + parser.Radius, ls.St.Y) ' 0°の線分. Dim ed As New FVIL.GDI.CFviGdiLineSegment(ls) ed.Pen.Color = Color.FromArgb(0, 255, 0) ' 緑. ed.Angle = parser.AngleEd ' 傾き. ' 追加. pOverlay0.Figures.Add(center) pOverlay0.Figures.Add(arc) pOverlay0.Figures.Add(st) pOverlay0.Figures.Add(ed) 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.ArcEdge.png", canvas) End If End Sub End Class End Namespace |
Inheritance Hierarchy
System..::..Object
FVIL..::..CFviObject
FVIL..::..CFviImageParser
FVIL.Edge..::..CFviEdge
FVIL.Edge..::..CFviArcEdge
FVIL..::..CFviObject
FVIL..::..CFviImageParser
FVIL.Edge..::..CFviEdge
FVIL.Edge..::..CFviArcEdge