座標変換マップに従って座標を変換する

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

Syntax

C#
public static int fnFIE_geotrans_warpping(
	FHANDLE hSrc,
	FHANDLE hMap,
	FHANDLE hDst,
	FHANDLE hMask,
	bool bIsClearBack,
	f_sampling_mode iSamplingMode
)
Visual Basic
Public Shared Function fnFIE_geotrans_warpping ( 
	hSrc As FHANDLE,
	hMap As FHANDLE,
	hDst As FHANDLE,
	hMask As FHANDLE,
	bIsClearBack As Boolean,
	iSamplingMode As f_sampling_mode
) As Integer

Parameters

hSrc
Type: fvalgcli..::..FHANDLE
処理対象画像( type: bin, uc8, us16, double )
hMap
Type: fvalgcli..::..FHANDLE
座標変換マップ画像( type: double, float )
hDst
Type: fvalgcli..::..FHANDLE
処理結果画像( type: bin, uc8, us16, double )
hMask
Type: fvalgcli..::..FHANDLE
処理結果画像の有効画素マスク画像( type: bin )
画像サイズはhDstと同じ、チャネル数1であること。
マスク画像が不要な場合は IntPtr.Zero を指定する。
bIsClearBack
Type: System..::..Boolean
処理対象画像の領域外になる画素の処理方法
  • true : 領域外になる画素は0クリア
  • false : 領域外になる画素は処理しない
iSamplingMode
Type: fvalgcli..::..f_sampling_mode
濃度補間方法
  • F_SAMPLING_NN :最近傍法により濃度補間を行う
  • F_SAMPLING_BILINEAR :共一次線形補間により濃度補間を行う
  • F_SAMPLING_CUBIC :三次畳み込み法により濃度補間を行う

Return Value

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

エラーコード:
f_err内容
F_ERR_NONE正常終了
F_ERR_NOMEMORYメモリ不足エラー
F_ERR_INVALID_IMAGE画像オブジェクトの異常
F_ERR_INVALID_PARAMパラメータ異常
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
    {
        /// <summary>
        /// 座標変換マップに従って座標を変換する.
        /// </summary>
        [FvPluginExecute]
        public void fnFIE_geotrans_warpping()
        {
            int status = (int)f_err.F_ERR_NONE;

            FHANDLE hSrc = FHANDLE.Zero;        // 処理対象画像.
            FHANDLE hMap = FHANDLE.Zero;        // 座標変換マップ画像.( type: double )
            FHANDLE hDst = FHANDLE.Zero;        // 処理結果画像.
            FHANDLE hMask = FHANDLE.Zero;        // 処理結果画像の有効画素マスク画像.
            bool bIsClearBack;                // 処理対象画像の領域外になる画素の処理方法.
            f_sampling_mode iSamplingMode;    // 濃度補間方法.

            try
            {
                // 処理対象画像の生成.
                api.fnFIE_load_bmp(TestImageDir + "/testdata/lena256.bmp", ref hSrc, f_color_img_type.F_COLOR_IMG_TYPE_UC8);

                int width = api.fnFIE_img_get_width(hSrc);
                int height = api.fnFIE_img_get_height(hSrc);

                // 処理結果画像の確保.
                hDst = api.fnFIE_img_root_alloc(api.fnFIE_img_get_type(hSrc), 1, width, height);

                // 座標変換マップ画像の確保と値の設定.
                hMap = api.fnFIE_img_root_alloc((int)f_imgtype.F_IMG_DOUBLE, 2, width, height);
                api.fnFIE_img_clear(hMap, 0);

                const int div = 3;
                for (int y = 0; y < height; y++)
                {
                    for (int x = 0; x < width; x++)
                    {
                        api.fnFIE_img_set_dens(hMap, 0, x, y, (x * div) % width);
                        api.fnFIE_img_set_dens(hMap, 1, x, y, (y * div) % height);
                    }
                }

                // その他のパラメータの設定.
                hMask = FHANDLE.Zero;
                bIsClearBack = true;
                iSamplingMode = f_sampling_mode.F_SAMPLING_BILINEAR;

                // 処理の実行.
                status = api.fnFIE_geotrans_warpping(hSrc, hMap, hDst, hMask, bIsClearBack, iSamplingMode);

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

                // 処理結果画像の保存.
                api.fnFIE_save_png(ResultDir + "/fnFIE_geotrans_warpping.png", hDst, -1);

            }
            finally
            {
                // オブジェクトの開放.
                hSrc.Dispose();
                hMap.Dispose();
                hDst.Dispose();
                hMask.Dispose();
            }
        }
    }
}


Visual Basic Copy imageCopy
'    $Revision: 1.1 $

Imports System.Collections.Generic
Imports System.Text

Imports fvalgcli

Public Partial Class FIE
    ''' <summary>
    ''' 座標変換マップに従って座標を変換する.
    ''' </summary>
    <FvPluginExecute> _
    Public Sub fnFIE_geotrans_warpping()
        Dim status As Integer = CInt(f_err.F_ERR_NONE)

        Dim hSrc As FHANDLE = FHANDLE.Zero
        ' 処理対象画像.
        Dim hMap As FHANDLE = FHANDLE.Zero
        ' 座標変換マップ画像.( type: double )
        Dim hDst As FHANDLE = FHANDLE.Zero
        ' 処理結果画像.
        Dim hMask As FHANDLE = FHANDLE.Zero
        ' 処理結果画像の有効画素マスク画像.
        Dim bIsClearBack As Boolean
        ' 処理対象画像の領域外になる画素の処理方法.
        Dim iSamplingMode As f_sampling_mode
        ' 濃度補間方法.
        Try
            ' 処理対象画像の生成.
            api.fnFIE_load_bmp(TestImageDir & "/testdata/lena256.bmp", hSrc, f_color_img_type.F_COLOR_IMG_TYPE_UC8)

            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(api.fnFIE_img_get_type(hSrc), 1, width, height)

            ' 座標変換マップ画像の確保と値の設定.
            hMap = api.fnFIE_img_root_alloc(CInt(f_imgtype.F_IMG_DOUBLE), 2, width, height)
            api.fnFIE_img_clear(hMap, 0)

            Const  div As Integer = 3
            For y As Integer = 0 To height - 1
                For x As Integer = 0 To width - 1
                    api.fnFIE_img_set_dens(hMap, 0, x, y, (x * div) Mod width)
                    api.fnFIE_img_set_dens(hMap, 1, x, y, (y * div) Mod height)
                Next
            Next

            ' その他のパラメータの設定.
            hMask = FHANDLE.Zero
            bIsClearBack = True
            iSamplingMode = f_sampling_mode.F_SAMPLING_BILINEAR

            ' 処理の実行.
            status = api.fnFIE_geotrans_warpping(hSrc, hMap, hDst, hMask, bIsClearBack, iSamplingMode)

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

            ' 処理結果画像の保存.

            api.fnFIE_save_png(ResultDir & "/fnFIE_geotrans_warpping.png", hDst, -1)
        Finally
            ' オブジェクトの開放.
            hSrc.Dispose()
            hMap.Dispose()
            hDst.Dispose()
            hMask.Dispose()
        End Try
    End Sub
End Class

See Also