色空間変換処理

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

Syntax

C#
public static int fnFGA_color_convert(
	FHANDLE src,
	f_color_space src_color_space,
	FHANDLE dst,
	f_color_space dst_color_space,
	FHANDLE cs_table
)
Visual Basic
Public Shared Function fnFGA_color_convert ( 
	src As FHANDLE,
	src_color_space As f_color_space,
	dst As FHANDLE,
	dst_color_space As f_color_space,
	cs_table As FHANDLE
) As Integer

Parameters

src
Type: fvalgcli..::..FHANDLE
入力画像オブジェクト(type:uc8,double)
src_color_space
Type: fvalgcli..::..f_color_space
入力画像オブジェクトの色空間
  • F_CS_RGB
  • F_CS_GRAY
  • F_CS_XYZ
  • F_CS_YUV
  • F_CS_YIQ
  • F_CS_I1I2I3
  • F_CS_HSV_SMITH
  • F_CS_HSV_JOBLOVE
  • F_CS_LAB
  • F_CS_HSV_FAST
  • F_CS_LAB_FAST
dst
Type: fvalgcli..::..FHANDLE
出力画像オブジェクト(type:uc8,double)
dst_color_space
Type: fvalgcli..::..f_color_space
出力画像オブジェクトの色空間
  • F_CS_RGB
  • F_CS_GRAY
  • F_CS_XYZ
  • F_CS_YUV
  • F_CS_YIQ
  • F_CS_I1I2I3
  • F_CS_HSV_SMITH
  • F_CS_HSV_JOBLOVE
  • F_CS_LAB
  • F_CS_HSV_FAST
  • F_CS_LAB_FAST
cs_table
Type: fvalgcli..::..FHANDLE
FGAオブジェクト(数値テーブル)のハンドル 必要がない場合は NULL を指定

Return Value

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

エラーコード:
f_err内容
F_ERR_NONE正常終了
F_ERR_INVALID_PARAM 不正なパラメータが渡された。 不正な色空間を指定した。 不正な数値テーブルが渡された。
F_ERR_INVALID_IMAGE不正な画像オブジェクトが渡された。
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>
        /// 色空間変換処理.
        /// </summary>
        [FvPluginExecute]
        public void fnFGA_color_convert()
        {
            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 cs_table = FHANDLE.Zero;

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

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

                // 処理の実行.
                status = fga.fnFGA_color_convert(hfga_src, f_color_space.F_CS_RGB, hfga_dst, f_color_space.F_CS_XYZ, cs_table);
                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_color_convert.png", hfie_dst, -1);
            }
            finally
            {
                // オブジェクトの開放.
                hfie_src.Dispose();
                hfie_dst.Dispose();
                hfga_src.Dispose();
                hfga_dst.Dispose();
                cs_table.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