局所領域平均値による2値画像作成 ボーダー処理付き

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

Syntax

C#
public static int fnFGA_shift_avr_threshold_ex(
	FHANDLE hSrc,
	FHANDLE hDst,
	int iX,
	int iY,
	f_border_mode border_mode,
	double value
)
Visual Basic
Public Shared Function fnFGA_shift_avr_threshold_ex ( 
	hSrc As FHANDLE,
	hDst As FHANDLE,
	iX As Integer,
	iY As Integer,
	border_mode As f_border_mode,
	value As Double
) As Integer

Parameters

hSrc
Type: fvalgcli..::..FHANDLE
入力画像 (type: uc8, us16, s16)
hDst
Type: fvalgcli..::..FHANDLE
出力画像 (type: bin)
iX
Type: System..::..Int32
近傍平均エリアの横サイズ。3〜画像の幅 の範囲の奇数を設定する
iY
Type: System..::..Int32
近傍平均エリアの縦サイズ。3〜画像の高さ の範囲の奇数を設定する
border_mode
Type: fvalgcli..::..f_border_mode
ボーダー処理モード
  • F_BORDER_NONE ボーダー拡張しない
  • F_BORDER_ZERO 0埋めモード
  • F_BORDER_VALUE 一定値モード
  • F_BORDER_CONTINUOUS 端延長モード
  • F_BORDER_REPEAT 繰り返しモード
  • F_BORDER_MIRROR1 反転モード1
  • F_BORDER_MIRROR2 反転モード2
value
Type: System..::..Double
ボーダー濃度値。 border_mode がF_BORDER_VALUEの場合のみ使用されます。 その他のモードの場合は、この値は無視されます。

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>
        /// 局所領域平均値による2値画像作成 (ボーダー処理付き)
        /// </summary>
        [FvPluginExecute]
        public void fnFGA_shift_avr_threshold_ex()
        {
            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 用)

            try
            {
                // 入力画像ファイルのロード.
                api.fnFIE_load_img_file(Defs.TestImageDir + "/testdata/gray_04.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(f_imgtype.F_IMG_BIN, channels, width, height);    // FGA 用.
                hfie_dst = api.fnFIE_img_root_alloc(f_imgtype.F_IMG_BIN, channels, width, height);

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

                // 処理の実行.
                status = fga.fnFGA_shift_avr_threshold_ex(hfga_src, hfga_dst, 3, 3, f_border_mode.F_BORDER_NONE, 0);
                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_shift_avr_threshold_ex.png", hfie_dst, -1);
            }
            finally
            {
                // オブジェクトの開放.
                hfie_src.Dispose();
                hfie_dst.Dispose();
                hfga_src.Dispose();
                hfga_dst.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