ImageWriteParam (Java Platform SE 8 )

java.lang.Object
- javax.imageio.IIOParam
- - javax.imageio.ImageWriteParam

已知直接子类：

BMPImageWriteParam， JPEGImageWriteParam
```
public class ImageWriteParam
extends IIOParam
```
描述要被编码的流的一个类。这类或其子类的实例，用实例 ImageWriter供应规定“如何做”的信息。
一个插件为特定的图像格式也可以定义该类的子类，并从其ImageWriter实施getDefaultWriteParam方法返回对象的类。例如，内置JPEG作家插件将返回的实例javax.imageio.plugins.jpeg.JPEGImageWriteParam。

的图像被写入的区域由第一交叉图像的实际范围指定IIOParam.setSourceRegion矩形确定，如果任何。如果得到的矩形的宽度或高度为零，笔者将抛出一个IIOException。如果交集非空，写作将开始第一次采样的像素，根据水平和垂直采样因子指定IIOParam.setSourceSubsampling包括额外的像素内相交的边界。

个人特征如平铺，渐进式编码，压缩可以在四种模式之一。MODE_DISABLED禁用功能；MODE_DEFAULT使特征与作家的控制参数值；MODE_EXPLICIT使特征允许一个set方法的使用提供了额外的参数；并MODE_COPY_FROM_METADATA拷贝相关参数值从流和图像元数据对象传递给作家。的所有功能，默认是MODE_COPY_FROM_METADATA。鼓励在子类中提供的非标准功能，但不需要使用类似的方案。

塞在作家可能通过提供一个类实现额外的扩展功能插件ImageWriteParam，特定的接口。它是由插件来记录什么接口是可用的，以及它们是如何被使用的。作家会默默地忽略任何扩展功能的其中一个ImageWriteParam类的他们不知道。同时，他们可能忽略任何可选的功能，他们通常禁用在创建自己的ImageWriteParam实例通过getDefaultWriteParam。

注意，除非有能力查询的方法是存在的，它必须由所有ImageWriter实现支持（例如渐进编码是可选的，但抽样必须支持）。

另请参见：

ImageReadParam

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`canOffsetTiles` 这是一 `boolean` `true`如果这 `ImageWriteParam`允许拼接网格偏移参数设置。
`protected boolean`	`canWriteCompressed` 这是一 `boolean` `true`如果这个作家写的图像进行压缩。
`protected boolean`	`canWriteProgressive` 这是一 `boolean` `true`如果这 `ImageWriteParam`允许图像被写成一个渐进序列通过提高质量。
`protected boolean`	`canWriteTiles` 这是一 `boolean` `true`如果这 `ImageWriteParam`允许瓦宽度和瓷砖高度参数设置。
`protected int`	`compressionMode` 模式控制压缩设置，必须设置一个四 `MODE_*`值。
`protected float`	`compressionQuality` 一个 `float`包含当前压缩质量设置。
`protected String`	`compressionType` 一个 `String`包含当前压缩类型的名称，或 `null`如果没有设置。
`protected String[]`	`compressionTypes` 含有可用的压缩类型的名字 `String`s数组。
`protected Locale`	`locale` 一个 `Locale`用来定位压缩类型名称和质量说明，或 `null`使用默认 `Locale`。
`static int`	`MODE_COPY_FROM_METADATA` 一个恒定值，可以传递到方法如 `setTilingMode`， `setProgressiveMode`，或 `setCompressionMode`使未来的写作特征。
`static int`	`MODE_DEFAULT` 一个恒定值，可以传递到方法如 `setTilingMode`， `setProgressiveMode`和 `setCompressionMode`，使未来的写作特征。
`static int`	`MODE_DISABLED` 一个恒定值，可以传递到方法如 `setTilingMode`， `setProgressiveMode`，和 `setCompressionMode`今后禁用功能写。
`static int`	`MODE_EXPLICIT` 一个恒定值，可以传递到方法如 `setTilingMode`或 `setCompressionMode`使未来的写作特征。
`protected Dimension[]`	`preferredTileSizes` 一个首选的瓷砖尺寸范围对数组。
`protected int`	`progressiveMode` 模式控制渐进编码，必须设置一个四 `MODE_*`值，除了 `MODE_EXPLICIT`。
`protected int`	`tileGridXOffset` 通过网格的起源应该偏离图像来源的水平如果瓦片已确定的数额，或0否则。
`protected int`	`tileGridYOffset` 通过网格的起源应该偏离垂直平铺图像来源如果已设置的数量，或0否则。
`protected int`	`tileHeight` 每瓦的高度，如果瓷砖已定，或0否则。
`protected int`	`tileWidth` 每个区块的宽度如果瓷砖已定，或0否则。
`protected int`	`tilingMode` 模式控制平铺设置，必须设置一个四 `MODE_*`值。
`protected boolean`	`tilingSet` 这是一 `boolean` `true`如果平铺参数指定了。

Fields inherited from class javax.imageio.IIOParam
controller, defaultController, destinationOffset, destinationType, sourceBands, sourceRegion, sourceXSubsampling, sourceYSubsampling, subsamplingXOffset, subsamplingYOffset

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`ImageWriteParam()` 构造一个空 `ImageWriteParam`。
	`ImageWriteParam(Locale locale)` 构建了一个 `ImageWriteParam`设置使用一个给定的 `Locale`。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`boolean`	`canOffsetTiles()` 返回 `true`如果作者能进行非零偏移而写作平铺网格。
`boolean`	`canWriteCompressed()` 返回 `true`如果笔者支持压缩。
`boolean`	`canWriteProgressive()` 返回 `true`如果作者能写出来的图像为一系列逐渐增加的质量传递。
`boolean`	`canWriteTiles()` 返回 `true`如果作者能进行拼接而写作。
`float`	`getBitRate(float quality)` 返回的 `float`表示在给定的质量水平的输入图像数据的每个比特输出数据位的数量估计。
`int`	`getCompressionMode()` 返回当前压缩模式，如果支持压缩。
`float`	`getCompressionQuality()` 返回当前压缩质量设置。
`String[]`	`getCompressionQualityDescriptions()` 返回 `String`s可能随着 `getCompressionQualityValues`为设置或显示压缩质量水平的用户界面部分的数组。
`float[]`	`getCompressionQualityValues()` 返回一个数组，可以使用 `float`s随着 `getCompressionQualityDescriptions`为设置或显示压缩质量水平的用户界面的一部分。
`String`	`getCompressionType()` 返回当前设置压缩式，或 `null`如果没有设置。
`String[]`	`getCompressionTypes()` 返回一个列表，可用的压缩类型，如数组或 `String`s，或 `null`如果压缩类型可能不选择使用这些接口。
`Locale`	`getLocale()` 返回当前设置 `Locale`，或 `null`如果只有默认的 `Locale`支持。
`String`	`getLocalizedCompressionTypeName()` 返回一个本地化版本的当前的压缩类型的名称，使用 `Locale`返回 `getLocale`。
`Dimension[]`	`getPreferredTileSizes()` 返回 `Dimension`s说明瓷砖的尺寸范围为法律他们将输出文件或流中编码的数组。
`int`	`getProgressiveMode()` 返回以渐进方式写入流的当前模式。
`int`	`getTileGridXOffset()` 返回一个图像的水平瓦栅偏移量，因为它将被写入到输出流中。
`int`	`getTileGridYOffset()` 返回一个图像的垂直瓦栅偏移量，因为它将被写入到输出流中。
`int`	`getTileHeight()` 返回一个图像中的每个瓦片的高度，因为它将被写入到输出流中。
`int`	`getTileWidth()` 返回一个图像中的每个瓦片的宽度，因为它将被写入到输出流中。
`int`	`getTilingMode()` 返回当前平铺模式，如果平铺的支持。
`boolean`	`isCompressionLossless()` 返回 `true`如果当前压缩类型提供无损压缩。
`void`	`setCompressionMode(int mode)` 指定是否要执行压缩，如果是这样的话，如何确定压缩参数。
`void`	`setCompressionQuality(float quality)` 设置一 `0`和 `1`之间价值的压缩质量。
`void`	`setCompressionType(String compressionType)` 设置一个值表示的 `getCompressionTypes`压缩式。
`void`	`setProgressiveMode(int mode)` 指定作者是在一个渐进的模式，这样的数据流将包含一系列的扫描质量提高的图像。
`void`	`setTiling(int tileWidth, int tileHeight, int tileGridXOffset, int tileGridYOffset)` 指定在输出流中应将图像拼接。
`void`	`setTilingMode(int mode)` 确定图像将平铺在输出流，如果它将如何平铺参数将决定。
`void`	`unsetCompression()` 删除任何以前的压缩类型和质量设置。
`void`	`unsetTiling()` 删除任何以前的平铺网格参数指定的电话 `setTiling`。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - MODE_DISABLED
```
public static final int MODE_DISABLED
```
    一个恒定值，可以传递到方法如 setTilingMode， setProgressiveMode，和 setCompressionMode今后禁用功能写。那就是，当这个模式设置流将不平铺，渐进的，或压缩，以及相关的访问器方法将抛出一个 IllegalStateException。
    
    另请参见：
    
    MODE_EXPLICIT， MODE_COPY_FROM_METADATA， MODE_DEFAULT， setProgressiveMode(int)， getProgressiveMode()， setTilingMode(int)， getTilingMode()， setCompressionMode(int)， getCompressionMode()， Constant Field Values
  - MODE_DEFAULT
```
public static final int MODE_DEFAULT
```
    一个恒定值，可以传递到方法如 setTilingMode， setProgressiveMode和 setCompressionMode，使未来的写作特征。那就是，当这个模式被激活的流将平铺的，渐进的，或压缩根据合理的默认选择的内部由作者在插件依赖的途径，以及相关的访问器方法将抛出一个 IllegalStateException。
    
    另请参见：
    
    MODE_DISABLED， MODE_EXPLICIT， MODE_COPY_FROM_METADATA， setProgressiveMode(int)， getProgressiveMode()， setTilingMode(int)， getTilingMode()， setCompressionMode(int)， getCompressionMode()， Constant Field Values
  - MODE_EXPLICIT
```
public static final int MODE_EXPLICIT
```
    一个恒定值，可以传递到方法如 setTilingMode或 setCompressionMode使未来的写作特征。那就是，当这个模式被设置流将平铺或压缩根据附加信息提供给这类和检索从相应的 get方法相应的 set方法。请注意，这种模式不支持渐进输出。
    
    另请参见：
    
    MODE_DISABLED， MODE_COPY_FROM_METADATA， MODE_DEFAULT， setProgressiveMode(int)， getProgressiveMode()， setTilingMode(int)， getTilingMode()， setCompressionMode(int)， getCompressionMode()， Constant Field Values
  - MODE_COPY_FROM_METADATA
```
public static final int MODE_COPY_FROM_METADATA
```
    一个恒定值，可以传递到方法如 setTilingMode， setProgressiveMode，或 setCompressionMode使未来的写作特征。那就是，当这个模式被激活的流将平铺的，渐进的，或基于内容的压缩流和/或图像元数据传递到写操作，和任何相关的访问器方法将抛出一个 IllegalStateException。
    这是所有功能的默认模式，因此，一个包括元数据的阅读，包括一个写，包括元数据将尽可能保存尽可能多的信息。
    
    另请参见：
    
    MODE_DISABLED， MODE_EXPLICIT， MODE_DEFAULT， setProgressiveMode(int)， getProgressiveMode()， setTilingMode(int)， getTilingMode()， setCompressionMode(int)， getCompressionMode()， Constant Field Values
  - canWriteTiles
```
protected boolean canWriteTiles
```
    这是一 boolean true如果这 ImageWriteParam允许瓦宽度和瓷砖高度参数设置。默认情况下，该值是 false。子类必须手动设置值。
    类不支持文字砖应确保该值设为false。
  - tilingMode
```
protected int tilingMode
```
    模式控制平铺设置，必须设置一个四 MODE_*值。默认的是 MODE_COPY_FROM_METADATA。
    不写瓷砖的子类可能忽略此值。
    
    另请参见：
    
    MODE_DISABLED， MODE_EXPLICIT， MODE_COPY_FROM_METADATA， MODE_DEFAULT， setTilingMode(int)， getTilingMode()
  - preferredTileSizes
```
protected Dimension[] preferredTileSizes
```
    一个首选的瓷砖尺寸范围对数组。默认值是 null，这表明没有优先尺寸。如果该值是非 null，它必须有至少两个偶数长度。
    不支持写瓷砖的子类可能忽略此值。
    
    另请参见：
    
    getPreferredTileSizes()
  - tilingSet
```
protected boolean tilingSet
```
    这是一 boolean true如果平铺参数指定了。
    不支持写瓷砖的子类可能忽略此值。
  - tileWidth
```
protected int tileWidth
```
    每个区块的宽度如果瓷砖已定，或0否则。
    类不支持平铺可以忽略这个值。
  - tileHeight
```
protected int tileHeight
```
    每瓦的高度，如果瓷砖已定，或0否则。初始值是 0。
    类不支持平铺可以忽略这个值。
  - canOffsetTiles
```
protected boolean canOffsetTiles
```
    这是一 boolean true如果这 ImageWriteParam允许拼接网格偏移参数设置。默认情况下，该值是 false。子类必须手动设置值。
    类不支持文字砖，或支持写作而不是抵消砖必须确保该值设为false。
  - tileGridXOffset
```
protected int tileGridXOffset
```
    通过网格的起源应该偏离图像来源的水平如果瓦片已确定的数额，或0否则。初始值是 0。
    不支持偏移的子类可能忽略此值。
  - tileGridYOffset
```
protected int tileGridYOffset
```
    通过网格的起源应该偏离垂直平铺图像来源如果已设置的数量，或0否则。初始值是 0。
    不支持偏移的子类可能忽略此值。
  - canWriteProgressive
```
protected boolean canWriteProgressive
```
    这是一 boolean true如果这 ImageWriteParam允许图像被写成一个渐进序列通过提高质量。默认情况下，该值是 false。子类必须手动设置值。
    类不支持逐行编码必须确保该值设为false。
  - progressiveMode
```
protected int progressiveMode
```
    模式控制渐进编码，必须设置一个四 MODE_*值，除了 MODE_EXPLICIT。默认的是 MODE_COPY_FROM_METADATA。
    不支持渐进编码的子类可能忽略此值。
    
    另请参见：
    
    MODE_DISABLED， MODE_EXPLICIT， MODE_COPY_FROM_METADATA， MODE_DEFAULT， setProgressiveMode(int)， getProgressiveMode()
  - canWriteCompressed
```
protected boolean canWriteCompressed
```
    这是一 boolean true如果这个作家写的图像进行压缩。默认情况下，该值是 false子类必须手动设置值。
    类不支持压缩，必须确保该值设为false。
  - compressionMode
```
protected int compressionMode
```
    模式控制压缩设置，必须设置一个四 MODE_*值。默认的是 MODE_COPY_FROM_METADATA。
    不支持压缩的子类可能忽略此值。
    
    另请参见：
    
    MODE_DISABLED， MODE_EXPLICIT， MODE_COPY_FROM_METADATA， MODE_DEFAULT， setCompressionMode(int)， getCompressionMode()
  - compressionTypes
```
protected String[] compressionTypes
```
    含有可用的压缩类型的名字 Strings数组。子类必须手动设置值。
    不支持压缩的子类可能忽略此值。
  - compressionType
```
protected String compressionType
```
    一个 String包含当前压缩类型的名称，或 null如果没有设置。
    不支持压缩的子类可能忽略此值。
  - compressionQuality
```
protected float compressionQuality
```
    一个 float包含当前压缩质量设置。初始值是 1.0F。
    不支持压缩的子类可能忽略此值。
  - locale
```
protected Locale locale
```
    一个 Locale用来定位压缩类型名称和质量说明，或 null使用默认 Locale。子类必须手动设置值。
- Constructor Detail
  - ImageWriteParam
```
protected ImageWriteParam()
```
    构造一个空 ImageWriteParam。正确设置实例变量是由子类来建立的。
  - ImageWriteParam
```
public ImageWriteParam(Locale locale)
```
    构建了一个 ImageWriteParam设置使用一个给定的 Locale。
    
    参数
    
    locale - Locale用来定位压缩类型名称和质量说明，或 null。
- 方法详细信息
  - getLocale
```
public Locale getLocale()
```
    返回当前设置 Locale，或 null如果只有默认的 Locale支持。
    
    结果
    
    目前 Locale，或 null。
  - canWriteTiles
```
public boolean canWriteTiles()
```
    返回 true如果作者能进行拼接而写作。如果此方法返回 false，然后 setTiling将抛出一个 UnsupportedOperationException。
    
    结果
    
    true如果支持平铺。
    
    另请参见：
    
    canOffsetTiles()， setTiling(int, int, int, int)
  - canOffsetTiles
```
public boolean canOffsetTiles()
```
    返回 true如果作者能进行非零偏移而写作平铺网格。如果此方法返回 false，然后 setTiling如果网格偏移参数不同时为零的抛出一个 UnsupportedOperationException。如果 canWriteTiles返回 false，此方法也会返回 false。
    
    结果
    
    true如果支持非零瓦偏移。
    
    另请参见：
    
    canWriteTiles()， setTiling(int, int, int, int)
  - setTilingMode
```
public void setTilingMode(int mode)
```
    确定图像将平铺在输出流，如果它将如何平铺参数将决定。模式解释如下：
    - MODE_DISABLED -图像将平铺。setTiling将抛出一个IllegalStateException。
    - MODE_DEFAULT -图像将平铺使用默认参数。setTiling将抛出一个IllegalStateException。
    - MODE_EXPLICIT -图像将平铺在setTiling方法根据给定的参数。任何先前设定的参数被丢弃的瓦片。
    - MODE_COPY_FROM_METADATA -图像将符合通过写入元数据对象。setTiling将抛出一个IllegalStateException。
    参数
    
    mode -使用平铺的方式。
    
    异常
    
    UnsupportedOperationException -如果 canWriteTiles返回 false。
    
    IllegalArgumentException -如果 mode不是上面列出的模式。
    
    另请参见：
    
    setTiling(int, int, int, int)， getTilingMode()
  - getTilingMode
```
public int getTilingMode()
```
    返回当前平铺模式，如果平铺的支持。否则抛出一个 UnsupportedOperationException。
    
    结果
    
    目前的拼接模式。
    
    异常
    
    UnsupportedOperationException -如果 canWriteTiles返回 false。
    
    另请参见：
    
    setTilingMode(int)
  - getPreferredTileSizes
```
public Dimension[] getPreferredTileSizes()
```
    返回 Dimensions说明瓷砖的尺寸范围为法律他们将输出文件或流中编码的数组。返回的数组是一个副本。
    作为一组对的信息返回；一对的第一个元素包含一个（包含）最小宽度和高度，和第二个元素包含一个（包含）最大宽度和高度。在一起，每个对定义了一个有效的大小范围。要为两个元素指定一个固定大小，使用相同的宽度和高度。指定一个任意的范围，价值null是用来对Dimensions实际阵列的地方。
    
    如果没有阵列在构造函数中指定，但平铺是允许的，那么这个方法返回null。
    
    结果
    
    一个至少有两个甚至 Dimensions数组长度，或 null。
    
    异常
    
    UnsupportedOperationException如果插件不支持平铺。
  - setTiling
```
public void setTiling(int tileWidth,
                      int tileHeight,
                      int tileGridXOffset,
                      int tileGridYOffset)
```
    指定在输出流中应将图像拼接。的 tileWidth和 tileHeight参数指定文件中的瓷砖的宽度和高度。如果瓦片的宽度或高度大于图像的宽度或高度，则该图像在该尺寸上不被拼接。
    如果canOffsetTiles返回false，然后tileGridXOffset和tileGridYOffset参数必须为零。
    
    参数
    
    tileWidth -每块瓷砖的宽度。
    
    tileHeight -每瓦的高度。
    
    tileGridXOffset -网格水平偏移。
    
    tileGridYOffset -网格垂直偏移。
    
    异常
    
    UnsupportedOperationException如果插件不支持平铺。
    
    IllegalStateException如果平铺模式不 MODE_EXPLICIT。
    
    UnsupportedOperationException如果插件不支持网格和网格偏移，偏移不是零。
    
    IllegalArgumentException如果瓷砖尺寸不在一个允许的范围内 getPreferredTileSizes返回的。
    
    IllegalArgumentException -如果 tileWidth或 tileHeight小于或等于0。
    
    另请参见：
    
    canWriteTiles， canOffsetTiles， getTileWidth()， getTileHeight()， getTileGridXOffset()， getTileGridYOffset()
  - unsetTiling
```
public void unsetTiling()
```
    删除任何以前的平铺网格参数指定的电话 setTiling。
    默认的实现设置实例变量tileWidth，tileHeight，tileGridXOffset，和tileGridYOffset到0。
    
    异常
    
    UnsupportedOperationException如果插件不支持平铺。
    
    IllegalStateException如果平铺模式不 MODE_EXPLICIT。
    
    另请参见：
    
    setTiling(int, int, int, int)
  - getTileWidth
```
public int getTileWidth()
```
    返回一个图像中的每个瓦片的宽度，因为它将被写入到输出流中。如果平铺参数没有被设置，一个 IllegalStateException抛出。
    
    结果
    
    用于编码的瓷砖宽度。
    
    异常
    
    UnsupportedOperationException如果插件不支持平铺。
    
    IllegalStateException如果平铺模式不 MODE_EXPLICIT。
    
    IllegalStateException如果平铺参数没有设置。
    
    另请参见：
    
    setTiling(int, int, int, int)， getTileHeight()
  - getTileHeight
```
public int getTileHeight()
```
    返回一个图像中的每个瓦片的高度，因为它将被写入到输出流中。如果平铺参数没有被设置，一个 IllegalStateException抛出。
    
    结果
    
    用于编码的瓦片高度。
    
    异常
    
    UnsupportedOperationException如果插件不支持平铺。
    
    IllegalStateException如果平铺模式不 MODE_EXPLICIT。
    
    IllegalStateException如果平铺参数没有设置。
    
    另请参见：
    
    setTiling(int, int, int, int)， getTileWidth()
  - getTileGridXOffset
```
public int getTileGridXOffset()
```
    返回一个图像的水平瓦栅偏移量，因为它将被写入到输出流中。如果平铺参数没有被设置，一个 IllegalStateException抛出。
    
    结果
    
    用于编码的瓷砖网格x偏移。
    
    异常
    
    UnsupportedOperationException如果插件不支持平铺。
    
    IllegalStateException如果平铺模式不 MODE_EXPLICIT。
    
    IllegalStateException如果平铺参数没有设置。
    
    另请参见：
    
    setTiling(int, int, int, int)， getTileGridYOffset()
  - getTileGridYOffset
```
public int getTileGridYOffset()
```
    返回一个图像的垂直瓦栅偏移量，因为它将被写入到输出流中。如果平铺参数没有被设置，一个 IllegalStateException抛出。
    
    结果
    
    用于编码的瓷砖栅极偏移偏移。
    
    异常
    
    UnsupportedOperationException如果插件不支持平铺。
    
    IllegalStateException如果平铺模式不 MODE_EXPLICIT。
    
    IllegalStateException如果平铺参数没有设置。
    
    另请参见：
    
    setTiling(int, int, int, int)， getTileGridXOffset()
  - canWriteProgressive
```
public boolean canWriteProgressive()
```
    返回 true如果作者能写出来的图像为一系列逐渐增加的质量传递。
    
    结果
    
    true如果支持渐进式编码。
    
    另请参见：
    
    setProgressiveMode(int)， getProgressiveMode()
  - setProgressiveMode
```
public void setProgressiveMode(int mode)
```
    指定作者是在一个渐进的模式，这样的数据流将包含一系列的扫描质量提高的图像。如果渐进编码不支持，一个 UnsupportedOperationException将抛出。
    mode参数决定如何进展的参数选择，而且必须是MODE_DISABLED，MODE_COPY_FROM_METADATA，或MODE_DEFAULT。否则IllegalArgumentException抛出。
    
    该模式被解释如下：
    - MODE_DISABLED没有进展。使用此关闭进程。
    - MODE_COPY_FROM_METADATA -输出图像将用什么进程参数的元数据对象传递到作者发现。
    - MODE_DEFAULT -图像将逐步由作家写的，选择的参数。
    默认的是MODE_COPY_FROM_METADATA。
    参数
    
    mode为输出流设置进程的模式。
    
    异常
    
    UnsupportedOperationException -如果作者不支持渐进式编码。
    
    IllegalArgumentException -如果 mode不是上面列出的模式。
    
    另请参见：
    
    getProgressiveMode()
  - getProgressiveMode
```
public int getProgressiveMode()
```
    返回以渐进方式写入流的当前模式。
    
    结果
    
    渐进式编码的电流模式。
    
    异常
    
    UnsupportedOperationException -如果作者不支持渐进式编码。
    
    另请参见：
    
    setProgressiveMode(int)
  - canWriteCompressed
```
public boolean canWriteCompressed()
```
    返回 true如果笔者支持压缩。
    
    结果
    
    true如果支持压缩。
  - setCompressionMode
```
public void setCompressionMode(int mode)
```
    指定是否要执行压缩，如果是这样的话，如何确定压缩参数。的 mode参数必须是一个四模式，解释如下：
    - MODE_DISABLED如果模式设置为MODE_DISABLED，方法，查询或修改压缩式或参数将抛出一个IllegalStateException（如果压缩通常是通过插件支持）。一些作家，如JPEG，通常不提供未压缩的输出。在这种情况下，试图设置模式MODE_DISABLED将抛出一个UnsupportedOperationException和模式不会改变。
    - MODE_EXPLICIT压缩使用压缩式和质量设置在这ImageWriteParam指定。任何先前设置的压缩参数都将被丢弃。
    - MODE_COPY_FROM_METADATA -使用任何压缩参数元数据对象传递给指定的作家。
    - MODE_DEFAULT使用默认压缩参数。
    默认的是MODE_COPY_FROM_METADATA。
    参数
    
    mode -在输出流中设置压缩模式。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩，或不支持请求的方式。
    
    IllegalArgumentException -如果 mode不是上面列出的模式。
    
    另请参见：
    
    getCompressionMode()
  - getCompressionMode
```
public int getCompressionMode()
```
    返回当前压缩模式，如果支持压缩。
    
    结果
    
    电流压缩模式。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    另请参见：
    
    setCompressionMode(int)
  - getCompressionTypes
```
public String[] getCompressionTypes()
```
    返回一个列表，可用的压缩类型，如数组或 Strings，或 null如果压缩类型可能不选择使用这些接口。返回的数组是一个副本。
    如果作者只提供一个单一的，强制性的压缩形式，它是没有必要提供任何命名的压缩类型。命名压缩类型只应使用在用户能够在不同的方案之间作出有意义的选择。
    
    默认的实现检查压缩支撑并引发UnsupportedOperationException如果不。否则，它返回的compressionTypes实例变量一个克隆，如果是non-null，否则返回null。
    
    结果
    
    一系列的 Strings包含（非局部）可用的压缩类型的名称，或 null。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
  - setCompressionType
```
public void setCompressionType(String compressionType)
```
    设置一个值表示的 getCompressionTypes压缩式。如果一个值是通过 null，任何以前的设置被删除。
    默认的实现检查是否压缩和压缩模式MODE_EXPLICIT支持。如果是这样的话，它要求getCompressionTypes和检查compressionType是其中的法律价值。如果是，那compressionType设置实例变量。如果compressionType是null，设置实例变量不进行任何检查。
    
    参数
    
    compressionType之一 getCompressionTypes Strings返回，或 null删除任何以前的设置。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    UnsupportedOperationException -如果没有设置压缩类型。
    
    IllegalArgumentException -如果 compressionType是非 null但不在返回的值 getCompressionTypes。
    
    另请参见：
    
    getCompressionTypes()， getCompressionType()， unsetCompression()
  - getCompressionType
```
public String getCompressionType()
```
    返回当前设置压缩式，或 null如果没有设置。类型是一个 String从其中返回 getCompressionTypes返回。如果没有压缩式已定， null返回。
    默认的实现检查是否压缩和压缩模式MODE_EXPLICIT支持。如果是这样的话，它返回的compressionType实例变量的值。
    
    结果
    
    目前的压缩类型作为 String，或 null如果没有类型设置。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    另请参见：
    
    setCompressionType(java.lang.String)
  - unsetCompression
```
public void unsetCompression()
```
    删除任何以前的压缩类型和质量设置。
    默认的实现设置实例变量compressionType到null，和实例变量来1.0F compressionQuality。
    
    异常
    
    UnsupportedOperationException如果插件不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    另请参见：
    
    setCompressionType(java.lang.String)， setCompressionQuality(float)
  - getLocalizedCompressionTypeName
```
public String getLocalizedCompressionTypeName()
```
    返回一个本地化版本的当前的压缩类型的名称，使用 Locale返回 getLocale。
    默认的实现检查是否压缩和压缩模式MODE_EXPLICIT支持。如果是这样的话，如果compressionType是non-null getCompressionType的价值是作为一种方便的返回。
    
    结果
    
    一个 String包含本地化版本的当前的压缩类型的名称。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    IllegalStateException -如果没有压缩类型设置。
  - isCompressionLossless
```
public boolean isCompressionLossless()
```
    返回 true如果当前压缩类型提供无损压缩。如果一个插件只提供了一个强制性的压缩类型，那么这种方法可以称为没有电话 setCompressionType第一。
    如果有多个压缩类型但都已定，一个IllegalStateException抛出。
    
    默认的实现检查是否压缩和压缩模式MODE_EXPLICIT支持。如果是这样的话，如果getCompressionTypes()是null或getCompressionType()是non-null true是作为一种方便的返回。
    
    结果
    
    true如果当前压缩式无损。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    IllegalStateException如果法律的压缩类型设置为非 null和当前的压缩类型 null。
  - setCompressionQuality
```
public void setCompressionQuality(float quality)
```
    设置一 0和 1之间价值的压缩质量。只有一个单一的压缩质量设置为默认支持；作家可以提供更多的控制 ImageWriteParam提供扩展的版本。对有损压缩格式，压缩质量控制文件大小和图像质量之间的权衡（例如，通过选择的量化表JPEG图像时写的）。无损格式，压缩质量可以用来控制之间的权衡，文件大小和时间进行压缩（例如，通过优化行筛选器设置zlib压缩水平的写作PNG图像时）。
    压缩质量设置0，一般解释为“高压缩是非常重要的，而1的设置是一般解释为“高图像质量是非常重要的。”
    
    如果有多个压缩类型但都已定，一个IllegalStateException抛出。
    
    默认的实现检查压缩的支持，这是MODE_EXPLICIT压缩模式。如果是这样的话，如果getCompressionTypes()返回null或compressionType是non-null设置compressionQuality实例变量。
    
    参数
    
    quality - 0and 1指示所期望的质量水平之间的 float。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    IllegalStateException如果法律的压缩类型设置为非 null和当前的压缩类型 null。
    
    IllegalArgumentException -如果 quality之间不是 0and 1，包容。
    
    另请参见：
    
    getCompressionQuality()
  - getCompressionQuality
```
public float getCompressionQuality()
```
    返回当前压缩质量设置。
    如果有多个压缩类型但都已定，一个IllegalStateException抛出。
    
    默认的实现检查压缩支持，压缩模式MODE_EXPLICIT。如果是这样的话，如果getCompressionTypes()是null或getCompressionType()是non-null，它返回的compressionQuality实例变量的值。
    
    结果
    
    当前压缩质量设置。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    IllegalStateException如果法律的压缩类型设置为非 null和当前的压缩类型 null。
    
    另请参见：
    
    setCompressionQuality(float)
  - getBitRate
```
public float getBitRate(float quality)
```
    返回的 float表示在给定的质量水平的输入图像数据的每个比特输出数据位的数量估计。该值通常会躺 0和 1之间，数值越小，表明更多的压缩。一个特殊的价值 -1.0F用于表示没有估计是可用的。
    如果有多个压缩类型但都已定，一个IllegalStateException抛出。
    
    默认的实现检查压缩支持压缩模式是MODE_EXPLICIT。如果是这样的话，如果getCompressionTypes()是null或getCompressionType()是non-null，和quality是出界，它返回-1.0。
    
    参数
    
    quality -质量设置的比特率被质疑。
    
    结果
    
    的压缩比特率的估计，或 -1.0F如果没有估计是可用的。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    IllegalStateException如果法律的压缩类型设置为非 null和当前的压缩类型 null。
    
    IllegalArgumentException -如果 quality之间不是 0and 1，包容。
  - getCompressionQualityDescriptions
```
public String[] getCompressionQualityDescriptions()
```
    返回一个数组，可以使用 Strings随着 getCompressionQualityValues为设置或显示压缩质量水平的用户界面的一部分。随着指数的 String i描述了质量水平 getCompressionQualityValues[i]和 getCompressionQualityValues[i + 1]之间的范围。注意，返回的数组的长度 getCompressionQualityValues永远是一个大于 getCompressionQualityDescriptions归来。
    例如，字符串“好”、“更好”，“最好”的可能的范围[0, .33)，[.33, .66)有关，和[.66, 1.0]。在这种情况下，getCompressionQualityDescriptions将返回{ "Good", "Better", "Best" }和getCompressionQualityValues将返回{ 0.0F, .33F, .66F, 1.0F }。
    
    如果没有描述可用，null返回。如果null是返回getCompressionQualityValues，这种方法也必须返回null。
    
    描述应该是为Locale局部返回getLocale，如果是non-null。
    
    如果有多个压缩类型但都已定，一个IllegalStateException抛出。
    
    默认的实现检查压缩支持，压缩模式MODE_EXPLICIT。如果是这样的话，如果getCompressionTypes()是null或getCompressionType()是non-null，它返回null。
    
    结果
    
    含有压缩质量水平的局部描述 Strings数组。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    IllegalStateException如果法律的压缩类型设置为非 null和当前的压缩类型 null。
    
    另请参见：
    
    getCompressionQualityValues()
  - getCompressionQualityValues
```
public float[] getCompressionQualityValues()
```
    返回一个数组，可以使用 floats随着 getCompressionQualityDescriptions为设置或显示压缩质量水平的用户界面的一部分。更多信息见 getCompressionQualityDescriptions。
    如果没有描述可用，null返回。如果null是返回getCompressionQualityDescriptions，这种方法也必须返回null。
    
    如果有多个压缩类型但都已定，一个IllegalStateException抛出。
    
    默认的实现检查压缩支持，压缩模式MODE_EXPLICIT。如果是这样的话，如果getCompressionTypes()是null或getCompressionType()是non-null，它返回null。
    
    结果
    
    对 floats指示压缩质量水平之间的边界由 getCompressionQualityDescriptions的 Strings描述数组。
    
    异常
    
    UnsupportedOperationException -如果作者不支持压缩。
    
    IllegalStateException -如果压缩模式不 MODE_EXPLICIT。
    
    IllegalStateException如果法律的压缩类型设置为非 null和当前的压缩类型 null。
    
    另请参见：
    
    getCompressionQualityDescriptions()

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ImageWriteParam

Field Summary

Fields inherited from class javax.imageio.IIOParam

构造方法摘要

方法摘要

Methods inherited from class javax.imageio.IIOParam

Methods inherited from class java.lang.Object

Field Detail

MODE_DISABLED

MODE_DEFAULT

MODE_EXPLICIT

MODE_COPY_FROM_METADATA

canWriteTiles

tilingMode

preferredTileSizes

tilingSet

tileWidth

tileHeight

canOffsetTiles

tileGridXOffset

tileGridYOffset

canWriteProgressive

progressiveMode

canWriteCompressed

compressionMode

compressionTypes

compressionType

compressionQuality

locale

Constructor Detail

ImageWriteParam

ImageWriteParam

方法详细信息

getLocale

canWriteTiles

canOffsetTiles

setTilingMode

getTilingMode

getPreferredTileSizes

setTiling

unsetTiling

getTileWidth

getTileHeight

getTileGridXOffset

getTileGridYOffset

canWriteProgressive

setProgressiveMode

getProgressiveMode

canWriteCompressed

setCompressionMode

getCompressionMode

getCompressionTypes

setCompressionType

getCompressionType

unsetCompression

getLocalizedCompressionTypeName

isCompressionLossless

setCompressionQuality

getCompressionQuality

getBitRate

getCompressionQualityDescriptions

getCompressionQualityValues