PNGファイルの保存（詳細設定付き）

Namespace: fvalgcli
Assembly: fvalgcli (in fvalgcli.dll) Version: 3.1.0.0 (3.1.0.11)

Syntax

C#
public static int fnFIE_save_png_ex(
	string filename,
	FHANDLE hImg,
	int compression_level,
	f_png_strategy compression_strategy,
	f_png_filter filter_type
)
Visual Basic
Public Shared Function fnFIE_save_png_ex ( 
	filename As String,
	hImg As FHANDLE,
	compression_level As Integer,
	compression_strategy As f_png_strategy,
	filter_type As f_png_filter
) As Integer

Parameters

filename
Type: System..::..String
保存するPNGファイル名
hImg
Type: fvalgcli..::..FHANDLE
保存するFIE画像
compression_level
Type: System..::..Int32
圧縮レベル[-1~9]
compression_strategy
Type: fvalgcli..::..f_png_strategy
圧縮戦略
filter_type
Type: fvalgcli..::..f_png_filter
フィルタ種別

Return Value

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

エラーコード：
f_err内容
F_ERR_NONE正常終了
F_ERR_NOMEMORYメモリ不足で確保に失敗した
F_ERR_INVALID_IMAGE不正なFIE画像オブジェクトが渡された
F_ERR_INVALID_PARAM不正なパラメータが渡された
F_ERR_FILE_IOPNGファイルのオープン失敗
F_ERR_UNSUPPORTED_IMAGE_FILE不正なPNGファイルへ書き込んだ
F_ERR_INTERRUPTED_IMAGE_IOユーザによって処理が中断された
F_ERR_NO_LICENCEライセンスエラー、または未初期化エラー

Examples

C# Copy imageCopy
//    $Revision: 1.1 $

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

namespace TC
{
    public partial class FIE
    {
        /// <summary>
        /// PNGファイルの保存.
        /// </summary>
        [FvPluginExecute]
        public void fnFIE_save_png_ex()
        {
            int status = (int)f_err.F_ERR_NONE;

            FHANDLE himg1 = FHANDLE.Zero;
            FHANDLE himg2 = FHANDLE.Zero;
            int type = (int)f_imgtype.F_IMG_UC8;
            int channels = 3;
            int width = 32;
            int height = 24;
            bool result = false;
            string filename = ResultDir + "/fnFIE_save_png_ex.png";

            try
            {
                // root 画像生成.
                himg1 = api.fnFIE_img_root_alloc(type, channels, width, height);
                Assert.IsTrue(himg1 != FHANDLE.Zero, "fnFIE_img_root_alloc: エラーが発生しました。");
                status = api.fnFIE_img_clear(himg1, 255);
                Assert.IsTrue(status == (int)f_err.F_ERR_NONE, "fnFIE_img_clear: エラーが発生しました。({0})", (f_err)status);

                himg2 = api.fnFIE_img_root_alloc(type, channels, width, height);
                Assert.IsTrue(himg2 != FHANDLE.Zero, "fnFIE_img_root_alloc: エラーが発生しました。");
                status = api.fnFIE_img_clear(himg2, 0);
                Assert.IsTrue(status == (int)f_err.F_ERR_NONE, "fnFIE_img_clear: エラーが発生しました。({0})", (f_err)status);

                // PNGファイル保存.
                f_png_strategy strategy = f_png_strategy.F_PNG_STRATEGY_DEFAULT;
                f_png_filter filter_type = f_png_filter.F_PNG_FILTER_NONE;
                status = api.fnFIE_save_png_ex(filename, himg1, -1, strategy, filter_type);
                Assert.IsTrue(status == (int)f_err.F_ERR_NONE, "fnFIE_save_png_ex: エラーが発生しました。({0})", (f_err)status);

                // PNGファイル読み込み.
                status = api.fnFIE_load_png(filename, ref himg2, f_color_img_type.F_COLOR_IMG_TYPE_UC8);
                Assert.IsTrue(status == (int)f_err.F_ERR_NONE, "fnFIE_load_png: エラーが発生しました。({0})", (f_err)status);

                status = api.fnFIE_img_compare(himg1, himg2, ref result);
                Assert.IsTrue(status == (int)f_err.F_ERR_NONE, "fnFIE_img_compare: エラーが発生しました。({0})", (f_err)status);
                if (result == false)
                    Assert.IsTrue(false, "値が一致しません。");
            }
            finally
            {
                himg1.Dispose();
                himg2.Dispose();
            }
        }
    }
}

Visual Basic Copy imageCopy
'    $Revision: 1.1 $

Imports System.Collections.Generic
Imports System.Text
Imports fvalgcli

Public Partial Class FIE
    ''' <summary>
    ''' PNGファイルの保存.
    ''' </summary>
    <FvPluginExecute> _
    Public Sub fnFIE_save_png_ex()
        Dim status As Integer = CInt(f_err.F_ERR_NONE)

        Dim himg1 As FHANDLE = FHANDLE.Zero
        Dim himg2 As FHANDLE = FHANDLE.Zero
        Dim type As Integer = CInt(f_imgtype.F_IMG_UC8)
        Dim channels As Integer = 3
        Dim width As Integer = 32
        Dim height As Integer = 24
        Dim result As Boolean = False
        Dim filename As String = ResultDir & "/fnFIE_save_png_ex.png"

        Try
            ' root 画像生成.
            himg1 = api.fnFIE_img_root_alloc(type, channels, width, height)
            Assert.IsTrue(himg1 <> FHANDLE.Zero, "fnFIE_img_root_alloc: エラーが発生しました。")
            status = api.fnFIE_img_clear(himg1, 255)
            Assert.IsTrue(status = CInt(f_err.F_ERR_NONE), "fnFIE_img_clear: エラーが発生しました。({0})", CType(status, f_err))

            himg2 = api.fnFIE_img_root_alloc(type, channels, width, height)
            Assert.IsTrue(himg2 <> FHANDLE.Zero, "fnFIE_img_root_alloc: エラーが発生しました。")
            status = api.fnFIE_img_clear(himg2, 0)
            Assert.IsTrue(status = CInt(f_err.F_ERR_NONE), "fnFIE_img_clear: エラーが発生しました。({0})", CType(status, f_err))

            ' PNGファイル保存.
            Dim strategy As f_png_strategy = f_png_strategy.F_PNG_STRATEGY_DEFAULT
            Dim filter_type As f_png_filter = f_png_filter.F_PNG_FILTER_NONE
            status = api.fnFIE_save_png_ex(filename, himg1, -1, strategy, filter_type)
            Assert.IsTrue(status = CInt(f_err.F_ERR_NONE), "fnFIE_save_png_ex: エラーが発生しました。({0})", CType(status, f_err))

            ' PNGファイル読み込み.
            status = api.fnFIE_load_png(filename, himg2, f_color_img_type.F_COLOR_IMG_TYPE_UC8)
            Assert.IsTrue(status = CInt(f_err.F_ERR_NONE), "fnFIE_load_png: エラーが発生しました。({0})", CType(status, f_err))

            status = api.fnFIE_img_compare(himg1, himg2, result)
            Assert.IsTrue(status = CInt(f_err.F_ERR_NONE), "fnFIE_img_compare: エラーが発生しました。({0})", CType(status, f_err))
            If result = False Then
                Assert.IsTrue(False, "値が一致しません。")
            End If
        Finally
            himg1.Dispose()
            himg2.Dispose()
        End Try
    End Sub
End Class

See Also