PngExtendedParams オブジェクト（IPngExtendedParams インターフェイス）

ABBYY FineReader Engine API の PngExtendedParams オブジェクト（IPngExtendedParams インターフェイス）。IImage.WriteToFile を介して白黒画像を PNG（IFF_Png）として保存する際の調整パラメーターを提供します。ファイルまたはメモリに保存可能な永続オブジェクトです。

このオブジェクトは、IImage::WriteToFile メソッドを使用して白黒画像を PNG 形式 (IFF_Png 形式) で保存する際のパラメーターを調整するための機能を提供します。このオブジェクトへのポインターは IImage::WriteToFile メソッドに入力パラメーターとして渡されるため、生成される画像のプロパティに影響します。この型の新規作成されたオブジェクトでは、すべてのプロパティに適切な既定値が設定されています。既定値については、各プロパティの説明を参照してください。

PngExtendedParams オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、オブジェクトを再作成できます。オブジェクトの永続化には、次のメソッドを使用します。

Linux: SaveToFile および LoadFromFile

Windows: SaveToFile、LoadFromFile、SaveToMemory、および LoadFromMemory。

​

プロパティ

名前	型	説明
Application	Engine, 読み取り専用	Engine オブジェクトを返します。
TransparentColor	int	画像を PNG 形式で保存する際に、透明領域に置き換える色を設定します。現在サポートされているのは白と黒のみです。 int 値は、次の式を使用して RGB の組み合わせから計算されます: ( 赤の値 ) + (256 x 緑の値 ) + (65536 x 青の値 )。ここで、赤の値は 1 番目の要素、緑の値は 2 番目の要素、青の値は 3 番目の要素です。たとえば、白の int 値は 16777215 です。 このプロパティの既定値は -1 で、どの色も透明に置き換えられないことを意味します。

​

メソッド

名前	説明
CopyFrom	現在のオブジェクトのプロパティを、別のオブジェクトの対応するプロパティの値で初期化します。
LoadFromFile	ディスク上のファイルからオブジェクトの内容を復元します。
LoadFromMemory	グローバルメモリからオブジェクトの内容を復元します。 Windows のみ。
SaveToFile	オブジェクトの内容をディスク上のファイルに保存します。
SaveToMemory	オブジェクトの内容をグローバルメモリに保存します。 Windows のみ。

​

出力パラメーター

このオブジェクトは、EngineオブジェクトのCreatePngExtendedParamsメソッドによって返される出力パラメーターです。

​

入力パラメーター

このオブジェクトは、Image オブジェクトの WriteToFile メソッドの入力パラメーターです。

​

関連項目

ImageFileFormatEnum

画像の操作

プロパティの操作