画像の射影変換

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_perspective(
	FHANDLE hSrc,
	FHANDLE hDst,
	FHANDLE hMask,
	FMATRIX_PTR vpMat,
	bool bIsClearBack,
	f_sampling_mode iSamplingMode
)
Visual Basic
Public Shared Function fnFGA_geotrans_perspective ( 
	hSrc As FHANDLE,
	hDst As FHANDLE,
	hMask As FHANDLE,
	vpMat As FMATRIX_PTR,
	bIsClearBack As Boolean,
	iSamplingMode As f_sampling_mode
) As Integer

Parameters

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

Return Value

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

エラーコード:
f_err内容
F_ERR_NONE正常終了
F_ERR_NOMEMORYメモリ不足エラー
F_ERR_INVALID_PARAMパラメータ異常
F_ERR_INVALID_IMAGE不正な画像オブジェクトが入力された
F_ERR_CALC_IMPOSSIBLE変換行列の逆行列が計算不可能
F_ERR_NO_LICENCEライセンスエラー、または未初期化エラー

Examples

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

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

            FHANDLE hfie_src = FHANDLE.Zero;    // 入力画像.
            FHANDLE hfie_dst = FHANDLE.Zero;    // 出力画像.
            FHANDLE hfga_src = FHANDLE.Zero;    // 入力画像.(FGA 用)
            FHANDLE hfga_dst = FHANDLE.Zero;    // 出力画像.(FGA 用)
            FHANDLE hfga_msk = FHANDLE.Zero;    // 処理結果画像の有効画素マスク画像.
            FMATRIX_PTR matrix = FMATRIX_PTR.Zero;    // 射影変換の同次変換行列.
            DPNT_T_PTR src_pnt = IntPtr.Zero;
            DPNT_T_PTR dst_pnt = IntPtr.Zero;
            const bool bIsClearBack = false;        // 処理対象画像の領域外画素の処理.
            const f_sampling_mode iSamplingMode = f_sampling_mode.F_SAMPLING_BILINEAR;    // 濃度補間法.

            try
            {
                // 処理対象画像の生成.
                status = api.fnFIE_load_img_file(Defs.TestImageDir + "/testdata/lena256.bmp", ref hfie_src, f_color_img_type.F_COLOR_IMG_TYPE_UC8);
                if (status != (int)f_err.F_ERR_NONE)
                    throw new FvException(status);

                // 入力画像の情報取得.
                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);

                // 同次行列の値設定.
                {
                    // 同次変換行列の確保.
                    matrix = api.fnFIE_mat_aalloc(3, 3);

                    uint pnt_num = 4;
                    int offs_x = width / 4;
                    int offs_y = height / 4;
                    src_pnt = DPNT_T_PTR.alloc((int)pnt_num);
                    dst_pnt = DPNT_T_PTR.alloc((int)pnt_num);

                    src_pnt[0] = DPNT_T.init(0, 0);
                    src_pnt[1] = DPNT_T.init(width - 1, 0);
                    src_pnt[2] = DPNT_T.init(0, height - 1);
                    src_pnt[3] = DPNT_T.init(width - 1, height - 1);

                    dst_pnt[0] = DPNT_T.init(offs_x, 0);
                    dst_pnt[1] = DPNT_T.init(width - 1 - offs_x, 0);
                    dst_pnt[2] = DPNT_T.init(0, height - 1 - offs_y);
                    dst_pnt[3] = DPNT_T.init(width - 1, height - 1 - offs_y);

                    // 同次行列の値設定.
                    status = api.fnFIE_geotrans_estimate_perspective_matrix(matrix, src_pnt, dst_pnt, pnt_num);
                    if (status != (int)f_err.F_ERR_NONE)
                        throw new FvException(status);
                }

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

                // FGA 画像オブジェクトから FIE 画像オブジェクトへコピー.
                status = fga.fnFGA_img_copy(hfga_dst, hfie_dst);
                if (status != (int)f_err.F_ERR_NONE)
                    throw new FvException(status);

                // 処理結果画像の保存.
                status = api.fnFIE_save_png(Defs.ResultDir + "/fnFGA_geotrans_perspective.png", hfie_dst, -1);
                if (status != (int)f_err.F_ERR_NONE)
                    throw new FvException(status);
            }
            finally
            {
                // オブジェクトの開放.
                hfie_src.Dispose();
                hfie_dst.Dispose();
                hfga_src.Dispose();
                hfga_dst.Dispose();
                hfga_msk.Dispose();
                matrix.Dispose();
            }
        }
    }
}

See Also