画像の射影変換
Namespace: fvalgcliAssembly: 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 |
---|---|
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(); } } } } |