パタンマスクの再設定

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

Syntax

C#
public static int fnFGA_gs2_pattern_set_mask(
	FHANDLE hpattern,
	FHANDLE hmask
)
Visual Basic
Public Shared Function fnFGA_gs2_pattern_set_mask ( 
	hpattern As FHANDLE,
	hmask As FHANDLE
) As Integer

Parameters

hpattern
Type: fvalgcli..::..FHANDLE
グレイサーチパタンオブジェクト
hmask
Type: fvalgcli..::..FHANDLE
新しいマスクにする画像オブジェクト( type : bin, uc8 )

Return Value

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

エラーコード:
f_err内容
F_ERR_NONE正常終了
F_ERR_NOMEMORYメモリ不足
F_ERR_INVALID_OBJECT渡されたオブジェクトの種別が異常,またはオブジェクトがNULL
F_ERR_GS_NO_CONTRAST パタン画像に情報が足りないため、パタンにならない。 (==マスク部をのぞいた画像の濃度分散が0.0になる)
F_ERR_INVALID_IMAGE対応していない画像が渡された,または画像がNULL
F_ERR_INVALID_PARAM パラメータ異常
  • hmask のチャネル数が1でない
  • hmask とパタンのサイズが違う
F_ERR_NO_LICENCEライセンスエラー、または未初期化エラー

Remarks

Examples

C# Copy imageCopy
//    $Revision: 1.2 $

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

namespace TC
{
    public partial class FIE
    {
        public void fnFGA_gs2_pattern_set_mask(FHANDLE hPattern)
        {
            Console.WriteLine(System.Reflection.MethodBase.GetCurrentMethod().Name);

            FHANDLE hfie_msk = FHANDLE.Zero;
            FHANDLE hfga_msk = FHANDLE.Zero;
            FHANDLE hfga_roi = FHANDLE.Zero;

            try
            {
                // マスク用画像の読み込み.
                int status = api.fnFIE_load_img_file(Defs.TestImageDir + "/testdata/bin_01.bmp", ref hfie_msk, f_color_img_type.F_COLOR_IMG_TYPE_UC8);

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

                // 入出力画像の生成.
                hfga_msk = fga.fnFGA_img_root_alloc(type, channels, width, height);    // FGA 用.

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

                // マスクに使用する部分.
                hfga_roi = fga.fnFGA_img_child_alloc(hfga_msk, 208, 96, 100, 100);

                // パタンマスクの再設定.
                status = fga.fnFGA_gs2_pattern_set_mask(hPattern, hfga_roi);
                if (status != (int)f_err.F_ERR_NONE)
                    throw new FvException(status, "エラーが発生しました。");
            }
            finally
            {
                hfie_msk.Dispose();
                hfga_msk.Dispose();
                hfga_roi.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