非極大値の抑制（Canny 法によるエッジ検出で利用）

Namespace: fvalgcli
Assembly: fvalgcli (in fvalgcli.dll) Version: 3.1.0.0 (3.1.0.11)

Syntax

C#
public static int fnFIE_nms_canny(
	FHANDLE hMagX,
	FHANDLE hMagY,
	FHANDLE hMag,
	double dTLow,
	double dTHigh,
	ref ushort ushpTLow,
	ref ushort ushpTHigh
)
Visual Basic
Public Shared Function fnFIE_nms_canny ( 
	hMagX As FHANDLE,
	hMagY As FHANDLE,
	hMag As FHANDLE,
	dTLow As Double,
	dTHigh As Double,
	ByRef ushpTLow As UShort,
	ByRef ushpTHigh As UShort
) As Integer

Parameters

hMagX
Type: fvalgcli..::..FHANDLE
X方向のエッジ勾配強度画像 ( type: s16 )
hMagY
Type: fvalgcli..::..FHANDLE
Y方向のエッジ勾配強度画像 ( type: s16 )
hMag
Type: fvalgcli..::..FHANDLE
エッジ勾配強度画像 (type: us16)
dTLow
Type: System..::..Double
ピクセル数の下限方向の割合を決定するための閾値　
dTHigh
Type: System..::..Double
ピクセル数の上限方向の割合を決定するための閾値
  • 0 ＜ dTLow ＜ 1.0 ＆＆ 0 ＜ dTHigh ＜ 1.0
  • dTLow ＜ dTHigh or dTLow == dTHigh == 0.0
ushpTLow
Type: System..::..UInt16%
dTLow から得られた下限閾値
ushpTHigh
Type: System..::..UInt16%
dTHigh から得られた上限閾値

Return Value

Type: Int32
以下のエラーコードを返します。

エラーコード：
f_err内容
F_ERR_NONE正常終了
F_ERR_INVALID_PARAM不正なパラメータが渡された （ dTHigh ≦ dTLow ＆＆ ( dTHigh != 0.0 ＆＆ dTLow != 0.0 ) ) or ( dTHigh　≧ 1 || dTLow ≧ 1 || dTHigh ＜ 0 || dTLow ＜ 0 )
F_ERR_INVALID_IMAGE不正な画像が渡された 各画像のサイズが違う(縦横サイズ、チャネル数) 不正な画像が渡された 画像横縦サイズはいずれが3以下 画像のチャンネル数は1以上
F_ERR_NOMEMORYバッファーメモリ配分失敗画像オブジェクトの異常
F_ERR_NO_LICENCEライセンスエラー、または未初期化エラー

Examples

C# Copy imageCopy
//    $Revision: 1.1 $

using System;
using System.Collections.Generic;
using System.Text;
using fvalgcli;

namespace TC
{
    public partial class FIE
    {
        [FvPluginExecute]
        public void fnFIE_nms_canny()
        {
            string filepath = TestImageDir + "/TC/SampleCode/floppy_UC8.jpg";

            FHANDLE hSrc = FHANDLE.Zero;
            FHANDLE hMagX = FHANDLE.Zero;
            FHANDLE hMagY = FHANDLE.Zero;
            FHANDLE hThin = FHANDLE.Zero;

            try
            {
                api.fnFIE_load_jpeg(filepath, ref hSrc, f_color_img_type.F_COLOR_IMG_TYPE_UC8);

                hMagX = api.fnFIE_img_root_alloc((int)f_imgtype.F_IMG_S16, 1, api.fnFIE_img_get_width(hSrc), api.fnFIE_img_get_height(hSrc));
                hMagY = api.fnFIE_img_root_alloc((int)f_imgtype.F_IMG_S16, 1, api.fnFIE_img_get_width(hSrc), api.fnFIE_img_get_height(hSrc));
                hThin = api.fnFIE_img_root_alloc((int)f_imgtype.F_IMG_US16, 1, api.fnFIE_img_get_width(hSrc), api.fnFIE_img_get_height(hSrc));

                api.fnFIE_sobel(hSrc, hMagX, f_sobel_mode.F_SOBEL_X_MODE, f_border_mode.F_BORDER_NONE, 0.0);
                api.fnFIE_sobel(hSrc, hMagY, f_sobel_mode.F_SOBEL_Y_MODE, f_border_mode.F_BORDER_NONE, 0.0);

                double dTLow = 0.2;
                double dTHigh = 0.5;
                ushort ushpTLow = 0;
                ushort ushpTHigh = 0;

                int status = api.fnFIE_nms_canny(hMagX, hMagY, hThin, dTLow, dTHigh, ref ushpTLow, ref ushpTHigh);
                Assert.IsTrue(status == (int)fvalgcli.f_err.F_ERR_NONE, "fnFIE_nms_canny: エラーが発生しました。({0})", (fvalgcli.f_err)status);
                Console.WriteLine("fnFIE_nms_canny");
                Console.WriteLine("ushpTLow={0}", ushpTLow);
                Console.WriteLine("ushpTHigh={0}", ushpTHigh);
            }
            finally
            {
                hSrc.Dispose();
                hMagX.Dispose();
                hMagY.Dispose();
                hThin.Dispose();
            }
        }
    }
}

Visual Basic Copy imageCopy
'    $Revision: 1.1 $

Imports System.Collections.Generic
Imports System.Text
Imports fvalgcli

Public Partial Class FIE
    <FvPluginExecute> _
    Public Sub fnFIE_nms_canny()
        Dim filepath As String = TestImageDir & "/TC/SampleCode/floppy_UC8.jpg"

        Dim hSrc As FHANDLE = FHANDLE.Zero
        Dim hMagX As FHANDLE = FHANDLE.Zero
        Dim hMagY As FHANDLE = FHANDLE.Zero
        Dim hThin As FHANDLE = FHANDLE.Zero

        Try
            api.fnFIE_load_jpeg(filepath, hSrc, f_color_img_type.F_COLOR_IMG_TYPE_UC8)

            hMagX = api.fnFIE_img_root_alloc(CInt(f_imgtype.F_IMG_S16), 1, api.fnFIE_img_get_width(hSrc), api.fnFIE_img_get_height(hSrc))
            hMagY = api.fnFIE_img_root_alloc(CInt(f_imgtype.F_IMG_S16), 1, api.fnFIE_img_get_width(hSrc), api.fnFIE_img_get_height(hSrc))
            hThin = api.fnFIE_img_root_alloc(CInt(f_imgtype.F_IMG_US16), 1, api.fnFIE_img_get_width(hSrc), api.fnFIE_img_get_height(hSrc))

            api.fnFIE_sobel(hSrc, hMagX, f_sobel_mode.F_SOBEL_X_MODE, f_border_mode.F_BORDER_NONE, 0.0)
            api.fnFIE_sobel(hSrc, hMagY, f_sobel_mode.F_SOBEL_Y_MODE, f_border_mode.F_BORDER_NONE, 0.0)

            Dim dTLow As Double = 0.2
            Dim dTHigh As Double = 0.5
            Dim ushpTLow As UShort = 0
            Dim ushpTHigh As UShort = 0

            Dim status As Integer = api.fnFIE_nms_canny(hMagX, hMagY, hThin, dTLow, dTHigh, ushpTLow, _
                ushpTHigh)
            Assert.IsTrue(status = CInt(fvalgcli.f_err.F_ERR_NONE), "fnFIE_nms_canny: エラーが発生しました。({0})", CType(status, fvalgcli.f_err))
            Console.WriteLine("fnFIE_nms_canny")
            Console.WriteLine("ushpTLow={0}", ushpTLow)
            Console.WriteLine("ushpTHigh={0}", ushpTHigh)
        Finally
            hSrc.Dispose()
            hMagX.Dispose()
            hMagY.Dispose()
            hThin.Dispose()
        End Try
    End Sub
End Class

See Also