Module java.desktop

Package java.awt.image

Interface MultiResolutionImage

所有已知的实现类:

AbstractMultiResolutionImage, BaseMultiResolutionImage

       public interface MultiResolutionImage
      

该接口被设计为一种可选的附加API，由一些实现Image的类支持，以便它们可以为不同的渲染分辨率提供替代图像。各种Graphics.drawImage(...)变体方法将在实现了该接口的Image对象上查询这个接口的方法，以便为每个渲染操作选择最佳的表示形式。

MultiResolutionImage接口应该由任何java.awt.Image的子类实现，其实例旨在根据给定的图像宽度和高度提供图像分辨率变体。为方便起见，从Toolkit.getImage(String name)和Toolkit.getImage(URL url)获取的工具图像将在支持存储图像媒体分辨率变体命名约定的平台上实现这个接口，并且提供了AbstractMultiResolutionImage和BaseMultiResolutionImage类，以便从相关图像列表轻松构建自定义多分辨率图像。

自 JDK 版本:

9

参见:

• Image
• AbstractMultiResolutionImage
• BaseMultiResolutionImage
• Toolkit.getImage(java.lang.String filename)
• Toolkit.getImage(java.net.URL url)

Method Summary

Modifier and Type	Method	Description
Image	getResolutionVariant(double destImageWidth, double destImageHeight)	获取一个最适合表示此逻辑图像的指定大小的特定图像。
List<Image>	getResolutionVariants()	获取所有分辨率变体的可读列表。

Method Details

getResolutionVariant

             Image getResolutionVariant(double destImageWidth, double destImageHeight)
            

获取一个最适合表示此逻辑图像的指定大小的特定图像。

参数:

destImageWidth - 目标图像的宽度，以像素为单位。

destImageHeight - 目标图像的高度，以像素为单位。

返回值:

图像分辨率变体。

抛出:

IllegalArgumentException - 如果destImageWidth或destImageHeight小于或等于零、无穷大或NaN。

自 JDK 版本:

9

getResolutionVariants

             List<Image> getResolutionVariants()
            

获取所有分辨率变体的可读列表。列表必须非空，并且至少包含一个分辨率变体。

请注意，许多实现可能返回一个不可修改的列表。

返回值:

分辨率变体的列表。

自 JDK 版本:

9