對一組檔案套用一連串的影像操作。
使用 AWT 和 ImageIO；取代 Java 9+ 的 image 工作。此工作也可以用於 Java 8，請參閱參數表格以了解限制。
注意：此工作會盡量維持與 image 工作的語法和語意一致。不過，它使用 format 屬性，而不是 encoding 屬性，因為後者是一個錯誤的名稱：幾乎所有工作都使用類似的屬性來設定檔案、檔名或其他字串的字元編碼。此外，當未指定 format 時，其值會由第一個處理的影像檔案格式來定義。
| 屬性 | 說明 | 必要 |
|---|---|---|
| failonerror | 布林值。如果為 false，會將錯誤記錄到輸出，但會繼續執行。 |
否；預設為 true |
| srcdir | 包含影像的目錄。 | 是，除非使用巢狀檔案集 |
| format | 影像格式。 有效值（不區分大小寫）： bmp、 gif、 jpeg、 jpg、 png、 tif、 tiff、 wbmp（Java 8 VM 不支援 TIFF，可以透過 外部函式庫 來提供支援）。 |
否；預設為（第一個）原始檔案的格式 |
| overwrite | 布林值。設定是否要覆寫檔案（如果發生命名衝突）。 | 否；預設為 false |
| gc | 布林值。在處理完每張影像後啟用垃圾回收。 | 否；預設為 false |
| destdir | 儲存結果影像的目錄。 | 否；預設為 srcdir 的值 |
| includes | 必須包含的檔案模式清單（以逗號或空格分隔）。 | 否；預設為全部 (**) |
| includesfile | 檔案名稱。此檔案的每一行都被視為包含模式 | 否 |
| excludes | 必須排除的檔案模式清單（以逗號或空格分隔）。 | 否；預設為預設排除或無（如果 defaultexcludes 為 no） |
| excludesfile | 檔案名稱。此檔案的每一行都被視為排除模式 | 否 |
| defaultexcludes | 表示是否要使用預設排除 (yes|no）。 |
否；預設為 yes |
| caseSensitive | 布林值。設定檔案系統的大小寫敏感性。 | 否；預設為 false |
| followSymlinks | 布林值。設定是否要追蹤符號連結。 | 否；預設為 true |
此工作會形成一個隱含的 FileSet，並支援 <fileset> 的大多數屬性，以及巢狀的 <include>、<exclude> 和 <patternset> 元素。
下列 ImageOperation 物件可指定為巢狀元素：Rotate、Scale 和 Draw。
將 Rotate ImageOperation 加入鏈結。
| 屬性 | 說明 | 必要 |
|---|---|---|
| angle | 浮點值。設定旋轉角度（以度為單位）。 | 否；預設為 0.0F |
將 Scale ImageOperation 加入鏈結。
| 屬性 | 說明 | 必要 |
|---|---|---|
| proportions | 設定要控制比例的尺寸。有效值為
|
否；預設為 ignore |
| width | 設定影像寬度，可以是整數（畫素）或 %。 | 否；預設為 100% |
| height | 設定影像高度，可以是整數（畫素）或 %。 | 否；預設為 100% |
將 Draw ImageOperation 加入鏈結。DrawOperation DataType 物件可巢狀在 Draw 物件內。
| 屬性 | 說明 | 必要 |
|---|---|---|
| xloc | 繪製巢狀影像元素的 X 位置。 | 否；預設為 0 |
| yloc | 繪製巢狀影像元素的 Y 位置。 | 否；預設為 0 |
Text 和 BasicShape 物件都可以巢狀。目前支援的 BasicShape 物件有 Arc、Ellipse 和 Rectangle。
| 屬性 | 說明 | 必要 |
|---|---|---|
| height | BasicShape 的高度。 | 否；預設為 0 |
| width | BasicShape 的寬度。 | 否；預設為 0 |
| strokewidth | BasicShape 的線條寬度。 | 否；預設為 0 |
| color | BasicShape 的顏色。 | 否；預設為 black |
| fill | BasicShape 的填滿。 | 否；預設為 transparent |
| 屬性 | 說明 | 必要 |
|---|---|---|
| start | 圓弧的起始角度（以度為單位）。 | 否；預設為 0 |
| stop | 圓弧的角度範圍（以度為單位）。 | 否；預設為 0 |
| type | 下列其中一種：chord、 open、 pie。 |
否；預設為 open |
無。
| 屬性 | 說明 | 必要 |
|---|---|---|
| archeight | 矩形角落圓弧的垂直直徑。 | 否；預設為 0 |
| arcwidth | 矩形角落圓弧的水平直徑。 | 否；預設為 0 |
| 屬性 | 說明 | 必要 |
|---|---|---|
| string | 文字字串。 | 否；預設為 |
| font | 設定文字字型的字型。 | 否；預設為 Arial |
| point | 字型的點數大小。 | 否；預設為 10 |
| 粗體 | 字型是否為粗體。 | 否；預設為 false |
| color | 文字的顏色。 | 否；預設為 black |
| 斜體 | 字型是否為斜體。 | 否；預設為 false |
你可以透過使用巢狀的 對應器 元素來定義檔案名稱轉換。<image> 所使用的預設對應器為 身分對應器。
你也可以使用 filenamemapper 類型來取代 mapper 元素。
建立我的圖片縮圖，並確保它們都符合 160×160 像素的大小，無論圖片是直幅或橫幅。
<image destdir="samples/low" overwrite="yes">
<fileset dir="samples/full">
<include name="**/*.jpg"/>
</fileset>
<scale width="160" height="160" proportions="fit"/>
</image>
在 src 中建立所有 PNG 檔案的縮圖，大小為 40 像素，並保持比例，並儲存 src。
<image srcdir="src" includes="*.png">
<scale proportions="width" width="40"/>
</image>
與上述相同，但將結果儲存在 dest 中。
<image srcdir="src" destdir="dest" includes="*.png">
<scale proportions="width" width="40"/>
</image>
與上述相同，但將結果儲存在檔案中，原始檔名加上前綴 scaled-。
<image srcdir="src" destdir="dest" includes="*.png">
<scale proportions="width" width="40"/>
<globmapper from="*" to="scaled-*"/>
</image>