画像のアフィン変換
Namespace: fvalgcliAssembly: fvalgcli_fga (in fvalgcli_fga.dll) Version: 3.1.0.0 (3.1.0.3)
Syntax
C# |
---|
public static int fnFGA_geotrans_affine( FHANDLE hSrc, FHANDLE hDst, FHANDLE hMask, FMATRIX_PTR vpMat, bool bIsClearBack, f_sampling_mode iSamplingMode ) |
Visual Basic |
---|
Public Shared Function fnFGA_geotrans_affine ( 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
処理対象画像( type: bin, uc8, us16, double )
- hDst
- Type: fvalgcli..::..FHANDLE
処理結果画像( type: bin, uc8, us16, double )
- hMask
- Type: fvalgcli..::..FHANDLE
処理結果画像の有効画素マスク画像( 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_LANCZOS :Lanczos-windowed Sinc function法により濃度補間を行う
- F_SAMPLING_SUPER :super-sampling 法により濃度補間を行う
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 |
---|---|
// $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_affine() { 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; // アフィン変換の同次変換行列. 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); status = api.fnFIE_geotrans_calc_rotate_matrix(matrix, 0.5, width / 2, height / 2); if (status != (int)f_err.F_ERR_NONE) throw new FvException(status); // 処理の実行. status = fga.fnFGA_geotrans_affine(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_affine.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(); } } } } |
Exceptions
Exception | Condition |
---|---|
System.IO..::..FileNotFoundException |
実行環境に NVIDIA CUDA Runtime が存在しない場合、FGA ライブラリのロードが失敗し、この例外が発行されます。 必要な環境については FGA ライブラリ説明書 をご参照ください。 例外メッセージの例 (32bit 日本語 O/S の場合): DLL 'fgamt.x86.3.0.0.dll' を読み込めません: 指定されたモジュールが見つかりません。 (HRESULT からの例外: 0x8007007E) |