軟體套件 javax.imageio

Java Image I/O API 的主要套件。

請參見：
描述

介面摘要

IIOParamController	該介面將由可以確定 IIOParam 物件設置值（通過提供一個 GUI 來從使用者那裡獲取值或其他方式）的物件實作。
ImageTranscoder	提供元資料程式碼轉換功能的介面。

類別摘要

IIOImage	一個聚集圖像、縮略（預覽）圖像集和表示與圖像關聯的元資料的物件的簡單容器類別。
IIOParam	所有描述應該如何對串流進行編碼和解碼的類別的父級類別。
ImageIO	該類別包含一些用來尋找 ImageReader 和 ImageWriter 以及執行簡單編碼和解碼的靜態便捷方法。
ImageReader	用來解析和解碼圖像的抽象父級類別。
ImageReadParam	描述如何對串流進行解碼的類別。
ImageTypeSpecifier	允許以便捷方式指定圖像格式（尤其是其 SampleModel 和 ColorModel）的類別。
ImageWriteParam	描述如何對串流進行編碼的類別。
ImageWriter	用來編碼和寫入圖像的抽象父級類別。

異常摘要

IIOException

該異常類別用於發出關於讀取和寫入操作的運行時故障的信號。

軟體套件 javax.imageio 的描述

Java Image I/O API 的主要套件。

使用 ImageIO 類別的靜態方法可以執行許多常見的圖像 I/O 操作。

此套件包含一些基本類別和介面，有的用來描述圖像檔案內容（包括元資料和縮略圖）(IIOImage)；有的用來控制圖像讀取過程（ImageReader、ImageReadParam 和 ImageTypeSpecifier）和圖像寫入過程（ImageWriter 和 ImageWriteParam）；還有的用來執行格式之間的程式碼轉換 (ImageTranscoder) 和報告錯誤 (IIOException)。

javax.imageio 的所有實作都提供以下標準圖像格式外掛程式：

	讀取	寫入	注意事項	元資料
JPEG	是	是	無	JPEG 元資料格式
PNG	是	是	無	PNG 元資料格式
BMP	是	是	無	BMP 元資料格式
WBMP	是	是	無	WBMP 元資料格式
GIF	是	是	GIF 外掛程式注意事項	GIF 元資料格式

標準外掛程式注意事項

GIF 圖像格式的標準外掛程式

ImageIO 為圖形交換格式 (GIF) 圖像格式提供 ImageReader 和 ImageWriter 外掛程式。 這些是「標準」GIF 外掛程式（意味著 JRE 中包含的外掛程式與標準擴展中包含的外掛程式不同）或是第三方外掛程式。下列注意事項和元資料規範適用於標準外掛程式。

寫入 GIF 圖像

GIF 圖像 writer 外掛程式保證滿足以下要求的圖像能無損失地寫入：

• band 數是 1；
• 每個採樣的位數不大於 8；
• 顏色份量的大小不大於 8。

預設情況下，GIF writer 外掛程式創建 "89a" 版本的圖像。這可以更改為 "87a"，將該版本在串流元資料中顯式設置即可（請參閱 GIF 串流元資料格式規範）。

GIF writer 外掛程式通過寫入 ImageWriter 類別中定義方法的標準序列，可支持創建動畫 GIF 圖像。

如果滿足以下條件之一，全體顏色表將被寫入輸出串流：

• 提供包含 GlobalColorTable 元素的串流元資料；
• 序列正被寫入，並且為序列中第一個圖像提供包含 LocalColorTable 元素的圖像元資料；
• 沒有提供圖像元資料或者圖像元資料不包含 LocalColorTable 元素。

在第一種情況下，使用串流元資料中的全體顏色表，在第二種情況下，使用圖像元資料中的局部顏色表，在第三種情況下，根據 ColorModel 或（第一個）圖像的 SampleModel 創建全體顏色表。

只有將包含 LocalColorTable 元素的圖像元資料提供給 writer，或者沒有圖像元資料提供給 writer 並且根據其圖像本身產生的局部顏色表不等於全體顏色表時，局部顏色表才寫入輸出串流。

只有將包含 GraphicControlExtension 元素的圖像元資料提供給 writer，或者不提供圖像元資料並且根據圖像產生的局部顏色表要求透明索引時，圖形控制擴展 (Graphic Control Extension) 塊才寫入輸出串流。應用程序 (Application)、純文本 (Plain Text) 和註釋擴展 (Comment Extension) 塊只有通過圖像元資料提供給 writer 時才寫入。

交錯圖像的寫入可通過提供的 ImageWriteParam 實例的逐步網要控制。如果逐步網要是 MODE_DISABLED，則寫入非交錯圖像。如果逐步網要是 MODE_DEFAULT，則寫入交錯圖像。如果逐步網要是 MODE_COPY_FROM_METADATA，則使用元資料設置（如果提供了元資料設置，否則寫入交錯圖像）。

GIF 圖像 writer 外掛程式支持根據提供給本機 GIF 串流元資料格式 javax_imageio_gif_stream_1.0 或標準元資料格式 javax_imageio_1.0 中 writer 的元資料設置輸出串流元資料，還支持根據提供給本機 GIF 圖像元資料格式 javax_imageio_gif_image_1.0 或標準元資料格式 javax_imageio_1.0 中 writer 的元資料設置輸出圖像元資料。 標準元資料格式到 GIF 本機串流以及圖像元資料格式的映射在此表中給出。

從以下版本開始：

1.4