JavaTM 2 Platform
Standard Ed. 5.0

パッケージ javax.imageio.metadata

メタデータの読み込みおよび書き込みを処理する Java イメージ入出力 API のパッケージです。

参照先:
          説明

インタフェースの概要
IIOMetadataController GUI を使用してユーザから値を取得するか、またはほかの手段によって、IIOMetadata オブジェクトの設定値を判定できるオブジェクトにより実装されるインタフェースです。
IIOMetadataFormat IIOMetadata.getAsTree から返されて IIOMetadata.setFromTreemergeTree に渡されるメタデータドキュメントの構造を記述するオブジェクトです。
 

クラスの概要
IIOMetadata イメージとストリームに関連したメタデータ (イメージ以外のデータ) を表すオブジェクトにより拡張される抽象クラスです。
IIOMetadataFormatImpl IIOMetadataFormat インタフェースの再使用可能な実装を提供する具象クラスです。
IIOMetadataNode メタデータツリーのノードを表すクラスで、org.w3c.dom.Element インタフェースを実装し、さらに getUserObject および setUserObject メソッドを使用してテキスト以外のオブジェクトを格納できるようにします。
 

例外の概要
IIOInvalidTreeException IIOInvalidTreeException は、IIOMetadata オブジェクトによる IIOMetadataNode のツリーの構文解析ができなかった場合にスローされます。
 

パッケージ javax.imageio.metadata の説明

メタデータの読み込みおよび書き込みを処理する Java イメージ入出力 API のパッケージです。 イメージを読み込む場合は、そのストリームごとおよびイメージごとのメタデータが 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

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。