图片编辑器 - Img

简介

Img 是 Hutool 提供的一个基于 AWT 的图片处理工具类，支持图片的缩放、裁剪、旋转、压缩、加水印等操作。该工具类提供了流式 API，可以方便地对图片进行多步操作，适合在实际开发中进行灵活的图片处理。

1. 使用场景

• 图像裁剪与编辑：需要对图片进行精确裁剪、调整、添加效果等操作时，可以使用 Img 进行灵活处理。
• 图片压缩与优化：在需要压缩图片大小以适应网络传输、存储要求时，可以使用 Img 进行高效压缩。
• 批量图片处理：支持链式调用，方便对图片进行多步骤的处理，如缩放、裁剪、加水印等操作。

2. 主要方法与示例

2.1 图像裁剪

cut 方法用于裁剪图片，可以根据指定的坐标和尺寸进行精确裁剪，支持裁剪为圆形、矩形等。

示例：裁剪为圆形图片

import cn.hutool.core.img.Img;
import cn.hutool.core.io.FileUtil;

public class ImgExample {
    public static void main(String[] args) {
        // 将图片裁剪为圆形并保存
        Img.from(FileUtil.file("e:/pic/face.jpg"))
            .cut(0, 0, 200) // 指定裁剪起始坐标(0, 0)和直径为200的圆形区域
            .write(FileUtil.file("e:/pic/face_radis.png")); // 保存裁剪后的图片
    }
}

• 方法签名：
  • public Img cut(int x, int y, int radius)
• 参数说明：
  • x：裁剪区域的起始 X 坐标。
  • y：裁剪区域的起始 Y 坐标。
  • radius：圆形裁剪区域的半径。
• 作用：在需要将图片裁剪为圆形时使用，适用于头像裁剪、图像美化等场景。

2.2 图片压缩

setQuality 方法用于设置图片的压缩质量，适用于 JPG 格式的图片。

示例：压缩图片并保存

import cn.hutool.core.img.Img;
import cn.hutool.core.io.FileUtil;

public class ImgExample {
    public static void main(String[] args) {
        // 压缩 PNG 图片并保存为 JPG 格式，压缩比率为0.8
        Img.from(FileUtil.file("e:/pic/1111.png"))
            .setQuality(0.8) // 设置压缩比率，0.8表示压缩20%
            .write(FileUtil.file("e:/pic/1111_target.jpg")); // 保存压缩后的图片
    }
}

• 方法签名：
  • public Img setQuality(float quality)
• 参数说明：
  • quality：压缩比率，范围为 [0.0, 1.0]。值越小，压缩越多，图片质量下降越明显。
• 作用：在需要减少图片文件大小时使用，适用于网络传输、图片存储优化等场景。

2.3 多步图片处理

Img 工具类支持链式调用，可以在同一个实例中进行多步处理，如缩放、裁剪、添加水印等。

示例：图片缩放、裁剪、加水印的多步处理

import cn.hutool.core.img.Img;
import cn.hutool.core.io.FileUtil;

import java.awt.Color;
import java.awt.Font;

public class ImgExample {
    public static void main(String[] args) {
        // 多步骤图片处理：缩放 -> 裁剪 -> 添加水印
        Img.from(FileUtil.file("e:/pic/sample.jpg"))
            .scale(0.5f) // 缩放图片，比例为0.5
            .cut(50, 50, 150, 150) // 裁剪图片，指定起始坐标和裁剪区域的宽高
            .pressText("Watermark", Color.WHITE, new Font("黑体", Font.BOLD, 30), 0, 0, 0.7f) // 添加文字水印
            .write(FileUtil.file("e:/pic/sample_processed.jpg")); // 保存最终处理结果
    }
}

3. 实际应用场景

• 电商平台图片处理：在上传商品图片时，通过 Img 实现图片的裁剪、缩放、添加品牌水印等操作，确保图片统一规格和品牌标识。
• 社交媒体应用：用户上传头像时，可以使用 Img 实现图片的圆形裁剪、压缩，提升用户体验并节省存储空间。
• 图像优化：在需要将大图片压缩为适合网络传输的小图片时，通过 Img 进行高效的图片压缩。

4. 注意事项

• 在处理较大图片时，建议考虑内存占用，避免发生内存溢出问题。
• 压缩 JPG 图片时，设置的压缩比率不宜过低，否则会影响图片质量。