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

Namespace: fvalgcli
Assembly: fvalgcli_fga (in fvalgcli_fga.dll) Version: 3.1.0.0 (3.1.0.3)

Syntax

C#
public static int fnFGA_geotrans_warpping(
	FHANDLE hSrc,
	FHANDLE hMap,
	FHANDLE hDst,
	FHANDLE hMask,
	bool bIsClearBack,
	f_sampling_mode iSamplingMode
)
Visual Basic
Public Shared Function fnFGA_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であること。
マスク画像が不要な場合はNULLを指定する。
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.3 $

using System;
using System.Collections.Generic;
using System.Text;
using System.Diagnostics;

using fvalgcli;

namespace TC
{
    public partial class FIE
    {
        /// <summary>
        /// 座標変換マップに従って座標を変換する.
        /// </summary>
        [FvPluginExecute]
        public void fnFGA_geotrans_warpping()
        {
            int status = (int)f_err.F_ERR_NONE;

            FHANDLE hfie_src = FHANDLE.Zero;    // 入力画像.
            FHANDLE hfie_dst = FHANDLE.Zero;    // 出力画像.
            FHANDLE hfie_map = FHANDLE.Zero;    // 座標変換マップ画像.( type: double )

            FHANDLE hfga_src = FHANDLE.Zero;    // 入力画像.(FGA 用)
            FHANDLE hfga_dst = FHANDLE.Zero;    // 出力画像.(FGA 用)
            FHANDLE hfga_map = FHANDLE.Zero;    // 座標変換マップ画像.( type: double )
            FHANDLE hfga_msk = FHANDLE.Zero;    // 処理結果画像の有効画素マスク画像.

            bool bIsClearBack = true;            // 処理対象画像の領域外になる画素の処理方法.
            f_sampling_mode iSamplingMode = f_sampling_mode.F_SAMPLING_BILINEAR;    // 濃度補間方法.

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

                // 入力画像の情報取得.
                int width = api.fnFIE_img_get_width(hfie_src);
                int height = api.fnFIE_img_get_height(hfie_src);
                int channels = api.fnFIE_img_get_channels(hfie_src);
                int type = api.fnFIE_img_get_type(hfie_src);

                // 入出力画像の生成.
                hfga_src = fga.fnFGA_img_root_alloc(type, channels, width, height);    // FGA 用.
                hfga_dst = fga.fnFGA_img_root_alloc(type, channels, width, height);    // FGA 用.
                hfie_dst = api.fnFIE_img_root_alloc(type, channels, width, height);

                // 座標変換マップ画像の確保と値の設定.
                hfie_map = api.fnFIE_img_root_alloc((int)f_imgtype.F_IMG_DOUBLE, 2, width, height);
                hfga_map = fga.fnFGA_img_root_alloc((int)f_imgtype.F_IMG_DOUBLE, 2, width, height);    // FGA 用.

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

                // FIE 画像オブジェクトから FGA 画像オブジェクトへコピー.
                fga.fnFGA_img_copy(hfie_src, hfga_src);
                fga.fnFGA_img_copy(hfie_map, hfga_map);

                // 処理の実行.
                status = fga.fnFGA_geotrans_warpping(hfga_src, hfga_map, hfga_dst, hfga_msk, bIsClearBack, iSamplingMode);
                if (status != (int)f_err.F_ERR_NONE)
                    throw new FvException(status, "エラーが発生しました。");

                // FGA 画像オブジェクトから FIE 画像オブジェクトへコピー.
                fga.fnFGA_img_copy(hfga_dst, hfie_dst);

                // 処理結果画像の保存.
                api.fnFIE_save_png(Defs.ResultDir + "/fnFGA_geotrans_warpping.png", hfie_dst, -1);
            }
            finally
            {
                // オブジェクトの開放.
                hfie_src.Dispose();
                hfie_dst.Dispose();
                hfie_map.Dispose();
                hfga_src.Dispose();
                hfga_dst.Dispose();
                hfga_map.Dispose();
                hfga_msk.Dispose();
            }
        }
    }
}

Exceptions

ExceptionCondition
System.IO..::..FileNotFoundException 実行環境に NVIDIA CUDA Runtime が存在しない場合、FGA ライブラリのロードが失敗し、この例外が発行されます。
必要な環境については FGA ライブラリ説明書 をご参照ください。
例外メッセージの例 (32bit 日本語 O/S の場合):
DLL 'fgamt.x86.3.0.0.dll' を読み込めません: 指定されたモジュールが見つかりません。 (HRESULT からの例外: 0x8007007E)

See Also