画像クリア 単独ch版

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

Syntax

C#
public static int fnFGA_img_clear_ch(
	FHANDLE himg,
	int channel,
	double val
)
Visual Basic
Public Shared Function fnFGA_img_clear_ch ( 
	himg As FHANDLE,
	channel As Integer,
	val As Double
) As Integer

Parameters

himg
Type: fvalgcli..::..FHANDLE
処理対象画像( type: bin, uc8, s16, us16, double, rgbq, i32, ui32, i64, float, rgbtriple )
channel
Type: System..::..Int32
処理対象にするチャネル
val
Type: System..::..Double
塗りつぶす濃度 画像が整数型の場合は、濃度値は単純キャストで整数に変換されます。 2値画像の場合は ((INT) val )==0 の場合は0, それ以外は1になります。 また、指定の濃度値が濃度値範囲を超えていた場合は、 サチュレーション処理が行われます。

Return Value

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

エラーコード:
f_err内容
F_ERR_NONE正常終了
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>
        /// 画像クリア 単独ch版.
        /// </summary>
        [FvPluginExecute]
        public void fnFGA_img_clear_ch()
        {
            int status = (int)f_err.F_ERR_NONE;

            FHANDLE hfie_src = FHANDLE.Zero;    // 処理対象画像ハンドル.
            FHANDLE hfie_dst = FHANDLE.Zero;    // 処理対象画像ハンドル.
            FHANDLE hfga_img = FHANDLE.Zero;    // 処理対象画像ハンドル.(FGA 用)
            const int channel = 0;                // 処理対象にするチャンネル.
            const double val = 128;                // 塗りつぶす濃度.

            try
            {
                // 画像ファイルのロード.
                api.fnFIE_load_img_file(Defs.TestImageDir + "/testdata/lena256.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_img = fga.fnFGA_img_root_alloc(type, channels, width, height);
                hfie_dst = api.fnFIE_img_root_alloc(type, channels, width, height);

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

                // 処理の実行.
                status = fga.fnFGA_img_clear_ch(hfga_img, channel, val);
                if (status != (int)f_err.F_ERR_NONE)
                    throw new FvException(status, "エラーが発生しました。");

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

                // 処理対象画像の保存.
                api.fnFIE_save_png(Defs.ResultDir + "/fnFGA_img_clear_ch.png", hfie_dst, -1);
            }
            finally
            {
                // オブジェクトの開放.
                hfie_src.Dispose();
                hfie_dst.Dispose();
                hfga_img.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