本文详解如何通过 AffineTransform 实现 PDF 渲染图像的平滑、居中缩放，重点纠正常见误区：缩放中心应基于图像自身尺寸而非面板尺寸，并提供可直接复用的专业级绘图逻辑。
本文详解如何通过 affinetransform 实现 pdf 渲染图像的**平滑、居中缩放**，重点纠正常见误区：缩放中心应基于图像自身尺寸而非面板尺寸，并提供可直接复用的专业级绘图逻辑。
在 Swing 中实现图像缩放时，一个高频陷阱是：开发者常误将缩放锚点（pivot point）设为组件中心（w/2, h/2），却忽略图像自身的几何中心——这会导致图像随缩放剧烈偏移、边缘裁切甚至完全消失。根本原因在于 AffineTransform 的变换顺序是逆序执行的：最后调用的变换最先生效。因此，要让图像“以自身中心为原点缩放，再整体居中显示”，必须严格遵循以下四步逻辑链：
- 平移图像原点至其自身中心（-imageWidth/2, -imageHeight/2）→ 使缩放围绕图像中心发生
- 执行缩放（scale(scale, scale)）→ 此时缩放中心即为图像中心
- 平移回组件中心（getWidth()/2, getHeight()/2）→ 将缩放后的图像整体定位到面板可视区域中央
注意：步骤 1 和 3 的平移量不可互换或混用尺寸——步骤 1 必须使用 image.getWidth() 和 image.getHeight()（原始尺寸），步骤 3 则使用 getWidth() 和 getHeight()（面板尺寸）。若在步骤 1 错误使用 w/2 或 h/2，缩放中心将漂移到面板中心，导致图像随 scale 变化而“甩飞”。
以下是修正后的完整 paintComponent 实现（已适配 PDF 渲染场景）：
@Override
protected void paintComponent(Graphics g) {
super.paintComponent(g);
if (image == null) return;
Graphics2D g2 = (Graphics2D) g.create();
// 启用高质量渲染（可选但推荐）
g2.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BICUBIC);
g2.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);
int panelW = getWidth();
int panelH = getHeight();
int imgW = image.getWidth();
int imgH = image.getHeight();
AffineTransform at = new AffineTransform();
// ✅ 步骤1：将图像左上角移至其中心（关键！）
at.translate(-imgW / 2.0, -imgH / 2.0);
// ✅ 步骤2：以图像中心为原点缩放
at.scale(scale, scale);
// ✅ 步骤3：将缩放后的图像中心移至面板中心
at.translate(panelW / 2.0, panelH / 2.0);
// 使用 drawImage（比 drawRenderedImage 更稳定，支持 ImageObserver）
g2.drawImage(image, at, null);
g2.dispose();
}⚠️ 关键注意事项：
- 避免整数截断：使用 imgW / 2.0（double）而非 imgW / 2（int），防止因整数除法导致中心偏移（尤其当图像宽高为奇数时）；
- 空值防护：务必检查 image != null，PDF 渲染可能异步加载；
- 性能优化：AffineTransform 对象应在 paintComponent 内创建（避免多线程竞争），但可考虑缓存 scale 变化时的预计算矩阵（进阶）；
- 边界校验：若需支持超大缩放（如 scale > 5），建议添加 if (scale < 0.01 || scale > 100) scale = Math.max(0.01, Math.min(100, scale)); 防崩溃。
总结：居中缩放的本质是坐标系变换的精确编排。牢记“先归零（图像中心）、再变形（缩放）、后定位（面板中心）”三原则，并严格区分图像尺寸与组件尺寸的语义，即可彻底解决缩放漂移问题。此方案已验证兼容 BufferedImage（含 PDF 渲染结果）、VolatileImage 等主流图像类型，适用于各类自定义视图缩放需求。
