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

2770 lines
152 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 ImageWriter">Class ImageWriter</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>javax.imageio.ImageWriter</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../javax/imageio/ImageTranscoder.html" title="javax.imageio中的接口">ImageTranscoder</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">ImageWriter</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../javax/imageio/ImageTranscoder.html" title="interface in javax.imageio">ImageTranscoder</a></pre>
<div class="block">
<span>用于编码和写入图像的抽象超类。</span>
<span>该类必须由在Java Image I / O框架的上下文中写出图像的类子类化。</span>
<p> <span><code>ImageWriter</code>对象通常由服务提供商类为特定格式实例化。</span> <span>服务提供者类与注册<code>IIORegistry</code> ,后者使用可用的格式,读者和作家的格式识别和介绍。</span> </p>
<p></p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../javax/imageio/ImageReader.html" title="javax.imageio中的类"><code>ImageReader</code></a> <a href="../../javax/imageio/ImageWriteParam.html" title="javax.imageio中的类"><code>ImageWriteParam</code></a> <a href="../../javax/imageio/spi/IIORegistry.html" title="javax.imageio.spi中的类"><code>IIORegistry</code></a> <a href="../../javax/imageio/spi/ImageWriterSpi.html" title="javax.imageio.spi中的类"><code>ImageWriterSpi</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 <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/ImageWriter.html#availableLocales">availableLocales</a></span></code>
<div class="block">
的阵列
<code>Locale</code>可用于本地化警告消息和压缩设置值或S
<code>null</code>如果不支持定位。
</div> </td>
</tr>
<tr class="rowColor">
<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/ImageWriter.html#locale">locale</a></span></code>
<div class="block">
目前
<code>Locale</code>用于定位,或
<code>null</code>如果没有设置。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected <a href="../../javax/imageio/spi/ImageWriterSpi.html" title="class in javax.imageio.spi">ImageWriterSpi</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#originatingProvider">originatingProvider</a></span></code>
<div class="block">
<code>ImageWriterSpi</code>化该对象的
<code>null</code>如果其身份不知道或不存在,
<code>null</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#output">output</a></span></code>
<div class="block">
<code>ImageOutputStream</code>或其他
<code>Object</code>
<code>Object</code>设定,
<code>setOutput</code> getOutput
<code>getOutput</code>
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../javax/imageio/event/IIOWriteProgressListener.html" title="interface in javax.imageio.event">IIOWriteProgressListener</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#progressListeners">progressListeners</a></span></code>
<div class="block">
A
<code>List</code>当前注册的
<code>IIOWriteProgressListener</code> s默认
<code>null</code> ,这是一个空的
<code>List</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../javax/imageio/event/IIOWriteWarningListener.html" title="interface in javax.imageio.event">IIOWriteWarningListener</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#warningListeners">warningListeners</a></span></code>
<div class="block">
A
<code>List</code>当前注册的
<code>IIOWriteWarningListener</code> s默认
<code>null</code>
<code>null</code> ,这是一个空的
<code>List</code>
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../java/util/Locale.html" title="class in java.util">Locale</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#warningLocales">warningLocales</a></span></code>
<div class="block">
<code>List</code>
<code>Locale</code> S一个用于的每个元素
<code>warningListeners</code> ,默认情况下初始化
<code>null</code> ,其与空同义
<code>List</code>
</div> </td>
</tr>
</tbody>
</table> </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/ImageWriter.html#ImageWriter-javax.imageio.spi.ImageWriterSpi-">ImageWriter</a></span>(<a href="../../javax/imageio/spi/ImageWriterSpi.html" title="class in javax.imageio.spi">ImageWriterSpi</a> originatingProvider)</code>
<div class="block">
构造一个
<code>ImageWriter</code>并将其
<code>originatingProvider</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="t3"><span><a href="javascript:show(4);">抽象方法</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>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#abort--">abort</a></span>()</code>
<div class="block">
请求中止任何当前的写入操作。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#abortRequested--">abortRequested</a></span>()</code>
<div class="block">
返回
<code>true</code>是否已经作出中止当前写入操作的请求自从writer被实例化或
<code>clearAbortRequest</code>被调用。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#addIIOWriteProgressListener-javax.imageio.event.IIOWriteProgressListener-">addIIOWriteProgressListener</a></span>(<a href="../../javax/imageio/event/IIOWriteProgressListener.html" title="interface in javax.imageio.event">IIOWriteProgressListener</a> listener)</code>
<div class="block">
<code>IIOWriteProgressListener</code>添加到已注册进度侦听器的列表中。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#addIIOWriteWarningListener-javax.imageio.event.IIOWriteWarningListener-">addIIOWriteWarningListener</a></span>(<a href="../../javax/imageio/event/IIOWriteWarningListener.html" title="interface in javax.imageio.event">IIOWriteWarningListener</a> listener)</code>
<div class="block">
<code>IIOWriteWarningListener</code>添加到已注册的警告监听器列表中。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#canInsertEmpty-int-">canInsertEmpty</a></span>(int imageIndex)</code>
<div class="block">
如果作者支持在给定索引处插入新的空图像,则返回
<code>true</code>
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#canInsertImage-int-">canInsertImage</a></span>(int imageIndex)</code>
<div class="block">
如果作者支持在给定索引处插入新图像,则返回
<code>true</code>
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#canRemoveImage-int-">canRemoveImage</a></span>(int imageIndex)</code>
<div class="block">
如果作者支持在给定索引处删除现有图像,则返回
<code>true</code>
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#canReplaceImageMetadata-int-">canReplaceImageMetadata</a></span>(int imageIndex)</code>
<div class="block">
返回
<code>true</code>如果能够替换与现有的图像与索引相关联的图像元数据
<code>imageIndex</code>
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#canReplacePixels-int-">canReplacePixels</a></span>(int imageIndex)</code>
<div class="block">
如果作者允许使用
<code>replacePixels</code>方法替换给定图像的像素,则返回
<code>true</code>
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#canReplaceStreamMetadata--">canReplaceStreamMetadata</a></span>()</code>
<div class="block">
如果可以替换输出中已经存在的流元数据,则返回
<code>true</code>
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#canWriteEmpty--">canWriteEmpty</a></span>()</code>
<div class="block">
如果作者支持将包含未定义像素值的单个图像和相关联的元数据和缩略图组成的完整图像流写入输出,则返回
<code>true</code>
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#canWriteRasters--">canWriteRasters</a></span>()</code>
<div class="block">
返回
<code>true</code>如果采取方法
<code>IIOImage</code>参数能够与处理的
<code>Raster</code> (相对于
<code>RenderedImage</code> )源图像。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#canWriteSequence--">canWriteSequence</a></span>()</code>
<div class="block">
如果作者能够将图像附加到已经包含标题信息和可能的先前图像的图像流中,则返回
<code>true</code>
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#clearAbortRequest--">clearAbortRequest</a></span>()</code>
<div class="block">
清除任何先前的中止请求。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#convertImageMetadata-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-">convertImageMetadata</a></span>(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> inData, <a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
返回可用于编码的
<code>IIOMetadata</code>对象并可使用其文档接口或特定于将用于编码的writer插件的其他接口进行可选修改。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#convertStreamMetadata-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageWriteParam-">convertStreamMetadata</a></span>(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> inData, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
返回可用于编码的
<code>IIOMetadata</code>对象,并可使用文档接口或特定于编写器插件的其他接口进行修改,该接口将用于编码。
</div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#dispose--">dispose</a></span>()</code>
<div class="block">
允许释放此对象持有的任何资源。
</div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#endInsertEmpty--">endInsertEmpty</a></span>()</code>
<div class="block">
完成插入一个以前调用
<code>prepareInsertEmpty</code>开始的新映像。
</div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#endReplacePixels--">endReplacePixels</a></span>()</code>
<div class="block">
终止调用序列
<code>replacePixels</code>
</div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#endWriteEmpty--">endWriteEmpty</a></span>()</code>
<div class="block">
完成了以前调用
<code>prepareWriteEmpty</code>开始的新图像的写入。
</div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#endWriteSequence--">endWriteSequence</a></span>()</code>
<div class="block">
完成了以prepareWriteSequence开头的一系列图像的
<code>prepareWriteSequence</code>
</div> </td>
</tr>
<tr class="rowColor" id="i21">
<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/ImageWriter.html#getAvailableLocales--">getAvailableLocales</a></span>()</code>
<div class="block">
返回的数组
<code>Locale</code> ,其可以被用于警告侦听器和压缩设置秒。
</div> </td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code>abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#getDefaultImageMetadata-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-">getDefaultImageMetadata</a></span>(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
返回一个
<code>IIOMetadata</code>用于对给定类型的图像进行编码的默认值的
<code>IIOMetadata</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code>abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#getDefaultStreamMetadata-javax.imageio.ImageWriteParam-">getDefaultStreamMetadata</a></span>(<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
返回一个
<code>IIOMetadata</code>用于编码图像流的默认值的
<code>IIOMetadata</code>对象。
</div> </td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code><a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#getDefaultWriteParam--">getDefaultWriteParam</a></span>()</code>
<div class="block">
返回包含默认值的此文件格式的适当类型的新
<code>ImageWriteParam</code>对象,即指定没有
<code>ImageWriteParam</code>对象时将使用的值。
</div> </td>
</tr>
<tr class="rowColor" id="i25">
<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/ImageWriter.html#getLocale--">getLocale</a></span>()</code>
<div class="block">
如果没有设置,则返回当前设置的
<code>Locale</code>
<code>null</code>
</div> </td>
</tr>
<tr class="altColor" id="i26">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#getNumThumbnailsSupported-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-javax.imageio.metadata.IIOMetadata-javax.imageio.metadata.IIOMetadata-">getNumThumbnailsSupported</a></span>(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param, <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata, <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata)</code>
<div class="block">
给定图像类型以及编码期间将要使用的任何其他写入参数和元数据对象,返回由正在写入的格式支持的缩略图数。
</div> </td>
</tr>
<tr class="rowColor" id="i27">
<td class="colFirst"><code><a href="../../javax/imageio/spi/ImageWriterSpi.html" title="class in javax.imageio.spi">ImageWriterSpi</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#getOriginatingProvider--">getOriginatingProvider</a></span>()</code>
<div class="block">
返回
<code>ImageWriterSpi</code>创建此对象
<code>ImageWriter</code> ,或
<code>null</code>如果此对象不是通过创建
<code>IIORegistry</code>
</div> </td>
</tr>
<tr class="altColor" id="i28">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#getOutput--">getOutput</a></span>()</code>
<div class="block">
返回
<code>ImageOutputStream</code>或其他
<code>Object</code>设置由最近调用
<code>setOutput</code>方法。
</div> </td>
</tr>
<tr class="rowColor" id="i29">
<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/ImageWriter.html#getPreferredThumbnailSizes-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-javax.imageio.metadata.IIOMetadata-javax.imageio.metadata.IIOMetadata-">getPreferredThumbnailSizes</a></span>(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param, <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata, <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata)</code>
<div class="block">
返回一个
<code>Dimension</code> s的数组
<code>Dimension</code>缩略图的合法大小范围,因为它们将被编码在输出文件或流中。
</div> </td>
</tr>
<tr class="altColor" id="i30">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#prepareInsertEmpty-int-javax.imageio.ImageTypeSpecifier-int-int-javax.imageio.metadata.IIOMetadata-java.util.List-javax.imageio.ImageWriteParam-">prepareInsertEmpty</a></span>(int imageIndex, <a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType, int width, int height, <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata, <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;? extends <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a>&gt; thumbnails, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
开始将未定义像素值的新图像插入到现有图像流中。
</div> </td>
</tr>
<tr class="rowColor" id="i31">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#prepareReplacePixels-int-java.awt.Rectangle-">prepareReplacePixels</a></span>(int imageIndex, <a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> region)</code>
<div class="block">
准备作者处理一系列对
<code>replacePixels</code>方法的电话。
</div> </td>
</tr>
<tr class="altColor" id="i32">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#prepareWriteEmpty-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageTypeSpecifier-int-int-javax.imageio.metadata.IIOMetadata-java.util.List-javax.imageio.ImageWriteParam-">prepareWriteEmpty</a></span>(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata, <a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType, int width, int height, <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata, <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;? extends <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a>&gt; thumbnails, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
开始将一个完整的图像流(包含一个具有未定义像素值的单个图像和关联的元数据和缩略图)写入输出。
</div> </td>
</tr>
<tr class="rowColor" id="i33">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#prepareWriteSequence-javax.imageio.metadata.IIOMetadata-">prepareWriteSequence</a></span>(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata)</code>
<div class="block">
使用提供的流元数据对象准备流以接受一系列后续
<code>writeToSequence</code>调用。
</div> </td>
</tr>
<tr class="altColor" id="i34">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#processImageComplete--">processImageComplete</a></span>()</code>
<div class="block">
通过调用他们的
<code>imageComplete</code>方法来广播对所有注册的
<code>IIOWriteProgressListener</code>的图像写入的
<code>imageComplete</code>
</div> </td>
</tr>
<tr class="rowColor" id="i35">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#processImageProgress-float-">processImageProgress</a></span>(float percentageDone)</code>
<div class="block">
通过调用他们的
<code>imageProgress</code>方法,将目前的图像完成百分比广播到所有注册的
<code>IIOWriteProgressListener</code>
</div> </td>
</tr>
<tr class="altColor" id="i36">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#processImageStarted-int-">processImageStarted</a></span>(int imageIndex)</code>
<div class="block">
通过调用他们的
<code>imageStarted</code>方法,将所有注册的
<code>IIOWriteProgressListener</code>的图像写入的开始
<code>imageStarted</code>
</div> </td>
</tr>
<tr class="rowColor" id="i37">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#processThumbnailComplete--">processThumbnailComplete</a></span>()</code>
<div class="block">
通过调用他们的
<code>thumbnailComplete</code>方法广播完成对所有注册的
<code>IIOWriteProgressListener</code>的缩略图写入。
</div> </td>
</tr>
<tr class="altColor" id="i38">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#processThumbnailProgress-float-">processThumbnailProgress</a></span>(float percentageDone)</code>
<div class="block">
通过调用他们的
<code>thumbnailProgress</code>方法,将目前的缩略图完成百分比广播到所有已
<code>IIOWriteProgressListener</code>
<code>thumbnailProgress</code>
</div> </td>
</tr>
<tr class="rowColor" id="i39">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#processThumbnailStarted-int-int-">processThumbnailStarted</a></span>(int imageIndex, int thumbnailIndex)</code>
<div class="block">
通过调用他们的
<code>thumbnailStarted</code>方法,将所有注册的
<code>IIOWriteProgressListener</code> s的缩略图写入的开始
<code>thumbnailStarted</code>
</div> </td>
</tr>
<tr class="altColor" id="i40">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#processWarningOccurred-int-java.lang.String-">processWarningOccurred</a></span>(int imageIndex, <a href="../../java/lang/String.html" title="class in java.lang">String</a> warning)</code>
<div class="block">
通过调用他们的
<code>warningOccurred</code>方法向所有注册的
<code>IIOWriteWarningListener</code>发送一条警告消息。
</div> </td>
</tr>
<tr class="rowColor" id="i41">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#processWarningOccurred-int-java.lang.String-java.lang.String-">processWarningOccurred</a></span>(int imageIndex, <a href="../../java/lang/String.html" title="class in java.lang">String</a> baseName, <a href="../../java/lang/String.html" title="class in java.lang">String</a> keyword)</code>
<div class="block">
通过使用从
<code>ResourceBundle</code>的字符串调用其
<code>warningOccurred</code>方法,向所有注册的
<code>IIOWriteWarningListener</code>广播本地化警告消息。
</div> </td>
</tr>
<tr class="altColor" id="i42">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#processWriteAborted--">processWriteAborted</a></span>()</code>
<div class="block">
通过调用他们的
<code>writeAborted</code>方法来广播写入已被中止到所有注册的
<code>IIOWriteProgressListener</code>
</div> </td>
</tr>
<tr class="rowColor" id="i43">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#removeAllIIOWriteProgressListeners--">removeAllIIOWriteProgressListeners</a></span>()</code>
<div class="block">
删除所有当前注册的
<code>IIOWriteProgressListener</code>对象。
</div> </td>
</tr>
<tr class="altColor" id="i44">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#removeAllIIOWriteWarningListeners--">removeAllIIOWriteWarningListeners</a></span>()</code>
<div class="block">
删除所有当前注册的
<code>IIOWriteWarningListener</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i45">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#removeIIOWriteProgressListener-javax.imageio.event.IIOWriteProgressListener-">removeIIOWriteProgressListener</a></span>(<a href="../../javax/imageio/event/IIOWriteProgressListener.html" title="interface in javax.imageio.event">IIOWriteProgressListener</a> listener)</code>
<div class="block">
删除一个
<code>IIOWriteProgressListener</code>从注册的进度侦听器列表中。
</div> </td>
</tr>
<tr class="altColor" id="i46">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#removeIIOWriteWarningListener-javax.imageio.event.IIOWriteWarningListener-">removeIIOWriteWarningListener</a></span>(<a href="../../javax/imageio/event/IIOWriteWarningListener.html" title="interface in javax.imageio.event">IIOWriteWarningListener</a> listener)</code>
<div class="block">
删除一个
<code>IIOWriteWarningListener</code>从注册的警告侦听器的列表。
</div> </td>
</tr>
<tr class="rowColor" id="i47">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#removeImage-int-">removeImage</a></span>(int imageIndex)</code>
<div class="block">
从流中删除图像。
</div> </td>
</tr>
<tr class="altColor" id="i48">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#replaceImageMetadata-int-javax.imageio.metadata.IIOMetadata-">replaceImageMetadata</a></span>(int imageIndex, <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata)</code>
<div class="block">
替换与现有图像相关联的图像元数据。
</div> </td>
</tr>
<tr class="rowColor" id="i49">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#replacePixels-java.awt.image.Raster-javax.imageio.ImageWriteParam-">replacePixels</a></span>(<a href="../../java/awt/image/Raster.html" title="class in java.awt.image">Raster</a> raster, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
用给定的
<code>Raster</code>的一部分替换已经存在于输出中的图像的一部分。
</div> </td>
</tr>
<tr class="altColor" id="i50">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#replacePixels-java.awt.image.RenderedImage-javax.imageio.ImageWriteParam-">replacePixels</a></span>(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> image, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
用给定图像的一部分替换已经存在于输出中的图像的一部分。
</div> </td>
</tr>
<tr class="rowColor" id="i51">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#replaceStreamMetadata-javax.imageio.metadata.IIOMetadata-">replaceStreamMetadata</a></span>(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata)</code>
<div class="block">
用新信息替换输出中的流元数据。
</div> </td>
</tr>
<tr class="altColor" id="i52">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#reset--">reset</a></span>()</code>
<div class="block">
<code>ImageWriter</code>恢复到初始状态。
</div> </td>
</tr>
<tr class="rowColor" id="i53">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#setLocale-java.util.Locale-">setLocale</a></span>(<a href="../../java/util/Locale.html" title="class in java.util">Locale</a> locale)</code>
<div class="block">
将此
<code>Locale</code>的当前
<code>ImageWriter</code>设置为给定值。
</div> </td>
</tr>
<tr class="altColor" id="i54">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#setOutput-java.lang.Object-">setOutput</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> output)</code>
<div class="block">
将目的地设置为给定的
<code>ImageOutputStream</code>或其他
<code>Object</code>
</div> </td>
</tr>
<tr class="rowColor" id="i55">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#write-javax.imageio.IIOImage-">write</a></span>(<a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a> image)</code>
<div class="block">
将含有默认元数据和缩略图的单个图像的完整图像流附加到输出。
</div> </td>
</tr>
<tr class="altColor" id="i56">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#write-javax.imageio.metadata.IIOMetadata-javax.imageio.IIOImage-javax.imageio.ImageWriteParam-">write</a></span>(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata, <a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a> image, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
将包含单个图像和关联流以及图像元数据和缩略图的完整图像流附加到输出。
</div> </td>
</tr>
<tr class="rowColor" id="i57">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#write-java.awt.image.RenderedImage-">write</a></span>(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> image)</code>
<div class="block">
将包含单个图像的完整图像流附加到输出的默认元数据和缩略图。
</div> </td>
</tr>
<tr class="altColor" id="i58">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#writeInsert-int-javax.imageio.IIOImage-javax.imageio.ImageWriteParam-">writeInsert</a></span>(int imageIndex, <a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a> image, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
将新图像插入到现有图像流中。
</div> </td>
</tr>
<tr class="rowColor" id="i59">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageWriter.html#writeToSequence-javax.imageio.IIOImage-javax.imageio.ImageWriteParam-">writeToSequence</a></span>(<a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a> image, <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</code>
<div class="block">
将单个图像和可能关联的元数据和缩略图附加到输出。
</div> </td>
</tr>
</tbody>
</table>
<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="originatingProvider">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>originatingProvider</h4> <pre>protected <a href="../../javax/imageio/spi/ImageWriterSpi.html" title="class in javax.imageio.spi">ImageWriterSpi</a> originatingProvider</pre>
<div class="block">
<span><code>ImageWriterSpi</code>认为这个实例化对象,或<code>null</code>如果其身份未知或不存在。</span>
<span>默认情况下,它被初始化为<code>null</code></span>
</div> </li>
</ul> <a name="output">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>output</h4> <pre>protected <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> output</pre>
<div class="block">
<span><code>ImageOutputStream</code>或其他<code>Object</code><code>Object</code>设置并由<code>setOutput</code> <code>getOutput</code></span>
<span>默认情况下,它被初始化为<code>null</code></span>
</div> </li>
</ul> <a name="availableLocales">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>availableLocales</h4> <pre>protected <a href="../../java/util/Locale.html" title="class in java.util">Locale</a>[] availableLocales</pre>
<div class="block">
<span>的阵列<code>Locale</code>可用于本地化警告消息和压缩设置值或S <code>null</code>如果不支持定位。</span>
<span>默认情况下,它被初始化为<code>null</code></span>
</div> </li>
</ul> <a name="locale">
<!-- --> </a>
<ul class="blockList">
<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>目前<code>Locale</code>用于定位,或<code>null</code>如果没有设置。</span>
<span>默认情况下,它被初始化为<code>null</code></span>
</div> </li>
</ul> <a name="warningListeners">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>warningListeners</h4> <pre>protected <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../javax/imageio/event/IIOWriteWarningListener.html" title="interface in javax.imageio.event">IIOWriteWarningListener</a>&gt; warningListeners</pre>
<div class="block">
A
<code>List</code>当前注册的
<code>IIOWriteWarningListener</code> s默认
<code>null</code>
<code>null</code> ,这是一个空的
<code>List</code>
</div> </li>
</ul> <a name="warningLocales">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>warningLocales</h4> <pre>protected <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../java/util/Locale.html" title="class in java.util">Locale</a>&gt; warningLocales</pre>
<div class="block">
<code>List</code>
<code>Locale</code> S一个用于的每个元素
<code>warningListeners</code> ,默认情况下初始化
<code>null</code> ,其与空同义
<code>List</code>
</div> </li>
</ul> <a name="progressListeners">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>progressListeners</h4> <pre>protected <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../javax/imageio/event/IIOWriteProgressListener.html" title="interface in javax.imageio.event">IIOWriteProgressListener</a>&gt; progressListeners</pre>
<div class="block">
A
<code>List</code>当前注册的
<code>IIOWriteProgressListener</code> s默认
<code>null</code> ,这是一个空的
<code>List</code>
</div> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="ImageWriter-javax.imageio.spi.ImageWriterSpi-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>ImageWriter</h4> <pre>protected ImageWriter(<a href="../../javax/imageio/spi/ImageWriterSpi.html" title="class in javax.imageio.spi">ImageWriterSpi</a> originatingProvider)</pre>
<div class="block">
<span>构造一个<code>ImageWriter</code>并将其<code>originatingProvider</code>实例变量设置为提供的值。</span>
<p> <span>使用扩展的子类应提供一个带有签名<code>(ImageWriterSpi, Object)</code> ,以便检索扩展对象。</span> <span>如果扩展对象不合适,则应抛出<code>IllegalArgumentException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>originatingProvider</code> -所述
<code>ImageWriterSpi</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="getOriginatingProvider--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getOriginatingProvider</h4> <pre>public <a href="../../javax/imageio/spi/ImageWriterSpi.html" title="class in javax.imageio.spi">ImageWriterSpi</a> getOriginatingProvider()</pre>
<div class="block">
<span>返回<code>ImageWriterSpi</code>创建此对象<code>ImageWriter</code> ,或<code>null</code>如果此对象不是通过创建<code>IIORegistry</code></span>
<p> <span>默认实现返回<code>originatingProvider</code>实例变量的值。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ImageWriterSpi</code>
<code>null</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../javax/imageio/spi/ImageWriterSpi.html" title="javax.imageio.spi中的类"><code>ImageWriterSpi</code></a></span>
</dd>
</dl> </li>
</ul> <a name="setOutput-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setOutput</h4> <pre>public void setOutput(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> output)</pre>
<div class="block">
<span>将目的地设置为给定的<code>ImageOutputStream</code>或其他<code>Object</code></span>
<span>假设目的地准备好接受数据,并且不会在每次写入结束时关闭。</span>
<span>这允许分布式成像应用程序通过单个网络连接传输一系列图像。</span>
<span>如果<code>output</code><code>null</code> ,任何当前设置的输出将被删除。</span>
<p> <span>如果<code>output</code><code>ImageOutputStream</code> ,调用到<code>write</code> <code>writeToSequence</code> ,并<code>prepareWriteEmpty</code> / <code>endWriteEmpty</code>方法将保留流的现有内容。</span> <span>其它的写入方法,如<code>writeInsert</code> <code>replaceStreamMetadata</code> <code>replaceImageMetadata</code> <code>replacePixels</code> <code>prepareInsertEmpty</code> / <code>endInsertEmpty</code><code>endWriteSequence</code> ,所需要的流的全部内容是可读的和可写的,并且可以改变流的任何部分。</span> </p>
<p> <span>的一般使用<code>Object</code>比其他<code>ImageOutputStream</code>旨在用于直接与输出装置或图像协议交互的作家。</span> <span>这套法律课由作者的服务提供者的<code>getOutputTypes</code>方法发布;</span> <span>大多数作家将返回一个仅<code>ImageOutputStream.class</code>的单元素数组,表示它们只接受一个<code>ImageOutputStream</code></span> </p>
<p> <span>对于发起提供者<code>output</code>的一组类别(如果有的话)检查<code>output</code>之后,默认实现将<code>output</code>实例变量设置为<code>output</code>的值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>output</code> -
<code>ImageOutputStream</code>或其他
<code>Object</code>用于将来的写作。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>output</code>不是始发服务提供商的
<code>getOutputTypes</code>方法返回的一个类的实例。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriter.html#getOutput--"><code>getOutput()</code></a>
</dd>
</dl> </li>
</ul> <a name="getOutput--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getOutput</h4> <pre>public <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getOutput()</pre>
<div class="block">
<span>返回<code>ImageOutputStream</code>或其他<code>Object</code>由最近调用的<code>setOutput</code>方法设置。</span>
<span>如果没有设置<code>null</code>则返回<code>null</code></span>
<p> <span>默认实现返回<code>output</code>实例变量的值。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
所述
<code>Object</code>最近使用指定
<code>setOutput</code> ,或
<code>null</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriter.html#setOutput-java.lang.Object-"><code>setOutput(java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="getAvailableLocales--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAvailableLocales</h4> <pre>public <a href="../../java/util/Locale.html" title="class in java.util">Locale</a>[] getAvailableLocales()</pre>
<div class="block">
<span>返回可用于本地化警告侦听器和压缩设置的<code>Locale</code> s数组。</span>
<span>返回值为<code>null</code>表示不支持本地化。</span>
<p> <span>如果<code>availableLocales</code>实例变量非<code>null</code> ,默认实现将返回一个克隆,否则返回<code>null</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
的阵列
<code>Locale</code> s表示可被用作参数
<code>setLocale</code> ,或
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="setLocale-java.util.Locale-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setLocale</h4> <pre>public void setLocale(<a href="../../java/util/Locale.html" title="class in java.util">Locale</a> locale)</pre>
<div class="block">
<span>将此<code>Locale</code>的当前<code>ImageWriter</code>设置为给定值。</span>
<span>值为<code>null</code>将删除任何以前的设置,并指示作者应将其视为合适的本地化。</span>
<p> <span>默认实现检查<code>locale</code>对返回的值<code>getAvailableLocales</code> ,并设置<code>locale</code>如果发现实例变量。</span> <span>如果<code>locale</code><code>null</code> ,则实例变量设置为<code>null</code>而不进行任何检查。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>locale</code> - 所需的
<code>Locale</code>
<code>null</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>locale</code>是非
<code>null</code>但不是由
<code>getAvailableLocales</code>返回的值
<code>getAvailableLocales</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriter.html#getLocale--"><code>getLocale()</code></a>
</dd>
</dl> </li>
</ul> <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">
<span>如果没有设置,则返回当前设置的<code>Locale</code><code>null</code></span>
<p> <span>默认实现返回<code>locale</code>实例变量的值。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
目前为
<code>Locale</code> ,或
<code>null</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriter.html#setLocale-java.util.Locale-"><code>setLocale(java.util.Locale)</code></a>
</dd>
</dl> </li>
</ul> <a name="getDefaultWriteParam--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDefaultWriteParam</h4> <pre>public <a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> getDefaultWriteParam()</pre>
<div class="block">
<span>返回一个包含默认值的文件格式的适当类型的新的<code>ImageWriteParam</code>对象,也就是指定没有<code>ImageWriteParam</code>对象时将使用的那些值。</span>
<span>这是一个起点,用于调整一些参数,否则只能保留默认设置。</span>
<p> <span>默认实现构造并返回不允许平铺,逐行编码或压缩的新的<code>ImageWriteParam</code>对象,并且将被本地化为当前的<code>Locale</code> <i></i> ,您将通过调用<code>new ImageWriteParam(getLocale())</code>获得的<code>new ImageWriteParam(getLocale())</code></span> </p>
<p> <span>单独的插件可能返回一个<code>ImageWriteParam</code>的实例,并启用了附加的可选功能,或者它们可能会返回<code>ImageWriteParam</code>的插件特定子类的<code>ImageWriteParam</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个新的
<code>ImageWriteParam</code>对象包含默认值。
</dd>
</dl> </li>
</ul> <a name="getDefaultStreamMetadata-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDefaultStreamMetadata</h4> <pre>public abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> getDefaultStreamMetadata(<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</pre>
<div class="block">
<span>返回一个<code>IIOMetadata</code>用于编码图像流的默认值的<code>IIOMetadata</code>对象。</span>
<span>可以使用由<code>IIOMetadata.getAsTree</code>方法返回的XML树结构 <code>IIOMetadataController</code>对象或通过插件特定接口来<code>IIOMetadataController</code>对象的内容,并将得到的数据提供给采用流元数据参数的<code>write</code>方法之一。</span>
<p> <span>可能会为可能影响流元数据结构的情况提供可选的<code>ImageWriteParam</code></span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
<p> <span>不使用流元数据的作者( <i>例如</i> ,单图像格式的作者)应返回<code>null</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>param</code> -一个
<code>ImageWriteParam</code>将被用于对图像,或编码
<code>null</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>IIOMetadata</code>对象。
</dd>
</dl> </li>
</ul> <a name="getDefaultImageMetadata-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDefaultImageMetadata</h4> <pre>public abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> getDefaultImageMetadata(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</pre>
<div class="block">
<span>返回一个<code>IIOMetadata</code>给定类型图像的默认值的<code>IIOMetadata</code>对象。</span>
<span>可以使用由<code>IIOMetadata.getAsTree</code>方法返回的XML树结构 <code>IIOMetadataController</code>对象或通过插件特定接口来<code>IIOMetadataController</code>对象的内容,并将得到的数据提供给采用流元数据参数的<code>write</code>方法之一。</span>
<p> <span>可能会为可能影响图像元数据结构的情况提供可选的<code>ImageWriteParam</code></span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageType</code> -一个
<code>ImageTypeSpecifier</code>表示的图像的格式将在后面写入。
</dd>
<dd>
<code>param</code> -一个
<code>ImageWriteParam</code>将被用于对图像,或编码
<code>null</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>IIOMetadata</code>对象。
</dd>
</dl> </li>
</ul> <a name="convertStreamMetadata-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>convertStreamMetadata</h4> <pre>public abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> convertStreamMetadata(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> inData,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从接口: <code><a href="../../javax/imageio/ImageTranscoder.html#convertStreamMetadata-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageWriteParam-">ImageTranscoder</a></code>复制</span>
</div>
<div class="block">
<span>返回可用于编码的<code>IIOMetadata</code>对象,并可使用其文档接口或特定于将用于编码的写入程序插件的其他接口进行可选修改。</span>
<p> <span>可能会为可能影响流元数据结构的情况提供可选的<code>ImageWriteParam</code></span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此作者或代码转换器不理解的可选设置值,则它们将被忽略。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/imageio/ImageTranscoder.html#convertStreamMetadata-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageWriteParam-">convertStreamMetadata</a></code>中的
<code><a href="../../javax/imageio/ImageTranscoder.html" title="interface in javax.imageio">ImageTranscoder</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>inData</code> - 表示流元数据的
<code>IIOMetadata</code>对象,用于初始化返回对象的状态。
</dd>
<dd>
<code>param</code> -一个
<code>ImageWriteParam</code>将被用于对图像,或编码
<code>null</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>IIOMetadata</code>对象,或
<code>null</code>如果插件并未提供元数据编码功能。
</dd>
</dl> </li>
</ul> <a name="convertImageMetadata-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>convertImageMetadata</h4> <pre>public abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> convertImageMetadata(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> inData,
<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面: <code><a href="../../javax/imageio/ImageTranscoder.html#convertImageMetadata-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-">ImageTranscoder</a></code>复制</span>
</div>
<div class="block">
<span>返回可用于编码的<code>IIOMetadata</code>对象并可以使用其文档接口或特定于将用于编码的writer插件的其他接口进行修改。</span>
<p> <span>可能会为可能影响图像元数据结构的情况提供可选的<code>ImageWriteParam</code></span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此作者或代码转换器不能理解的可选设置值,则它们将被忽略。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/imageio/ImageTranscoder.html#convertImageMetadata-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-">convertImageMetadata</a></code>在界面
<code><a href="../../javax/imageio/ImageTranscoder.html" title="interface in javax.imageio">ImageTranscoder</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>inData</code> - 表示图像元数据的
<code>IIOMetadata</code>对象,用于初始化返回对象的状态。
</dd>
<dd>
<code>imageType</code> -
<code>ImageTypeSpecifier</code> ,其指示与元数据相关联的图像的布局和颜色信息。
</dd>
<dd>
<code>param</code> -一个
<code>ImageWriteParam</code>将被用于对图像,或编码
<code>null</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>IIOMetadata</code>对象,或
<code>null</code>如果插件不提供元数据编码功能。
</dd>
</dl> </li>
</ul> <a name="getNumThumbnailsSupported-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-javax.imageio.metadata.IIOMetadata-javax.imageio.metadata.IIOMetadata-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNumThumbnailsSupported</h4> <pre>public int getNumThumbnailsSupported(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param,
<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata,
<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata)</pre>
<div class="block">
<span>给定图像类型以及编码期间将要使用的任何其他写入参数和元数据对象,返回由正在写入的格式支持的缩略图数。</span>
<span>返回值为<code>-1</code>表明,信息不足是可用的。</span>
<p> <span>一个<code>ImageWriteParam</code>可任选地被用于在那里它可以影响缩略图办案提供。</span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
<p> <span>默认实现返回0。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageType</code> -
<code>ImageTypeSpecifier</code>要写入的图像的类型的
<code>null</code> ,或
<code>null</code>
</dd>
<dd>
<code>param</code> -该
<code>ImageWriteParam</code>将被用于书写,或
<code>null</code>
</dd>
<dd>
<code>streamMetadata</code> - 将用于写入的
<code>IIOMetadata</code>对象,或
<code>null</code>
</dd>
<dd>
<code>imageMetadata</code> - 将用于写入的
<code>IIOMetadata</code>对象,或
<code>null</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
其可以被写入给定所提供的参数,或缩略图的数目
<code>-1</code>如果信息不足是可用的。
</dd>
</dl> </li>
</ul> <a name="getPreferredThumbnailSizes-javax.imageio.ImageTypeSpecifier-javax.imageio.ImageWriteParam-javax.imageio.metadata.IIOMetadata-javax.imageio.metadata.IIOMetadata-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPreferredThumbnailSizes</h4> <pre>public <a href="../../java/awt/Dimension.html" title="class in java.awt">Dimension</a>[] getPreferredThumbnailSizes(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param,
<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata,
<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata)</pre>
<div class="block">
<span>返回一个<code>Dimension</code> s的数组 <code>Dimension</code>像的合法大小范围,因为它们将被编码在输出文件或流中。</span>
<span>这些信息只是咨询;</span>
<span>作者将根据需要调整所提供的缩略图大小。</span>
<p> <span>该信息作为一组对返回;</span> <span>一对的第一个元素包含(包括)最小宽度和高度,第二个元素包含(包含)最大宽度和高度。</span> <span>在一起,每对都定义了一个有效的大小范围。</span> <span>要指定一个固定的大小,两个元素都会出现相同的宽度和高度。</span> <span>返回值为<code>null</code>指示大小是任意的或未知的。</span> </p>
<p> <span>一个<code>ImageWriteParam</code>可任选地被用于在那里它可以影响缩略图办案提供。</span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
<p> <span>默认实现返回<code>null</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageType</code> -
<code>ImageTypeSpecifier</code>要写入的图像的类型的
<code>null</code> ,或
<code>null</code>
</dd>
<dd>
<code>param</code> -该
<code>ImageWriteParam</code>将被用于书写,或
<code>null</code>
</dd>
<dd>
<code>streamMetadata</code> - 将用于写入的
<code>IIOMetadata</code>对象,或
<code>null</code>
</dd>
<dd>
<code>imageMetadata</code> - 将用于写入的
<code>IIOMetadata</code>对象,或
<code>null</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>Dimension</code>的数组其长度至少为2或
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="canWriteRasters--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canWriteRasters</h4> <pre>public boolean canWriteRasters()</pre>
<div class="block">
<span>返回<code>true</code>如果采取方法<code>IIOImage</code>参数能够与处理的<code>Raster</code> (相对于<code>RenderedImage</code> )源图像。</span>
<span>如果此方法返回<code>false</code> ,那么这些方法将抛出一个<code>UnsupportedOperationException</code>如果附带一个<code>IIOImage</code> Raster的<code>Raster</code></span>
<p> <span>默认实现返回<code>false</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果
<code>Raster</code>源支持。
</dd>
</dl> </li>
</ul> <a name="write-javax.imageio.metadata.IIOMetadata-javax.imageio.IIOImage-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>write</h4> <pre>public abstract void write(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata,
<a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a> image,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>将包含单个图像和关联流以及图像元数据和缩略图的完整图像流附加到输出。</span>
<span>包括任何必要的标题信息。</span>
<span>如果输出为<code>ImageOutputStream</code> ,则其当前查找位置之前的现有内容不受影响,无需读写。</span>
<p> <span>必须使用<code>setOutput</code>方法预先设置输出。</span> </p>
<p> <span>可以可选地提供流元数据;</span> <span>如果是<code>null</code> ,将使用默认流元数据。</span> </p>
<p> <span>如果<code>canWriteRasters</code>返回<code>true</code> ,则<code>IIOImage</code>可能包含一个<code>Raster</code>源。</span> <span>否则,它必须包含一个<code>RenderedImage</code>源代码。</span> </p>
<p> <span>如果需要,提供的缩略图将被调整大小,超过支持的数字的任何缩略图将被忽略。</span> <span>如果格式需要未提供的附加缩略图,则作者应在内部生成它们。</span> </p>
<p> <span>一个<code>ImageWriteParam</code>可任选地提供给控制写入过程。</span> <span>如果<code>param</code><code>null</code> ,则将使用默认的写参数。</span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>streamMetadata</code> - 表示流元数据的
<code>IIOMetadata</code>对象,或使用默认值的
<code>null</code>
</dd>
<dd>
<code>image</code> - 包含要写入的图像,缩略图和元数据的
<code>IIOImage</code>对象。
</dd>
<dd>
<code>param</code> - 一个
<code>ImageWriteParam</code>
<code>null</code>使用默认
<code>ImageWriteParam</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>image</code>包含一个
<code>Raster</code>
<code>canWriteRasters</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>image</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="write-javax.imageio.IIOImage-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>write</h4> <pre>public void write(<a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a> image)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>将含有默认元数据和缩略图的单个图像的完整图像流附加到输出。</span>
<span>这个方法是write(null, image, null)的<code>write(null, image, null)</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>image</code> - 一个
<code>IIOImage</code>要写入的图像,缩略图和元数据的
<code>IIOImage</code>对象。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>image</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>image</code>包含一个
<code>Raster</code>
<code>canWriteRasters</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="write-java.awt.image.RenderedImage-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>write</h4> <pre>public void write(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> image)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>将包含单个图像的完整图像流附加到输出的默认元数据和缩略图。</span>
<span>这个方法是write(null, new IIOImage(image, null, null), null)的<code>write(null, new IIOImage(image, null, null), null)</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>image</code> - a
<code>RenderedImage</code>待写。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>image</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="canWriteSequence--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canWriteSequence</h4> <pre>public boolean canWriteSequence()</pre>
<div class="block">
<span>如果作者能够将图像附加到已经包含标题信息和可能的先前图像的图像流中,则返回<code>true</code></span>
<p> <span>如果<code>canWriteSequence</code>返回<code>false</code> <code>writeToSequence</code><code>endWriteSequence</code>将抛出<code>UnsupportedOperationException</code></span> </p>
<p> <span>默认实现返回<code>false</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果可以顺序附加图像。
</dd>
</dl> </li>
</ul> <a name="prepareWriteSequence-javax.imageio.metadata.IIOMetadata-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>prepareWriteSequence</h4> <pre>public void prepareWriteSequence(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>使用提供的流元数据对象准备流以接受一系列后续的<code>writeToSequence</code>调用。</span>
<span>如果元数据应该在图像数据之前,则会将元数据写入流中。</span>
<span>如果参数为<code>null</code> ,则使用默认流元数据。</span>
<p> <span>如果输出为<code>ImageOutputStream</code> ,则刷新当前查找位置之前的输出的现有内容,并且不需要可读写。</span> <span>如果格式要求<code>endWriteSequence</code>能够倒带来补丁头信息例如对于单个TIFF文件中的一系列图像则由该方法写入的元数据必须保留在该流的可写入部分中。</span> <span>其他格式可以在此方法之后和每个图像之后刷新流。</span> </p>
<p> <span>如果<code>canWriteSequence</code>返回<code>false</code> ,这个方法会抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>必须使用<code>setOutput</code>方法预先设置输出。</span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>streamMetadata</code> - 流元数据对象,或
<code>null</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canWriteSequence</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果写入流元数据发生错误。
</dd>
</dl> </li>
</ul> <a name="writeToSequence-javax.imageio.IIOImage-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>writeToSequence</h4> <pre>public void writeToSequence(<a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a> image,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>将单个图像和可能关联的元数据和缩略图附加到输出。</span>
<span>如果输出为<code>ImageOutputStream</code> 则当前查找位置之前的输出的现有内容可能被刷新并且不需要读取或写入除非插件需要在调用endWriteSequence时<code>endWriteSequence</code>进行补丁( <i>例如</i> TIFF</span>
<p> <span>如果<code>canWriteSequence</code>返回<code>false</code> ,这个方法会抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>必须使用<code>setOutput</code>方法预先设置输出。</span> </p>
<p> <span><code>prepareWriteSequence</code>必须事先调用,或抛出<code>IllegalStateException</code></span> </p>
<p> <span>如果<code>canWriteRasters</code>返回<code>true</code> ,则<code>IIOImage</code>可能包含一个<code>Raster</code>源。</span> <span>否则,它必须包含一个<code>RenderedImage</code>源。</span> </p>
<p> <span>如果需要,提供的缩略图将被调整大小,超过支持的数字的任何缩略图将被忽略。</span> <span>如果格式需要未提供的附加缩略图,写入程序将在内部生成它们。</span> </p>
<p> <span>一个<code>ImageWriteParam</code>可任选地提供给控制写入过程。</span> <span>如果<code>param</code><code>null</code> ,则将使用默认的写参数。</span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>image</code> - 一个
<code>IIOImage</code>要写入的图像,缩略图和元数据的
<code>IIOImage</code>对象。
</dd>
<dd>
<code>param</code> - 一个
<code>ImageWriteParam</code>
<code>null</code>使用默认的
<code>ImageWriteParam</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置,或
<code>prepareWriteSequence</code>尚未被调用。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canWriteSequence</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>image</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>image</code>包含一个
<code>Raster</code>
<code>canWriteRasters</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="endWriteSequence--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>endWriteSequence</h4> <pre>public void endWriteSequence()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>完成以<code>prepareWriteSequence</code>开始的一系列图像的<code>prepareWriteSequence</code></span>
<span>写出在图像序列结尾应该出现的任何流元数据,并且如果需要,则在序列开始处的任何头信息被修补。</span>
<span>如果输出为<code>ImageOutputStream</code> ,则通过序列结尾处的流元数据的数据被刷新,并且不需要可读写。</span>
<p> <span>如果<code>canWriteSequence</code>返回<code>false</code> ,这个方法会抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置,或
<code>prepareWriteSequence</code>未被调用。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canWriteSequence</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="canReplaceStreamMetadata--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canReplaceStreamMetadata</h4> <pre>public boolean canReplaceStreamMetadata()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>如果可以替换输出中已经存在的流元数据,则返回<code>true</code></span>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则返回<code>false</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/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果在查询期间发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="replaceStreamMetadata-javax.imageio.metadata.IIOMetadata-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>replaceStreamMetadata</h4> <pre>public void replaceStreamMetadata(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>用新信息替换输出中的流元数据。</span>
<span>如果输出为<code>ImageOutputStream</code> <code>ImageOutputStream</code>检查并可能编辑流的先前内容,为新数据腾出空间。</span>
<span>输出的所有先前内容必须可用于阅读和写入。</span>
<p> <span>如果<code>canReplaceStreamMetadata</code>返回<code>false</code> ,将抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>如果输出为<code>null</code> ,默认实现会抛出一个<code>IllegalStateException</code> ,否则会抛出一个<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>streamMetadata</code> - 表示流元数据的
<code>IIOMetadata</code>对象,或使用默认值的
<code>null</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<span><code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果<code>canReplaceStreamMetadata</code>返回<code>false</code></span>
<span>模式不包括</span>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="canReplaceImageMetadata-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canReplaceImageMetadata</h4> <pre>public boolean canReplaceImageMetadata(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回<code>true</code>如果能够替换与现有的图像与索引相关联的图像元数据<code>imageIndex</code></span>
<span>如果这个方法返回<code>false</code> ,那么调用<code>replaceImageMetadata(imageIndex)</code>将会抛出一个<code>UnsupportedOperationException</code></span>
<p> <span>不支持任何图像元数据替换的作者可能会返回<code>false</code>而不对索引执行边界检查。</span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则返回<code>false</code>不检查的值<code>imageIndex</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要替换其元数据的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果可以替换给定图像的图像元数据。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果作者一般支持图像元数据替换,但
<code>imageIndex</code>小于0或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果在查询期间发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="replaceImageMetadata-int-javax.imageio.metadata.IIOMetadata-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>replaceImageMetadata</h4> <pre>public void replaceImageMetadata(int imageIndex,
<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>替换与现有图像相关联的图像元数据。</span>
<p> <span>如果<code>canReplaceImageMetadata(imageIndex)</code>返回<code>false</code> ,则会抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要替换其元数据的图像的索引。
</dd>
<dd>
<code>imageMetadata</code> - 表示图像元数据的
<code>IIOMetadata</code>对象,或
<code>null</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canReplaceImageMetadata</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果
<code>imageIndex</code>小于0或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="canInsertImage-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canInsertImage</h4> <pre>public boolean canInsertImage(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>如果作者支持在给定索引处插入新图像,则返回<code>true</code></span>
<span>索引大于或等于插入索引的现有图像将其索引增加1. <code>imageIndex</code><code>-1</code>值可用于表示大于当前最大索引的索引。</span>
<p> <span>不支持任何图像插入的作者可能会返回<code>false</code>而不对索引执行边界检查。</span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则返回<code>false</code>不检查的值<code>imageIndex</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要插入图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果可以在给定索引处插入图像。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果作者一般支持图像插入,但
<code>imageIndex</code>小于-1或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果在查询期间发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="writeInsert-int-javax.imageio.IIOImage-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>writeInsert</h4> <pre>public void writeInsert(int imageIndex,
<a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a> image,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>将新图像插入到现有图像流中。</span>
<span>索引大于<code>imageIndex</code>现有图像被保留它们的指数各自增加1. <code>imageIndex</code> -1的值可用于表示大于前一大指数的指数;</span>
<span>也就是说,它将使图像逻辑地附加到序列的末尾。</span>
<span>如果输出是<code>ImageOutputStream</code> ,则整个流必须是可读写的。</span>
<p> <span>如果<code>canInsertImage(imageIndex)</code>返回<code>false</code> ,将抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>一个<code>ImageWriteParam</code>可任选地提供给控制写入过程。</span> <span>如果<code>param</code><code>null</code> ,则将使用默认写参数。</span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 写入图像的索引。
</dd>
<dd>
<code>image</code> - 一个
<code>IIOImage</code>要写入的图像,缩略图和元数据的
<code>IIOImage</code>对象。
</dd>
<dd>
<code>param</code> - 一个
<code>ImageWriteParam</code>
<code>null</code>使用默认的
<code>ImageWriteParam</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canInsertImage(imageIndex)</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>image</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果
<code>imageIndex</code>小于-1或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>image</code>包含一个
<code>Raster</code>
<code>canWriteRasters</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="canRemoveImage-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canRemoveImage</h4> <pre>public boolean canRemoveImage(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>如果作者支持删除给定索引中的现有图像,则返回<code>true</code></span>
<span>索引大于插入索引的现有图像的索引将减少1。</span>
<p> <span>不支持任何图像删除的作者可能会返回<code>false</code>而不对索引执行边界检查。</span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则返回<code>false</code>不检查的值<code>imageIndex</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要删除的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果可以删除给定的图像。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果作者一般支持图像删除,但
<code>imageIndex</code>小于0或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 查询期间是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="removeImage-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeImage</h4> <pre>public void removeImage(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>从流中删除图像。</span>
<p> <span>如果<code>canRemoveImage(imageIndex)</code>返回false将抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>删除可能会导致或可能不会导致实际文件大小的减少。</span> </p>
<p> <span>如果输出为<code>null</code> ,默认实现会抛出一个<code>IllegalStateException</code> ,否则会抛出一个<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要删除的图像的索引。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canRemoveImage(imageIndex)</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果
<code>imageIndex</code>小于0或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果在删除期间发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="canWriteEmpty--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canWriteEmpty</h4> <pre>public boolean canWriteEmpty()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>如果作者支持将包含未定义像素值的单个图像和相关联的元数据和缩略图组成的完整图像流写入输出,则返回<code>true</code></span>
<span>可以通过将来调用<code>replacePixels</code>方法来定义像素值。</span>
<span>如果输出为<code>ImageOutputStream</code> ,则其当前查找位置之前的现有内容不受影响,不需要读取或写入。</span>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则返回<code>false</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/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 查询期间是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="prepareWriteEmpty-javax.imageio.metadata.IIOMetadata-javax.imageio.ImageTypeSpecifier-int-int-javax.imageio.metadata.IIOMetadata-java.util.List-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>prepareWriteEmpty</h4> <pre>public void prepareWriteEmpty(<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> streamMetadata,
<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType,
int width,
int height,
<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata,
<a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;? extends <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a>&gt; thumbnails,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>开始将一个完整的图像流(包含一个具有未定义像素值的单个图像和关联的元数据和缩略图)写入输出。</span>
<span>像素值将由将来调用<code>replacePixels</code>方法定义。</span>
<span>如果输出为<code>ImageOutputStream</code> ,则其当前查找位置之前的现有内容不受影响,无需读取或写入。</span>
<p> <span><code>endWriteEmpty</code>发出呼叫之前,写入不完整。</span> <span>拨打<code>prepareReplacePixels</code> <code>replacePixels</code><code>endReplacePixels</code>可调用之间发生<code>prepareWriteEmpty</code><code>endWriteEmpty</code></span> <span>但是,调用<code>prepareWriteEmpty</code>无法嵌套,并且调用<code>prepareWriteEmpty</code><code>prepareInsertEmpty</code>可能不会散置。</span> </p>
<p> <span>如果<code>canWriteEmpty</code>返回<code>false</code> ,将抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>一个<code>ImageWriteParam</code>可任选地提供给控制写入过程。</span> <span>如果<code>param</code><code>null</code> ,将使用默认的写参数。</span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
<p> <span>如果输出为<code>null</code> ,默认实现会抛出一个<code>IllegalStateException</code> ,否则会抛出一个<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>streamMetadata</code> - 表示流元数据的
<code>IIOMetadata</code>对象,或使用默认值的
<code>null</code>
</dd>
<dd>
<code>imageType</code> -
<code>ImageTypeSpecifier</code>图像布局的ImageTypeSpecifier。
</dd>
<dd>
<code>width</code> - 图像的宽度。
</dd>
<dd>
<code>height</code> - 图像的高度。
</dd>
<dd>
<code>imageMetadata</code> - 表示图像元数据的
<code>IIOMetadata</code>对象,或
<code>null</code>
</dd>
<dd>
<code>thumbnails</code> - a
<code>List</code>
<code>BufferedImage</code>此图片的
<code>BufferedImage</code> ,或
<code>null</code>
</dd>
<dd>
<code>param</code> - 一个
<code>ImageWriteParam</code>
<code>null</code>使用默认的
<code>ImageWriteParam</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canWriteEmpty</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果先前致电
<code>prepareWriteEmpty</code>已经进行了没有相应的调用
<code>endWriteEmpty</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果先前致电
<code>prepareInsertEmpty</code>已经进行了没有相应的调用
<code>endInsertEmpty</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>imageType</code>
<code>null</code>
<code>thumbnails</code>包含
<code>null</code>引用或除
<code>BufferedImage</code>的对象。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果宽度或高度小于1。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="endWriteEmpty--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>endWriteEmpty</h4> <pre>public void endWriteEmpty()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>完成了以前调用<code>prepareWriteEmpty</code>开始的新图像的写入。</span>
<p> <span>如果<code>canWriteEmpty()</code>返回<code>false</code> ,则会抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 若
<code>canWriteEmpty(imageIndex)</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code>如果以前调用-
<code>prepareWriteEmpty</code>没有相应的调用
<code>endWriteEmpty</code>尚未作出。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果以前拨打
<code>prepareInsertEmpty</code>没有对应的调用
<code>endInsertEmpty</code>已经做出了。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果没有对
<code>prepareReiplacePixels</code>进行匹配调用,
<code>endReplacePixels</code>调用
<code>endReplacePixels</code>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="canInsertEmpty-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canInsertEmpty</h4> <pre>public boolean canInsertEmpty(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>如果作者支持在给定索引处插入新的空图像,则返回<code>true</code></span>
<span>图像的像素值未定义,可以使用<code>replacePixels</code>方法<code>replacePixels</code></span>
<span>索引大于或等于插入索引的现有图像将其索引增加1. <code>imageIndex</code><code>-1</code>值可用于表示大于当前最大索引的索引。</span>
<p> <span>不支持插入空图像的作者可能会返回<code>false</code>而不对索引执行边界检查。</span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则返回<code>false</code>不检查的值<code>imageIndex</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要插入图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果可以在给定索引处插入空图像。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果作者一般支持空图像插入,但
<code>imageIndex</code>小于-1或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 查询期间是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="prepareInsertEmpty-int-javax.imageio.ImageTypeSpecifier-int-int-javax.imageio.metadata.IIOMetadata-java.util.List-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>prepareInsertEmpty</h4> <pre>public void prepareInsertEmpty(int imageIndex,
<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> imageType,
int width,
int height,
<a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> imageMetadata,
<a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;? extends <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a>&gt; thumbnails,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>开始将未定义像素值的新图像插入到现有图像流中。</span>
<span>索引大于<code>imageIndex</code>现有图像被保留它们的索引各自增加1.可以使用-1的<code>imageIndex</code>的值来表示比先前最大索引大的索引;</span>
<span>也就是说,它将使图像逻辑地附加到序列的末尾。</span>
<span>如果输出是<code>ImageOutputStream</code> ,则整个流都必须是可读写的。</span>
<p> <span>以后可以使用<code>replacePixels</code>方法提供图像内容。</span> <span>调用<code>endInsertEmpty</code>之前插入不完整。</span> <span>拨打<code>prepareReplacePixels</code> <code>replacePixels</code><code>endReplacePixels</code>可调用之间发生<code>prepareInsertEmpty</code><code>endInsertEmpty</code></span> <span>但是,拨打<code>prepareInsertEmpty</code>不能嵌套,并且调用<code>prepareWriteEmpty</code><code>prepareInsertEmpty</code>可能不会散布。</span> </p>
<p> <span>如果<code>canInsertEmpty(imageIndex)</code>返回<code>false</code> ,则会抛出一个<code>UnsupportedOperationException</code></span> </p>
<p> <span>一个<code>ImageWriteParam</code>可任选地提供给控制写入过程。</span> <span>如果<code>param</code><code>null</code> ,将使用默认的写参数。</span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
<p> <span>如果输出为<code>null</code> ,默认实现会抛出一个<code>IllegalStateException</code> ,否则会抛出一个<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 写入图像的索引。
</dd>
<dd>
<code>imageType</code> -
<code>ImageTypeSpecifier</code>图像布局的ImageTypeSpecifier。
</dd>
<dd>
<code>width</code> - 图像的宽度。
</dd>
<dd>
<code>height</code> - 图像的高度。
</dd>
<dd>
<code>imageMetadata</code> - 表示图像元数据的
<code>IIOMetadata</code>对象,或
<code>null</code>
</dd>
<dd>
<code>thumbnails</code> - a
<code>List</code>
<code>BufferedImage</code>该图像的
<code>BufferedImage</code> ,或
<code>null</code>
</dd>
<dd>
<code>param</code> - 一个
<code>ImageWriteParam</code>
<code>null</code>使用默认的
<code>ImageWriteParam</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canInsertEmpty(imageIndex)</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果
<code>imageIndex</code>小于-1或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果先前致电
<code>prepareInsertEmpty</code>已经进行了没有相应的调用
<code>endInsertEmpty</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果先前致电
<code>prepareWriteEmpty</code>已经进行了没有相应的调用
<code>endWriteEmpty</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>imageType</code>
<code>null</code>
<code>thumbnails</code>包含
<code>null</code>引用或除
<code>BufferedImage</code>的对象。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果宽度或高度小于1。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="endInsertEmpty--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>endInsertEmpty</h4> <pre>public void endInsertEmpty()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>完成插入一个以前调用<code>prepareInsertEmpty</code>开始的新映像。</span>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canInsertEmpty(imageIndex)</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code>如果以前调用-
<code>prepareInsertEmpty</code>没有相应的调用
<code>endInsertEmpty</code>尚未作出。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果以前致电
<code>prepareWriteEmpty</code>没有对应的调用
<code>endWriteEmpty</code>已经做出了。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果没有对
<code>prepareReplacePixels</code>的匹配呼叫进行
<code>endReplacePixels</code>呼叫。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="canReplacePixels-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canReplacePixels</h4> <pre>public boolean canReplacePixels(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>如果作者允许使用<code>replacePixels</code>方法替换给定图像的像素,则返回<code>true</code></span>
<p> <span>不支持任何像素替换的作者可能会返回<code>false</code>而不对索引执行边界检查。</span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则返回<code>false</code>不检查的值<code>imageIndex</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要替换其像素的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果可以替换给定图像的像素。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果作者一般支持像素替换,但
<code>imageIndex</code>小于0或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 查询期间是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="prepareReplacePixels-int-java.awt.Rectangle-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>prepareReplacePixels</h4> <pre>public void prepareReplacePixels(int imageIndex,
<a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> region)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>准备作者处理一系列对<code>replacePixels</code>方法的调用。</span>
<span>受影响的像素区域将与所提供的像素区域相对</span>
<p> <span>如果<code>canReplacePixels</code>返回<code>false</code> ,则会抛出<code>UnsupportedOperationException</code></span> </p>
<p> <span>如果输出为<code>null</code> ,默认实现会抛出一个<code>IllegalStateException</code> ,否则会抛出一个<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要替换其像素的图像的索引。
</dd>
<dd>
<code>region</code> - 将用于剪辑未来像素区域的
<code>Rectangle</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canReplacePixels(imageIndex)</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果
<code>imageIndex</code>小于0或大于最大可用索引。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> -如果以前调用
<code>prepareReplacePixels</code>没有相应地调用
<code>endReplacePixels</code>
<i></i>嵌套是不允许的)。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>region</code>
<code>null</code>或宽度或高度小于1。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 在准备过程中是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="replacePixels-java.awt.image.RenderedImage-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>replacePixels</h4> <pre>public void replacePixels(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> image,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>用给定图像的一部分替换已经存在于输出中的图像的一部分。</span>
<span>图像数据必须匹配或可转换为现有图像的图像布局。</span>
<p> <span>目标区域在<code>param</code>参数中指定,并将被剪切到图像边界和提供给<code>prepareReplacePixels</code>的区域。</span> <span>源的至少一个像素不能被裁剪,或抛出异常。</span> </p>
<p> <span>一个<code>ImageWriteParam</code>可任选地提供给控制写入过程。</span> <span>如果<code>param</code><code>null</code> ,则将使用默认的写参数。</span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
<p> <span>此方法只能在调用<code>prepareReplacePixels</code>后调用,否则将抛出<code>IllegalStateException</code></span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>image</code> - 一个包含源像素的
<code>RenderedImage</code>
</dd>
<dd>
<code>param</code> - 一个
<code>ImageWriteParam</code>
<code>null</code>使用默认的
<code>ImageWriteParam</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canReplacePixels(imageIndex)</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果没有以前的电话
<code>prepareReplacePixels</code>没有匹配的电话
<code>endReplacePixels</code>
</dd>
<dd>
<span><code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果满足以下条件:</span>
<ul>
<li> <span><code>image</code><code>null</code></span> </li>
<li> <span><code>param</code><code>null</code></span> </li>
<li> <span>相交区域不包含至少一个像素。</span> </li>
<li> <span><code>image</code>的布局不匹配,或者这个作者不能将其转换为现有的图像布局。</span> </li>
</ul>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="replacePixels-java.awt.image.Raster-javax.imageio.ImageWriteParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>replacePixels</h4> <pre>public void replacePixels(<a href="../../java/awt/image/Raster.html" title="class in java.awt.image">Raster</a> raster,
<a href="../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>用给定的<code>Raster</code>的一部分代替输出中已存在的图像的一部分。</span>
<span>图像数据必须匹配或可转换为现有图像的图像布局。</span>
<p> <span>一个<code>ImageWriteParam</code>可任选地提供给控制写入过程。</span> <span>如果<code>param</code><code>null</code> ,将使用默认的写参数。</span> </p>
<p> <span>目的地区域在<code>param</code>参数中指定,并将被剪切到图像边界和提供给<code>prepareReplacePixels</code>的区域。</span> <span>源的至少一个像素不能被裁剪,或抛出异常。</span> </p>
<p> <span>如果提供的<code>ImageWriteParam</code>包含此写入程序不支持的可选设置值( <i>例如</i>逐行编码或任何特定于格式的设置),它们将被忽略。</span> </p>
<p> <span>此方法只能在调用<code>prepareReplacePixels</code>后调用,否则将抛出<code>IllegalStateException</code></span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>raster</code> - 一个包含源像素的
<code>Raster</code>
</dd>
<dd>
<code>param</code> - 一个
<code>ImageWriteParam</code>
<code>null</code>使用默认的
<code>ImageWriteParam</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canReplacePixels(imageIndex)</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果没有调用
<code>prepareReplacePixels</code>而没有匹配的调用
<code>endReplacePixels</code>
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canWriteRasters</code>返回
<code>false</code>
</dd>
<dd>
<span><code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果满足以下条件:</span>
<ul>
<li> <span><code>raster</code><code>null</code></span> </li>
<li> <span><code>param</code><code>null</code></span> </li>
<li> <span>相交区域不包含至少一个像素。</span> </li>
<li> <span><code>raster</code>的布局不匹配,或者这个作者不能将其转换为现有的图像布局。</span> </li>
</ul>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="endReplacePixels--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>endReplacePixels</h4> <pre>public void endReplacePixels()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>终止调用序列<code>replacePixels</code></span>
<p> <span>如果<code>canReplacePixels</code>返回<code>false</code> ,则会抛出<code>UnsupportedOperationException</code></span> </p>
<p> <span>默认的实现抛出<code>IllegalStateException</code>如果输出为<code>null</code> ,否则会引发<code>UnsupportedOperationException</code></span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输出未设置。
</dd>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果
<code>canReplacePixels(imageIndex)</code>返回
<code>false</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果没有以前的电话
<code>prepareReplacePixels</code>没有匹配的电话
<code>endReplacePixels</code>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="abort--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>abort</h4> <pre>public void abort()</pre>
<div class="block">
<span>请求中止任何当前的写入操作。</span>
<span>中止输出后的内容将不确定。</span>
<p> <span>写入应在每次写操作开始时调用<code>clearAbortRequest</code> ,并在写入期间<code>abortRequested</code>轮询abortRequested的值。</span> </p>
</div> </li>
</ul> <a name="abortRequested--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>abortRequested</h4> <pre>protected boolean abortRequested()</pre>
<div class="block">
返回
<code>true</code>是否已经作出中止当前写入操作的请求自从writer被实例化或
<code>clearAbortRequest</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/ImageWriter.html#abort--"><code>abort()</code></a>
<a href="../../javax/imageio/ImageWriter.html#clearAbortRequest--"><code>clearAbortRequest()</code></a>
</dd>
</dl> </li>
</ul> <a name="clearAbortRequest--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>clearAbortRequest</h4> <pre>protected void clearAbortRequest()</pre>
<div class="block">
<span>清除任何先前的中止请求。</span>
<span>此方法被调用后, <code>abortRequested</code>将返回<code>false</code></span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriter.html#abort--"><code>abort()</code></a>
<a href="../../javax/imageio/ImageWriter.html#abortRequested--"><code>abortRequested()</code></a>
</dd>
</dl> </li>
</ul> <a name="addIIOWriteWarningListener-javax.imageio.event.IIOWriteWarningListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addIIOWriteWarningListener</h4> <pre>public void addIIOWriteWarningListener(<a href="../../javax/imageio/event/IIOWriteWarningListener.html" title="interface in javax.imageio.event">IIOWriteWarningListener</a> listener)</pre>
<div class="block">
<span><code>IIOWriteWarningListener</code>添加到已注册警告侦听器的列表中。</span>
<span>如果<code>listener</code><code>null</code> ,则不会抛出异常,不会执行任何操作。</span>
<span>发送给给定侦听器的消息将被本地化,如果可能,匹配当前的<code>Locale</code></span>
<span>如果没有设置<code>Locale</code> ,那么警告消息可能会按照写入器的身份进行本地化。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> -一个
<code>IIOWriteWarningListener</code>注册。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriter.html#removeIIOWriteWarningListener-javax.imageio.event.IIOWriteWarningListener-"><code>removeIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeIIOWriteWarningListener-javax.imageio.event.IIOWriteWarningListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeIIOWriteWarningListener</h4> <pre>public void removeIIOWriteWarningListener(<a href="../../javax/imageio/event/IIOWriteWarningListener.html" title="interface in javax.imageio.event">IIOWriteWarningListener</a> listener)</pre>
<div class="block">
<span>删除一个<code>IIOWriteWarningListener</code>从注册的警告侦听器的列表。</span>
<span>如果听众以前没有注册,或者如果<code>listener</code><code>null</code> ,则不会抛出异常,也不会采取任何操作。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> -一个
<code>IIOWriteWarningListener</code>被注销。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriter.html#addIIOWriteWarningListener-javax.imageio.event.IIOWriteWarningListener-"><code>addIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeAllIIOWriteWarningListeners--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeAllIIOWriteWarningListeners</h4> <pre>public void removeAllIIOWriteWarningListeners()</pre>
<div class="block">
<span>删除所有当前注册的<code>IIOWriteWarningListener</code>对象。</span>
<p> <span>默认实现将<code>warningListeners</code><code>warningLocales</code>实例变量设置为<code>null</code></span> </p>
</div> </li>
</ul> <a name="addIIOWriteProgressListener-javax.imageio.event.IIOWriteProgressListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addIIOWriteProgressListener</h4> <pre>public void addIIOWriteProgressListener(<a href="../../javax/imageio/event/IIOWriteProgressListener.html" title="interface in javax.imageio.event">IIOWriteProgressListener</a> listener)</pre>
<div class="block">
<span><code>IIOWriteProgressListener</code>添加到已注册进度侦听器的列表中。</span>
<span>如果<code>listener</code><code>null</code> ,则不会抛出任何异常,也不会采取任何行动。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> -一个
<code>IIOWriteProgressListener</code>注册。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriter.html#removeIIOWriteProgressListener-javax.imageio.event.IIOWriteProgressListener-"><code>removeIIOWriteProgressListener(javax.imageio.event.IIOWriteProgressListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeIIOWriteProgressListener-javax.imageio.event.IIOWriteProgressListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeIIOWriteProgressListener</h4> <pre>public void removeIIOWriteProgressListener(<a href="../../javax/imageio/event/IIOWriteProgressListener.html" title="interface in javax.imageio.event">IIOWriteProgressListener</a> listener)</pre>
<div class="block">
<span>删除一个<code>IIOWriteProgressListener</code>从注册的进度侦听器列表中。</span>
<span>如果监听者以前没有注册,或者如果<code>listener</code><code>null</code> ,则不会抛出异常,也不会采取任何操作。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> -一个
<code>IIOWriteProgressListener</code>被注销。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageWriter.html#addIIOWriteProgressListener-javax.imageio.event.IIOWriteProgressListener-"><code>addIIOWriteProgressListener(javax.imageio.event.IIOWriteProgressListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeAllIIOWriteProgressListeners--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeAllIIOWriteProgressListeners</h4> <pre>public void removeAllIIOWriteProgressListeners()</pre>
<div class="block">
<span>删除所有当前注册的<code>IIOWriteProgressListener</code>对象。</span>
<p> <span>默认实现将<code>progressListeners</code>实例变量设置为<code>null</code></span> </p>
</div> </li>
</ul> <a name="processImageStarted-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processImageStarted</h4> <pre>protected void processImageStarted(int imageIndex)</pre>
<div class="block">
<span>通过调用他们的<code>imageStarted</code>方法,将所有注册的<code>IIOWriteProgressListener</code> s的图像写入的开始<code>imageStarted</code></span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要写入的图像的索引。
</dd>
</dl> </li>
</ul> <a name="processImageProgress-float-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processImageProgress</h4> <pre>protected void processImageProgress(float percentageDone)</pre>
<div class="block">
<span>通过调用他们的<code>imageProgress</code>方法,将目前的图像完成百分比广播到所有注册的<code>IIOWriteProgressListener</code></span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>percentageDone</code> - 目前的完成百分比,作为
<code>float</code>
</dd>
</dl> </li>
</ul> <a name="processImageComplete--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processImageComplete</h4> <pre>protected void processImageComplete()</pre>
<div class="block">
<span>通过调用他们的<code>imageComplete</code>方法来广播对所有注册的<code>IIOWriteProgressListener</code>的图像写入的<code>imageComplete</code></span>
<span>子类可以方便地使用这种方法。</span>
</div> </li>
</ul> <a name="processThumbnailStarted-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processThumbnailStarted</h4> <pre>protected void processThumbnailStarted(int imageIndex,
int thumbnailIndex)</pre>
<div class="block">
<span>通过调用他们的<code>thumbnailStarted</code>方法,将所有注册的<code>IIOWriteProgressListener</code> s的缩略图写入的开始<code>thumbnailStarted</code></span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 与
<code>imageIndex</code>的图像的索引。
</dd>
<dd>
<code>thumbnailIndex</code> -
<code>thumbnailIndex</code>的索引。
</dd>
</dl> </li>
</ul> <a name="processThumbnailProgress-float-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processThumbnailProgress</h4> <pre>protected void processThumbnailProgress(float percentageDone)</pre>
<div class="block">
<span>通过调用他们的<code>thumbnailProgress</code>方法,将目前的缩略图完成百分比广播到所有注册的<code>IIOWriteProgressListener</code></span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>percentageDone</code> - 目前的完成百分比,为
<code>float</code>
</dd>
</dl> </li>
</ul> <a name="processThumbnailComplete--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processThumbnailComplete</h4> <pre>protected void processThumbnailComplete()</pre>
<div class="block">
<span>通过调用他们的<code>thumbnailComplete</code>方法广播完成对所有注册的<code>IIOWriteProgressListener</code>的缩略图写入。</span>
<span>子类可以方便地使用这种方法。</span>
</div> </li>
</ul> <a name="processWriteAborted--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processWriteAborted</h4> <pre>protected void processWriteAborted()</pre>
<div class="block">
<span>通过调用他们的<code>writeAborted</code>方法<code>IIOWriteProgressListener</code>已经中止所有注册的所有注册的<code>IIOWriteProgressListener</code></span>
<span>子类可以方便地使用这种方法。</span>
</div> </li>
</ul> <a name="processWarningOccurred-int-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processWarningOccurred</h4> <pre>protected void processWarningOccurred(int imageIndex,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> warning)</pre>
<div class="block">
<span>通过调用他们的<code>warningOccurred</code>方法向所有注册的<code>IIOWriteWarningListener</code>发送一条警告消息。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 发生警告的图像的索引。
</dd>
<dd>
<code>warning</code> - 警告信息。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>warning</code>
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="processWarningOccurred-int-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processWarningOccurred</h4> <pre>protected void processWarningOccurred(int imageIndex,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> baseName,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> keyword)</pre>
<div class="block">
<span>广播本地化警告消息给所有注册<code>IIOWriteWarningListener</code>通过调用它们的S <code>warningOccurred</code>法从拍摄字符串<code>ResourceBundle</code></span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 发生警告的图像的索引。
</dd>
<dd>
<code>baseName</code> -一组的基本名称
<code>ResourceBundle</code>包含本地化警告消息秒。
</dd>
<dd>
<code>keyword</code> - 用于索引
<code>ResourceBundle</code>的集合内的警告消息的关键字。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>baseName</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>keyword</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果不能找到
<code>ResourceBundle</code>
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果找不到位于
<code>ResourceBundle</code>的命名资源。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果从
<code>ResourceBundle</code>的对象不是
<code>String</code>
</dd>
</dl> </li>
</ul> <a name="reset--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>reset</h4> <pre>public void reset()</pre>
<div class="block">
<span><code>ImageWriter</code>恢复到初始状态。</span>
<p> <span>默认实现调用<code>setOutput(null)</code> <code>setLocale(null)</code> <code>removeAllIIOWriteWarningListeners()</code> <code>removeAllIIOWriteProgressListeners()</code><code>clearAbortRequest</code></span> </p>
</div> </li>
</ul> <a name="dispose--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>dispose</h4> <pre>public void dispose()</pre>
<div class="block">
<span>允许释放此对象持有的任何资源。</span>
<span>在调用此方法之后调用其他方法( <code>finalize</code>之外的其他方法)的结果未定义。</span>
<p> <span>当应用程序知道他们将不再使用此方法时,调用此方法很<code>ImageWriter</code></span> <span>否则,作者可以继续无限期地持有资源。</span> </p>
<p> <span>超类中的这个方法的默认实现什么都不做。</span> <span>子类实现应确保释放所有资源,特别是本地资源。</span> </p>
</div> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>