エッジ点の連結

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

Syntax

C#
public static int fnFIE_edge_connecting2(
	F_DEDGE_PTR pedges,
	int edge_num,
	double angle_range,
	int distance_range,
	int min_clust_elem,
	int max_clust_elem,
	ref F_EDGE_CLUST_PTR ppedge_clust,
	ref int pclust_num
)
Visual Basic
Public Shared Function fnFIE_edge_connecting2 ( 
	pedges As F_DEDGE_PTR,
	edge_num As Integer,
	angle_range As Double,
	distance_range As Integer,
	min_clust_elem As Integer,
	max_clust_elem As Integer,
	ByRef ppedge_clust As F_EDGE_CLUST_PTR,
	ByRef pclust_num As Integer
) As Integer

Parameters

pedges
Type: fvalgcli..::..F_DEDGE_PTR
エッジ点の配列
edge_num
Type: System..::..Int32
エッジ点の個数 ( 2 ≦ edge_num )
angle_range
Type: System..::..Double
探索角度範囲 ( 単位: radian , 0 ＜ angle_range ≦ $\pi$ )
distance_range
Type: System..::..Int32
探索距離範囲 ( 単位: pixel , 0 ＜ distance_range )
min_clust_elem
Type: System..::..Int32
クラスタに属するエッジ点個数の最小値 ( 2 ≦ min_clust_elem )
max_clust_elem
Type: System..::..Int32
クラスタに属するエッジ点個数の最大値 ( min_clust_elem ≦ max_clust_elem ,ただし max_clust_elem ＜ 0 とした場合は無制限 )
ppedge_clust
Type: fvalgcli..::..F_EDGE_CLUST_PTR%
抽出した曲線の情報 ( クラスタ ) の配列 ( 初期値は IntPtr.Zero を指定 )
pclust_num
Type: System..::..Int32%
抽出した曲線の個数

Return Value

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

エラーコード：
f_err内容
F_ERR_NONE正常終了
F_ERR_INVALID_PARAMパラメータ異常
F_ERR_NOMEMORYメモリ不足エラー
F_ERR_NO_LICENCEライセンスエラー

Examples

C# Copy imageCopy
using System;
using System.Collections.Generic;
using System.Text;
using fvalgcli;

namespace TC
{
    public partial class FIE
    {
        [FvPluginExecute]
        public void fnFIE_edge_connecting2()
        {
            int status = (int)f_err.F_ERR_NONE;

            FHANDLE hsrc = FHANDLE.Zero;

            // ２次元エッジ抽出用.
            F_DEDGE_PTR edges = F_DEDGE_PTR.Zero;
            int edge_num = 0;

            // エッジ点群連結用.
            F_EDGE_CLUST_PTR clust = F_EDGE_CLUST_PTR.Zero;
            int clust_num = 0;

            try
            {
                // 入力画像の読み込み.
                // 適当な画像を読み込んでください.
                api.fnFIE_load_png(TestImageDir + "/testdata/camcalib_1_uc8.png", ref hsrc, f_color_img_type.F_COLOR_IMG_TYPE_UC8);

                // ２次元エッジ抽出(相関エッジ)用パラメータの設定.
                var param = F_EDGE_CORR_PARAMS.init(13, 5, 25.0, 1.0, 160, 6);
                var offset = DPNT_T.init(0, 0);

                // ２次元エッジ抽出(相関エッジ)
                api.fnFIE_edge_corr_subpix(
                        hsrc,
                        FHANDLE.Zero,
                        ref param,
                        f_edge_feature_mode.F_EDGE_FEAT_DIRECT,
                        f_border_mode.F_BORDER_CONTINUOUS,
                        offset,
                        ref edges,
                        ref edge_num
                    );

                // エッジ点群の連結用パラメータの設定.
                double angle_range = System.Math.PI / 2;
                int distance_range = 5;
                int min_clust_elem = 3;
                int max_clust_elem = -1; 

                // エッジ点群の連結.
                status = api.fnFIE_edge_connecting2(
                    edges, edge_num,
                    angle_range, distance_range, min_clust_elem, max_clust_elem,
                    ref clust, ref clust_num
                    );

                // エラー判定.
                Assert.IsTrue(status == (int)f_err.F_ERR_NONE, "エラーが発生しました。({0})", (f_err)status);

                // 確認用.
                var hdraw_image = fnPRV_draw_edge_clust(hsrc, edges, clust, clust_num);
                api.fnFIE_save_png(ResultDir + "/fnFIE_edge_connecting2.png", hdraw_image, -1);
                hdraw_image.Dispose();
            }
            finally
            {
                // オブジェクトの開放.
                hsrc.Dispose();
                edges.Dispose();
                api.fnFIE_free_edge_clust(clust, clust_num);
            }
        }
    }
}

確認用の描画処理:
C# Copy imageCopy
using System;
using System.Collections.Generic;
using System.Text;
using fvalgcli;

namespace TC
{
    public partial class FIE
    {
        /// <summary>
        /// 連結された曲線を色を変えて入力画像上に描画する.
        /// </summary>
        /// <param name="hsrc">元画像</param>
        /// <param name="edges">エッジ点群</param>
        /// <param name="clust">クラスタ</param>
        /// <param name="clust_num">クラスタ数</param>
        /// <returns>
        ///        描画結果の画像。解放必要。
        /// </returns>
        private FHANDLE fnPRV_draw_edge_clust(FHANDLE hsrc, F_DEDGE_PTR edges, F_EDGE_CLUST_PTR clust, int clust_num)
        {
            FHANDLE hdst = FHANDLE.Zero;

            // 連結して生成された曲線描画用.
            double[,] colors =
            {
                {   0.0,   0.0, 255.0 },
                {   0.0,   0.0, 128.0 },
                {   0.0, 255.0,   0.0 },
                { 255.0, 255.0,   0.0 },
                { 255.0, 165.0,   0.0 },
                { 255.0,   0.0,   0.0 },
                { 255.0, 192.0, 203.0 },
                { 176.0,  48.0,  96.0 },
                {   0.0, 255.0, 255.0 },
                { 160.0,  32.0, 240.0 },
                { 255.0,   0.0, 255.0 },
                {   0.0, 100.0,   0.0 },
            };

            FHANDLE hdst0 = FHANDLE.Zero;
            FHANDLE hdst1 = FHANDLE.Zero;
            FHANDLE hdst2 = FHANDLE.Zero;
            DOUBLE_PTR color = DOUBLE_PTR.Zero;
            DPNT_T_PTR points = DPNT_T_PTR.Zero;

            try
            {
                // 入力画像の情報取得.
                int width = api.fnFIE_img_get_width(hsrc);
                int height = api.fnFIE_img_get_height(hsrc);

                // 出力画像の生成.
                hdst = api.fnFIE_img_root_alloc((int)f_imgtype.F_IMG_UC8, 3, width, height);

                hdst0 = api.fnFIE_img_child_alloc_single_ch(hdst, 0, 0, 0, width, height);    // CH0
                hdst1 = api.fnFIE_img_child_alloc_single_ch(hdst, 1, 0, 0, width, height);    // CH1
                hdst2 = api.fnFIE_img_child_alloc_single_ch(hdst, 2, 0, 0, width, height);    // CH2
                api.fnFIE_img_copy_ex(hsrc, hdst0, 1, 0, 0);
                api.fnFIE_img_copy_ex(hsrc, hdst1, 1, 0, 0);
                api.fnFIE_img_copy_ex(hsrc, hdst2, 1, 0, 0);

                // 描画色.
                color = DOUBLE_PTR.alloc(3);    // R,G,B

                for (int i = 0; i < clust_num; i++)
                {
                    color[0] = colors[i % 4, 0];
                    color[1] = colors[i % 4, 1];
                    color[2] = colors[i % 4, 2];

                    int num = clust[i].num - 1;
                    for (int j = 0; j < num; j++)
                    {
                        int index0 = clust[i].pindex[j + 0];
                        int index1 = clust[i].pindex[j + 1];
                        DPNT_T st = DPNT_T.init(edges[index0].x, edges[index0].y);
                        DPNT_T ed = DPNT_T.init(edges[index1].x, edges[index1].y);

                        // 描画.
                        api.fnFIE_draw_line_seg(hdst, color, st, ed);
                    }
                }
            }
            finally
            {
                // オブジェクトの開放.
                hdst0.Dispose();
                hdst1.Dispose();
                hdst2.Dispose();
                color.Dispose();
                points.Dispose();
            }

            return hdst;
        }
    }
}

Visual Basic Copy imageCopy
Imports System.Collections.Generic
Imports System.Text
Imports fvalgcli

Public Partial Class FIE
    <FvPluginExecute> _
    Public Sub fnFIE_edge_connecting2()
        Dim status As Integer = CInt(f_err.F_ERR_NONE)

        Dim hsrc As FHANDLE = FHANDLE.Zero

        ' ２次元エッジ抽出用.
        Dim edges As F_DEDGE_PTR = F_DEDGE_PTR.Zero
        Dim edge_num As Integer = 0

        ' エッジ点群連結用.
        Dim clust As F_EDGE_CLUST_PTR = F_EDGE_CLUST_PTR.Zero
        Dim clust_num As Integer = 0

        Try
            ' 入力画像の読み込み.
            ' 適当な画像を読み込んでください.
            api.fnFIE_load_png(TestImageDir & "/testdata/camcalib_1_uc8.png", hsrc, f_color_img_type.F_COLOR_IMG_TYPE_UC8)

            ' ２次元エッジ抽出(相関エッジ)用パラメータの設定.
            Dim param As F_EDGE_CORR_PARAMS = F_EDGE_CORR_PARAMS.init(13, 5, 25.0, 1.0, 160, 6)
            Dim offset As DPNT_T = DPNT_T.init(0, 0)

            ' ２次元エッジ抽出(相関エッジ)
            api.fnFIE_edge_corr_subpix(hsrc, FHANDLE.Zero, param, _
                f_edge_feature_mode.F_EDGE_FEAT_DIRECT, f_border_mode.F_BORDER_CONTINUOUS, offset, _
                edges, edge_num)

            ' エッジ点群の連結用パラメータの設定.
            Dim angle_range As Double = System.Math.PI / 2
            Dim distance_range As Integer = 5
            Dim min_clust_elem As Integer = 3
            Dim max_clust_elem As Integer = -1

            ' エッジ点群の連結.
            status = api.fnFIE_edge_connecting2(edges, edge_num, angle_range, distance_range, min_clust_elem, max_clust_elem, _
                clust, clust_num)

            ' エラー判定.
            Assert.IsTrue(status = CInt(f_err.F_ERR_NONE), "エラーが発生しました。({0})", CType(status, f_err))

            ' 確認用.
            Dim hdraw_image As FHANDLE = fnPRV_draw_edge_clust(hsrc, edges, clust, clust_num)
            api.fnFIE_save_png(ResultDir & "/fnFIE_edge_connecting2.png", hdraw_image, -1)
            hdraw_image.Dispose()
        Finally
            ' オブジェクトの開放.
            hsrc.Dispose()
            edges.Dispose()
            api.fnFIE_free_edge_clust(clust, clust_num)
        End Try
    End Sub
End Class

確認用の描画処理:
Visual Basic Copy imageCopy
Imports System.Collections.Generic
Imports System.Text
Imports fvalgcli

Public Partial Class FIE
    ''' <summary>
    ''' 連結された曲線を色を変えて入力画像上に描画する.
    ''' </summary>
    ''' <param name="hsrc">元画像</param>
    ''' <param name="edges">エッジ点群</param>
    ''' <param name="clust">クラスタ</param>
    ''' <param name="clust_num">クラスタ数</param>
    ''' <returns>
    '''        描画結果の画像。解放必要。
    ''' </returns>
    Private Function fnPRV_draw_edge_clust(hsrc As FHANDLE, edges As F_DEDGE_PTR, clust As F_EDGE_CLUST_PTR, clust_num As Integer) As FHANDLE
        Dim hdst As FHANDLE = FHANDLE.Zero

        ' 連結して生成された曲線描画用.
        Dim colors As Double(,) = {{0.0, 0.0, 255.0}, {0.0, 0.0, 128.0}, {0.0, 255.0, 0.0}, {255.0, 255.0, 0.0}, {255.0, 165.0, 0.0}, {255.0, 0.0, 0.0}, _
            {255.0, 192.0, 203.0}, {176.0, 48.0, 96.0}, {0.0, 255.0, 255.0}, {160.0, 32.0, 240.0}, {255.0, 0.0, 255.0}, {0.0, 100.0, 0.0}}

        Dim hdst0 As FHANDLE = FHANDLE.Zero
        Dim hdst1 As FHANDLE = FHANDLE.Zero
        Dim hdst2 As FHANDLE = FHANDLE.Zero
        Dim color As DOUBLE_PTR = DOUBLE_PTR.Zero
        Dim points As DPNT_T_PTR = DPNT_T_PTR.Zero

        Try
            ' 入力画像の情報取得.
            Dim width As Integer = api.fnFIE_img_get_width(hsrc)
            Dim height As Integer = api.fnFIE_img_get_height(hsrc)

            ' 出力画像の生成.
            hdst = api.fnFIE_img_root_alloc(CInt(f_imgtype.F_IMG_UC8), 3, width, height)

            hdst0 = api.fnFIE_img_child_alloc_single_ch(hdst, 0, 0, 0, width, height)
            ' CH0
            hdst1 = api.fnFIE_img_child_alloc_single_ch(hdst, 1, 0, 0, width, height)
            ' CH1
            hdst2 = api.fnFIE_img_child_alloc_single_ch(hdst, 2, 0, 0, width, height)
            ' CH2
            api.fnFIE_img_copy_ex(hsrc, hdst0, 1, 0, 0)
            api.fnFIE_img_copy_ex(hsrc, hdst1, 1, 0, 0)
            api.fnFIE_img_copy_ex(hsrc, hdst2, 1, 0, 0)

            ' 描画色.
            color = DOUBLE_PTR.alloc(3)
            ' R,G,B
            For i As Integer = 0 To clust_num - 1
                color(0) = colors(i Mod 4, 0)
                color(1) = colors(i Mod 4, 1)
                color(2) = colors(i Mod 4, 2)

                Dim num As Integer = clust(i).num - 1
                For j As Integer = 0 To num - 1
                    Dim index0 As Integer = clust(i).pindex(j + 0)
                    Dim index1 As Integer = clust(i).pindex(j + 1)
                    Dim st As DPNT_T = DPNT_T.init(edges(index0).x, edges(index0).y)
                    Dim ed As DPNT_T = DPNT_T.init(edges(index1).x, edges(index1).y)

                    ' 描画.
                    api.fnFIE_draw_line_seg(hdst, color, st, ed)
                Next
            Next
        Finally
            ' オブジェクトの開放.
            hdst0.Dispose()
            hdst1.Dispose()
            hdst2.Dispose()
            color.Dispose()
            points.Dispose()
        End Try

        Return hdst
    End Function
End Class

See Also