JavaTM 2 Platform
Standard Ed. 6

軟體套件 javax.imageio.metadata

用於處理讀寫元資料的 Java Image I/O API 的套件。

請參見:
          描述

介面摘要
IIOMetadataController 該介面將由可以確定 IIOMetadata 物件設置值(通過提供一個 GUI 來從使用者那裡獲取值或其他方式)的物件實作。
IIOMetadataFormat 描述從 IIOMetadata.getAsTree 返回並傳遞給 IIOMetadata.setFromTreemergeTree 的元資料文檔結構的物件。
 

類別摘要
IIOMetadata 將由表示與圖像和串流關聯的元資料(非圖像資料)的物件擴展的抽象類別。
IIOMetadataFormatImpl 提供 IIOMetadataFormat 介面的可重用實作的具體類別。
IIOMetadataNode 表示元資料階層樹中節點的類別,該類別實作 org.w3c.dom.Element 介面,還允許通過 getUserObjectsetUserObject 方法存儲非文本物件。
 

異常摘要
IIOInvalidTreeException IIOMetadata 物件嘗試解析 IIOMetadataNode 的階層樹失敗時,將拋出 IIOInvalidTreeException
 

軟體套件 javax.imageio.metadata 的描述

用於處理讀寫元資料的 Java Image I/O API 的套件。

讀取圖像時,其每個串流和每個圖像元資料都可以作為 IIOMetadata 物件使用。此物件的內部特定於創建它的外掛程式。其內容能夠以作為 IIOMetadataNode 物件的階層樹實作的 XML Document 的形式存取。

寫入圖像時,其元資料可以通過定義或修改 IIOMetadata 物件設置。這種對象可以從(javax.imageio 套件中的)ImageWriterImageTranscoder 獲得。獲得這種物件後,就可以通過修改由 IIOMetadataNode 組成的 Document 來設置其內容。可以選擇是否使用 IIOMetadataFormat 物件來描述文檔格式。

XML Document 中所含元資料的格式由一個字元串標識,該字元串作為 IIOMetadataNode 物件的階層樹的根節點出現。此字元串包含版本號,例如,"javax_imageio_jpeg_image_1.0"。Reader 和 writer 可能支持同一基本格式的多個版本號,Image I/O API 的方法可以通過將字元串傳遞給用於獲取 IIOMetadata 物件的方法/建構子來指定要使用的版本。在某些情況下,較新的版本可能與按較舊版本編寫的程序不完全相容(有關範例,請參見下文 JPEG 元資料用法說明的 Native Metadata Format 一節)。

外掛程式可以選擇支持標準(外掛程式無關)格式。此格式不提供元資料的無損耗編碼,但是允許以通用方式存取部分元資料。

每個標準外掛程式都支持所謂的“本機”元資料格式,該格式以無損耗的方式編碼其元資料:

從以下版本開始:
1.4

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only