Java 9 多Resolution图像API：响应式图形处理

MultiResolutionImage API

Java 9 引入 java.awt.image.MultiResolutionImage 接口及基础实现 BaseMultiResolutionImage，将不同分辨率的图像变体封装为单一逻辑图像，运行时自动选择最佳变体。

核心方法

• Image getResolutionVariant(double destWidth, double destHeight)：返回目标尺寸下最佳变体（就近匹配，不放大）。
• List getResolutionVariants()：返回所有变体的只读列表。
• 继承 Image 方法：getWidth()、getHeight() 返回基础变体尺寸（通常为最大分辨率）。

完整示例

import java.awt.Image;
import java.awt.image.BaseMultiResolutionImage;
import java.awt.image.MultiResolutionImage;
import java.io.IOException;
import java.net.URL;
import java.util.ArrayList;
import java.util.List;
import javax.imageio.ImageIO;

public class Tester {
    public static void main(String[] args) throws IOException {
        List imgUrls = List.of(
            "https://example.com/images/logo.png",      // 311x89
            "https://example.com/images/mini_logo.png", // 156x45
            "https://example.com/images/large_logo.png" // 622x178
        );

        List images = new ArrayList<>();
        for (String url : imgUrls) {
            images.add(ImageIO.read(new URL(url)));
        }

        MultiResolutionImage mri = new BaseMultiResolutionImage(
            images.toArray(new Image[0]));

        // 列出所有变体
        List variants = mri.getResolutionVariants();
        System.out.println("Total variants: " + variants.size());
        for (Image img : variants) {
            System.out.println(img);
        }

        // 请求不同目标尺寸
        Image v1 = mri.getResolutionVariant(156, 45);
        System.out.printf("Dest[156,45] -> [%d,%d]%n", v1.getWidth(null), v1.getHeight(null));
        
        Image v2 = mri.getResolutionVariant(311, 89);
        System.out.printf("Dest[311,89] -> [%d,%d]%n", v2.getWidth(null), v2.getHeight(null));
        
        Image v3 = mri.getResolutionVariant(622, 178);
        System.out.printf("Dest[622,178] -> [%d,%d]%n", v3.getWidth(null), v3.getHeight(null));
        
        Image v4 = mri.getResolutionVariant(300, 300);
        System.out.printf("Dest[300,300] -> [%d,%d]%n", v4.getWidth(null), v4.getHeight(null));
    }
}

输出解析

Total variants: 3
BufferedImage@... width=311 height=89
BufferedImage@... width=156 height=45
BufferedImage@... width=622 height=178

Dest[156,45] -> [311,89]      // 无精确匹配，选最接近不小于目标的变体
Dest[311,89] -> [311,89]      // 精确匹配
Dest[622,178] -> [622,178]    // 精确匹配
Dest[300,300] -> [622,178]    // 无匹配，选最大变体

选取算法

1. 若有变体尺寸 完全等于 目标尺寸 → 直接返回。
2. 否则选 宽高均不小于目标尺寸 中面积最小的变体。
3. 若无变体满足不小于条件 → 返回 最大分辨率 变体（允许缩小渲染）。

应用场景

• HiDPI/Retina 显示适配：同一逻辑图像自动选择 1x/2x/3x 变体。
• 响应式 Web/桌面 UI：组件尺寸变化时自动切换最优图像资源。
• 打印与导出：请求高分辨率变体用于打印输出。
• 缩略图生成：请求小尺寸变体避免客户端下载大图再缩放。

注意事项

• 变体列表顺序不影响选择算法，但建议按分辨率升序提供。
• 所有变体应表示同一视觉内容，仅分辨率不同。
• API 仅在 AWT/Swing 环境可用，Headless 模式需配置 -Djava.awt.headless=false 或使用无头图像库。