uTools-Manuals/docs/java/javax/imageio/ImageWriteParam.html

1888 lines
97 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.imageio
</div>
<h2 class="title" title="Class ImageWriteParam">Class ImageWriteParam</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../javax/imageio/IIOParam.html" title="class in javax.imageio">javax.imageio.IIOParam</a></li>
<li>
<ul class="inheritance">
<li>javax.imageio.ImageWriteParam</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
已知直接子类:
</dt>
<dd>
<span><a href="../../javax/imageio/plugins/bmp/BMPImageWriteParam.html" title="javax.imageio.plugins.bmp中的类">BMPImageWriteParam</a> <a href="../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html" title="javax.imageio.plugins.jpeg中的类">JPEGImageWriteParam</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">ImageWriteParam</span>
extends <a href="../../javax/imageio/IIOParam.html" title="class in javax.imageio">IIOParam</a></pre>
<div class="block">
<span>描述流如何编码的类。</span>
<span>该类或其子类的实例用于向ImageWriter的实例提供规定的“how-to” <code>ImageWriter</code></span>
<p> <span>用于特定图像格式的插件可以定义该类的子类,并从其<code>ImageWriter</code>实现的<code>getDefaultWriteParam</code>方法返回该类的对象。</span> <span>例如内置的JPEG writer插件将返回javax.imageio.plugins.jpeg.JPEGImageWriteParam的<code>javax.imageio.plugins.jpeg.JPEGImageWriteParam</code></span> </p>
<p> <span>要写入的图像的区域通过首先将图像的实际边界与由IIOParam.setSourceRegion指定的<code>IIOParam.setSourceRegion</code> (如果有的话)来确定。</span> <span>如果生成的矩形的宽度或高度为零,作者将抛出一个<code>IIOException</code></span> <span>如果交集非空,写入将与第一子采样像素开始,并包括根据所指定的水平和垂直子采样因子的相交边界内的额外像素<a href="../../javax/imageio/IIOParam.html#setSourceSubsampling-int-int-int-int-"><code>IIOParam.setSourceSubsampling</code></a></span> </p>
<p> <span>可以在四种模式之一中设置诸如平铺,逐行编码和压缩的各种特征。</span> <span><code>MODE_DISABLED</code>禁用功能;</span> <span><code>MODE_DEFAULT</code>启用具有写入控制参数值的功能;</span> <span><code>MODE_EXPLICIT</code>启用该功能并允许使用<code>set</code>方法提供附加参数;</span> <span><code>MODE_COPY_FROM_METADATA</code>从传递给作者的流和图像元数据对象复制相关参数值。</span> <span>所有功能的默认值为<code>MODE_COPY_FROM_METADATA</code></span> <span>鼓励在子类中提供的非标准功能,但不需要使用类似的方案。</span> </p>
<p> <span>插件作家可以延伸的功能<code>ImageWriteParam</code>通过提供实现额外的子类,插件特定的接口。</span> <span>插件可以记录哪些接口可用,以及如何使用它们。</span> <span>作家将默默地忽略他们不知道的<code>ImageWriteParam</code>子类的任何扩展功能。</span> <span>此外,他们可能会忽略通过<code>getDefaultWriteParam</code>创建自己的<code>ImageWriteParam</code>实例时通常禁用的任何可选功能。</span> </p>
<p> <span>请注意,除非存在某种功能的查询方法,否则必须由所有<code>ImageWriter</code>实现( <i>例如</i>逐行编码是可选的,但是必须支持二次抽样)。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../javax/imageio/ImageReadParam.html" title="javax.imageio中的类"><code>ImageReadParam</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#canOffsetTiles">canOffsetTiles</a></span></code>
<div class="block">
A
<code>boolean</code>
<code>true</code>如果这
<code>ImageWriteParam</code>允许平铺网格偏移参数被设置。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#canWriteCompressed">canWriteCompressed</a></span></code>
<div class="block">
A
<code>boolean</code>
<code>true</code>如果这个作者可以使用压缩编写图像。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#canWriteProgressive">canWriteProgressive</a></span></code>
<div class="block">
A
<code>boolean</code>
<code>true</code>如果这个
<code>ImageWriteParam</code>允许图像被写入作为逐渐增加的质量通行序列。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#canWriteTiles">canWriteTiles</a></span></code>
<div class="block">
A
<code>boolean</code>
<code>true</code>如果这个
<code>ImageWriteParam</code>允许设置瓦片宽度和瓦片高度参数。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#compressionMode">compressionMode</a></span></code>
<div class="block">
模式控制压缩设置,必须设置为四个
<code>MODE_*</code>之一。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected float</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#compressionQuality">compressionQuality</a></span></code>
<div class="block">
A
<code>float</code>包含当前的压缩质量设置。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected <a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#compressionType">compressionType</a></span></code>
<div class="block">
A
<code>String</code>包含当前压缩类型的名称,如果没有设置,
<code>null</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../java/lang/String.html" title="class in java.lang">String</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#compressionTypes">compressionTypes</a></span></code>
<div class="block">
的阵列
<code>String</code>包含可用压缩类型的名称秒。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected <a href="../../java/util/Locale.html" title="class in java.util">Locale</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#locale">locale</a></span></code>
<div class="block">
A
<code>Locale</code>用于本地化压缩类型名称和质量描述,或
<code>null</code>使用默认值
<code>Locale</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#MODE_COPY_FROM_METADATA">MODE_COPY_FROM_METADATA</a></span></code>
<div class="block">
可通入的方法,如恒定值
<code>setTilingMode</code>
<code>setProgressiveMode</code> ,或
<code>setCompressionMode</code>启用该功能用于以后的写入。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#MODE_DEFAULT">MODE_DEFAULT</a></span></code>
<div class="block">
可通入的方法,如恒定值
<code>setTilingMode</code>
<code>setProgressiveMode</code>
<code>setCompressionMode</code>启用该功能用于以后的写入。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#MODE_DISABLED">MODE_DISABLED</a></span></code>
<div class="block">
可通入的方法,如恒定值
<code>setTilingMode</code>
<code>setProgressiveMode</code>
<code>setCompressionMode</code>至用于以后的写入禁用的特征。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#MODE_EXPLICIT">MODE_EXPLICIT</a></span></code>
<div class="block">
可以传递给诸如
<code>setTilingMode</code>
<code>setCompressionMode</code>之类的方法的常量值,以便将来可以写入功能。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../java/awt/Dimension.html" title="class in java.awt">Dimension</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#preferredTileSizes">preferredTileSizes</a></span></code>
<div class="block">
一组优选的瓷砖尺寸范围对。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#progressiveMode">progressiveMode</a></span></code>
<div class="block">
控制逐行编码的模式,必须设置为四个
<code>MODE_*</code>之一,除了
<code>MODE_EXPLICIT</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#tileGridXOffset">tileGridXOffset</a></span></code>
<div class="block">
如果已经设置了平铺则瓦片网格原点应从图像原点水平偏移否则为0。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#tileGridYOffset">tileGridYOffset</a></span></code>
<div class="block">
如果平铺已设置则瓦片网格原点应与图像原点垂直偏移否则为0。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#tileHeight">tileHeight</a></span></code>
<div class="block">
每个瓦片的高度如果平铺已设置否则为0。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#tileWidth">tileWidth</a></span></code>
<div class="block">
每个瓦片的宽度如果已经设置了平铺否则为0。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#tilingMode">tilingMode</a></span></code>
<div class="block">
该模式控制平铺设置,其中必须设置为四个
<code>MODE_*</code>值。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#tilingSet">tilingSet</a></span></code>
<div class="block">
一个
<code>boolean</code>
<code>true</code> 如果已经指定tiling参数。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.imageio.IIOParam">
<!-- --> </a> <h3>Fields inherited from class javax.imageio.<a href="../../javax/imageio/IIOParam.html" title="class in javax.imageio">IIOParam</a></h3> <code><a href="../../javax/imageio/IIOParam.html#controller">controller</a>, <a href="../../javax/imageio/IIOParam.html#defaultController">defaultController</a>, <a href="../../javax/imageio/IIOParam.html#destinationOffset">destinationOffset</a>, <a href="../../javax/imageio/IIOParam.html#destinationType">destinationType</a>, <a href="../../javax/imageio/IIOParam.html#sourceBands">sourceBands</a>, <a href="../../javax/imageio/IIOParam.html#sourceRegion">sourceRegion</a>, <a href="../../javax/imageio/IIOParam.html#sourceXSubsampling">sourceXSubsampling</a>, <a href="../../javax/imageio/IIOParam.html#sourceYSubsampling">sourceYSubsampling</a>, <a href="../../javax/imageio/IIOParam.html#subsamplingXOffset">subsamplingXOffset</a>, <a href="../../javax/imageio/IIOParam.html#subsamplingYOffset">subsamplingYOffset</a></code></li>
</ul> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier</th>
<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#ImageWriteParam--">ImageWriteParam</a></span>()</code>
<div class="block">
构造一个空的
<code>ImageWriteParam</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#ImageWriteParam-java.util.Locale-">ImageWriteParam</a></span>(<a href="../../java/util/Locale.html" title="class in java.util">Locale</a> locale)</code>
<div class="block">
构造一个
<code>ImageWriteParam</code>集使用给定的
<code>Locale</code>
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#canOffsetTiles--">canOffsetTiles</a></span>()</code>
<div class="block">
如果作者在写入时可以执行非零网格偏移量的平铺,则返回
<code>true</code>
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#canWriteCompressed--">canWriteCompressed</a></span>()</code>
<div class="block">
返回
<code>true</code>如果此writer支持压缩。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#canWriteProgressive--">canWriteProgressive</a></span>()</code>
<div class="block">
返回
<code>true</code>如果作者可以将图像写成一系列逐渐提高质量的通行证。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#canWriteTiles--">canWriteTiles</a></span>()</code>
<div class="block">
如果作者在写作时可以执行平铺,则返回
<code>true</code>
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>float</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getBitRate-float-">getBitRate</a></span>(float quality)</code>
<div class="block">
返回
<code>float</code>指示在给定质量水平的每个输入图像数据的位的输出数据的位数的估计。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getCompressionMode--">getCompressionMode</a></span>()</code>
<div class="block">
如果支持压缩,则返回当前压缩模式。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>float</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getCompressionQuality--">getCompressionQuality</a></span>()</code>
<div class="block">
返回当前的压缩质量设置。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getCompressionQualityDescriptions--">getCompressionQualityDescriptions</a></span>()</code>
<div class="block">
返回的数组
<code>String</code>可与被用于沿小号
<code>getCompressionQualityValues</code>作为用户接口,用于设置或显示压缩质量级别的一部分。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>float[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getCompressionQualityValues--">getCompressionQualityValues</a></span>()</code>
<div class="block">
返回的数组
<code>float</code>可与被用于沿小号
<code>getCompressionQualityDescriptions</code>作为用户接口,用于设置或显示压缩质量级别的一部分。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getCompressionType--">getCompressionType</a></span>()</code>
<div class="block">
返回当前设置的压缩类型,或
<code>null</code>如果没有设置。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getCompressionTypes--">getCompressionTypes</a></span>()</code>
<div class="block">
返回一个可用的压缩类型的列表,如数组或
<code>String</code> s或
<code>null</code>如果可能无法使用这些接口选择压缩类型。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../java/util/Locale.html" title="class in java.util">Locale</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getLocale--">getLocale</a></span>()</code>
<div class="block">
返回当前设置
<code>Locale</code> ,或
<code>null</code>如果只有一个默认
<code>Locale</code>支持。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getLocalizedCompressionTypeName--">getLocalizedCompressionTypeName</a></span>()</code>
<div class="block">
返回当前压缩类型名称的本地化版本,使用
<code>Locale</code>通过返回
<code>getLocale</code>
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code><a href="../../java/awt/Dimension.html" title="class in java.awt">Dimension</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getPreferredTileSizes--">getPreferredTileSizes</a></span>()</code>
<div class="block">
返回一个
<code>Dimension</code> s的数组
<code>Dimension</code>瓦片的合法尺寸范围,因为它们将被编码在输出文件或流中。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getProgressiveMode--">getProgressiveMode</a></span>()</code>
<div class="block">
返回以逐行方式写入流的当前模式。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getTileGridXOffset--">getTileGridXOffset</a></span>()</code>
<div class="block">
返回图像的水平瓦片网格偏移,因为它将被写入输出流。
</div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getTileGridYOffset--">getTileGridYOffset</a></span>()</code>
<div class="block">
返回图像的垂直瓦片网格偏移,因为它将被写入输出流。
</div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getTileHeight--">getTileHeight</a></span>()</code>
<div class="block">
返回图像中每个图块的高度,因为它将被写入输出流。
</div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getTileWidth--">getTileWidth</a></span>()</code>
<div class="block">
返回图像中每个图块的宽度,因为它将被写入输出流。
</div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#getTilingMode--">getTilingMode</a></span>()</code>
<div class="block">
如果支持平铺,返回当前的平铺模式。
</div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#isCompressionLossless--">isCompressionLossless</a></span>()</code>
<div class="block">
返回
<code>true</code>如果当前压缩类型提供无损压缩。
</div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#setCompressionMode-int-">setCompressionMode</a></span>(int mode)</code>
<div class="block">
指定是否执行压缩,如果需要确定压缩参数。
</div> </td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#setCompressionQuality-float-">setCompressionQuality</a></span>(float quality)</code>
<div class="block">
将压缩质量设置为
<code>0</code>
<code>1</code>之间的值。
</div> </td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#setCompressionType-java.lang.String-">setCompressionType</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> compressionType)</code>
<div class="block">
将压缩类型设置为getCompressionTypes指示的值
<code>getCompressionTypes</code>
</div> </td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#setProgressiveMode-int-">setProgressiveMode</a></span>(int mode)</code>
<div class="block">
指定写入器将以逐行模式写入图像,以使流包含一系列增加质量的扫描。
</div> </td>
</tr>
<tr class="rowColor" id="i25">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-">setTiling</a></span>(int tileWidth, int tileHeight, int tileGridXOffset, int tileGridYOffset)</code>
<div class="block">
指定图像应该平铺在输出流中。
</div> </td>
</tr>
<tr class="altColor" id="i26">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#setTilingMode-int-">setTilingMode</a></span>(int mode)</code>
<div class="block">
确定图像是否将平铺在输出流中,如果是,将确定平铺参数的确定方式。
</div> </td>
</tr>
<tr class="rowColor" id="i27">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#unsetCompression--">unsetCompression</a></span>()</code>
<div class="block">
删除任何以前的压缩类型和质量设置。
</div> </td>
</tr>
<tr class="altColor" id="i28">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriteParam.html#unsetTiling--">unsetTiling</a></span>()</code>
<div class="block">
删除通过调用指定的任何以前的瓦片网格参数
<code>setTiling</code>
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.imageio.IIOParam">
<!-- --> </a> <h3>Methods inherited from class javax.imageio.<a href="../../javax/imageio/IIOParam.html" title="class in javax.imageio">IIOParam</a></h3> <code><a href="../../javax/imageio/IIOParam.html#activateController--">activateController</a>, <a href="../../javax/imageio/IIOParam.html#getController--">getController</a>, <a href="../../javax/imageio/IIOParam.html#getDefaultController--">getDefaultController</a>, <a href="../../javax/imageio/IIOParam.html#getDestinationOffset--">getDestinationOffset</a>, <a href="../../javax/imageio/IIOParam.html#getDestinationType--">getDestinationType</a>, <a href="../../javax/imageio/IIOParam.html#getSourceBands--">getSourceBands</a>, <a href="../../javax/imageio/IIOParam.html#getSourceRegion--">getSourceRegion</a>, <a href="../../javax/imageio/IIOParam.html#getSourceXSubsampling--">getSourceXSubsampling</a>, <a href="../../javax/imageio/IIOParam.html#getSourceYSubsampling--">getSourceYSubsampling</a>, <a href="../../javax/imageio/IIOParam.html#getSubsamplingXOffset--">getSubsamplingXOffset</a>, <a href="../../javax/imageio/IIOParam.html#getSubsamplingYOffset--">getSubsamplingYOffset</a>, <a href="../../javax/imageio/IIOParam.html#hasController--">hasController</a>, <a href="../../javax/imageio/IIOParam.html#setController-javax.imageio.IIOParamController-">setController</a>, <a href="../../javax/imageio/IIOParam.html#setDestinationOffset-java.awt.Point-">setDestinationOffset</a>, <a href="../../javax/imageio/IIOParam.html#setDestinationType-javax.imageio.ImageTypeSpecifier-">setDestinationType</a>, <a href="../../javax/imageio/IIOParam.html#setSourceBands-int:A-">setSourceBands</a>, <a href="../../javax/imageio/IIOParam.html#setSourceRegion-java.awt.Rectangle-">setSourceRegion</a>, <a href="../../javax/imageio/IIOParam.html#setSourceSubsampling-int-int-int-int-">setSourceSubsampling</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../java/lang/Object.html#clone--">clone</a>, <a href="../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../java/lang/Object.html#notify--">notify</a>, <a href="../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../java/lang/Object.html#toString--">toString</a>, <a href="../../java/lang/Object.html#wait--">wait</a>, <a href="../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="MODE_DISABLED">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>MODE_DISABLED</h4> <pre>public static final int MODE_DISABLED</pre>
<div class="block">
<span>可通入的方法,如恒定值<code>setTilingMode</code> <code>setProgressiveMode</code><code>setCompressionMode</code>至用于以后的写入禁用的特征。</span>
<span>也就是说,当设置此模式时,流将<b>不会</b>被平铺,渐进或压缩,相关的访问器方法将抛出<code>IllegalStateException</code></span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_EXPLICIT"><code>MODE_EXPLICIT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_COPY_FROM_METADATA"><code>MODE_COPY_FROM_METADATA</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DEFAULT"><code>MODE_DEFAULT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setProgressiveMode-int-"><code>setProgressiveMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getProgressiveMode--"><code>getProgressiveMode()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setTilingMode-int-"><code>setTilingMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTilingMode--"><code>getTilingMode()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionMode-int-"><code>setCompressionMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionMode--"><code>getCompressionMode()</code></a>
<a href="../../constant-values.html#javax.imageio.ImageWriteParam.MODE_DISABLED">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="MODE_DEFAULT">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>MODE_DEFAULT</h4> <pre>public static final int MODE_DEFAULT</pre>
<div class="block">
<span>可通入的方法,如恒定值<code>setTilingMode</code> <code>setProgressiveMode</code><code>setCompressionMode</code>启用该功能用于以后的写入。</span>
<span>也就是说,当启用此模式时,流将按照插件依赖方式由作者内部选择的合理默认进行平铺,渐进或压缩,相关的访问者方法将抛出<code>IllegalStateException</code></span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DISABLED"><code>MODE_DISABLED</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_EXPLICIT"><code>MODE_EXPLICIT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_COPY_FROM_METADATA"><code>MODE_COPY_FROM_METADATA</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setProgressiveMode-int-"><code>setProgressiveMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getProgressiveMode--"><code>getProgressiveMode()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setTilingMode-int-"><code>setTilingMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTilingMode--"><code>getTilingMode()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionMode-int-"><code>setCompressionMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionMode--"><code>getCompressionMode()</code></a>
<a href="../../constant-values.html#javax.imageio.ImageWriteParam.MODE_DEFAULT">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="MODE_EXPLICIT">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>MODE_EXPLICIT</h4> <pre>public static final int MODE_EXPLICIT</pre>
<div class="block">
<span>可以传递给诸如<code>setTilingMode</code><code>setCompressionMode</code>之类的方法的常量值,以使能功能以供将来写入。</span>
<span>也就是说,当该模式被设置时,根据提供给该类中<code>set</code>方法的附加<code>set</code> ,流将被平铺或压缩,并且可以从相应的<code>set</code>方法中<code>get</code></span>
<span>请注意,逐行输出不支持此模式。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DISABLED"><code>MODE_DISABLED</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_COPY_FROM_METADATA"><code>MODE_COPY_FROM_METADATA</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DEFAULT"><code>MODE_DEFAULT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setProgressiveMode-int-"><code>setProgressiveMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getProgressiveMode--"><code>getProgressiveMode()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setTilingMode-int-"><code>setTilingMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTilingMode--"><code>getTilingMode()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionMode-int-"><code>setCompressionMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionMode--"><code>getCompressionMode()</code></a>
<a href="../../constant-values.html#javax.imageio.ImageWriteParam.MODE_EXPLICIT">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="MODE_COPY_FROM_METADATA">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>MODE_COPY_FROM_METADATA</h4> <pre>public static final int MODE_COPY_FROM_METADATA</pre>
<div class="block">
<span>可通入的方法,如恒定值<code>setTilingMode</code> <code>setProgressiveMode</code> ,或<code>setCompressionMode</code>启用该功能用于以后的写入。</span>
<span>也就是说,当启用此模式时,流将按照传入到写入操作的流和/或图像元数据的内容进行平铺,逐行或压缩,任何相关的访问器方法将会抛出一个<code>IllegalStateException</code></span>
<p> <span>这是所有功能的默认模式,因此包括元数据在内的读取(包括元数据)的读取将尽可能保留尽可能多的信息。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DISABLED"><code>MODE_DISABLED</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_EXPLICIT"><code>MODE_EXPLICIT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DEFAULT"><code>MODE_DEFAULT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setProgressiveMode-int-"><code>setProgressiveMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getProgressiveMode--"><code>getProgressiveMode()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setTilingMode-int-"><code>setTilingMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTilingMode--"><code>getTilingMode()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionMode-int-"><code>setCompressionMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionMode--"><code>getCompressionMode()</code></a>
<a href="../../constant-values.html#javax.imageio.ImageWriteParam.MODE_COPY_FROM_METADATA">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="canWriteTiles">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canWriteTiles</h4> <pre>protected boolean canWriteTiles</pre>
<div class="block">
<span>A <code>boolean</code><code>true</code>如果这<code>ImageWriteParam</code>允许设置瓦片宽度和瓦片高度参数。</span>
<span>默认值为<code>false</code></span>
<span>子类必须手动设置该值。</span>
<p> <span>不支持写入磁贴的子类应确保此值设置为<code>false</code></span> </p>
</div> </li>
</ul> <a name="tilingMode">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>tilingMode</h4> <pre>protected int tilingMode</pre>
<div class="block">
<span>模式控制平铺设置,其中必须设置为四个<code>MODE_*</code>之一。</span>
<span>默认值为<code>MODE_COPY_FROM_METADATA</code></span>
<p> <span>不写图块的子类可能会忽略此值。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DISABLED"><code>MODE_DISABLED</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_EXPLICIT"><code>MODE_EXPLICIT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_COPY_FROM_METADATA"><code>MODE_COPY_FROM_METADATA</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DEFAULT"><code>MODE_DEFAULT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setTilingMode-int-"><code>setTilingMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTilingMode--"><code>getTilingMode()</code></a>
</dd>
</dl> </li>
</ul> <a name="preferredTileSizes">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>preferredTileSizes</h4> <pre>protected <a href="../../java/awt/Dimension.html" title="class in java.awt">Dimension</a>[] preferredTileSizes</pre>
<div class="block">
<span>一组优选的瓷砖尺寸范围对。</span>
<span>默认值为<code>null</code> ,表示没有首选尺寸。</span>
<span>如果值不是<code>null</code> 那么它的长度必须至少为2。</span>
<p> <span>不支持写图块的子类可能会忽略此值。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#getPreferredTileSizes--"><code>getPreferredTileSizes()</code></a>
</dd>
</dl> </li>
</ul> <a name="tilingSet">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>tilingSet</h4> <pre>protected boolean tilingSet</pre>
<div class="block">
<span>一个<code>boolean</code><code>true</code> 如果已经指定tiling参数。</span>
<p> <span>不支持写图块的子类可能会忽略此值。</span> </p>
</div> </li>
</ul> <a name="tileWidth">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>tileWidth</h4> <pre>protected int tileWidth</pre>
<div class="block">
<span>每个瓦片的宽度如果已经设置了平铺否则为0。</span>
<p> <span>不支持平铺的子类可能忽略此值。</span> </p>
</div> </li>
</ul> <a name="tileHeight">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>tileHeight</h4> <pre>protected int tileHeight</pre>
<div class="block">
<span>每个瓦片的高度如果平铺已设置否则为0。</span>
<span>初始值为<code>0</code></span>
<p> <span>不支持平铺的子类可能忽略此值。</span> </p>
</div> </li>
</ul> <a name="canOffsetTiles">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canOffsetTiles</h4> <pre>protected boolean canOffsetTiles</pre>
<div class="block">
<span>A <code>boolean</code><code>true</code>如果这个<code>ImageWriteParam</code>允许设置平铺网格偏移参数。</span>
<span>默认值为<code>false</code></span>
<span>子类必须手动设置该值。</span>
<p> <span>不支持编写图块的子类,或支持写入但不支持拼贴的子类必须确保此值设置为<code>false</code></span> </p>
</div> </li>
</ul> <a name="tileGridXOffset">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>tileGridXOffset</h4> <pre>protected int tileGridXOffset</pre>
<div class="block">
<span>如果已经设置了平铺则瓦片网格原点应从图像原点水平偏移否则为0。</span>
<span>初始值为<code>0</code></span>
<p> <span>不支持偏移图块的子类可能忽略此值。</span> </p>
</div> </li>
</ul> <a name="tileGridYOffset">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>tileGridYOffset</h4> <pre>protected int tileGridYOffset</pre>
<div class="block">
<span>如果平铺已设置则瓦片网格原点应与图像原点垂直偏移否则为0。</span>
<span>初始值为<code>0</code></span>
<p> <span>不支持偏移图块的子类可能忽略此值。</span> </p>
</div> </li>
</ul> <a name="canWriteProgressive">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canWriteProgressive</h4> <pre>protected boolean canWriteProgressive</pre>
<div class="block">
<span>A <code>boolean</code><code>true</code>如果这个<code>ImageWriteParam</code>允许图像被写入逐渐增加的质量通行序列。</span>
<span>默认值为<code>false</code></span>
<span>子类必须手动设置该值。</span>
<p> <span>不支持逐行编码的子类必须确保该值设置为<code>false</code></span> </p>
</div> </li>
</ul> <a name="progressiveMode">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>progressiveMode</h4> <pre>protected int progressiveMode</pre>
<div class="block">
<span>控制逐行编码的模式,必须设置为四个<code>MODE_*</code>之一,除了<code>MODE_EXPLICIT</code></span>
<span>默认值为<code>MODE_COPY_FROM_METADATA</code></span>
<p> <span>不支持逐行编码的子类可能忽略此值。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DISABLED"><code>MODE_DISABLED</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_EXPLICIT"><code>MODE_EXPLICIT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_COPY_FROM_METADATA"><code>MODE_COPY_FROM_METADATA</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DEFAULT"><code>MODE_DEFAULT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setProgressiveMode-int-"><code>setProgressiveMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getProgressiveMode--"><code>getProgressiveMode()</code></a>
</dd>
</dl> </li>
</ul> <a name="canWriteCompressed">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canWriteCompressed</h4> <pre>protected boolean canWriteCompressed</pre>
<div class="block">
<span>A <code>boolean</code><code>true</code>如果这个作者可以使用压缩编写图像。</span>
<span>默认值为<code>false</code></span>
<span>子类必须手动设置该值。</span>
<p> <span>不支持压缩的子类必须确保此值设置为<code>false</code></span> </p>
</div> </li>
</ul> <a name="compressionMode">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>compressionMode</h4> <pre>protected int compressionMode</pre>
<div class="block">
<span>模式控制压缩设置,必须将其设置为四个<code>MODE_*</code>之一。</span>
<span>默认值为<code>MODE_COPY_FROM_METADATA</code></span>
<p> <span>不支持压缩的子类可能忽略此值。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DISABLED"><code>MODE_DISABLED</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_EXPLICIT"><code>MODE_EXPLICIT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_COPY_FROM_METADATA"><code>MODE_COPY_FROM_METADATA</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#MODE_DEFAULT"><code>MODE_DEFAULT</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionMode-int-"><code>setCompressionMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionMode--"><code>getCompressionMode()</code></a>
</dd>
</dl> </li>
</ul> <a name="compressionTypes">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>compressionTypes</h4> <pre>protected <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] compressionTypes</pre>
<div class="block">
<span>的阵列<code>String</code>包含可用压缩类型的名称秒。</span>
<span>子类必须手动设置该值。</span>
<p> <span>不支持压缩的子类可能忽略此值。</span> </p>
</div> </li>
</ul> <a name="compressionType">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>compressionType</h4> <pre>protected <a href="../../java/lang/String.html" title="class in java.lang">String</a> compressionType</pre>
<div class="block">
<span>A <code>String</code>包含当前压缩类型的名称,如果没有设置, <code>null</code></span>
<p> <span>不支持压缩的子类可能忽略此值。</span> </p>
</div> </li>
</ul> <a name="compressionQuality">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>compressionQuality</h4> <pre>protected float compressionQuality</pre>
<div class="block">
<span>A <code>float</code>包含当前的压缩质量设置。</span>
<span>初始值为<code>1.0F</code></span>
<p> <span>不支持压缩的子类可能忽略此值。</span> </p>
</div> </li>
</ul> <a name="locale">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>locale</h4> <pre>protected <a href="../../java/util/Locale.html" title="class in java.util">Locale</a> locale</pre>
<div class="block">
<span>A <code>Locale</code>用于本地化压缩类型名称和质量描述,或<code>null</code>使用默认值<code>Locale</code></span>
<span>子类必须手动设置该值。</span>
</div> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="ImageWriteParam--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ImageWriteParam</h4> <pre>protected ImageWriteParam()</pre>
<div class="block">
<span>构造一个空的<code>ImageWriteParam</code></span>
<span>子类可以正确设置实例变量。</span>
</div> </li>
</ul> <a name="ImageWriteParam-java.util.Locale-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>ImageWriteParam</h4> <pre>public ImageWriteParam(<a href="../../java/util/Locale.html" title="class in java.util">Locale</a> locale)</pre>
<div class="block">
构造一个
<code>ImageWriteParam</code>集使用给定的
<code>Locale</code>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>locale</code> - a
<code>Locale</code>用于本地化压缩类型名称和质量描述,或
<code>null</code>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getLocale--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLocale</h4> <pre>public <a href="../../java/util/Locale.html" title="class in java.util">Locale</a> getLocale()</pre>
<div class="block">
返回当前设置
<code>Locale</code> ,或
<code>null</code>如果只有一个默认
<code>Locale</code>支持。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
目前为
<code>Locale</code> ,或
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="canWriteTiles--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canWriteTiles</h4> <pre>public boolean canWriteTiles()</pre>
<div class="block">
<span>返回<code>true</code>如果作者可以在书写时执行拼贴。</span>
<span>如果这个方法返回<code>false</code> ,那么<code>setTiling</code>会抛出一个<code>UnsupportedOperationException</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果作者支持平铺。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#canOffsetTiles--"><code>canOffsetTiles()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-"><code>setTiling(int, int, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="canOffsetTiles--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canOffsetTiles</h4> <pre>public boolean canOffsetTiles()</pre>
<div class="block">
<span>返回<code>true</code>如果写入可以在写入时执行非零网格偏移的平铺。</span>
<span>如果此方法返回<code>false</code> ,则<code>setTiling</code>将抛出<code>UnsupportedOperationException</code>如果网格偏移参数不为零。</span>
<span>如果<code>canWriteTiles</code>返回<code>false</code> ,此方法也将返回<code>false</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果作者支持非零瓦片偏移。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#canWriteTiles--"><code>canWriteTiles()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-"><code>setTiling(int, int, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setTilingMode-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setTilingMode</h4> <pre>public void setTilingMode(int mode)</pre>
<div class="block">
<span>确定图像是否将平铺在输出流中,如果是,将确定平铺参数的确定方式。</span>
<span>模式解释如下:</span>
<ul>
<li> <span><code>MODE_DISABLED</code> - 图像不会被平铺。</span> <span><code>setTiling</code>会抛出一个<code>IllegalStateException</code></span> </li>
<li> <span><code>MODE_DEFAULT</code> - 图像将使用默认参数进行平铺。</span> <span><code>setTiling</code>将会抛出一个<code>IllegalStateException</code></span> </li>
<li> <span><code>MODE_EXPLICIT</code> - 图像将根据<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-"><code>setTiling</code></a>方法中给出的<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-">参数</a>进行平铺。</span> <span>任何先前设置的平铺参数都将被丢弃。</span> </li>
<li> <span><code>MODE_COPY_FROM_METADATA</code> - 图像将符合传入到写入的元数据对象。</span> <span><code>setTiling</code>将抛出一个<code>IllegalStateException</code></span> </li>
</ul>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mode</code> - 用于平铺的模式。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canWriteTiles</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>mode</code>不是上面列出的一种模式。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-"><code>setTiling(int, int, int, int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTilingMode--"><code>getTilingMode()</code></a>
</dd>
</dl> </li>
</ul> <a name="getTilingMode--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTilingMode</h4> <pre>public int getTilingMode()</pre>
<div class="block">
<span>如果支持平铺,返回当前的平铺模式。</span>
<span>否则抛出一个<code>UnsupportedOperationException</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前的平铺模式。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canWriteTiles</code>返回
<code>false</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setTilingMode-int-"><code>setTilingMode(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getPreferredTileSizes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPreferredTileSizes</h4> <pre>public <a href="../../java/awt/Dimension.html" title="class in java.awt">Dimension</a>[] getPreferredTileSizes()</pre>
<div class="block">
<span>返回一个<code>Dimension</code>的数组, <code>Dimension</code>瓦片的合法尺寸范围,因为它们将被编码在输出文件或流中。</span>
<span>返回的数组是一个副本。</span>
<p> <span>该信息作为一组对返回;</span> <span>一对的第一个元素包含(包括)最小宽度和高度,第二个元素包含(包含)最大宽度和高度。</span> <span>在一起,每对都定义了一个有效的大小范围。</span> <span>要指定固定的大小,请对两个元素使用相同的宽度和高度。</span> <span>指定任意范围,值<code>null</code>替代的实际阵列的使用<code>Dimension</code>秒。</span> </p>
<p> <span>如果在构造函数中没有指定数组,但是允许平铺,则该方法返回<code>null</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>Dimension</code>的数组,
<code>Dimension</code>长度至少为2
<code>null</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果插件不支持平铺。
</dd>
</dl> </li>
</ul> <a name="setTiling-int-int-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setTiling</h4> <pre>public void setTiling(int tileWidth,
int tileHeight,
int tileGridXOffset,
int tileGridYOffset)</pre>
<div class="block">
<span>指定图像应该平铺在输出流中。</span>
<span><code>tileWidth</code><code>tileHeight</code>参数指定文件中的图块的宽度和高度。</span>
<span>如果图块宽度或高度大于图像的宽度或高度,则图像不会在该维度中平铺。</span>
<p> <span>如果<code>canOffsetTiles</code>返回<code>false</code> ,则<code>tileGridXOffset</code><code>tileGridYOffset</code>参数必须为零。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>tileWidth</code> - 每个瓦片的宽度。
</dd>
<dd>
<code>tileHeight</code> - 每个瓷砖的高度。
</dd>
<dd>
<code>tileGridXOffset</code> - 瓦片网格的水平偏移。
</dd>
<dd>
<code>tileGridYOffset</code> - 瓦片网格的垂直偏移。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果插件不支持平铺。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果插件不支持网格偏移,并且网格偏移量不为零。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> -如果瓦片大小不是由返回的容许范围之一内
<code>getPreferredTileSizes</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>tileWidth</code>
<code>tileHeight</code>小于或等于0。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#canWriteTiles"><code>canWriteTiles</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#canOffsetTiles"><code>canOffsetTiles</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTileWidth--"><code>getTileWidth()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTileHeight--"><code>getTileHeight()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTileGridXOffset--"><code>getTileGridXOffset()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTileGridYOffset--"><code>getTileGridYOffset()</code></a>
</dd>
</dl> </li>
</ul> <a name="unsetTiling--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>unsetTiling</h4> <pre>public void unsetTiling()</pre>
<div class="block">
<span>删除由setTiling调用指定的任何以前的瓦片网格<code>setTiling</code></span>
<p> <span>默认实现将实例变量<code>tileWidth</code> <code>tileHeight</code> <code>tileGridXOffset</code><code>tileGridYOffset</code><code>0</code></span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果插件不支持平铺。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-"><code>setTiling(int, int, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getTileWidth--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTileWidth</h4> <pre>public int getTileWidth()</pre>
<div class="block">
<span>返回图像中每个图块的宽度,因为它将被写入输出流。</span>
<span>如果未设置平铺参数,则抛出<code>IllegalStateException</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
要用于编码的瓦片宽度。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果插件不支持平铺。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺参数尚未设置。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-"><code>setTiling(int, int, int, int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTileHeight--"><code>getTileHeight()</code></a>
</dd>
</dl> </li>
</ul> <a name="getTileHeight--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTileHeight</h4> <pre>public int getTileHeight()</pre>
<div class="block">
<span>返回图像中每个图块的高度,因为它将被写入输出流。</span>
<span>如果未设置平铺参数,则抛出<code>IllegalStateException</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
要用于编码的瓦片高度。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果插件不支持平铺。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺参数尚未设置。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-"><code>setTiling(int, int, int, int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTileWidth--"><code>getTileWidth()</code></a>
</dd>
</dl> </li>
</ul> <a name="getTileGridXOffset--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTileGridXOffset</h4> <pre>public int getTileGridXOffset()</pre>
<div class="block">
<span>返回图像的水平瓦片网格偏移,因为它将被写入输出流。</span>
<span>如果未设置平铺参数,则抛出<code>IllegalStateException</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
瓦片网格X偏移量用于编码。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果插件不支持拼贴。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺参数尚未设置。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-"><code>setTiling(int, int, int, int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTileGridYOffset--"><code>getTileGridYOffset()</code></a>
</dd>
</dl> </li>
</ul> <a name="getTileGridYOffset--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTileGridYOffset</h4> <pre>public int getTileGridYOffset()</pre>
<div class="block">
<span>返回图像的垂直瓦片网格偏移,因为它将被写入输出流。</span>
<span>如果未设置平铺参数,则抛出<code>IllegalStateException</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
瓦片网格Y偏移量用于编码。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果插件不支持平铺。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果平铺参数尚未设置。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-"><code>setTiling(int, int, int, int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getTileGridXOffset--"><code>getTileGridXOffset()</code></a>
</dd>
</dl> </li>
</ul> <a name="canWriteProgressive--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canWriteProgressive</h4> <pre>public boolean canWriteProgressive()</pre>
<div class="block">
返回
<code>true</code>如果作者可以将图像写成一系列逐渐提高质量的通行证。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果作者支持逐行编码。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setProgressiveMode-int-"><code>setProgressiveMode(int)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getProgressiveMode--"><code>getProgressiveMode()</code></a>
</dd>
</dl> </li>
</ul> <a name="setProgressiveMode-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setProgressiveMode</h4> <pre>public void setProgressiveMode(int mode)</pre>
<div class="block">
<span>指定写入器将以逐行模式写入图像,以使流包含一系列增加质量的扫描。</span>
<span>如果不支持渐进式编码,则会抛出<code>UnsupportedOperationException</code></span>
<p> <span>模式参数确定如何选择progression参数并且必须是<code>MODE_DISABLED</code> <code>MODE_COPY_FROM_METADATA</code> ,或<code>MODE_DEFAULT</code></span> <span>否则抛出一个<code>IllegalArgumentException</code></span> </p>
<p> <span>模式解释如下:</span> </p>
<ul>
<li> <span><code>MODE_DISABLED</code> - 无进展。</span> <span>使用它来关闭进度。</span> </li>
<li> <span><code>MODE_COPY_FROM_METADATA</code> - 输出图像将使用传入到作者的元数据对象中的任何进度参数。</span> </li>
<li> <span><code>MODE_DEFAULT</code> - 图像将逐步写入,并由作者选择参数。</span> </li>
</ul>
<p> <span>默认值为<code>MODE_COPY_FROM_METADATA</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mode</code> - 在输出流中设置进度的模式。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持逐行编码。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>mode</code>不是上面列出的一种模式。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#getProgressiveMode--"><code>getProgressiveMode()</code></a>
</dd>
</dl> </li>
</ul> <a name="getProgressiveMode--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getProgressiveMode</h4> <pre>public int getProgressiveMode()</pre>
<div class="block">
返回以逐行方式写入流的当前模式。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
逐行编码的当前模式。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持逐行编码。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setProgressiveMode-int-"><code>setProgressiveMode(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="canWriteCompressed--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canWriteCompressed</h4> <pre>public boolean canWriteCompressed()</pre>
<div class="block">
返回
<code>true</code>如果此writer支持压缩。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果作者支持压缩。
</dd>
</dl> </li>
</ul> <a name="setCompressionMode-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setCompressionMode</h4> <pre>public void setCompressionMode(int mode)</pre>
<div class="block">
<span>指定是否执行压缩,如果需要确定压缩参数。</span>
<span><code>mode</code>参数必须是四种模式之一,解释如下:</span>
<ul>
<li> <span><code>MODE_DISABLED</code> - 如果模式设置为<code>MODE_DISABLED</code> ,则查询或修改压缩类型或参数的方法将抛出<code>IllegalStateException</code> (如果插件通常支持压缩)。</span> <span>一些作者例如JPEG通常不提供未压缩的输出。</span> <span>在这种情况下,尝试将模式设置为<code>MODE_DISABLED</code>将会抛出一个<code>UnsupportedOperationException</code>并且模式不会被更改。</span> </li>
<li> <span><code>MODE_EXPLICIT</code> - 使用此ImageWriteParam中指定的压缩类型和质量设置进行<code>ImageWriteParam</code></span> <span>任何先前设置的压缩参数都被丢弃。</span> </li>
<li> <span><code>MODE_COPY_FROM_METADATA</code> - 使用传入到作者的元数据对象中指定的任何压缩参数。</span> </li>
<li> <span><code>MODE_DEFAULT</code> - 使用默认压缩参数。</span> </li>
</ul>
<p> <span>默认值为<code>MODE_COPY_FROM_METADATA</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mode</code> - 输出流中设置压缩的模式。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩,或者不支持请求的模式。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>mode</code>不是上面列出的一种模式。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionMode--"><code>getCompressionMode()</code></a>
</dd>
</dl> </li>
</ul> <a name="getCompressionMode--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCompressionMode</h4> <pre>public int getCompressionMode()</pre>
<div class="block">
如果支持压缩,则返回当前压缩模式。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前压缩模式。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionMode-int-"><code>setCompressionMode(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getCompressionTypes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCompressionTypes</h4> <pre>public <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getCompressionTypes()</pre>
<div class="block">
<span>返回可用压缩类型的列表,数组或<code>String</code> S<code>null</code>如果压缩类型可以不使用这些接口选择。</span>
<span>返回的数组是一个副本。</span>
<p> <span>如果作者仅提供单一的强制性压缩形式,则不需要提供任何命名的压缩类型。</span> <span>命名的压缩类型只能在用户能够在不同方案之间进行有意义的选择的地方使用。</span> </p>
<p> <span>默认实现检查压缩是否受支持,如果不支持,则会抛出<code>UnsupportedOperationException</code></span> <span>否则,它返回的克隆<code>compressionTypes</code> ,如果它是非实例变量<code>null</code> ,否则返回<code>null</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
的阵列
<code>String</code>包含可用压缩类型,或的(非本地化)名称
<code>null</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
</dl> </li>
</ul> <a name="setCompressionType-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setCompressionType</h4> <pre>public void setCompressionType(<a href="../../java/lang/String.html" title="class in java.lang">String</a> compressionType)</pre>
<div class="block">
<span>将压缩类型设置为getCompressionTypes指示的值<code>getCompressionTypes</code></span>
<span>如果传入值为<code>null</code> ,则删除以前的任何设置。</span>
<p> <span>默认实现检查压缩是否受支持,压缩模式是否为<code>MODE_EXPLICIT</code></span> <span>如果是这样,它调用<code>getCompressionTypes</code>并检查是否<code>compressionType</code>是合法值之一。</span> <span>如果是,则设置<code>compressionType</code>实例变量。</span> <span>如果<code>compressionType</code><code>null</code> ,那么设置实例变量而不执行任何检查。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>compressionType</code> -
<code>String</code>返回的
<code>getCompressionTypes</code> ,或
<code>null</code>删除任何以前的设置。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果没有可设置的压缩类型。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>compressionType</code>不是
<code>null</code>但不是由
<code>getCompressionTypes</code>返回的值
<code>getCompressionTypes</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionTypes--"><code>getCompressionTypes()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionType--"><code>getCompressionType()</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#unsetCompression--"><code>unsetCompression()</code></a>
</dd>
</dl> </li>
</ul> <a name="getCompressionType--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCompressionType</h4> <pre>public <a href="../../java/lang/String.html" title="class in java.lang">String</a> getCompressionType()</pre>
<div class="block">
<span>返回当前设置的压缩类型,或<code>null</code>如果没有设置。</span>
<span>类型被返回作为<code>String</code>从那些通过返回<code>getCompressionTypes</code></span>
<span>如果没有设置压缩类型,则返回<code>null</code></span>
<p> <span>默认实现检查压缩是否受支持,压缩模式是否为<code>MODE_EXPLICIT</code></span> <span>如果是这样,它返回<code>compressionType</code>实例变量的值。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前压缩类型为
<code>String</code> ,如果没有设置类型,
<code>null</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionType-java.lang.String-"><code>setCompressionType(java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="unsetCompression--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>unsetCompression</h4> <pre>public void unsetCompression()</pre>
<div class="block">
<span>删除任何以前的压缩类型和质量设置。</span>
<p> <span>默认实现将实例变量<code>compressionType</code>设置为<code>null</code> ,实例变量<code>compressionQuality</code>设置为<code>1.0F</code></span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果插件不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionType-java.lang.String-"><code>setCompressionType(java.lang.String)</code></a>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionQuality-float-"><code>setCompressionQuality(float)</code></a>
</dd>
</dl> </li>
</ul> <a name="getLocalizedCompressionTypeName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLocalizedCompressionTypeName</h4> <pre>public <a href="../../java/lang/String.html" title="class in java.lang">String</a> getLocalizedCompressionTypeName()</pre>
<div class="block">
<span>返回当前压缩类型名称的本地化版本,使用<code>Locale</code>通过返回<code>getLocale</code></span>
<p> <span>默认实现检查压缩是否受支持,压缩模式是否为<code>MODE_EXPLICIT</code></span> <span>如果是,如果<code>compressionType</code><code>non-null</code> ,则返回值为<code>getCompressionType</code>作为方便。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>String</code>包含当前压缩类型的本地化版本的名称。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果没有设置压缩类型。
</dd>
</dl> </li>
</ul> <a name="isCompressionLossless--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isCompressionLossless</h4> <pre>public boolean isCompressionLossless()</pre>
<div class="block">
<span>返回<code>true</code>如果当前压缩类型提供无损压缩。</span>
<span>如果插件仅提供一种强制性压缩类型,则可以先调用此方法,而不<code>setCompressionType</code>调用<code>setCompressionType</code></span>
<p> <span>如果有多种压缩类型,但没有设置,则会抛出一个<code>IllegalStateException</code></span> </p>
<p> <span>默认实现检查压缩是否受支持,压缩模式是否为<code>MODE_EXPLICIT</code></span> <span>如果是,如果<code>getCompressionTypes()</code><code>null</code><code>getCompressionType()</code>是非<code>null</code> <code>true</code>作为方便返回。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果当前的压缩类型是无损的。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果一组合法的压缩类型是非
<code>null</code> ,当前的压缩类型是
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="setCompressionQuality-float-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setCompressionQuality</h4> <pre>public void setCompressionQuality(float quality)</pre>
<div class="block">
<span>将压缩质量设置为<code>0</code><code>1</code>之间的值。</span>
<span>默认情况下,仅支持单个压缩质量设置;</span>
<span>作者可以提供更多版本的<code>ImageWriteParam</code> ,提供更多的控制。</span>
<span>对于有损压缩方案压缩质量应该控制文件大小和图像质量之间的折衷例如通过在编写JPEG图像时选择量化表</span>
<span>对于无损方案可以使用压缩质量来控制文件大小和执行压缩所花费的时间之间的折衷例如通过优化行过滤器并在编写PNG图像时设置ZLIB压缩级别</span>
<p> <span>0.0的压缩质量设置最通俗地被解释为“高压缩是重要的”而1.0的设置最通常被解释为“高图像质量很重要”。</span> </p>
<p> <span>如果有多种压缩类型,但没有设置,则会抛出一个<code>IllegalStateException</code></span> </p>
<p> <span>默认实现检查是否支持压缩,压缩模式为<code>MODE_EXPLICIT</code></span> <span>如果是,如果<code>getCompressionTypes()</code>返回<code>null</code><code>compressionType</code>是非<code>null</code>它设置<code>compressionQuality</code>实例变量。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>quality</code> -一个
<code>float</code>之间
<code>0</code>
<code>1</code>指示期望的质量水平。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果一组法定压缩类型不是
<code>null</code> ,当前的压缩类型是
<code>null</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>quality</code>不在
<code>0</code>
<code>1</code>之间,包括在内。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionQuality--"><code>getCompressionQuality()</code></a>
</dd>
</dl> </li>
</ul> <a name="getCompressionQuality--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCompressionQuality</h4> <pre>public float getCompressionQuality()</pre>
<div class="block">
<span>返回当前的压缩质量设置。</span>
<p> <span>如果有多种压缩类型,但没有设置,则会抛出<code>IllegalStateException</code></span> </p>
<p> <span>默认实现检查压缩是否受支持,压缩模式是<code>MODE_EXPLICIT</code></span> <span>如果是,如果<code>getCompressionTypes()</code><code>null</code><code>getCompressionType()</code>是非<code>null</code> ,它返回<code>compressionQuality</code>实例变量的值。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前的压缩质量设置。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果一组法定压缩类型不是
<code>null</code> ,当前的压缩类型是
<code>null</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#setCompressionQuality-float-"><code>setCompressionQuality(float)</code></a>
</dd>
</dl> </li>
</ul> <a name="getBitRate-float-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBitRate</h4> <pre>public float getBitRate(float quality)</pre>
<div class="block">
<span>返回<code>float</code>指示在给定质量水平下每个输入图像数据位的输出数据的位数的估计。</span>
<span>该值通常位于<code>0</code><code>1</code>之间,较小的值表示更多的压缩。</span>
<span><code>-1.0F</code>的特殊值用于表示没有估计可用。</span>
<p> <span>如果有多种压缩类型,但没有设置,则抛出<code>IllegalStateException</code></span> </p>
<p> <span>默认实现检查是否支持压缩,压缩模式为<code>MODE_EXPLICIT</code></span> <span>如果是,如果<code>getCompressionTypes()</code><code>null</code><code>getCompressionType()</code>是非<code>null</code> ,而<code>quality</code>是在范围内,则返回<code>-1.0</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>quality</code> - 要查询其比特率的质量设置。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
压缩比特率,或估计
<code>-1.0F</code> ,如果没有估计可用。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果一组合法的压缩类型是非
<code>null</code> ,当前的压缩类型是
<code>null</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>quality</code>不在
<code>0</code>
<code>1</code>之间,包括在内。
</dd>
</dl> </li>
</ul> <a name="getCompressionQualityDescriptions--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCompressionQualityDescriptions</h4> <pre>public <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getCompressionQualityDescriptions()</pre>
<div class="block">
<span>返回的数组<code>String</code>可与被用于沿小号<code>getCompressionQualityValues</code>作为用户接口,用于设置或显示压缩质量级别的一部分。</span>
<span>所述<code>String</code>具有索引<code>i</code>提供质量水平之间的范围内的描述<code>getCompressionQualityValues[i]</code><code>getCompressionQualityValues[i + 1]</code></span>
<span>需要注意的是阵列的长度从返回<code>getCompressionQualityValues</code>将始终是一个大于从返回<code>getCompressionQualityDescriptions</code></span>
<p> <span>作为一个例子,字符串“好”,“较好”和“最佳”可与范围相关<code>[0, .33)</code> <code>[.33, .66)</code><code>[.66, 1.0]</code></span> <span>在这种情况下, <code>getCompressionQualityDescriptions</code>将返回<code>{ "Good", "Better", "Best" }</code><code>getCompressionQualityValues</code>将返回<code>{ 0.0F, .33F, .66F, 1.0F }</code></span> </p>
<p> <span>如果没有可用的描述,则返回<code>null</code></span> <span>如果<code>null</code><code>getCompressionQualityValues</code>返回,此方法也必须返回<code>null</code></span> </p>
<p> <span>对于<code>Locale</code>返回的<code>getLocale</code> ,如果不是<code>getLocale</code> ,则应对其进行<code>null</code></span> </p>
<p> <span>如果有多种压缩类型,但没有设置,则会抛出<code>IllegalStateException</code></span> </p>
<p> <span>默认实现检查压缩是否受支持,并且压缩模式是<code>MODE_EXPLICIT</code></span> <span>如果是,如果<code>getCompressionTypes()</code><code>null</code><code>getCompressionType()</code>是非<code>null</code> ,它返回<code>null</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>String</code>的数组包含压缩质量等级的本地化描述。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果作者不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果一组合法的压缩类型是非
<code>null</code> ,当前的压缩类型是
<code>null</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionQualityValues--"><code>getCompressionQualityValues()</code></a>
</dd>
</dl> </li>
</ul> <a name="getCompressionQualityValues--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getCompressionQualityValues</h4> <pre>public float[] getCompressionQualityValues()</pre>
<div class="block">
<span>返回一个可以与<code>getCompressionQualityDescriptions</code>一起使用的<code>float</code> s数组作为设置或显示压缩质量等级的用户界面的一部分。</span>
<span><a href="../../javax/imageio/ImageWriteParam.html#getCompressionQualityDescriptions--"><code>getCompressionQualityDescriptions</code></a>以获取更多信息。</span>
<p> <span>如果没有可用的描述,则返回<code>null</code></span> <span>如果<code>null</code><code>getCompressionQualityDescriptions</code>返回,此方法也必须返回<code>null</code></span> </p>
<p> <span>如果有多种压缩类型,但没有设置,则抛出<code>IllegalStateException</code></span> </p>
<p> <span>默认实现检查压缩是否受支持,压缩模式是<code>MODE_EXPLICIT</code></span> <span>如果是,如果<code>getCompressionTypes()</code><code>null</code><code>getCompressionType()</code>是非<code>null</code> ,它返回<code>null</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>float</code> s的阵列
<code>float</code>压缩质量水平之间的边界如String的
<code>String</code>
<code>getCompressionQualityDescriptions</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果写入程序不支持压缩。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果一组合法的压缩类型不是
<code>null</code> ,当前的压缩类型是
<code>null</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriteParam.html#getCompressionQualityDescriptions--"><code>getCompressionQualityDescriptions()</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>