Java Swing中UI缩放与离屏缓冲下如何避免图文失真？

问题核心在于：高DPI屏幕上Swing会对UI应用逻辑像素到物理像素的缩放，但手动创建的离屏图像是基于逻辑像素尺寸的。当把这个图像绘制到组件时，Swing会将其作为光栅图像再次缩放，导致文本、线条等矢量内容模糊失真；而直接绘制到组件的Graphics2D已经自动应用了缩放变换，因此显示清晰。

解决方案步骤 #

要创建感知缩放的离屏缓冲，需按以下步骤处理：

1. 获取组件当前的UI缩放因子；
2. 创建对应物理像素尺寸的缓冲图像；
3. 在缓冲的Graphics2D上预先应用缩放变换，确保矢量内容按物理像素渲染；
4. 绘制缓冲图像时，指定逻辑像素尺寸，避免Swing再次缩放。

修改后的示例代码 #

import java.awt.*;
import java.awt.geom.Line2D;
import java.awt.geom.AffineTransform;
import javax.swing.JComponent;
import javax.swing.JFrame;

public class Main {
    public static void main(String[] args) {
        JFrame jf = new JFrame("Demo");
        Container cp = jf.getContentPane();
        MyCanvas tl = new MyCanvas();
        cp.add(tl);
        jf.setSize(500, 250);
        jf.setVisible(true);
        jf.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    }
}

class MyCanvas extends JComponent {

    // 实现感知缩放的离屏缓冲创建方法
    private Image createScalingAwareBuffer(JComponent component, int logicalWidth, int logicalHeight) {
        // 获取组件的缩放变换
        GraphicsConfiguration gc = component.getGraphicsConfiguration();
        AffineTransform transform = gc.getDefaultTransform();
        double scaleX = transform.getScaleX();
        double scaleY = transform.getScaleY();

        // 计算物理像素尺寸
        int physicalWidth = (int) Math.round(logicalWidth * scaleX);
        int physicalHeight = (int) Math.round(logicalHeight * scaleY);

        // 创建对应物理尺寸的缓冲图像
        return gc.createCompatibleImage(physicalWidth, physicalHeight, Transparency.TRANSLUCENT);
    }

    @Override
    public void paintComponent(Graphics g) {
        if (g instanceof Graphics2D g2) {
            g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
                RenderingHints.VALUE_ANTIALIAS_ON);

            // 直接渲染到组件（作为对比）
            g2.setFont(Font.decode("Times New Roman-26"));
            g2.drawString("The properly-scaled cake is NOT a lie.", 70, 40);
            g2.setStroke(new BasicStroke(2.3f));
            g2.draw(new Line2D.Double(420, 10, 425, 70));

            // 创建感知缩放的离屏缓冲
            Image offscreen = createScalingAwareBuffer(this, 500, 150);
            Graphics2D g2Off = (Graphics2D) offscreen.getGraphics();
            
            // 应用缩放变换到缓冲的Graphics2D
            GraphicsConfiguration gc = getGraphicsConfiguration();
            AffineTransform transform = gc.getDefaultTransform();
            g2Off.transform(transform);

            // 配置渲染参数，和直接渲染一致
            g2Off.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
                RenderingHints.VALUE_ANTIALIAS_ON);
            g2Off.setColor(Color.BLACK);
            g2Off.setFont(Font.decode("Times New Roman-26"));
            g2Off.drawString("The properly-scaled cake is NOT a lie.", 70, 40);
            g2Off.setStroke(new BasicStroke(2.3f));
            g2Off.draw(new Line2D.Double(420, 10, 425, 70));
            
            g2Off.dispose();

            // 绘制缓冲图像时指定逻辑尺寸，避免二次缩放
            g2.drawImage(offscreen, 0, 130, 500, 150, null);
        }
    }
}

关键细节说明 #

• 获取缩放因子：通过组件的GraphicsConfiguration.getDefaultTransform()获取系统自动应用的缩放变换，这比手动计算DPI更可靠，直接反映Swing当前的UI缩放设置。
• 物理尺寸缓冲：创建和物理像素匹配的图像，确保矢量内容渲染时有足够的分辨率。
• 预应用缩放：在缓冲的Graphics2D上应用缩放变换，使绘制的文本、线条直接按物理像素渲染，效果与直接绘制到组件完全一致。
• 指定逻辑尺寸绘制：调用drawImage时传入逻辑宽度和高度，Swing会直接将物理像素图像映射到逻辑区域，不会再进行光栅缩放。

额外注意事项 #

• 动画场景中建议复用缓冲图像，避免每次paintComponent都创建新图像，提升性能。
• 使用createCompatibleImage确保图像与当前显示设备的颜色模型匹配，减少额外的颜色转换开销。

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