study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-04 07:42:45 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/imageio/ImageReader.html

3618 lines
190 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 ImageReader">Class ImageReader</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.ImageReader</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">ImageReader</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>用于解析和解码图像的抽象超类。</span>
<span>这个类必须由在Java Image I / O框架的上下文中读取的类进行子类化。</span>
<p> <span><code>ImageReader</code>对象通常由特定格式的服务提供商接口（SPI）类实例化。</span> <span>服务提供商类（例如，ImageReaderSpi的<code>ImageReaderSpi</code> ）已注册到<code>IIORegistry</code> ，它们用于格式识别和呈现可用格式的读者和作者。</span> </p>
<p> <span>当设置输入源（使用<code>setInput</code>方法）时，可能将其标记为“仅向前搜索”。</span> <span>此设置意味着输入源中包含的图像只能按顺序读取，可能允许读取器避免缓存包含与先前读取的图像相关联的数据的输入的部分。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/ImageWriter.html" title="javax.imageio中的类"><code>ImageWriter</code></a> ， <a href="../../javax/imageio/spi/IIORegistry.html" title="javax.imageio.spi中的类"><code>IIORegistry</code></a> ， <a href="../../javax/imageio/spi/ImageReaderSpi.html" title="javax.imageio.spi中的类"><code>ImageReaderSpi</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/ImageReader.html#availableLocales">availableLocales</a></span></code>
<div class="block">
可用于本地化警告消息的
<code>Locale</code> s阵列，如果不支持本地化，
<code>null</code> null。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#ignoreMetadata">ignoreMetadata</a></span></code>
<div class="block">
<code>true</code>如果当前的输入源已被标记为允许元数据被
<code>setInput</code>忽略。
</div> </td>
</tr>
<tr class="altColor">
<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/ImageReader.html#input">input</a></span></code>
<div class="block">
<code>ImageInputStream</code>或其他
<code>Object</code>由
<code>setInput</code>和getInput
<code>getInput</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/ImageReader.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 int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#minIndex">minIndex</a></span></code>
<div class="block">
读取的最小有效索引，最初为0。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../javax/imageio/spi/ImageReaderSpi.html" title="class in javax.imageio.spi">ImageReaderSpi</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#originatingProvider">originatingProvider</a></span></code>
<div class="block">
该
<code>ImageReaderSpi</code>认为这个实例化对象，或
<code>null</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/IIOReadProgressListener.html" title="interface in javax.imageio.event">IIOReadProgressListener</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#progressListeners">progressListeners</a></span></code>
<div class="block">
A
<code>List</code>当前注册的
<code>IIOReadProgressListener</code> s，默认
<code>null</code>为
<code>null</code> ，这是一个空的
<code>List</code> 。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#seekForwardOnly">seekForwardOnly</a></span></code>
<div class="block">
<code>true</code>如果当前的输入源已被标记为只允许前向寻找
<code>setInput</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/IIOReadUpdateListener.html" title="interface in javax.imageio.event">IIOReadUpdateListener</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#updateListeners">updateListeners</a></span></code>
<div class="block">
A
<code>List</code>目前注册的
<code>IIOReadUpdateListener</code> s，默认
<code>null</code>为
<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/IIOReadWarningListener.html" title="interface in javax.imageio.event">IIOReadWarningListener</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#warningListeners">warningListeners</a></span></code>
<div class="block">
A
<code>List</code>目前注册的
<code>IIOReadWarningListener</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/ImageReader.html#warningLocales">warningLocales</a></span></code>
<div class="block">
一个
<code>List</code>的
<code>Locale</code> s与每个当前注册的
<code>IIOReadWarningListener</code>联，默认
<code>null</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/ImageReader.html#ImageReader-javax.imageio.spi.ImageReaderSpi-">ImageReader</a></span>(<a href="../../javax/imageio/spi/ImageReaderSpi.html" title="class in javax.imageio.spi">ImageReaderSpi</a> originatingProvider)</code>
<div class="block">
构造一个
<code>ImageReader</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="t1"><span><a href="javascript:show(1);">静态方法</a></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/ImageReader.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/ImageReader.html#abortRequested--">abortRequested</a></span>()</code>
<div class="block">
返回
<code>true</code>是否已经做出了中止当前读取操作的请求，因为读者被实例化或
<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/ImageReader.html#addIIOReadProgressListener-javax.imageio.event.IIOReadProgressListener-">addIIOReadProgressListener</a></span>(<a href="../../javax/imageio/event/IIOReadProgressListener.html" title="interface in javax.imageio.event">IIOReadProgressListener</a> listener)</code>
<div class="block">
将
<code>IIOReadProgressListener</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/ImageReader.html#addIIOReadUpdateListener-javax.imageio.event.IIOReadUpdateListener-">addIIOReadUpdateListener</a></span>(<a href="../../javax/imageio/event/IIOReadUpdateListener.html" title="interface in javax.imageio.event">IIOReadUpdateListener</a> listener)</code>
<div class="block">
将
<code>IIOReadUpdateListener</code>添加到已注册的更新监听器列表中。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#addIIOReadWarningListener-javax.imageio.event.IIOReadWarningListener-">addIIOReadWarningListener</a></span>(<a href="../../javax/imageio/event/IIOReadWarningListener.html" title="interface in javax.imageio.event">IIOReadWarningListener</a> listener)</code>
<div class="block">
将
<code>IIOReadWarningListener</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/ImageReader.html#canReadRaster--">canReadRaster</a></span>()</code>
<div class="block">
<span>如果此插件支持只读取<a href="../../java/awt/image/Raster.html" title="java.awt.image中的类"><code>Raster</code></a>像素数据，则返回<code>true</code> 。</span>
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>protected static void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#checkReadParamBandSettings-javax.imageio.ImageReadParam-int-int-">checkReadParamBandSettings</a></span>(<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param, int numSrcBands, int numDstBands)</code>
<div class="block">
读者可以使用一种实用方法来测试ImageReadParam的源和目标频带设置的
<code>ImageReadParam</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#clearAbortRequest--">clearAbortRequest</a></span>()</code>
<div class="block">
清除任何先前的中止请求。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>protected static void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#computeRegions-javax.imageio.ImageReadParam-int-int-java.awt.image.BufferedImage-java.awt.Rectangle-java.awt.Rectangle-">computeRegions</a></span>(<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param, int srcWidth, int srcHeight, <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> image, <a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> srcRegion, <a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> destRegion)</code>
<div class="block">
计算感兴趣的源区域和感兴趣的目的地区域，考虑源图像的宽度和高度，可选的目标图像和可选的
<code>ImageReadParam</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#dispose--">dispose</a></span>()</code>
<div class="block">
允许释放此对象持有的任何资源。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>float</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getAspectRatio-int-">getAspectRatio</a></span>(int imageIndex)</code>
<div class="block">
将给定图像的宽高比（即其宽度除以其高度）返回为
<code>float</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../java/util/Locale.html" title="class in java.util">Locale</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getAvailableLocales--">getAvailableLocales</a></span>()</code>
<div class="block">
返回可用于本地化警告侦听器和压缩设置的
<code>Locale</code> s数组。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code><a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getDefaultReadParam--">getDefaultReadParam</a></span>()</code>
<div class="block">
返回适用于此格式的默认
<code>ImageReadParam</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>protected static <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getDestination-javax.imageio.ImageReadParam-java.util.Iterator-int-int-">getDestination</a></span>(<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param, <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a>&gt; imageTypes, int width, int height)</code>
<div class="block">
返回应写入解码像素数据的
<code>BufferedImage</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getFormatName--">getFormatName</a></span>()</code>
<div class="block">
返回一个
<code>String</code>标识输入源的格式。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>abstract int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getHeight-int-">getHeight</a></span>(int imageIndex)</code>
<div class="block">
返回输入源中给定图像的高度（以像素为单位）。
</div> </td>
</tr>
<tr class="altColor" id="i16">
<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/ImageReader.html#getImageMetadata-int-">getImageMetadata</a></span>(int imageIndex)</code>
<div class="block">
返回一个
<code>IIOMetadata</code>与给定图像，或相关联的对象包含元数据
<code>null</code>如果读取器不支持读取元数据，被设置为忽略元数据，或者，如果没有元数据可用。
</div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code><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/ImageReader.html#getImageMetadata-int-java.lang.String-java.util.Set-">getImageMetadata</a></span>(int imageIndex, <a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName, <a href="../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../java/lang/String.html" title="class in java.lang">String</a>&gt; nodeNames)</code>
<div class="block">
返回一个
<code>IIOMetadata</code>表示与给定图像，或相关联的元数据对象
<code>null</code>如果读取器不支持读取元数据或没有可用的。
</div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code>abstract <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getImageTypes-int-">getImageTypes</a></span>(int imageIndex)</code>
<div class="block">
返回一个
<code>Iterator</code> ，其中包含可以解码给定图像的可能图像类型，格式为
<code>ImageTypeSpecifiers</code> s。
</div> </td>
</tr>
<tr class="rowColor" id="i19">
<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/ImageReader.html#getInput--">getInput</a></span>()</code>
<div class="block">
返回
<code>ImageInputStream</code>或其他
<code>Object</code>以前设置为输入源。
</div> </td>
</tr>
<tr class="altColor" id="i20">
<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/ImageReader.html#getLocale--">getLocale</a></span>()</code>
<div class="block">
如果没有设置，则返回当前设置的
<code>Locale</code>或
<code>null</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getMinIndex--">getMinIndex</a></span>()</code>
<div class="block">
返回读取图像，缩略图或图像元数据的最低有效索引。
</div> </td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code>abstract int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getNumImages-boolean-">getNumImages</a></span>(boolean allowSearch)</code>
<div class="block">
返回当前输入源可用的图像数量，不包括缩略图。
</div> </td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getNumThumbnails-int-">getNumThumbnails</a></span>(int imageIndex)</code>
<div class="block">
返回与给定图像相关联的缩略图预览图像的数量。
</div> </td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code><a href="../../javax/imageio/spi/ImageReaderSpi.html" title="class in javax.imageio.spi">ImageReaderSpi</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getOriginatingProvider--">getOriginatingProvider</a></span>()</code>
<div class="block">
返回
<code>ImageReaderSpi</code>这是通过在构造函数中。
</div> </td>
</tr>
<tr class="rowColor" id="i25">
<td class="colFirst"><code><a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getRawImageType-int-">getRawImageType</a></span>(int imageIndex)</code>
<div class="block">
返回一个
<code>ImageTypeSpecifier</code>表示
<code>SampleModel</code>和
<code>ColorModel</code> ，其最接近地表示图像的“原始”内部格式。
</div> </td>
</tr>
<tr class="altColor" id="i26">
<td class="colFirst"><code>protected static <a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getSourceRegion-javax.imageio.ImageReadParam-int-int-">getSourceRegion</a></span>(<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param, int srcWidth, int srcHeight)</code>
<div class="block">
读者可以使用一种实用方法来计算应该读取的源图像的区域，同时考虑到所提供的
<code>ImageReadParam</code>中的任何源区域和子采样偏移设置。
</div> </td>
</tr>
<tr class="rowColor" id="i27">
<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/ImageReader.html#getStreamMetadata--">getStreamMetadata</a></span>()</code>
<div class="block">
返回一个
<code>IIOMetadata</code>对象，表示与整个输入源相关联的元数据（即，与任何特定图像无关），如果读取器不支持读取元数据，则
<code>null</code> ，被设置为忽略元数据，或者没有元数据可用。
</div> </td>
</tr>
<tr class="altColor" id="i28">
<td class="colFirst"><code><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/ImageReader.html#getStreamMetadata-java.lang.String-java.util.Set-">getStreamMetadata</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName, <a href="../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../java/lang/String.html" title="class in java.lang">String</a>&gt; nodeNames)</code>
<div class="block">
返回一个
<code>IIOMetadata</code>对象，表示与整个输入源相关联的元数据（即，不与任何特定图像相关联）。
</div> </td>
</tr>
<tr class="rowColor" id="i29">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getThumbnailHeight-int-int-">getThumbnailHeight</a></span>(int imageIndex, int thumbnailIndex)</code>
<div class="block">
返回由
<code>thumbnailIndex</code>索引的缩略图预览图像的高度，与由
<code>thumbnailIndex</code>索引的图像相关
<code>ImageIndex</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i30">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getThumbnailWidth-int-int-">getThumbnailWidth</a></span>(int imageIndex, int thumbnailIndex)</code>
<div class="block">
返回由
<code>thumbnailIndex</code>索引的缩略图预览图像的宽度，与ImageIndex索引的图像相关
<code>ImageIndex</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i31">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getTileGridXOffset-int-">getTileGridXOffset</a></span>(int imageIndex)</code>
<div class="block">
返回给定图像中瓦片（0，0）左上角的X坐标。
</div> </td>
</tr>
<tr class="altColor" id="i32">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getTileGridYOffset-int-">getTileGridYOffset</a></span>(int imageIndex)</code>
<div class="block">
返回给定图像中瓦片（0，0）左上角的Y坐标。
</div> </td>
</tr>
<tr class="rowColor" id="i33">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getTileHeight-int-">getTileHeight</a></span>(int imageIndex)</code>
<div class="block">
返回给定图像中图块的高度。
</div> </td>
</tr>
<tr class="altColor" id="i34">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getTileWidth-int-">getTileWidth</a></span>(int imageIndex)</code>
<div class="block">
返回给定图像中图块的宽度。
</div> </td>
</tr>
<tr class="rowColor" id="i35">
<td class="colFirst"><code>abstract int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#getWidth-int-">getWidth</a></span>(int imageIndex)</code>
<div class="block">
返回输入源中给定图像的宽度（以像素为单位）。
</div> </td>
</tr>
<tr class="altColor" id="i36">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#hasThumbnails-int-">hasThumbnails</a></span>(int imageIndex)</code>
<div class="block">
如果给定的图像具有与其相关联的缩略图预览图像，则返回
<code>true</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i37">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#isIgnoringMetadata--">isIgnoringMetadata</a></span>()</code>
<div class="block">
如果当前输入源已被标记为允许通过
<code>true</code>作为
<code>ignoreMetadata</code>参数传递
<code>setInput</code>方法来忽略元数据，则返回
<code>true</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i38">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#isImageTiled-int-">isImageTiled</a></span>(int imageIndex)</code>
<div class="block">
返回
<code>true</code>如果图像被组织成
<i>瓦片</i> ，也就是等大小的非重叠矩形。
</div> </td>
</tr>
<tr class="rowColor" id="i39">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#isRandomAccessEasy-int-">isRandomAccessEasy</a></span>(int imageIndex)</code>
<div class="block">
如果给定图像的存储格式不会对随机访问像素造成固有的障碍，则返回
<code>true</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i40">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#isSeekForwardOnly--">isSeekForwardOnly</a></span>()</code>
<div class="block">
返回
<code>true</code>如果当前的输入源已经被标记为寻找前进，只能通过
<code>true</code>作为
<code>seekForwardOnly</code>参数为
<code>setInput</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/ImageReader.html#processImageComplete--">processImageComplete</a></span>()</code>
<div class="block">
通过调用他们的
<code>imageComplete</code>方法，将所读取的图像的完成
<code>IIOReadProgressListener</code>到所有注册的
<code>IIOReadProgressListener</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/ImageReader.html#processImageProgress-float-">processImageProgress</a></span>(float percentageDone)</code>
<div class="block">
通过调用他们的
<code>imageProgress</code>方法，将目前的图像完成百分比广播到所有注册的
<code>IIOReadProgressListener</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i43">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processImageStarted-int-">processImageStarted</a></span>(int imageIndex)</code>
<div class="block">
通过调用他们的
<code>imageStarted</code>方法，将所读取的图像的开始广播到所有注册的
<code>IIOReadProgressListener</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i44">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processImageUpdate-java.awt.image.BufferedImage-int-int-int-int-int-int-int:A-">processImageUpdate</a></span>(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)</code>
<div class="block">
通过调用他们的
<code>imageUpdate</code>方法，将一组样本的更新广播到所有注册的
<code>IIOReadUpdateListener</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i45">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processPassComplete-java.awt.image.BufferedImage-">processPassComplete</a></span>(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theImage)</code>
<div class="block">
通过调用他们的
<code>passComplete</code>方法，将所有已
<code>IIOReadUpdateListener</code>的IIOReadUpdateListener通过循环传递结束。
</div> </td>
</tr>
<tr class="altColor" id="i46">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processPassStarted-java.awt.image.BufferedImage-int-int-int-int-int-int-int-int:A-">processPassStarted</a></span>(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)</code>
<div class="block">
通过调用他们的
<code>passStarted</code>方法，将所有已注册的
<code>IIOReadUpdateListener</code>的
<code>passStarted</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i47">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processReadAborted--">processReadAborted</a></span>()</code>
<div class="block">
通过调用他们的
<code>readAborted</code>方法来广播已读取已被中止到所有注册的
<code>IIOReadProgressListener</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i48">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processSequenceComplete--">processSequenceComplete</a></span>()</code>
<div class="block">
通过调用他们的
<code>sequenceComplete</code>方法，将所有注册的
<code>IIOReadProgressListener</code>的图像读取顺序的完成
<code>IIOReadProgressListener</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i49">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processSequenceStarted-int-">processSequenceStarted</a></span>(int minIndex)</code>
<div class="block">
通过调用他们的
<code>sequenceStarted</code>方法，将所有注册的
<code>IIOReadProgressListener</code>的图像读取序列的开始
<code>sequenceStarted</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i50">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processThumbnailComplete--">processThumbnailComplete</a></span>()</code>
<div class="block">
通过调用他们的
<code>thumbnailComplete</code>方法，将所有注册的
<code>IIOReadProgressListener</code>的缩略图读取完成。
</div> </td>
</tr>
<tr class="rowColor" id="i51">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processThumbnailPassComplete-java.awt.image.BufferedImage-">processThumbnailPassComplete</a></span>(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theThumbnail)</code>
<div class="block">
通过调用他们的
<code>thumbnailPassComplete</code>方法，将所有注册的
<code>IIOReadUpdateListener</code> s的缩略图遍历传递结束。
</div> </td>
</tr>
<tr class="altColor" id="i52">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processThumbnailPassStarted-java.awt.image.BufferedImage-int-int-int-int-int-int-int-int:A-">processThumbnailPassStarted</a></span>(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)</code>
<div class="block">
通过调用他们的
<code>thumbnailPassStarted</code>方法，将所有注册的
<code>IIOReadUpdateListener</code> s的缩略图遍历通过开始
<code>thumbnailPassStarted</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i53">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processThumbnailProgress-float-">processThumbnailProgress</a></span>(float percentageDone)</code>
<div class="block">
通过调用他们的
<code>thumbnailProgress</code>方法，将所有已
<code>IIOReadProgressListener</code>的IIOReadProgressListener的缩略图完成的当前百分比
<code>thumbnailProgress</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i54">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processThumbnailStarted-int-int-">processThumbnailStarted</a></span>(int imageIndex, int thumbnailIndex)</code>
<div class="block">
通过调用他们的
<code>thumbnailStarted</code>方法，将所有注册的
<code>IIOReadProgressListener</code> s的缩略图读取开始
<code>thumbnailStarted</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i55">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processThumbnailUpdate-java.awt.image.BufferedImage-int-int-int-int-int-int-int:A-">processThumbnailUpdate</a></span>(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)</code>
<div class="block">
通过调用他们的
<code>thumbnailUpdate</code>方法，将缩略图中的一组样本的更新广播到所有注册的
<code>IIOReadUpdateListener</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i56">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processWarningOccurred-java.lang.String-">processWarningOccurred</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> warning)</code>
<div class="block">
通过调用他们的
<code>warningOccurred</code>方法向所有注册的IIOReadWarningListener
<code>IIOReadWarningListener</code>警告消息。
</div> </td>
</tr>
<tr class="rowColor" id="i57">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#processWarningOccurred-java.lang.String-java.lang.String-">processWarningOccurred</a></span>(<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>IIOReadWarningListener</code>广播本地化警告消息。
</div> </td>
</tr>
<tr class="altColor" id="i58">
<td class="colFirst"><code><a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#read-int-">read</a></span>(int imageIndex)</code>
<div class="block">
读取由
<code>imageIndex</code>索引的图像，并将其作为完整的
<code>BufferedImage</code>返回，使用默认值
<code>ImageReadParam</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i59">
<td class="colFirst"><code>abstract <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#read-int-javax.imageio.ImageReadParam-">read</a></span>(int imageIndex, <a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param)</code>
<div class="block">
读取由
<code>imageIndex</code>索引的图像，并将其作为完整的
<code>BufferedImage</code>返回，使用附带的
<code>ImageReadParam</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i60">
<td class="colFirst"><code><a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#readAll-int-javax.imageio.ImageReadParam-">readAll</a></span>(int imageIndex, <a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param)</code>
<div class="block">
读取由索引的图像
<code>imageIndex</code>并返回一个
<code>IIOImage</code>包含图像，缩略图和相关联的图像元数据，使用所提供的
<code>ImageReadParam</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i61">
<td class="colFirst"><code><a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#readAll-java.util.Iterator-">readAll</a></span>(<a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;? extends <a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a>&gt; params)</code>
<div class="block">
返回一个
<code>Iterator</code>所有图像，缩略图和元数据的
<code>getMinIndex</code> ，从
<code>getMinIndex</code>给出的索引开始，从输入源以
<code>IIOImage</code>对象的形式。
</div> </td>
</tr>
<tr class="altColor" id="i62">
<td class="colFirst"><code><a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#readAsRenderedImage-int-javax.imageio.ImageReadParam-">readAsRenderedImage</a></span>(int imageIndex, <a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param)</code>
<div class="block">
返回一个
<code>RenderedImage</code>对象，其中包含由
<code>imageIndex</code>索引的图像的内容。
</div> </td>
</tr>
<tr class="rowColor" id="i63">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#readerSupportsThumbnails--">readerSupportsThumbnails</a></span>()</code>
<div class="block">
如果此阅读器
<code>true</code>的图像格式支持与之相关的缩略图预览图像，则返回
<code>true</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i64">
<td class="colFirst"><code><a href="../../java/awt/image/Raster.html" title="class in java.awt.image">Raster</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#readRaster-int-javax.imageio.ImageReadParam-">readRaster</a></span>(int imageIndex, <a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param)</code>
<div class="block">
返回包含图像流中的原始像素数据的新的
<code>Raster</code>对象，而不应用任何颜色转换。
</div> </td>
</tr>
<tr class="rowColor" id="i65">
<td class="colFirst"><code><a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#readThumbnail-int-int-">readThumbnail</a></span>(int imageIndex, int thumbnailIndex)</code>
<div class="block">
返回索引缩略图预览图像
<code>thumbnailIndex</code> ，通过索引的图像关联
<code>ImageIndex</code>为
<code>BufferedImage</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i66">
<td class="colFirst"><code><a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#readTile-int-int-int-">readTile</a></span>(int imageIndex, int tileX, int tileY)</code>
<div class="block">
读取由
<code>tileX</code>和
<code>tileY</code>参数指示的图块，将其作为
<code>BufferedImage</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i67">
<td class="colFirst"><code><a href="../../java/awt/image/Raster.html" title="class in java.awt.image">Raster</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#readTileRaster-int-int-int-">readTileRaster</a></span>(int imageIndex, int tileX, int tileY)</code>
<div class="block">
返回一个新的
<code>Raster</code>对象，其中包含来自图块的原始像素数据，而不应用任何颜色转换。
</div> </td>
</tr>
<tr class="altColor" id="i68">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#removeAllIIOReadProgressListeners--">removeAllIIOReadProgressListeners</a></span>()</code>
<div class="block">
删除所有当前注册的
<code>IIOReadProgressListener</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i69">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#removeAllIIOReadUpdateListeners--">removeAllIIOReadUpdateListeners</a></span>()</code>
<div class="block">
删除所有当前注册的
<code>IIOReadUpdateListener</code>对象。
</div> </td>
</tr>
<tr class="altColor" id="i70">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#removeAllIIOReadWarningListeners--">removeAllIIOReadWarningListeners</a></span>()</code>
<div class="block">
删除所有当前注册的
<code>IIOReadWarningListener</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i71">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#removeIIOReadProgressListener-javax.imageio.event.IIOReadProgressListener-">removeIIOReadProgressListener</a></span>(<a href="../../javax/imageio/event/IIOReadProgressListener.html" title="interface in javax.imageio.event">IIOReadProgressListener</a> listener)</code>
<div class="block">
删除一个
<code>IIOReadProgressListener</code>从注册的进度侦听器列表中。
</div> </td>
</tr>
<tr class="altColor" id="i72">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#removeIIOReadUpdateListener-javax.imageio.event.IIOReadUpdateListener-">removeIIOReadUpdateListener</a></span>(<a href="../../javax/imageio/event/IIOReadUpdateListener.html" title="interface in javax.imageio.event">IIOReadUpdateListener</a> listener)</code>
<div class="block">
删除一个
<code>IIOReadUpdateListener</code>从已注册的更新侦听器列表中。
</div> </td>
</tr>
<tr class="rowColor" id="i73">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#removeIIOReadWarningListener-javax.imageio.event.IIOReadWarningListener-">removeIIOReadWarningListener</a></span>(<a href="../../javax/imageio/event/IIOReadWarningListener.html" title="interface in javax.imageio.event">IIOReadWarningListener</a> listener)</code>
<div class="block">
删除一个
<code>IIOReadWarningListener</code>从已注册的错误侦听器列表中。
</div> </td>
</tr>
<tr class="altColor" id="i74">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#reset--">reset</a></span>()</code>
<div class="block">
将
<code>ImageReader</code>恢复到初始状态。
</div> </td>
</tr>
<tr class="rowColor" id="i75">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#setInput-java.lang.Object-">setInput</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input)</code>
<div class="block">
设置输入源用于给定的
<code>ImageInputStream</code>或其他
<code>Object</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i76">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#setInput-java.lang.Object-boolean-">setInput</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input, boolean seekForwardOnly)</code>
<div class="block">
将输入源设置为给定的
<code>ImageInputStream</code>或其他
<code>Object</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i77">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.html#setInput-java.lang.Object-boolean-boolean-">setInput</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input, boolean seekForwardOnly, boolean ignoreMetadata)</code>
<div class="block">
设置输入源用于给定的
<code>ImageInputStream</code>或其他
<code>Object</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i78">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageReader.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>ImageReader</code>设置为给定值。
</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/ImageReaderSpi.html" title="class in javax.imageio.spi">ImageReaderSpi</a> originatingProvider</pre>
<div class="block">
<span><code>ImageReaderSpi</code>化该对象的<code>null</code>如果其身份不知道或不存在， <code>null</code> 。</span>
<span>默认情况下，它被初始化为<code>null</code> 。</span>
</div> </li>
</ul> <a name="input">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>input</h4> <pre>protected <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input</pre>
<div class="block">
<span>所述<code>ImageInputStream</code>或其他<code>Object</code>通过<code>setInput</code>和由检索<code>getInput</code> 。</span>
<span>默认情况下，它被初始化为<code>null</code> 。</span>
</div> </li>
</ul> <a name="seekForwardOnly">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>seekForwardOnly</h4> <pre>protected boolean seekForwardOnly</pre>
<div class="block">
<span><code>true</code>如果当前的输入源已被标记为只允许前向寻找<code>setInput</code> 。</span>
<span>默认值为<code>false</code> 。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#minIndex"><code>minIndex</code></a> ，
<a href="../../javax/imageio/ImageReader.html#setInput-java.lang.Object-boolean-boolean-"><code>setInput(java.lang.Object, boolean, boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="ignoreMetadata">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ignoreMetadata</h4> <pre>protected boolean ignoreMetadata</pre>
<div class="block">
<span><code>true</code>如果当前的输入源已被标记为允许元数据被<code>setInput</code>忽略。</span>
<span>默认值为<code>false</code> 。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#setInput-java.lang.Object-boolean-boolean-"><code>setInput(java.lang.Object, boolean, boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="minIndex">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>minIndex</h4> <pre>protected int minIndex</pre>
<div class="block">
用于读取的最小有效索引，最初0。当
<code>seekForwardOnly</code>是
<code>true</code> ，各种方法可引发
<code>IndexOutOfBoundsException</code>上尝试与具有较低索引的图像来访问数据相关联。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#seekForwardOnly"><code>seekForwardOnly</code></a> ，
<a href="../../javax/imageio/ImageReader.html#setInput-java.lang.Object-boolean-boolean-"><code>setInput(java.lang.Object, boolean, boolean)</code></a>
</dd>
</dl> </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">
可用于本地化警告消息的
<code>Locale</code> s阵列，如果不支持本地化，
<code>null</code> null。
</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">
目前
<code>Locale</code>用于定位，或
<code>null</code>如果没有设置。
</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/IIOReadWarningListener.html" title="interface in javax.imageio.event">IIOReadWarningListener</a>&gt; warningListeners</pre>
<div class="block">
A
<code>List</code>当前注册的
<code>IIOReadWarningListener</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>IIOReadWarningListener</code> ，默认情况下初始化为
<code>null</code> ，其与空同义
<code>List</code> 。
</div> </li>
</ul> <a name="progressListeners">
<!-- --> </a>
<ul class="blockList">
<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/IIOReadProgressListener.html" title="interface in javax.imageio.event">IIOReadProgressListener</a>&gt; progressListeners</pre>
<div class="block">
A
<code>List</code>当前注册的
<code>IIOReadProgressListener</code> s，默认
<code>null</code>为
<code>null</code> ，这是一个空的
<code>List</code> 。
</div> </li>
</ul> <a name="updateListeners">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>updateListeners</h4> <pre>protected <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../javax/imageio/event/IIOReadUpdateListener.html" title="interface in javax.imageio.event">IIOReadUpdateListener</a>&gt; updateListeners</pre>
<div class="block">
A
<code>List</code>当前注册的
<code>IIOReadUpdateListener</code> s，默认
<code>null</code>为
<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="ImageReader-javax.imageio.spi.ImageReaderSpi-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>ImageReader</h4> <pre>protected ImageReader(<a href="../../javax/imageio/spi/ImageReaderSpi.html" title="class in javax.imageio.spi">ImageReaderSpi</a> originatingProvider)</pre>
<div class="block">
<span>构造一个<code>ImageReader</code>并将其<code>originatingProvider</code>字段设置为提供的值。</span>
<p> <span>使用扩展的子类应提供一个带有签名<code>(ImageReaderSpi, Object)</code> ，以检索扩展对象。</span> <span>如果扩展对象不合适，则应抛出一个<code>IllegalArgumentException</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>originatingProvider</code> -该
<code>ImageReaderSpi</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="getFormatName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getFormatName</h4> <pre>public <a href="../../java/lang/String.html" title="class in java.lang">String</a> getFormatName()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个<code>String</code>标识输入源的格式。</span>
<p> <span>默认实现返回<code>originatingProvider.getFormatNames()[0]</code> 。</span> <span>可能没有源服务提供商的实现，或者希望使用不同命名策略的实现应该覆盖此方法。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
格式名称，作为一个
<code>String</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果从输入源读取信息发生错误。
</dd>
</dl> </li>
</ul> <a name="getOriginatingProvider--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getOriginatingProvider</h4> <pre>public <a href="../../javax/imageio/spi/ImageReaderSpi.html" title="class in javax.imageio.spi">ImageReaderSpi</a> getOriginatingProvider()</pre>
<div class="block">
<span>返回<code>ImageReaderSpi</code>这是通过在构造函数中。</span>
<span>请注意，此值可能为<code>null</code> 。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ImageReaderSpi</code>或
<code>null</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/spi/ImageReaderSpi.html" title="javax.imageio.spi中的类"><code>ImageReaderSpi</code></a></span>
</dd>
</dl> </li>
</ul> <a name="setInput-java.lang.Object-boolean-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setInput</h4> <pre>public void setInput(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input,
boolean seekForwardOnly,
boolean ignoreMetadata)</pre>
<div class="block">
<span>将输入源设置为给定的<code>ImageInputStream</code>或其他<code>Object</code> 。</span>
<span>必须在使用任何查询或读取方法之前设置输入源。</span>
<span>如果<code>input</code>是<code>null</code> ，任何当前设置的输入源将被删除。</span>
<span>无论如何， <code>minIndex</code>的值将被初始化为0。</span>
<p> <span><code>seekForwardOnly</code>参数控制是否读取每个图像（或缩略图或图像元数据）时由<code>getMinIndex</code>返回的值是否增加。</span> <span>如果<code>seekForwardOnly</code>是真的，那么调用<code>read(index)</code>会抛出一个<code>IndexOutOfBoundsException</code>如果<code>index &lt; this.minIndex</code> ;</span> <span>否则，值<code>minIndex</code>将被设置为<code>index</code> 。</span> <span>如果<code>seekForwardOnly</code>是<code>false</code> ，价值<code>minIndex</code>将保持0无论任何读操作。</span> </p>
<p> <span><code>ignoreMetadata</code>参数，如果设置为<code>true</code> ，则允许读者忽略读取期间遇到的任何元数据。</span> <span>在后续调用<code>getStreamMetadata</code>种<code>getImageMetadata</code>方法可能会返回<code>null</code>和<code>IIOImage</code>从返回<code>readAll</code>可能返回<code>null</code>从他们<code>getMetadata</code>方法。</span> <span>设置此参数可能会使读者更有效地工作。</span> <span>读者可以选择忽略此设置并正常返回元数据。</span> </p>
<p> <span>子类应该注意根据前一个流来删除任何缓存的信息，例如标题信息或部分解码的图像数据。</span> </p>
<p> <span>的一般使用<code>Object</code>比其他<code>ImageInputStream</code>旨在用于直接与捕获设备或图像协议交互的读取器。</span> <span>这套法律课由读者服务提供者的<code>getInputTypes</code>方法发布;</span> <span>大多数读者将返回一个仅<code>ImageInputStream.class</code>的单元素数组，表示它们只接受<code>ImageInputStream</code> 。</span> </p>
<p> <span>默认实现检查<code>input</code>对返回的list参数<code>originatingProvider.getInputTypes()</code> ，如果说法是不在列表中的一个类的实例失败。</span> <span>如果始发提供商设置为<code>null</code> ，则只有在<code>ImageInputStream</code>接受输入。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>input</code> -
<code>ImageInputStream</code>或其他
<code>Object</code>用于将来的解码。
</dd>
<dd>
<code>seekForwardOnly</code> - 如果
<code>true</code> ，图像和元数据只能从此输入源的升序读取。
</dd>
<dd>
<code>ignoreMetadata</code> - 如果
<code>true</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>input</code>不是始发服务提供商的
<code>getInputTypes</code>方法返回的一个类的实例，或者不是
<code>ImageInputStream</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/stream/ImageInputStream.html" title="javax.imageio.stream中的接口"><code>ImageInputStream</code></a> ， <a href="../../javax/imageio/ImageReader.html#getInput--"><code>getInput()</code></a> ， <a href="../../javax/imageio/spi/ImageReaderSpi.html#getInputTypes--"><code>ImageReaderSpi.getInputTypes()</code></a></span>
</dd>
</dl> </li>
</ul> <a name="setInput-java.lang.Object-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setInput</h4> <pre>public void setInput(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input,
boolean seekForwardOnly)</pre>
<div class="block">
<span>将输入源设置为给定的<code>ImageInputStream</code>或其他<code>Object</code> 。</span>
<span>必须在使用任何查询或读取方法之前设置输入源。</span>
<span>如果<code>input</code>是<code>null</code> ，任何当前设置的输入源将被删除。</span>
<span>在任何情况下， <code>minIndex</code>的值将被初始化为0。</span>
<p> <span><code>seekForwardOnly</code>参数控制是否读取每个图像（或缩略图或图像元数据）时由<code>getMinIndex</code>返回的值是否增加。</span> <span>如果<code>seekForwardOnly</code>是真的，那么调用<code>read(index)</code>会抛出一个<code>IndexOutOfBoundsException</code>如果<code>index &lt; this.minIndex</code> ;</span> <span>否则，值<code>minIndex</code>将被设置为<code>index</code> 。</span> <span>如果<code>seekForwardOnly</code>是<code>false</code> ，价值<code>minIndex</code>将保持0无论任何读操作。</span> </p>
<p> <span>此方法相当于<code>setInput(input, seekForwardOnly, false)</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>input</code> -
<code>ImageInputStream</code>或其他
<code>Object</code>用于将来的解码。
</dd>
<dd>
<code>seekForwardOnly</code> - 如果
<code>true</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>input</code>不是由始发服务提供商的
<code>getInputTypes</code>方法返回的一个类的实例，或者不是
<code>ImageInputStream</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#getInput--"><code>getInput()</code></a>
</dd>
</dl> </li>
</ul> <a name="setInput-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setInput</h4> <pre>public void setInput(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input)</pre>
<div class="block">
<span>设置用于给定的<code>ImageInputStream</code>或其他<code>Object</code>的输入源。</span>
<span>必须在使用任何查询或读取方法之前设置输入源。</span>
<span>如果<code>input</code>是<code>null</code> ，任何当前设置的输入源将被删除。</span>
<span>在任何情况下， <code>minIndex</code>的值将被初始化为0。</span>
<p> <span>此方法相当于<code>setInput(input, false, false)</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>input</code> -
<code>ImageInputStream</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>input</code>不是始发服务提供商的
<code>getInputTypes</code>方法返回的一个类的实例，或者不是
<code>ImageInputStream</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#getInput--"><code>getInput()</code></a>
</dd>
</dl> </li>
</ul> <a name="getInput--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getInput</h4> <pre>public <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getInput()</pre>
<div class="block">
<span>返回之前设置为输入源的<code>ImageInputStream</code>或其他<code>Object</code> 。</span>
<span>如果输入源尚未设置，则返回<code>null</code> 。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该
<code>Object</code>将被用于未来解码，或
<code>null</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/stream/ImageInputStream.html" title="javax.imageio.stream中的接口"><code>ImageInputStream</code></a> ， <a href="../../javax/imageio/ImageReader.html#setInput-java.lang.Object-boolean-boolean-"><code>setInput(java.lang.Object, boolean, boolean)</code></a></span>
</dd>
</dl> </li>
</ul> <a name="isSeekForwardOnly--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isSeekForwardOnly</h4> <pre>public boolean isSeekForwardOnly()</pre>
<div class="block">
返回
<code>true</code>如果当前的输入源已经被标记为寻找向前，只能通过
<code>true</code>作为
<code>seekForwardOnly</code>参数到
<code>setInput</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/ImageReader.html#setInput-java.lang.Object-boolean-boolean-"><code>setInput(java.lang.Object, boolean, boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="isIgnoringMetadata--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isIgnoringMetadata</h4> <pre>public boolean isIgnoringMetadata()</pre>
<div class="block">
如果当前输入源已被标记为允许通过将
<code>true</code>作为
<code>ignoreMetadata</code>参数传递给
<code>setInput</code>方法来忽略元数据，则返回
<code>true</code> 。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果元数据可能被忽略。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#setInput-java.lang.Object-boolean-boolean-"><code>setInput(java.lang.Object, boolean, boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="getMinIndex--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMinIndex</h4> <pre>public int getMinIndex()</pre>
<div class="block">
<span>返回读取图像，缩略图或图像元数据的最低有效索引。</span>
<span>如果<code>seekForwardOnly()</code>是<code>false</code> ，则该值通常将保持为0，表示随机访问是可能的。</span>
<span>否则，它将包含最近访问的索引的值，并以单调方式增加。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
阅读的最低法定指数。
</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>ImageReader</code>设置为给定值。</span>
<span>值<code>null</code>删除任何以前的设置，并指示阅读器应将其视为合适的本地化。</span>
</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/ImageReader.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">
如果没有设置，则返回当前设置的
<code>Locale</code>或
<code>null</code> 。
</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/ImageReader.html#setLocale-java.util.Locale-"><code>setLocale(java.util.Locale)</code></a>
</dd>
</dl> </li>
</ul> <a name="getNumImages-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNumImages</h4> <pre>public abstract int getNumImages(boolean allowSearch)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回当前输入源可用的图像数量，不包括缩略图。</span>
<p> <span>请注意，某些图像格式（如动画GIF）不会指定流中存在多少图像。</span> <span>因此，确定图像的数量将需要扫描整个流，并且可能需要用于缓冲的存储器。</span> <span>如果要按顺序处理图像，则可以通过增加索引直接致电<code>read</code>更有效，直到抛出<code>IndexOutOfBoundsException</code>以指示不再有图像可用。</span> <span><code>allowSearch</code>参数可以设置为<code>false</code>以表示不需要详尽的搜索;</span> <span>返回值将为<code>-1</code> ，表示需要进行搜索。</span> <span>如果输入已与指定<code>seekForwardOnly</code>设置为<code>true</code> ，此方法将引发<code>IllegalStateException</code>如果<code>allowSearch</code>被设置为<code>true</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>allowSearch</code> - 如果<code>true</code> ，即使需要搜索，也会返回真实的图像数量。</span>
<span>如果<code>false</code> ，读者可以返回<code>-1</code>而不执行搜索。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>int</code>或
<code>-1</code>如果
<code>allowSearch</code>是
<code>false</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>seekForwardOnly</code>设置为
<code>true</code> 。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果从输入源读取信息发生错误。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#setInput-java.lang.Object-boolean-boolean-"><code>setInput(java.lang.Object, boolean, boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="getWidth-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getWidth</h4> <pre>public abstract int getWidth(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回输入源中给定图像的宽度（以像素为单位）。</span>
<p> <span>如果图像可以呈现为用户指定的大小，则此方法返回默认宽度。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要查询的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
图像的宽度，作为
<code>int</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果从输入源读取宽度信息发生错误。
</dd>
</dl> </li>
</ul> <a name="getHeight-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getHeight</h4> <pre>public abstract int getHeight(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回输入源中给定图像的高度（以像素为单位）。</span>
<p> <span>如果图像可以呈现为用户指定的大小，则此方法返回默认高度。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要查询的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
图像的高度，如
<code>int</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果从输入源读取高度信息发生错误。
</dd>
</dl> </li>
</ul> <a name="isRandomAccessEasy-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isRandomAccessEasy</h4> <pre>public boolean isRandomAccessEasy(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>对于大多数压缩格式（如JPEG），此方法应该返回<code>false</code> ，除了感兴趣的区域之外，图像的大部分可能需要被解码。</span>
<p> <span>这只是一个希望有效的计划的提示;</span> <span>如在指定的所有读者必须能够读取任意区域<code>ImageReadParam</code> 。</span> </p>
<p> <span>请注意，从该方法返回<code>false</code>格式可能允许平铺（ <i>例如</i> ，JPEG中的重新启动标记），并且随机访问在瓦片上可能会相当有效。</span> <span>见<a href="../../javax/imageio/ImageReader.html#isImageTiled-int-"><code>isImageTiled</code></a> 。</span> </p>
<p> <span>针对所有图像都保证支持容易随机存取，或保证不支持容易随机存取的读取器，可以返回<code>true</code>或<code>false</code>分别而不访问任何图像数据。</span> <span>在这种情况下，即使没有设置输入源或图像索引超出范围，也不必抛出异常。</span> </p>
<p> <span>默认实现返回<code>false</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> - 如果必须访问图像以确定返回值，但提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读数时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="getAspectRatio-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAspectRatio</h4> <pre>public float getAspectRatio(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>将给定图像的宽高比（即其宽度除以其高度）返回为<code>float</code> 。</span>
<span>对于固有可调整尺寸的图像，该方法提供了一种确定给定期望高度的适当宽度的方法，反之亦然。</span>
<span>对于不可调整大小的图像，使用真实的宽度和高度。</span>
<p> <span>默认实现只返回<code>(float)getWidth(imageIndex)/getHeight(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>float</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="getRawImageType-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRawImageType</h4> <pre>public <a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> getRawImageType(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个<code>ImageTypeSpecifier</code>表示<code>SampleModel</code>和<code>ColorModel</code> ，最贴切地表示图像的“原始”内部格式。</span>
<span>例如，对于JPEG图像，原始类型可能具有YCbCr颜色空间，即使图像通常在显示之前被转换为RGB颜色空间。</span>
<span>返回的值也应包含在由<code>getImageTypes</code>返回的值列表中。</span>
<p> <span>默认实现只是返回由<code>getImageType</code>提供的列表中的第一个条目。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要查询的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ImageTypeSpecifier</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果从输入源读取格式信息发生错误。
</dd>
</dl> </li>
</ul> <a name="getImageTypes-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageTypes</h4> <pre>public abstract <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a>&gt; getImageTypes(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个<code>Iterator</code> ，其中包含可以解码给定图像的可能的图像类型，格式为<code>ImageTypeSpecifiers</code> s。</span>
<span>将返回至少一个合法的图像类型。</span>
<p> <span>迭代器的第一个元素应该是用于以尽可能少的损失解码图像的最“自然”类型。</span> <span>例如，对于JPEG图像，第一个条目应该是RGB图像，即使图像数据内部存储在YCbCr颜色空间中。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 图像的索引为
<code>retrieved</code> 。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>Iterator</code>含有至少一个
<code>ImageTypeSpecifier</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果从输入源读取格式信息发生错误。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReadParam.html#setDestination-java.awt.image.BufferedImage-"><code>ImageReadParam.setDestination(BufferedImage)</code></a> ，
<a href="../../javax/imageio/ImageReadParam.html#setDestinationType-javax.imageio.ImageTypeSpecifier-"><code>ImageReadParam.setDestinationType(ImageTypeSpecifier)</code></a>
</dd>
</dl> </li>
</ul> <a name="getDefaultReadParam--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDefaultReadParam</h4> <pre>public <a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> getDefaultReadParam()</pre>
<div class="block">
<span>返回适合此格式的默认<code>ImageReadParam</code>对象。</span>
<span>所有子类应为所有参数定义一组默认值，并使用此调用返回它们。</span>
<span>可以在设置输入源之前调用此方法。</span>
<p> <span>默认实现构造并返回不允许源缩放的新的<code>ImageReadParam</code>对象（ <i>即</i> ，它返回<code>new ImageReadParam()</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ImageReadParam</code>对象，可用于使用一组默认设置来控制解码过程。
</dd>
</dl> </li>
</ul> <a name="getStreamMetadata--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getStreamMetadata</h4> <pre>public abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> getStreamMetadata()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
返回一个
<code>IIOMetadata</code>表示与输入源作为一个整体（即，不与任何特定图像相关联）相关联的元数据对象，或
<code>null</code>如果读取器不支持读取元数据，被设置为忽略元数据，或者，如果没有元数据可用。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>IIOMetadata</code>对象，或
<code>null</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="getStreamMetadata-java.lang.String-java.util.Set-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getStreamMetadata</h4> <pre>public <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> getStreamMetadata(<a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName,
<a href="../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../java/lang/String.html" title="class in java.lang">String</a>&gt; nodeNames)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个<code>IIOMetadata</code>表示与输入源作为一个整体（即，不与任何特定图像相关联）相关联的元数据对象。</span>
<span>如果没有这样的数据，返回<code>null</code> 。</span>
<p> <span>所生成的元数据对象仅负责以formatName命名的格式<code>formatName</code> 。</span> <span>在返回的任何文档中，只需要返回名称为<code>nodeNames</code>节点。</span> <span>以这种方式，基于什么信息实际需要，读取器完成的元数据处理的量可以保持最小。</span> </p>
<p> <span>如果<code>formatName</code>不是支持的元数据格式的名称，则返回<code>null</code> 。</span> </p>
<p> <span>在所有情况下，返回一个比严格必要的更有能力的元数据对象是合法的。</span> <span>格式名称和节点名称仅仅是可用于减少读者工作量的提示。</span> </p>
<p> <span>在检查格式名称是否支持后，默认实现只是返回调用<code>getStreamMetadata()</code>的结果。</span> <span>如果不是，则返回<code>null</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>formatName</code> - 可用于从返回的
<code>IIOMetadata</code>对象中检索文档的元数据格式名称。
</dd>
<dd>
<code>nodeNames</code> - 一个
<code>Set</code>可能包含在检索文档中的节点名称的Set。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>IIOMetadata</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>formatName</code>是
<code>null</code> 。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>nodeNames</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="getImageMetadata-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageMetadata</h4> <pre>public abstract <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> getImageMetadata(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
返回一个
<code>IIOMetadata</code>与给定图像，或相关联的对象包含元数据
<code>null</code>如果读取器不支持读取元数据，被设置为忽略元数据，或者，如果没有元数据可用。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索其元数据的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<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/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="getImageMetadata-int-java.lang.String-java.util.Set-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageMetadata</h4> <pre>public <a href="../../javax/imageio/metadata/IIOMetadata.html" title="class in javax.imageio.metadata">IIOMetadata</a> getImageMetadata(int imageIndex,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName,
<a href="../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../java/lang/String.html" title="class in java.lang">String</a>&gt; nodeNames)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个<code>IIOMetadata</code>表示与给定图像，或相关联的元数据对象<code>null</code>如果读取器不支持读取元数据或没有可用的。</span>
<p> <span>所生成的元数据对象仅负责以formatName命名的格式<code>formatName</code> 。</span> <span>在返回的任何文档中，只需要返回名称为<code>nodeNames</code>节点。</span> <span>以这种方式，基于什么信息实际需要，读取器完成的元数据处理的量可以保持最小。</span> </p>
<p> <span>如果<code>formatName</code>不是受支持的元数据格式的名称， <code>null</code>可能会返回<code>null</code> 。</span> </p>
<p> <span>在所有情况下，返回一个比严格必要的更有能力的元数据对象是合法的。</span> <span>格式名称和节点名称仅仅是可用于减少读者工作量的提示。</span> </p>
<p> <span>在检查格式名称被支持后，默认实现方法只返回调用<code>getImageMetadata(imageIndex)</code>的结果。</span> <span>如果不是，则返回<code>null</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索其元数据的图像的索引。
</dd>
<dd>
<code>formatName</code> - 可用于从返回的
<code>IIOMetadata</code>对象检索文档的元数据格式名称。
</dd>
<dd>
<code>nodeNames</code> -一个
<code>Set</code>包含可以被包含在检索到的文档中的节点的名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<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/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>formatName</code>是
<code>null</code> 。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>nodeNames</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="read-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>read</h4> <pre>public <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> read(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>读取由<code>imageIndex</code>索引的图像，并将其作为完整的<code>BufferedImage</code>返回，使用默认值<code>ImageReadParam</code> 。</span>
<span>这是一个方便的方法，调用<code>read(imageIndex, null)</code> 。</span>
<p> <span>返回的图像将根据从<code>getImageTypes</code>返回的第一个<code>ImageTypeSpecifier</code>进行<code>getImageTypes</code> 。</span> </p>
<p> <span>任何已注册的<code>IIOReadProgressListener</code>对象将通过调用他们的<code>imageStarted</code>方法通知，随后随着读取进程调用他们的<code>imageProgress</code>方法。</span> <span>最后他们会调用<code>imageComplete</code>方法。</span> <span><code>IIOReadUpdateListener</code>对象可以在其他时间读出期间像素被解码被更新。</span> <span>最后， <code>IIOReadWarningListener</code>对象将收到在解码期间发生的任何非致命警告的通知。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
图像的所需部分为
<code>BufferedImage</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="read-int-javax.imageio.ImageReadParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>read</h4> <pre>public abstract <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> read(int imageIndex,
<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>读取由<code>imageIndex</code>索引的图像，并将其作为完整的<code>BufferedImage</code>返回，使用附带的<code>ImageReadParam</code> 。</span>
<p> <span>将使用<code>getDestination</code>方法定义的<code>getDestination</code>选择实际的<code>BufferedImage</code> 。</span> </p>
<p> <span>任何已注册的<code>IIOReadProgressListener</code>对象将通过调用他们的<code>imageStarted</code>方法通知，随后随着读取进程调用他们的<code>imageProgress</code>方法。</span> <span>最后他们会调用<code>imageComplete</code>方法。</span> <span><code>IIOReadUpdateListener</code>对象可以在其他时间读出期间像素被解码被更新。</span> <span>最后， <code>IIOReadWarningListener</code>对象将收到在解码期间发生的任何非致命警告的通知。</span> </p>
<p> <span>要读取的源频带组和要写入的目标频带由所提供的<code>ImageReadParam</code>上的<code>getSourceBands</code>和<code>getDestinationBands</code> <code>ImageReadParam</code> 。</span> <span>如果由这些方法返回的数组的长度不同，则源频带集包含一个较大的索引，即最大可用源索引，或者目标频段集合包含大于最大合法目标索引的索引，抛出<code>IllegalArgumentException</code> 。</span> </p>
<p> <span>如果提供的<code>ImageReadParam</code>包含此读卡器不支持的可选设置值（ <i>例如</i>源渲染大小或任何特定于格式的设置），它们将被忽略。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索的图像的索引。
</dd>
<dd>
<code>param</code> -一个
<code>ImageReadParam</code>用来控制读取过程中，或
<code>null</code> 。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
图像的所需部分为
<code>BufferedImage</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果由
<code>param.getSourceBands</code>和
<code>param.getDestinationBands</code>指定的源和目标频带组长
<code>param.getDestinationBands</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> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="readAll-int-javax.imageio.ImageReadParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>readAll</h4> <pre>public <a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a> readAll(int imageIndex,
<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>读取由索引的图像<code>imageIndex</code>并返回一个<code>IIOImage</code>包含图像，缩略图和相关联的图像元数据，使用所提供的<code>ImageReadParam</code> 。</span>
<p> <span>将使用<code>getDestination</code>方法定义的<code>getDestination</code>选择返回的<code>IIOImage</code>的实际<code>BufferedImage</code> 。</span> </p>
<p> <span>任何已注册的<code>IIOReadProgressListener</code>对象将通过调用其<code>imageStarted</code>方法通知，随后在读取进程时调用其<code>imageProgress</code>方法。</span> <span>最后他们会调用他们的<code>imageComplete</code>方法。</span> <span><code>IIOReadUpdateListener</code>对象可以在其他时间读出期间像素被解码被更新。</span> <span>最后， <code>IIOReadWarningListener</code>对象将收到在解码期间发生的任何非致命警告的通知。</span> </p>
<p> <span>要读取的源频带组和要写入的目的地频段通过调用<code>getDestinationBands</code>上的<code>getSourceBands</code>和<code>getDestinationBands</code>来<code>ImageReadParam</code> 。</span> <span>如果由这些方法返回的数组的长度不同，则源频带集包含一个较大的索引，即最大的可用源索引或目标频带集合包含大于最大合法目的地索引的索引，抛出一个<code>IllegalArgumentException</code> 。</span> </p>
<p> <span>无论区域设置如何，缩略图将全部返回。</span> </p>
<p> <span>如果提供的<code>ImageReadParam</code>包含此读卡器不支持的可选设置值（ <i>例如</i>源渲染大小或任何特定于格式的设置），则这些值将被忽略。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索的图像的索引。
</dd>
<dd>
<code>param</code> -一个
<code>ImageReadParam</code>用来控制读取过程中，或
<code>null</code> 。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
包含
<code>IIOImage</code>的期望部分，一组缩略图和相关联的图像元数据的IIOImage。
</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果由
<code>param.getSourceBands</code>和
<code>param.getDestinationBands</code>指定的源和目标频带组长
<code>param.getDestinationBands</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> - 如果在阅读期间发生错误。
</dd>
</dl> </li>
</ul> <a name="readAll-java.util.Iterator-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>readAll</h4> <pre>public <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/IIOImage.html" title="class in javax.imageio">IIOImage</a>&gt; readAll(<a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;? extends <a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a>&gt; params)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个<code>Iterator</code>包含所有图像，缩略图和元数据，从<code>getMinIndex</code>给出的索引开始，从输入源以<code>IIOImage</code>对象的形式。</span>
<span>提供一个<code>Iterator</code> ImageReadParam <code>ImageReadParam</code>对象的<code>Iterator</code> ;</span>
<span>从输入源读取的每个图像消耗一个元素，直到没有更多的图像可用。</span>
<span>如果读取参数<code>Iterator</code>用尽了元素，但是仍然有更多的图像可以从输入源，默认读参数用于剩余的图像。</span>
<p> <span>如果<code>params</code>是<code>null</code> ，则所有图像将使用默认读取参数。</span> </p>
<p> <span>将使用<code>getDestination</code>方法定义的<code>getDestination</code>选择返回的<code>IIOImage</code>的实际<code>BufferedImage</code> 。</span> </p>
<p> <span>任何已注册的<code>IIOReadProgressListener</code>对象将通过调用他们的<code>sequenceStarted</code>方法一次通知。</span> <span>然后，对于每个图像解码，将有一个<code>imageStarted</code>的调用，随后调用<code>imageProgress</code>作为读取进度，最后到<code>imageComplete</code> 。</span> <span><code>sequenceComplete</code>方法将在最后一个图像解码后被调用。</span> <span><code>IIOReadUpdateListener</code>对象可以在其他时间读出期间像素被解码被更新。</span> <span>最后， <code>IIOReadWarningListener</code>对象将收到解码过程中发生的任何非致命警告的通知。</span> </p>
<p> <span>要读取的源频带组和要写入的目标频段由所提供的<code>ImageReadParam</code>上的<code>getSourceBands</code>和<code>getDestinationBands</code> <code>ImageReadParam</code> 。</span> <span>如果由这些方法返回的数组的长度不同，则源频带集包含较大的索引，即最大可用源索引或目标频带集包含大于最大合法目标索引的索引，抛出<code>IllegalArgumentException</code> 。</span> </p>
<p> <span>无论区域设置如何，缩略图将全部返回。</span> </p>
<p> <span>如果提供的任何<code>ImageReadParam</code>包含此读卡器不支持的可选设置值（ <i>例如</i>源渲染大小或任何特定于格式的设置），它们将被忽略。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>params</code> - 一个
<code>Iterator</code> ImageReadParam
<code>ImageReadParam</code>对象的
<code>ImageReadParam</code> 。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>Iterator</code>表示输入源的内容为
<code>IIOImage</code> s。
</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>null</code>的元件
<code>params</code>不是
<code>ImageReadParam</code> 。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果由
<code>param.getSourceBands</code>和
<code>param.getDestinationBands</code>指定的源和目标频带组长
<code>param.getDestinationBands</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> - 读数时是否发生错误。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/ImageReadParam.html" title="javax.imageio中的类"><code>ImageReadParam</code></a> ， <a href="../../javax/imageio/IIOImage.html" title="javax.imageio中的类"><code>IIOImage</code></a></span>
</dd>
</dl> </li>
</ul> <a name="canReadRaster--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canReadRaster</h4> <pre>public boolean canReadRaster()</pre>
<div class="block">
<span>如果此插件支持只读取<a href="../../java/awt/image/Raster.html" title="java.awt.image中的类"><code>Raster</code></a>像素数据，则返回<code>true</code> 。</span>
<span>如果这个方法返回<code>false</code> ，调用<a href="../../javax/imageio/ImageReader.html#readRaster-int-javax.imageio.ImageReadParam-"><code>readRaster</code></a>或<a href="../../javax/imageio/ImageReader.html#readTileRaster-int-int-int-"><code>readTileRaster</code></a>将会抛出一个<code>UnsupportedOperationException</code> 。</span>
<p> <span>默认实现返回<code>false</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果这个插件支持阅读原始
<code>Raster</code> s。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#readRaster-int-javax.imageio.ImageReadParam-"><code>readRaster(int, javax.imageio.ImageReadParam)</code></a> ，
<a href="../../javax/imageio/ImageReader.html#readTileRaster-int-int-int-"><code>readTileRaster(int, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="readRaster-int-javax.imageio.ImageReadParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>readRaster</h4> <pre>public <a href="../../java/awt/image/Raster.html" title="class in java.awt.image">Raster</a> readRaster(int imageIndex,
<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</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>
<span>所提供的<code>ImageReadParam</code>对象中的任何目的地或图像类型的参数都将被忽略，但所有其他参数都与<a href="../../javax/imageio/ImageReader.html#read-int-"><code>read</code></a>方法完全相同，不同之处在于使用任何目标偏移量作为逻辑而不是物理偏移量。</span>
<span>返回的<code>Raster</code>的大小将始终是剪辑到实际图像的源区域的大小。</span>
<span>流中的逻辑偏移本身将被忽略。</span>
<p> <span>该方法允许通常应用颜色转换的格式（例如JPEG）和通常不具有相关联的颜色空间的格式（例如遥感或医学成像数据）来提供对原始像素数据的访问。</span> </p>
<p> <span>任何已注册的<code>readUpdateListener</code>都被忽略，因为没有<code>BufferedImage</code> ，但所有其他监听器被完全称为<a href="../../javax/imageio/ImageReader.html#read-int-"><code>read</code></a>方法。</span> </p>
<p> <span>如果<a href="../../javax/imageio/ImageReader.html#canReadRaster--"><code>canReadRaster()</code></a>返回<code>false</code> ，这个方法会抛出一个<code>UnsupportedOperationException</code> 。</span> </p>
<p> <span>如果提供的<code>ImageReadParam</code>包含此读卡器不支持的可选设置值（ <i>例如</i>源渲染大小或任何特定于格式的设置），它们将被忽略。</span> </p>
<p> <span>默认实现会抛出一个<code>UnsupportedOperationException</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要读取的图像的索引。
</dd>
<dd>
<code>param</code> -一个
<code>ImageReadParam</code>用来控制读取过程中，或
<code>null</code> 。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
图像的所需部分为
<code>Raster</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果这个插件不支持读取原始的
<code>Raster</code> s。
</dd>
<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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果在阅读期间发生错误。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/ImageReader.html#canReadRaster--"><code>canReadRaster()</code></a> ， <a href="../../javax/imageio/ImageReader.html#read-int-"><code>read(int)</code></a> ， <a href="../../java/awt/image/Raster.html" title="java.awt.image中的类"><code>Raster</code></a></span>
</dd>
</dl> </li>
</ul> <a name="isImageTiled-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isImageTiled</h4> <pre>public boolean isImageTiled(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回<code>true</code>如果图像被组织成<i>瓦片</i> ，也就是等大小的非重叠矩形。</span>
<p> <span>阅读器插件可以选择是否在存储图像时公开存在的平铺。</span> <span>甚至可以选择在没有明确存在的情况下发布平铺。</span> <span>一般来说，如果存在访问各个瓦片的某些优势（速度或空间），则仅应该对平铺进行通告。</span> <span>无论读取器是否通告平铺，它必须能够读取在所指定的任意矩形区域<code>ImageReadParam</code> 。</span> </p>
<p> <span>针对所有图像都保证读者平铺，或保证不被平铺，可以返回<code>true</code>或<code>false</code>分别而不访问任何图像数据。</span> <span>在这种情况下，即使没有设置输入源或图像索引超出范围，也不必抛出异常。</span> </p>
<p> <span>默认实现只返回<code>false</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> - 如果必须访问映像以确定返回值，但提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="getTileWidth-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTileWidth</h4> <pre>public int getTileWidth(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>getWidth(imageIndex)</code> ，这对于非平铺图像是正确的。</span> <span>支持平铺的读者应该覆盖此方法。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要查询的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
瓷砖的宽度。
</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="getTileHeight-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTileHeight</h4> <pre>public int getTileHeight(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>getHeight(imageIndex)</code> ，这对于非平铺图像是正确的。</span> <span>支持平铺的读者应该覆盖此方法。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要查询的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
瓷砖的高度。
</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> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="getTileGridXOffset-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTileGridXOffset</h4> <pre>public int getTileGridXOffset(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回给定图像中瓦片（0，0）左上角的X坐标。</span>
<p> <span>瓦片网格X偏移总是具有相同值（通常为0）的读取器可以返回该值而不访问任何图像数据。</span> <span>在这种情况下，即使没有设置输入源或图像索引超出范围，也不必抛出异常。</span> </p>
<p> <span>默认实现只返回0，这对于大多数格式的非平铺图像和平铺图像是正确的。</span> <span>支持平铺（0，0）偏移量的读者应该覆盖此方法。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要查询的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
瓦片网格的X偏移量。
</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> - 如果必须访问映像以确定返回值，但提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果在读取期间发生错误。
</dd>
</dl> </li>
</ul> <a name="getTileGridYOffset-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTileGridYOffset</h4> <pre>public int getTileGridYOffset(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回给定图像中瓦片（0，0）左上角的Y坐标。</span>
<p> <span>瓦片网格Y偏移总是具有相同值（通常为0）的读取器可以返回该值而不访问任何图像数据。</span> <span>在这种情况下，即使没有设置输入源或图像索引超出范围，也不必抛出异常。</span> </p>
<p> <span>默认实现只返回0，这对于大多数格式的非平铺图像和平铺图像是正确的。</span> <span>支持平铺（0，0）偏移量的读者应该覆盖此方法。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要查询的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
瓦片网格的Y偏移量。
</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> - 如果必须访问映像以确定返回值，但提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="readTile-int-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>readTile</h4> <pre>public <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> readTile(int imageIndex,
int tileX,
int tileY)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>读取由<code>tileX</code>和<code>tileY</code>参数指示的磁贴，将其作为<code>BufferedImage</code> 。</span>
<span>如果参数超出范围，则抛出<code>IllegalArgumentException</code> 。</span>
<span>如果图像不平铺，值0,0将返回整个图像;</span>
<span>任何其他值将导致抛出<code>IllegalArgumentException</code> 。</span>
<p> <span>此方法仅仅是一个方便相当于调用<code>read(int, ImageReadParam)</code>用read参数指定具有偏移量的源极区域<code>tileX*getTileWidth(imageIndex)</code> ， <code>tileY*getTileHeight(imageIndex)</code>和宽度和高度<code>getTileWidth(imageIndex)</code> ， <code>getTileHeight(imageIndex)</code> ;</span> <span>并且子采样因子为1，偏移量为0.要对图块进行子采样，请使用指定此区域的读取参数调用<code>read</code>和不同的子采样参数。</span> </p>
<p> <span>如果<code>tileX</code>和<code>tileY</code>为0，则默认实现将返回整个映像，否则<code>IllegalArgumentException</code> IllegalArgumentException。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索的图像的索引。
</dd>
<dd>
<code>tileX</code> - 要
<code>tileX</code>的列索引（以0开头）。
</dd>
<dd>
<code>tileY</code> - 要
<code>tileY</code>的行索引（以0开头）。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
瓷砖为
<code>BufferedImage</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>超出范围。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果图块索引超出界限。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="readTileRaster-int-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>readTileRaster</h4> <pre>public <a href="../../java/awt/image/Raster.html" title="class in java.awt.image">Raster</a> readTileRaster(int imageIndex,
int tileX,
int tileY)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个新的<code>Raster</code>原始像素数据的<code>Raster</code>对象，不需要任何颜色转换。</span>
<span>应用程序必须确定如何通过其他方式解释像素数据。</span>
<p> <span>如果<a href="../../javax/imageio/ImageReader.html#canReadRaster--"><code>canReadRaster()</code></a>返回<code>false</code> ，这个方法会抛出一个<code>UnsupportedOperationException</code> 。</span> </p>
<p> <span>默认实现检查是否阅读<code>Raster</code> s的支持，如果有来电<a href="../../javax/imageio/ImageReader.html#readRaster-int-javax.imageio.ImageReadParam-"><code>readRaster(imageIndex, null)</code></a>如果<code>tileX</code>和<code>tileY</code>都为0，或将引发<code>IllegalArgumentException</code>其他。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索的图像的索引。
</dd>
<dd>
<code>tileX</code> - 要
<code>tileX</code>的列索引（以0开头）。
</dd>
<dd>
<code>tileY</code> - 要
<code>tileY</code>的行索引（以0开头）。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
瓷砖为
<code>Raster</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果这个插件不支持阅读原始的
<code>Raster</code> s。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果图块索引超出界限。
</dd>
<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>是超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读数时是否发生错误。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/ImageReader.html#readTile-int-int-int-"><code>readTile(int, int, int)</code></a> ， <a href="../../javax/imageio/ImageReader.html#readRaster-int-javax.imageio.ImageReadParam-"><code>readRaster(int, javax.imageio.ImageReadParam)</code></a> ， <a href="../../java/awt/image/Raster.html" title="java.awt.image中的类"><code>Raster</code></a></span>
</dd>
</dl> </li>
</ul> <a name="readAsRenderedImage-int-javax.imageio.ImageReadParam-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>readAsRenderedImage</h4> <pre>public <a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> readAsRenderedImage(int imageIndex,
<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个<code>RenderedImage</code>对象，其中包含由<code>imageIndex</code>索引的图像的内容。</span>
<span>默认情况下，返回的图像只是由<code>BufferedImage</code>返回的<code>read(imageIndex, param)</code> 。</span>
<p> <span>该方法的语义可能与其他<code>read</code>方法的<code>read</code>有所不同。</span> <span>首先，任何目标图像和/或图像类型中设定<code>ImageReadParam</code>可被忽略。</span> <span>第二，通常的听众电话不能保证制作，或者是有意义的。</span> <span>这是因为返回的图像在返回时可能未完全填充像素数据，或者确实在任何时候。</span> </p>
<p> <span>如果提供的<code>ImageReadParam</code>包含此读卡器不支持的可选设置值（ <i>例如</i>源渲染大小或任何特定于格式的设置），它们将被忽略。</span> </p>
<p> <span>默认实现只是调用<a href="../../javax/imageio/ImageReader.html#read-int-"><code>read(imageIndex, param)</code></a> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索的图像的索引。
</dd>
<dd>
<code>param</code> -一个
<code>ImageReadParam</code>用来控制读取过程中，或
<code>null</code> 。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<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/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果由
<code>param.getSourceBands</code>和
<code>param.getDestinationBands</code>指定的源和目标频带组长
<code>param.getDestinationBands</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> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="readerSupportsThumbnails--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>readerSupportsThumbnails</h4> <pre>public boolean readerSupportsThumbnails()</pre>
<div class="block">
<span>如果此阅读器<code>true</code>的图像格式支持与之相关的缩略图预览图像，则返回<code>true</code> 。</span>
<span>默认实现返回<code>false</code> 。</span>
<p> <span>如果此方法返回<code>false</code> ， <code>hasThumbnails</code>和<code>getNumThumbnails</code>将返回<code>false</code>和<code>0</code>分别和<code>readThumbnail</code>将抛出<code>UnsupportedOperationException</code> ，不管他们的论点。</span> </p>
<p> <span>不支持缩略图的读者不需要实现与缩略图相关的任何方法。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果支持缩略图。
</dd>
</dl> </li>
</ul> <a name="hasThumbnails-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hasThumbnails</h4> <pre>public boolean hasThumbnails(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>readerSupportsThumbnails</code>返回<code>false</code> ）， <code>false</code>将被返回，无论输入源是设置还是在边界<code>imageIndex</code> 。</span>
<p> <span>如果<code>getNumThumbnails</code>返回大于0的值，则默认实现将返回<code>true</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>是超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="getNumThumbnails-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNumThumbnails</h4> <pre>public int getNumThumbnails(int imageIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回与给定图像相关联的缩略图预览图像的数量。</span>
<span>如果格式不支持缩略图，（ <code>readerSupportsThumbnails</code>返回<code>false</code> ）， <code>0</code>将被返回，无论输入源是设置还是在边界<code>imageIndex</code> 。</span>
<p> <span>默认实现返回0，而不检查其参数。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要查询的图像的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与给定图像相关联的缩略图数量。
</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>是超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果在阅读期间发生错误。
</dd>
</dl> </li>
</ul> <a name="getThumbnailWidth-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getThumbnailWidth</h4> <pre>public int getThumbnailWidth(int imageIndex,
int thumbnailIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回由<code>thumbnailIndex</code>索引的缩略图预览图像的宽度，与由<code>thumbnailIndex</code>索引的图像相关<code>ImageIndex</code> 。</span>
<p> <span>如果读者不支持缩略图，（ <code>readerSupportsThumbnails</code>返回<code>false</code> ），将抛出一个<code>UnsupportedOperationException</code> 。</span> </p>
<p> <span>默认实现只是返回<code>readThumbnail(imageindex, thumbnailIndex).getWidth()</code> 。</span> <span>因此，如果可能，子类应该覆盖此方法，以避免强制缩略图被读取。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索的图像的索引。
</dd>
<dd>
<code>thumbnailIndex</code> - 要检索的缩略图的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
所需缩略图的宽度为
<code>int</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果不支持缩略图。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输入源尚未设置。
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果任何一个提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="getThumbnailHeight-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getThumbnailHeight</h4> <pre>public int getThumbnailHeight(int imageIndex,
int thumbnailIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回由<code>thumbnailIndex</code>索引的缩略图预览图像的高度，与由<code>thumbnailIndex</code>索引的图像相关<code>ImageIndex</code> 。</span>
<p> <span>如果读者不支持缩略图，（ <code>readerSupportsThumbnails</code>返回<code>false</code> ），则会抛出一个<code>UnsupportedOperationException</code> 。</span> </p>
<p> <span>默认实现简单地返回<code>readThumbnail(imageindex, thumbnailIndex).getHeight()</code> 。</span> <span>因此，如果可能，子类应该覆盖此方法，以避免强制缩略图被读取。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索的图像的索引。
</dd>
<dd>
<code>thumbnailIndex</code> - 要检索的缩略图的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
所需缩略图的高度为
<code>int</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果不支持缩略图。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输入源尚未设置。
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果提供的任何一个索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读数时是否发生错误。
</dd>
</dl> </li>
</ul> <a name="readThumbnail-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>readThumbnail</h4> <pre>public <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> readThumbnail(int imageIndex,
int thumbnailIndex)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回索引缩略图预览图像<code>thumbnailIndex</code> ，通过索引的图像关联<code>ImageIndex</code>为<code>BufferedImage</code> 。</span>
<p> <span>任何注册<code>IIOReadProgressListener</code>对象将通过调用它们的通知<code>thumbnailStarted</code> ， <code>thumbnailProgress</code>和<code>thumbnailComplete</code>方法。</span> </p>
<p> <span>如果读者不支持缩略图（ <code>readerSupportsThumbnails</code>返回<code>false</code> ），一个<code>UnsupportedOperationException</code>将忽略输入源是否已经设置抛出或索引是否在范围。</span> </p>
<p> <span>默认实现会抛出一个<code>UnsupportedOperationException</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imageIndex</code> - 要检索的图像的索引。
</dd>
<dd>
<code>thumbnailIndex</code> - 要检索的缩略图的索引。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
所需的缩略图为
<code>BufferedImage</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果不支持缩略图。
</dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果输入源尚未设置。
</dd>
<dd>
<code><a href="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果任何一个提供的索引超出范围。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读数时是否发生错误。
</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>clearAbortRequest</code>被调用，如果已经进行了中止当前读取操作的请求，则返回
<code>true</code> 。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果当前的读取操作应该中止。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#abort--"><code>abort()</code></a> ，
<a href="../../javax/imageio/ImageReader.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/ImageReader.html#abort--"><code>abort()</code></a> ，
<a href="../../javax/imageio/ImageReader.html#abortRequested--"><code>abortRequested()</code></a>
</dd>
</dl> </li>
</ul> <a name="addIIOReadWarningListener-javax.imageio.event.IIOReadWarningListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addIIOReadWarningListener</h4> <pre>public void addIIOReadWarningListener(<a href="../../javax/imageio/event/IIOReadWarningListener.html" title="interface in javax.imageio.event">IIOReadWarningListener</a> listener)</pre>
<div class="block">
<span>添加一个<code>IIOReadWarningListener</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>IIOReadWarningListener</code>注册。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#removeIIOReadWarningListener-javax.imageio.event.IIOReadWarningListener-"><code>removeIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeIIOReadWarningListener-javax.imageio.event.IIOReadWarningListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeIIOReadWarningListener</h4> <pre>public void removeIIOReadWarningListener(<a href="../../javax/imageio/event/IIOReadWarningListener.html" title="interface in javax.imageio.event">IIOReadWarningListener</a> listener)</pre>
<div class="block">
<span>删除一个<code>IIOReadWarningListener</code>从已注册的错误侦听器列表中。</span>
<span>如果听众以前没有注册，或者如果<code>listener</code>是<code>null</code> ，则不会抛出异常，也不会采取任何操作。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 要注销的IIOReadWarningListener。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#addIIOReadWarningListener-javax.imageio.event.IIOReadWarningListener-"><code>addIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeAllIIOReadWarningListeners--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeAllIIOReadWarningListeners</h4> <pre>public void removeAllIIOReadWarningListeners()</pre>
<div class="block">
<span>删除所有当前注册的<code>IIOReadWarningListener</code>对象。</span>
<p> <span>默认实现将<code>warningListeners</code>和<code>warningLocales</code>实例变量设置为<code>null</code> 。</span> </p>
</div> </li>
</ul> <a name="addIIOReadProgressListener-javax.imageio.event.IIOReadProgressListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addIIOReadProgressListener</h4> <pre>public void addIIOReadProgressListener(<a href="../../javax/imageio/event/IIOReadProgressListener.html" title="interface in javax.imageio.event">IIOReadProgressListener</a> listener)</pre>
<div class="block">
<span>添加一个<code>IIOReadProgressListener</code>到已注册的进度侦听器列表中。</span>
<span>如果<code>listener</code>是<code>null</code> ，将不会抛出异常，也不会采取任何行动。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 要注册的IIOReadProgressListener。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#removeIIOReadProgressListener-javax.imageio.event.IIOReadProgressListener-"><code>removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeIIOReadProgressListener-javax.imageio.event.IIOReadProgressListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeIIOReadProgressListener</h4> <pre>public void removeIIOReadProgressListener(<a href="../../javax/imageio/event/IIOReadProgressListener.html" title="interface in javax.imageio.event">IIOReadProgressListener</a> listener)</pre>
<div class="block">
<span>删除一个<code>IIOReadProgressListener</code>从注册的进度侦听器列表中。</span>
<span>如果监听者以前没有注册，或者如果<code>listener</code>是<code>null</code> ，则不会抛出异常，不会执行任何操作。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 要注销的IIOReadProgressListener。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#addIIOReadProgressListener-javax.imageio.event.IIOReadProgressListener-"><code>addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeAllIIOReadProgressListeners--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeAllIIOReadProgressListeners</h4> <pre>public void removeAllIIOReadProgressListeners()</pre>
<div class="block">
<span>删除所有当前注册的<code>IIOReadProgressListener</code>对象。</span>
<p> <span>默认实现将<code>progressListeners</code>实例变量设置为<code>null</code> 。</span> </p>
</div> </li>
</ul> <a name="addIIOReadUpdateListener-javax.imageio.event.IIOReadUpdateListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addIIOReadUpdateListener</h4> <pre>public void addIIOReadUpdateListener(<a href="../../javax/imageio/event/IIOReadUpdateListener.html" title="interface in javax.imageio.event">IIOReadUpdateListener</a> listener)</pre>
<div class="block">
<span>添加一个<code>IIOReadUpdateListener</code>到注册的更新侦听器列表中。</span>
<span>如果<code>listener</code>是<code>null</code> ，将不会抛出异常，也不会采取任何行动。</span>
<span>听众将接收像素更新的通知，因为图像和缩略图被解码，包括渐进通过的开始和结束。</span>
<p> <span>如果没有更新听众存在，读者可以选择对目的地图像和/或缩略图的像素执行更少的更新，这可以导致更有效的解码。</span> </p>
<p> <span>例如，在逐行JPEG解码中，每个遍历包含对一组系数的更新，如果存在听众，则必须将其转换成像素值并且将其转换为每个遍的RGB颜色空间。</span> <span>如果没有听众存在，则可以简单地累积系数，并且最终结果被转换并仅一次进行颜色转换。</span> </p>
<p> <span>无论中间更新是否被执行，解码的最终结果将是相同的。</span> <span>因此，如果只需要最终的图像，则最好不要注册任何<code>IIOReadUpdateListener</code> 。</span> <span>通常，通过与本地CPU处理相比非常慢的网络连接获取图像时，逐行更新最有效;</span> <span>通过快速连接，逐行更新可能实际上会减慢图像的呈现。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 要注册的IIOReadUpdateListener。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#removeIIOReadUpdateListener-javax.imageio.event.IIOReadUpdateListener-"><code>removeIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeIIOReadUpdateListener-javax.imageio.event.IIOReadUpdateListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeIIOReadUpdateListener</h4> <pre>public void removeIIOReadUpdateListener(<a href="../../javax/imageio/event/IIOReadUpdateListener.html" title="interface in javax.imageio.event">IIOReadUpdateListener</a> listener)</pre>
<div class="block">
<span>删除一个<code>IIOReadUpdateListener</code>从已注册的更新侦听器列表中。</span>
<span>如果监听者以前没有注册，或者如果<code>listener</code>是<code>null</code> ，则不会抛出异常，也不会采取任何操作。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 要注销的IIOReadUpdateListener。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageReader.html#addIIOReadUpdateListener-javax.imageio.event.IIOReadUpdateListener-"><code>addIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeAllIIOReadUpdateListeners--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeAllIIOReadUpdateListeners</h4> <pre>public void removeAllIIOReadUpdateListeners()</pre>
<div class="block">
<span>删除所有当前注册的<code>IIOReadUpdateListener</code>对象。</span>
<p> <span>默认实现将<code>updateListeners</code>实例变量设置为<code>null</code> 。</span> </p>
</div> </li>
</ul> <a name="processSequenceStarted-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processSequenceStarted</h4> <pre>protected void processSequenceStarted(int minIndex)</pre>
<div class="block">
<span>通过调用他们的<code>sequenceStarted</code>方法，将所有注册的<code>IIOReadProgressListener</code>的图像读取序列的开始<code>sequenceStarted</code> 。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>minIndex</code> - 正在读取的最低索引。
</dd>
</dl> </li>
</ul> <a name="processSequenceComplete--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processSequenceComplete</h4> <pre>protected void processSequenceComplete()</pre>
<div class="block">
<span>通过调用他们的<code>sequenceComplete</code>方法，将所有注册的<code>IIOReadProgressListener</code>的一系列图像读取广播<code>IIOReadProgressListener</code> 。</span>
<span>子类可以方便地使用这种方法。</span>
</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>IIOReadProgressListener</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>IIOReadProgressListener</code>的IIOReadProgressListener的图像完成的当前百分比<code>imageProgress</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>IIOReadProgressListener</code>到所有注册的<code>IIOReadProgressListener</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>IIOReadProgressListener</code>的缩略图的开始<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>IIOReadProgressListener</code>的IIOReadProgressListener的缩略图完成的当前百分比<code>thumbnailProgress</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>IIOReadProgressListener</code>的缩略图读取完成。</span>
<span>子类可以方便地使用这种方法。</span>
</div> </li>
</ul> <a name="processReadAborted--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processReadAborted</h4> <pre>protected void processReadAborted()</pre>
<div class="block">
<span>通过调用他们的<code>readAborted</code>方法来广播已读取已被中止到所有注册的<code>IIOReadProgressListener</code> 。</span>
<span>子类可以方便地使用这种方法。</span>
</div> </li>
</ul> <a name="processPassStarted-java.awt.image.BufferedImage-int-int-int-int-int-int-int-int:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processPassStarted</h4> <pre>protected void processPassStarted(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theImage,
int pass,
int minPass,
int maxPass,
int minX,
int minY,
int periodX,
int periodY,
int[] bands)</pre>
<div class="block">
<span>通过调用他们的<code>passStarted</code>方法，将所有已注册的<code>IIOReadUpdateListener</code> s的渐进通过开始。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>theImage</code> -
<code>BufferedImage</code>正在更新。
</dd>
<dd>
<code>pass</code> - 当前通过的索引，从0开始。
</dd>
<dd>
<code>minPass</code> - 将被解码的第一遍的索引。
</dd>
<dd>
<code>maxPass</code> - 将被解码的最后一次通过的索引。
</dd>
<dd>
<code>minX</code> - 通过中包含的左上角像素的X坐标。
</dd>
<dd>
<code>minY</code> - 通过中包含的左上角像素的X坐标。
</dd>
<dd>
<code>periodX</code> - 像素之间的水平间隔。
</dd>
<dd>
<code>periodY</code> - 像素之间的垂直分隔。
</dd>
<dd>
<code>bands</code> -
<code>int</code> s的数组，
<code>int</code>目的地的一组受影响的频带。
</dd>
</dl> </li>
</ul> <a name="processImageUpdate-java.awt.image.BufferedImage-int-int-int-int-int-int-int:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processImageUpdate</h4> <pre>protected void processImageUpdate(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theImage,
int minX,
int minY,
int width,
int height,
int periodX,
int periodY,
int[] bands)</pre>
<div class="block">
<span>通过调用他们的<code>imageUpdate</code>方法将一组样本的更新广播到所有注册的<code>IIOReadUpdateListener</code> 。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>theImage</code> -
<code>BufferedImage</code>正在更新。
</dd>
<dd>
<code>minX</code> - 通过中包含的左上角像素的X坐标。
</dd>
<dd>
<code>minY</code> - 通过中包含的左上角像素的X坐标。
</dd>
<dd>
<code>width</code> - 正在更新的区域的总宽度，包括如果
<code>periodX &gt; 1</code>被跳过的像素。
</dd>
<dd>
<code>height</code> - 要更新的区域的总高度，包括如果
<code>periodY &gt; 1</code>被跳过的像素。
</dd>
<dd>
<code>periodX</code> - 像素之间的水平间隔。
</dd>
<dd>
<code>periodY</code> - 像素之间的垂直分隔。
</dd>
<dd>
<code>bands</code> -
<code>bands</code>的阵列，
<code>int</code>目的地的受影响的频带集合。
</dd>
</dl> </li>
</ul> <a name="processPassComplete-java.awt.image.BufferedImage-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processPassComplete</h4> <pre>protected void processPassComplete(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theImage)</pre>
<div class="block">
<span>通过调用他们的<code>passComplete</code>方法，将所有已<code>IIOReadUpdateListener</code>的IIOReadUpdateListener通过循环传递结束。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>theImage</code> -
<code>BufferedImage</code>正在更新。
</dd>
</dl> </li>
</ul> <a name="processThumbnailPassStarted-java.awt.image.BufferedImage-int-int-int-int-int-int-int-int:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processThumbnailPassStarted</h4> <pre>protected void processThumbnailPassStarted(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theThumbnail,
int pass,
int minPass,
int maxPass,
int minX,
int minY,
int periodX,
int periodY,
int[] bands)</pre>
<div class="block">
<span>通过调用他们的<code>thumbnailPassStarted</code>方法，将所有注册的<code>IIOReadUpdateListener</code> s的缩略图渐变通行符<code>IIOReadUpdateListener</code> <code>thumbnailPassStarted</code> 。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>theThumbnail</code> - 正在更新的
<code>BufferedImage</code>缩略图。
</dd>
<dd>
<code>pass</code> - 当前通行证的索引，以0开头。
</dd>
<dd>
<code>minPass</code> - 将被解码的第一遍的索引。
</dd>
<dd>
<code>maxPass</code> - 将被解码的最后一次通过的索引。
</dd>
<dd>
<code>minX</code> - 通过中包含的左上角像素的X坐标。
</dd>
<dd>
<code>minY</code> - 通过中包含的左上角像素的X坐标。
</dd>
<dd>
<code>periodX</code> - 像素之间的水平分隔。
</dd>
<dd>
<code>periodY</code> - 像素之间的垂直分隔。
</dd>
<dd>
<code>bands</code> - 一个
<code>bands</code>的数组，
<code>int</code>目的地的一组受影响的频带。
</dd>
</dl> </li>
</ul> <a name="processThumbnailUpdate-java.awt.image.BufferedImage-int-int-int-int-int-int-int:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processThumbnailUpdate</h4> <pre>protected void processThumbnailUpdate(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theThumbnail,
int minX,
int minY,
int width,
int height,
int periodX,
int periodY,
int[] bands)</pre>
<div class="block">
<span>通过调用他们的<code>thumbnailUpdate</code>方法，将缩略图中的一组样本的更新广播到所有注册的<code>IIOReadUpdateListener</code> 。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>theThumbnail</code> - 正在更新的
<code>BufferedImage</code>缩略图。
</dd>
<dd>
<code>minX</code> - 通过中包含的左上角像素的X坐标。
</dd>
<dd>
<code>minY</code> - 通过中包含的左上角像素的X坐标。
</dd>
<dd>
<code>width</code> - 正在更新的区域的总宽度，包括如果
<code>periodX &gt; 1</code>被跳过的像素。
</dd>
<dd>
<code>height</code> - 正在更新的区域的总高度，包括如果
<code>periodY &gt; 1</code>被跳过的像素。
</dd>
<dd>
<code>periodX</code> - 像素之间的水平分隔。
</dd>
<dd>
<code>periodY</code> - 像素之间的垂直分隔。
</dd>
<dd>
<code>bands</code> -
<code>int</code> s的数组，
<code>int</code>目的地的一组受影响的频带。
</dd>
</dl> </li>
</ul> <a name="processThumbnailPassComplete-java.awt.image.BufferedImage-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processThumbnailPassComplete</h4> <pre>protected void processThumbnailPassComplete(<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> theThumbnail)</pre>
<div class="block">
<span>通过调用他们的<code>thumbnailPassComplete</code>方法，将所有已注册的<code>IIOReadUpdateListener</code> s的缩略图遍历传递结束。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>theThumbnail</code> - 正在更新的
<code>BufferedImage</code>缩略图。
</dd>
</dl> </li>
</ul> <a name="processWarningOccurred-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processWarningOccurred</h4> <pre>protected void processWarningOccurred(<a href="../../java/lang/String.html" title="class in java.lang">String</a> warning)</pre>
<div class="block">
<span>通过调用他们的<code>warningOccurred</code>方法向所有注册的<code>IIOReadWarningListener</code>发送一条警告消息。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<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-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>processWarningOccurred</h4> <pre>protected void processWarningOccurred(<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>IIOReadWarningListener</code>通过调用它们的S <code>warningOccurred</code>法从拍摄字符串<code>ResourceBundle</code> 。</span>
<span>子类可以方便地使用这种方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>baseName</code> - 包含本地化警告消息的一组
<code>ResourceBundle</code> s的基本名称。
</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>可能会找到
<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>ImageReader</code>恢复到初始状态。</span>
<p> <span>默认实现调用<code>setInput(null, false)</code> ， <code>setLocale(null)</code> ， <code>removeAllIIOReadUpdateListeners()</code> ， <code>removeAllIIOReadWarningListeners()</code> ， <code>removeAllIIOReadProgressListeners()</code>和<code>clearAbortRequest</code> 。</span> </p>
</div> </li>
</ul> <a name="dispose--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>dispose</h4> <pre>public void dispose()</pre>
<div class="block">
<span>允许释放此对象持有的任何资源。</span>
<span>在调用此方法之后调用其他方法（不<code>finalize</code> ）的结果是未定义的。</span>
<p> <span>当应用程序知道他们将不再使用此方法时，调用此方法很<code>ImageReader</code> 。</span> <span>否则，读者可以继续无限期地持有资源。</span> </p>
<p> <span>超类中的这个方法的默认实现什么都不做。</span> <span>子类实现应确保释放所有资源，特别是本地资源。</span> </p>
</div> </li>
</ul> <a name="getSourceRegion-javax.imageio.ImageReadParam-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSourceRegion</h4> <pre>protected static <a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> getSourceRegion(<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param,
int srcWidth,
int srcHeight)</pre>
<div class="block">
<span>读者可以使用一种实用方法来计算应该读取的源图像的区域，同时考虑到所提供的<code>ImageReadParam</code>中的任何源区域和子采样偏移设置。</span>
<span><em>不</em>考虑实际的子采样因子，目的地大小和目的地偏移，因此必须进行进一步的剪切。</span>
<span><a href="../../javax/imageio/ImageReader.html#computeRegions-javax.imageio.ImageReadParam-int-int-java.awt.image.BufferedImage-java.awt.Rectangle-java.awt.Rectangle-"><code>computeRegions</code></a>方法执行所有必要的剪辑。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>param</code> - 正在使用的
<code>ImageReadParam</code> ，或
<code>null</code> 。
</dd>
<dd>
<code>srcWidth</code> - 源图像的宽度。
</dd>
<dd>
<code>srcHeight</code> - 源图像的高度。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
源区域为
<code>Rectangle</code> 。
</dd>
</dl> </li>
</ul> <a name="computeRegions-javax.imageio.ImageReadParam-int-int-java.awt.image.BufferedImage-java.awt.Rectangle-java.awt.Rectangle-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>computeRegions</h4> <pre>protected static void computeRegions(<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param,
int srcWidth,
int srcHeight,
<a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> image,
<a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> srcRegion,
<a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> destRegion)</pre>
<div class="block">
<span>计算感兴趣的源区域和感兴趣的目的地区域，考虑源图像的宽度和高度，可选的目标图像和可选的<code>ImageReadParam</code> 。</span>
<span>源区域以整个源图像开始。</span>
<span>然后该被夹到在指定的源区<code>ImageReadParam</code> ，如果指定了一个。</span>
<p> <span>如果任一目标偏移量为负值，则源区域被剪切，以使其左上角与目标图像的左上角重合，并考虑子采样。</span> <span>然后将结果剪切到右侧和底部的目标图像，如果指定了目标图像，则将子采样和目标偏移量纳入考虑。</span> </p>
<p> <span>类似地，目的地区域与源图像开始，被转换为目的地的给定偏移量<code>ImageReadParam</code>如果有一个，最后被夹到目标图像，如果存在一个。</span> </p>
<p> <span>如果源或目的地区域的宽度或高度为0，则抛出<code>IllegalArgumentException</code> 。</span> </p>
<p> <span>如果仅需要源限幅，则可以使用<a href="../../javax/imageio/ImageReader.html#getSourceRegion-javax.imageio.ImageReadParam-int-int-"><code>getSourceRegion&gt;</code></a>方法。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>param</code> - 一个
<code>ImageReadParam</code>或
<code>null</code> 。
</dd>
<dd>
<code>srcWidth</code> - 源图像的宽度。
</dd>
<dd>
<code>srcHeight</code> - 源图像的高度。
</dd>
<dd>
<code>image</code> - 一个
<code>BufferedImage</code>将成为目标图像，或
<code>null</code> 。
</dd>
<dd>
<code>srcRegion</code> - 一个
<code>Rectangle</code> ，将填充感兴趣的来源地区。
</dd>
<dd>
<code>destRegion</code> - 一个
<code>Rectangle</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>srcRegion</code>是
<code>null</code> 。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>dstRegion</code>是
<code>null</code> 。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果生成的源或目的地区域为空。
</dd>
</dl> </li>
</ul> <a name="checkReadParamBandSettings-javax.imageio.ImageReadParam-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>checkReadParamBandSettings</h4> <pre>protected static void checkReadParamBandSettings(<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param,
int numSrcBands,
int numDstBands)</pre>
<div class="block">
<span>读者可以使用一种实用方法来测试ImageReadParam的源和目标频带设置的<code>ImageReadParam</code> 。</span>
<span>一旦读取器知道源图像在输入流中存在的频带的数量以及正被写入的目的图像的频带数量，则可以调用该方法。</span>
<p> <span>该方法检索的源和目标频带设定从使用PARAM阵列<code>getSourceBands</code>种<code>getDestinationBands</code>方法（或认为它们是<code>null</code>如果<code>param</code>是<code>null</code> ）。</span> <span>如果源频带设置数组为<code>null</code> ，则认为等于阵列<code>{ 0, 1, ..., numSrcBands - 1 }</code> ，类似地用于目标频带设置数组。</span> </p>
<p> <span>然后，该方法测试两个数组的长度相等，并且两个数组都不包含大于最大可用带索引的值。</span> </p>
<p> <span>任何失败都导致抛出<code>IllegalArgumentException</code> ;</span> <span>成功导致该方法静默地返回。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>param</code> - 用于阅读图像的
<code>ImageReadParam</code> 。
</dd>
<dd>
<code>numSrcBands</code> - 输入源中存在的图像的频带数。
</dd>
<dd>
<code>numDstBands</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>param</code>包含源和/或目标带子集的无效规范。
</dd>
</dl> </li>
</ul> <a name="getDestination-javax.imageio.ImageReadParam-java.util.Iterator-int-int-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getDestination</h4> <pre>protected static <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> getDestination(<a href="../../javax/imageio/ImageReadParam.html" title="class in javax.imageio">ImageReadParam</a> param,
<a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a>&gt; imageTypes,
int width,
int height)
throws <a href="../../javax/imageio/IIOException.html" title="class in javax.imageio">IIOException</a></pre>
<div class="block">
<span>返回应写入解码像素数据的<code>BufferedImage</code> 。</span>
<span>图像通过检查提供的<code>ImageReadParam</code>如果不是<code>null</code> ;</span>
<span>如果其<code>getDestination</code>方法返回非<code>null</code>值，那么该图像将被简单地返回。</span>
<span>否则， <code>param.getDestinationType</code>方法来确定是否指定了特定的图像类型。</span>
<span>如果是这样，则返回<code>ImageTypeSpecifier</code>正在检查它等于那些包含在之后使用<code>imageTypes</code> 。</span>
<p> <span>如果<code>param</code>为<code>null</code>或上述步骤未产生图像或<code>ImageTypeSpecifier</code> ，则使用从<code>imageTypes</code>参数获得的第一个值。</span> <span>通常情况下，主叫方将设置<code>imageTypes</code>到的值<code>getImageTypes(imageIndex)</code> 。</span> </p>
<p> <span>接下来，通过调用computeRegions确定图像的<code>computeRegions</code> 。</span> <span>正在解码的图像的实际宽度和高度以<code>width</code>和<code>height</code>参数传入。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>param</code> -一个
<code>ImageReadParam</code>被用于获取目标图像或图像类型，或
<code>null</code> 。
</dd>
<dd>
<code>imageTypes</code> -
<code>Iterator</code>的
<code>ImageTypeSpecifier</code> s，表示合法的图像类型，默认为第一个。
</dd>
<dd>
<code>width</code> - 图像或瓦片的真实宽度开始解码。
</dd>
<dd>
<code>height</code> - 正在解码的图像或瓦片的真实宽度。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
应写入解码像素数据的
<code>BufferedImage</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/imageio/IIOException.html" title="class in javax.imageio">IIOException</a></code> -如果
<code>ImageTypeSpecifier</code>由指定的
<code>param</code>不从匹配任何法律措施的
<code>imageTypes</code> 。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> -如果
<code>imageTypes</code>是
<code>null</code>或空的，或如果不是的类型的对象
<code>ImageTypeSpecifier</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/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>width</code>和
<code>height</code>的产品大于
<code>Integer.MAX_VALUE</code> 。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink