パッケージ javax.imageio.metadata
イメージを読み込む場合は、そのストリームごとおよびイメージごとのメタデータがIIOMetadata
オブジェクトとして使用可能になります。 このオブジェクトの内部は作成に使ったプラグインに固有です。 その内容は、IIOMetadataNode
オブジェクトのツリーとして実装されるXML Document
の形式でアクセスできます。
イメージを書き込む場合は、そのメタデータをIIOMetadata
オブジェクトの定義または変更により設定することができます。 このようなオブジェクトは、javax.imageio
パッケージのImageWriter
またはImageTranscoder
から取得することができます。 このようなオブジェクトが取得されると、IIOMetadataNode
で構成されるDocument
を使用して、その内容を変更できます。 ドキュメント形式は、必要に応じて、IIOMetadataFormat
オブジェクトを使用して記述することができます。
XML Document
に格納されるメタデータの形式は、IIOMetadataNode
オブジェクトのツリーのルート・ノードとして表示される文字列によって識別されます。 この文字列には、javax_imageio_jpeg_image_1.0などのバージョン番号が含まれます。 リーダーとライターは複数バージョンの同じ基本形式をサポートすることができ、イメージ入出力APIには、IIOMetadata
オブジェクトの取得に使用されるメソッドまたはコンストラクタにこの文字列を渡して、使用するバージョンを指定できるメソッドがあります。 場合によっては、新しいバージョンは、古いバージョンを想定して記述されたプログラムと厳密な互換性がないことがあります。この例については、下記の「JPEGメタデータの使用法に関するノート」の「ネイティブのメタデータ形式」のセクションを参照してください。
プラグインは、標準の(プラグインに依存しない)形式 のサポートを選択することができます。 この形式は、メタデータの損失のないエンコーディングを提供できませんが、一般的な方法でメタデータの一部へのアクセスを可能にできます。
各標準プラグインは、損失なしでメタデータをエンコードする「ネイティブ」と呼ばれるメタデータ形式をサポートします。
- 導入されたバージョン:
- 1.4
-
インタフェースのサマリー インタフェース 説明 IIOMetadataController GUIを使用してユーザーから値を取得するか、またはほかの手段によって、IIOMetadata
オブジェクトの設定値を判定できるオブジェクトにより実装されるインタフェースです。IIOMetadataFormat IIOMetadata.getAsTree
から返されてIIOMetadata.setFromTree
とmergeTree
に渡されるメタデータ・ドキュメントの構造を記述するオブジェクトです。 -
クラスのサマリー クラス 説明 IIOMetadata イメージとストリームに関連付けられたメタデータ(イメージ以外のデータ)を表すオブジェクトにより拡張される抽象クラスです。IIOMetadataFormatImpl IIOMetadataFormat
インタフェースの再使用可能な実装を提供する具象クラスです。IIOMetadataNode org.w3c.dom.Element
インタフェースを実装し、getUserObject
メソッドとsetUserObject
メソッドを介した外部オブジェクトのストレージを追加可能にする、メタデータ・ツリー内のノードを表すクラス。 -
例外のサマリー 例外 説明 IIOInvalidTreeException IIOInvalidTreeException
は、IIOMetadata
オブジェクトによるIIOMetadataNode
のツリーの構文解析の試みに失敗した場合にスローされます。