使用Graphics2D将矩形图像裁剪为指定直径圆形，经ImageIO读取仍显示完整原图

常见踩坑点 #

• 依赖Graphics2D的setClip做裁剪时，仅能限定绘制操作的生效范围，不会自动给裁剪范围外的像素设置透明属性——虽然新建的ARGB图像默认是全透明状态，但这种依赖初始值的写法很容易因为上下文状态混乱出问题，本质上没有主动清空画布的操作，一旦有残留像素，就会出现“看起来裁剪了，实际整张图都是不透明的”的情况。
• 原代码里定义圆形的尺寸写错了：用宽作为椭圆的宽高，也就是Arc2D.Double(0,0,w,w)，如果原图不是正方形，圆形要么超出边界，要么不居中，根本没法得到标准正圆。
• 代码顺序问题：把g2.dispose()放在文件读取逻辑之后，绘制内容没有完全提交到像素数组时就做读写操作，很容易出现文件内容和预期不符的问题。
• 创建输出图像时如果选了不带alpha通道的类型（比如TYPE_INT_RGB），哪怕用setClip画了圆形，clip外的区域也会保留不透明像素，根本达不到透明裁剪的效果。
• 读回图像后渲染时丢失了alpha通道的合成逻辑：带透明通道的PNG被读回来后，如果渲染的组件默认不透明，透明像素会被组件背景覆盖，视觉上就和没裁剪的完整矩形原图没有区别，很容易误以为是裁剪环节出了问题。

正确实现逻辑 #

按照以下步骤调整代码，即可稳定得到带透明通道的正圆裁剪效果：

1. 取原图的短边作为正圆直径，保证正圆能完整落在画布范围内
2. 计算正圆的居中坐标，避免圆形偏移
3. 先手动把整个画布清空为全透明状态，从根源上杜绝残留像素的问题
4. 开启抗锯齿，让圆形边缘更平滑
5. 在圆形裁剪范围内绘制原图
6. 绘制完成后立刻释放Graphics2D上下文，再执行文件的写入和读取操作

int w = bufferedImage.getWidth();
int h = bufferedImage.getHeight();
// 取短边作为正圆直径，保证圆形不超出画布
int circleDiameter = Math.min(w, h);
// 计算正圆居中坐标
int circleX = (w - circleDiameter) / 2;
int circleY = (h - circleDiameter) / 2;

BufferedImage output = new BufferedImage(w, h, BufferedImage.TYPE_INT_ARGB);
Graphics2D g2 = output.createGraphics();
// 开启抗锯齿，消除圆形边缘的锯齿
g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);

// 先把整个画布填充为全透明，清除所有初始残留像素
g2.setComposite(AlphaComposite.Clear);
g2.fillRect(0, 0, w, h);
// 切回正常的alpha合成模式，准备绘制原图
g2.setComposite(AlphaComposite.SrcOver);

// 定义正圆蒙版
Ellipse2D circleMask = new Ellipse2D.Double(circleX, circleY, circleDiameter, circleDiameter);
g2.setClip(circleMask);
// 在蒙版范围内绘制原图
g2.drawImage(bufferedImage, circleX, circleY, circleDiameter, circleDiameter, null);

// 所有绘制操作完成后立刻释放图形上下文
g2.dispose();
bufferedImage = output;

try {
    // 只有PNG格式支持存储alpha透明通道
    ImageIO.write(bufferedImage, "png", new File("D:/new.png"));
    // 读回文件做验证
    BufferedImage readbackImg = ImageIO.read(new File("D:/new.png"));
} catch (IOException e) {
    e.printStackTrace();
}

额外注意事项 #

• 保存裁剪结果时必须使用PNG格式，JPG、BMP等格式不支持存储透明通道，保存后圆形外的区域会被自动填充为纯黑色，完全达不到裁剪效果。
• 读回图像后渲染时，要确保渲染目标的图形上下文支持alpha合成，否则透明像素会被直接丢弃，视觉上看起来和未裁剪的原图完全一致。
• 生产环境中尽量不要用Arc2D的PI类型做圆形蒙版，用Ellipse2D实现正圆的兼容性更好，不会因为角度参数设置错误出现边缘缺口。

内容的提问来源于stack exchange，提问作者sogytots