Java javax.imageio.spi 类 ImageWriterSpi（JDK5）

所有类

javax.imageio.spi
类 ImageWriterSpi

java.lang.Object
  javax.imageio.spi.IIOServiceProvider
      javax.imageio.spi.ImageReaderWriterSpi
          javax.imageio.spi.ImageWriterSpi

所有已实现的接口：

RegisterableService

public abstract class ImageWriterSpi
   
   
   
   
   
extends ImageReaderWriterSpi
   
   
   
   
   

用于 ImageWriter 的服务提供程序接口 (SPI)。有关服务提供程序类的更多信息，请参见 IIORegistry 类的注释。

每个 ImageWriterSpi 都提供了有关与之关联的 ImageWriter 类的几种类型的信息。

使用 getVendorName、getDescription 和 getVersion 方法可获得定义 SPI 类和此类简明描述的供应商的名称。可将这些方法进行国际化，以提供特对于语言环境的输出。这些方法主要用于提供可用于组织弹出菜单或其他列表的简短可写信息。

使用 getFormatNames、getFileSuffixes 和 getMIMEType 方法可获得与服务有关联的格式名称、文件后缀和 MIME 类型的列表。使用这些方法可识别候选 ImageWriter，从而基于手动格式选择、文件命名或 MIME 关联写入特定文件或流。

canEncodeImage 方法提供了确定最有可能解析特定数据流的 ImageWriter 的更可靠途径。此方法允许服务提供程序检查实际的图像内容。

最后，通过调用 createWriterInstance 方法，可获得与此服务提供程序关联的 ImageWriter 类的实例。任何重量级的初始化，例如加载本地库或创建大的表，都应推迟，至少应该推迟到完成此方法的第一次调用。

另请参见：

IIORegistry, ImageTypeSpecifier, ImageWriter

STANDARD_OUTPUT_TYPE

public static final Class[] STANDARD_OUTPUT_TYPE

从 getInputTypes 返回的单元素数组，该数组最初包含 ImageInputStream.class。

outputTypes

protected Class[] outputTypes

将从 getOutputTypes 返回的 Class 对象的数组，该数组最初为 null。

readerSpiNames

protected String[] readerSpiNames

将从 getImageReaderSpiNames 返回的字符串数组，该数组最初为 null。

ImageWriterSpi

protected ImageWriterSpi()

构造一个空的 ImageWriterSpi。为提供所有方法的可用版本，由子类负责初始化实例变量和/或重写方法实现。

ImageWriterSpi

public ImageWriterSpi(String vendorName,
                      String version,
                      String[] names,
                      String[] suffixes,
                      String[] MIMETypes,
                      String writerClassName,
                      Class[] outputTypes,
                      String[] readerSpiNames,
                      boolean supportsStandardStreamMetadataFormat,
                      String nativeStreamMetadataFormatName,
                      String nativeStreamMetadataFormatClassName,
                      String[] extraStreamMetadataFormatNames,
                      String[] extraStreamMetadataFormatClassNames,
                      boolean supportsStandardImageMetadataFormat,
                      String nativeImageMetadataFormatName,
                      String nativeImageMetadataFormatClassName,
                      String[] extraImageMetadataFormatNames,
                      String[] extraImageMetadataFormatClassNames)

用给定的一组值构造 ImageWriterSpi。

参数：

vendorName - 供应商名称，它是一个非 null 的 String。

version - 版本标识符，它是一个非 null 的 String。

names - 指示格式名称的一个非 null 的 String 数组。必须至少有一个项。

suffixes - 指示常用文件后缀的 String 数组。如果没有定义后缀，则应指定为 null。长度为 0 的数组将被标准化为 null。

MIMETypes - 指示格式的 MIME 类型的 String 数组。如果没有定义后缀，则应指定为 null。长度为 0 的数组将被标准化为 null。

writerClassName - 所关联的 ImageWriterSpi 类的完全限定名，它为一个非 null 的 String。

outputTypes - 指示合法的输出类型的长度至少为 1 的 Class 对象的数组。

readerSpiNames - 命名所有与 ImageReader 关联的类的长度至少为 1 的 String 数组，或者为 null。长度为 0 的数组将被标准化为 null。

supportsStandardStreamMetadataFormat - 一个 boolean 值，指示流元数据对象是否可使用由标准元数据格式描述的树。

nativeStreamMetadataFormatName - 从 getNativeStreamMetadataFormatName 返回的一个 String，或者为 null。

nativeStreamMetadataFormatClassName - 将用于实例化从 getNativeStreamMetadataFormat 返回的元数据格式对象的 String，或者为 null。

extraStreamMetadataFormatNames - 从 getExtraStreamMetadataFormatNames 返回的 String 数组，或者为 null。长度为 0 的数组将被标准化为 null。

extraStreamMetadataFormatClassNames - 用于实例化从 getStreamMetadataFormat 返回的元数据格式对象的 String 数组，或者为 null。长度为 0 的数组将被标准化为 null。

supportsStandardImageMetadataFormat - 一个 boolean 值，指示图像元数据对象是否可使用由标准元数据格式描述的树。

nativeImageMetadataFormatName - 从 getNativeImageMetadataFormatName 返回的一个 String，或者为 null。

nativeImageMetadataFormatClassName - 用于实例化从 getNativeImageMetadataFormat 返回的元数据格式对象的 String，或者为 null。

extraImageMetadataFormatNames - 从 getExtraImageMetadataFormatNames 返回的 String 数组。长度为 0 的数组将被标准化为 null。

extraImageMetadataFormatClassNames - 用于实例化从 getImageMetadataFormat 返回的元数据格式对象的 String 数组，或者为 null。长度为 0 的数组将被标准化为 null。

抛出：

IllegalArgumentException - 如果 vendorName 为 null。

IllegalArgumentException - 如果 version 为 null。

IllegalArgumentException - 如果 names 为 null 或长度为 0。

IllegalArgumentException - 如果 writerClassName 为 null。

IllegalArgumentException - 如果 outputTypes 为 null 或长度为 0。

isFormatLossless

public boolean isFormatLossless()

如果此 writer 输出的格式准确保留了像素数据位，则返回 true。默认实现返回 true。

返回：

如果格式完全保留了像素的准确性，则返回 true。

getOutputTypes

public Class[] getOutputTypes()

返回 Class 对象数组，指示可用作 setOutput 方法参数的对象类型。

对于大多数只输出到 ImageOutputStream 的 writer，应返回一个包含 ImageOutputStream.class 的单元素数组。

返回：

长度至少为 1 的、非 null 的 Class 对象数组。

canEncodeImage

public abstract boolean canEncodeImage(ImageTypeSpecifier type)

如果与此服务提供程序关联的 ImageWriter 实现能够使用给定的布局编码图像，则返回 true。布局（即 图像的 SampleModel 和 ColorModel）由 ImageTypeSpecifier 对象描述。

返回的值为 true 并不能绝对保证成功地编码；编码过程中仍有可能因为类似 I/O 错误、不一致或错误的数据结构等而产生错误。执行对图像的基本结构的合理检查是为了确定图像是否处在编码格式范围内。例如，如果要求一个只能编码灰度格式的服务提供程序处理 RGB BufferedImage，将返回 false。类似地，能够编码 8 位 RGB 图像格式的服务提供程序可能拒绝编码与 alpha 通道关联的图像。

不同的 ImageWriter 以及由此导致的不同的服务提供程序，可以更严格或更松散。例如，即使为了存储而不得不减少每个图像的像素，从而使精度下降，也有可能接受预乘 alpha 的图像。

参数：

type - 指定将要写入的图像的布局的 ImageTypeSpecifier。

返回：

如果 writer 看起来能够按给定的布局编码此图像，则返回 true。

抛出：

IllegalArgumentException - 如果 type 为 null。

canEncodeImage

public boolean canEncodeImage(RenderedImage im)

如果与此服务提供程序关联的 ImageWriter 实现能够编码给定的 RenderedImage 实例，则返回 true。注意，这包括 java.awt.image.BufferedImage 的实例。

有关此方法的语义信息，请参见对 canEncodeImage(ImageTypeSpecifier) 的讨论。

参数：

im - 要编码的 RenderedImage 的实例。

返回：

如果 writer 看起来能够编码此图像，则返回 true。

抛出：

IllegalArgumentException - 如果 im 为 null。