> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

Linux: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) および [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、[LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)、[SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)、および [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)。

<div id="properties">
  ## プロパティ
</div>

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

<div id="methods">
  ## メソッド
</div>

| 名前                                                                                                                       | 説明                                                     |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ |
| [CopyFrom](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | 現在のオブジェクトのプロパティを、別のオブジェクトの対応するプロパティの値で初期化します。          |
| [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)               | ディスク上のファイルからオブジェクトの内容を復元します。                           |
| [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)           | グローバルメモリからオブジェクトの内容を復元します。 <Note> *Windows のみ。*</Note> |
| [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                   | オブジェクトの内容をディスク上のファイルに保存します。                            |
| [SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)               | オブジェクトの内容をグローバルメモリに保存します。 <Note> *Windows のみ。*</Note>  |

<div id="output-parameter">
  ## 出力パラメーター
</div>

このオブジェクトは、[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface)オブジェクトの[CreatePngExtendedParams](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods)メソッドによって返される出力パラメーターです。

<div id="input-parameter">
  ## 入力パラメーター
</div>

このオブジェクトは、[Image](/ja/fine-reader/engine/api-reference/image-related-objects/image) オブジェクトの [WriteToFile](/ja/fine-reader/engine/api-reference/image-related-objects/image/writetofile-method) メソッドの入力パラメーターです。

<div id="see-also">
  ## 関連項目
</div>

[ImageFileFormatEnum](/ja/fine-reader/engine/api-reference/enumerations/imagefileformatenum)

[画像の操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images)

[プロパティの操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)