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

<div class="header">
<div class="subTitle">
     javax.imageio 
   </div>
<h2 class="title" title="Class ImageIO">Class ImageIO</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.ImageIO</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public final class <span class="typeNameLabel">ImageIO</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
        一个类包含静态方便的方法来定位 
       <code>ImageReader</code> s和 
       <code>ImageWriter</code> s，并执行简单的编码和解码。 
      </div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== 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="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>static <a href="../../javax/imageio/stream/ImageInputStream.html" title="interface in javax.imageio.stream">ImageInputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#createImageInputStream-java.lang.Object-">createImageInputStream</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="rowColor" id="i1">
<td class="colFirst"><code>static <a href="../../javax/imageio/stream/ImageOutputStream.html" title="interface in javax.imageio.stream">ImageOutputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#createImageOutputStream-java.lang.Object-">createImageOutputStream</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> output)</code>
<div class="block">
              返回一个 
             <code>ImageOutputStream</code> ，将其输出发送给给定的 
             <code>Object</code> 。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>static <a href="../../java/io/File.html" title="class in java.io">File</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getCacheDirectory--">getCacheDirectory</a></span>()</code>
<div class="block">
              返回当前值设置由 
             <code>setCacheDirectory</code> ，或 
             <code>null</code> ，如果没有明确的设定已经取得进展。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>static <a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageReader-javax.imageio.ImageWriter-">getImageReader</a></span>(<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a> writer)</code>
<div class="block">
              返回一个 
             <code>ImageReader</code>对应于给定的 
             <code>ImageWriter</code> ，如果有一个，或 
             <code>null</code>如果这个插件为 
             <code>ImageWriter</code>没有指定相应的 
             <code>ImageReader</code> ，或者如果给定的 
             <code>ImageWriter</code>没有注册。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageReaders-java.lang.Object-">getImageReaders</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input)</code>
<div class="block">
              返回一个 
             <code>Iterator</code>包含所有当前注册的 
             <code>ImageReader</code> s，声称能够解码提供的 
             <code>Object</code> ，通常为 
             <code>ImageInputStream</code> 。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageReadersByFormatName-java.lang.String-">getImageReadersByFormatName</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName)</code>
<div class="block">
              返回一个 
             <code>Iterator</code>包含所有当前注册的 
             <code>ImageReader</code> ，声称能够解码命名格式。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageReadersByMIMEType-java.lang.String-">getImageReadersByMIMEType</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> MIMEType)</code>
<div class="block">
              返回一个 
             <code>Iterator</code>包含所有当前已注册的 
             <code>ImageReader</code> ，声称能够解码具有给定MIME类型的文件。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageReadersBySuffix-java.lang.String-">getImageReadersBySuffix</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fileSuffix)</code>
<div class="block">
              返回一个 
             <code>Iterator</code>包含所有当前注册的 
             <code>ImageReader</code> ，声称能够使用给定的后缀来解码文件。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageTranscoder.html" title="interface in javax.imageio">ImageTranscoder</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageTranscoders-javax.imageio.ImageReader-javax.imageio.ImageWriter-">getImageTranscoders</a></span>(<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a> reader, <a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a> writer)</code>
<div class="block">
              返回一个 
             <code>Iterator</code>包含所有当前注册的 
             <code>ImageTranscoder</code> s，声称能够在给定的 
             <code>ImageReader</code>和 
             <code>ImageWriter</code>的元数据之间进行 
             <code>ImageReader</code>
<code>ImageWriter</code> 。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>static <a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageWriter-javax.imageio.ImageReader-">getImageWriter</a></span>(<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a> reader)</code>
<div class="block">
              返回一个 
             <code>ImageWriter</code>对应于给定的 
             <code>ImageReader</code> ，如果有一个，或 
             <code>null</code>如果这个 
             <code>ImageReader</code>的插件没有指定相应的 
             <code>ImageWriter</code> ，或者如果给定的 
             <code>ImageReader</code>没有注册。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageWriters-javax.imageio.ImageTypeSpecifier-java.lang.String-">getImageWriters</a></span>(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> type, <a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName)</code>
<div class="block">
              返回一个 
             <code>Iterator</code>包含所有当前注册的 
             <code>ImageWriter</code> s，声称能够以给定格式对给定布局（使用 
             <code>ImageTypeSpecifier</code> ）的图像进行编码。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageWritersByFormatName-java.lang.String-">getImageWritersByFormatName</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName)</code>
<div class="block">
              返回一个 
             <code>Iterator</code>包含所有当前注册的 
             <code>ImageWriter</code> ，声称能够对命名格式进行编码。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageWritersByMIMEType-java.lang.String-">getImageWritersByMIMEType</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> MIMEType)</code>
<div class="block">
              返回一个 
             <code>Iterator</code>包含所有当前注册的 
             <code>ImageWriter</code> s，声称能够使用给定的MIME类型对文件进行编码。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getImageWritersBySuffix-java.lang.String-">getImageWritersBySuffix</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fileSuffix)</code>
<div class="block">
              返回一个 
             <code>Iterator</code>所有当前注册的ImageWriter的 
             <code>ImageWriter</code> ，声称能够使用给定的后缀对文件进行编码。 
            </div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>static <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/ImageIO.html#getReaderFileSuffixes--">getReaderFileSuffixes</a></span>()</code>
<div class="block">
              返回一个 
             <code>String</code>的数组，列出与当前注册读者集合所理解的格式相关联的所有文件后缀。 
            </div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>static <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/ImageIO.html#getReaderFormatNames--">getReaderFormatNames</a></span>()</code>
<div class="block">
              返回一个 
             <code>String</code>的数组， 
             <code>String</code>列出了当前注册读者集所理解的所有非正式格式名称。 
            </div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>static <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/ImageIO.html#getReaderMIMETypes--">getReaderMIMETypes</a></span>()</code>
<div class="block">
              返回一个 
             <code>String</code>的数组， 
             <code>String</code>列出了当前注册读者集所理解的所有MIME类型。 
            </div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#getUseCache--">getUseCache</a></span>()</code>
<div class="block">
              返回当前值设置由 
             <code>setUseCache</code> ，或 
             <code>true</code> ，如果没有明确的设定已经取得进展。 
            </div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code>static <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/ImageIO.html#getWriterFileSuffixes--">getWriterFileSuffixes</a></span>()</code>
<div class="block">
              返回一个 
             <code>String</code>的数组， 
             <code>String</code>列出了与当前注册作者集合所理解的格式相关联的所有文件后缀。 
            </div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code>static <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/ImageIO.html#getWriterFormatNames--">getWriterFormatNames</a></span>()</code>
<div class="block">
              返回一个 
             <code>String</code>的数组， 
             <code>String</code>列出了当前注册作者集所理解的所有非正式格式名称。 
            </div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>static <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/ImageIO.html#getWriterMIMETypes--">getWriterMIMETypes</a></span>()</code>
<div class="block">
              返回一个 
             <code>String</code>的数组， 
             <code>String</code>列出了当前注册作者集所理解的所有MIME类型。 
            </div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code>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/ImageIO.html#read-java.io.File-">read</a></span>(<a href="../../java/io/File.html" title="class in java.io">File</a> input)</code>
<div class="block">
              返回 
             <code>BufferedImage</code>作为供给的解码结果 
             <code>File</code>与 
             <code>ImageReader</code>选自目前登记的那些自动选择。 
            </div> </td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code>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/ImageIO.html#read-javax.imageio.stream.ImageInputStream-">read</a></span>(<a href="../../javax/imageio/stream/ImageInputStream.html" title="interface in javax.imageio.stream">ImageInputStream</a> stream)</code>
<div class="block">
              返回 
             <code>BufferedImage</code>作为供给的解码结果 
             <code>ImageInputStream</code>与 
             <code>ImageReader</code>选自目前登记的那些自动选择。 
            </div> </td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code>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/ImageIO.html#read-java.io.InputStream-">read</a></span>(<a href="../../java/io/InputStream.html" title="class in java.io">InputStream</a> input)</code>
<div class="block">
              返回 
             <code>BufferedImage</code>作为供给的解码结果 
             <code>InputStream</code>与 
             <code>ImageReader</code>选自目前登记的那些自动选择。 
            </div> </td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code>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/ImageIO.html#read-java.net.URL-">read</a></span>(<a href="../../java/net/URL.html" title="class in java.net">URL</a> input)</code>
<div class="block">
              返回 
             <code>BufferedImage</code>作为供给的解码结果 
             <code>URL</code>与 
             <code>ImageReader</code>选自目前登记的那些自动选择。 
            </div> </td>
</tr>
<tr class="rowColor" id="i25">
<td class="colFirst"><code>static void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#scanForPlugins--">scanForPlugins</a></span>()</code>
<div class="block">
              扫描应用程序类路径上的插件，加载其服务提供者类，并为每个发现的 
             <code>IIORegistry</code>注册一个服务提供者实例。 
            </div> </td>
</tr>
<tr class="altColor" id="i26">
<td class="colFirst"><code>static void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#setCacheDirectory-java.io.File-">setCacheDirectory</a></span>(<a href="../../java/io/File.html" title="class in java.io">File</a> cacheDirectory)</code>
<div class="block">
              设置要创建缓存文件的目录。 
            </div> </td>
</tr>
<tr class="rowColor" id="i27">
<td class="colFirst"><code>static void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#setUseCache-boolean-">setUseCache</a></span>(boolean useCache)</code>
<div class="block">
              设置一个标志，指示在创建 
             <code>ImageInputStream</code> s和 
             <code>ImageOutputStream</code>时是否应使用基于磁盘的缓存文件。 
            </div> </td>
</tr>
<tr class="altColor" id="i28">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#write-java.awt.image.RenderedImage-java.lang.String-java.io.File-">write</a></span>(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> im, <a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName, <a href="../../java/io/File.html" title="class in java.io">File</a> output)</code>
<div class="block">
              使用支持给定格式的任意 
             <code>ImageWriter</code>写入图像到 
             <code>File</code> 。 
            </div> </td>
</tr>
<tr class="rowColor" id="i29">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#write-java.awt.image.RenderedImage-java.lang.String-javax.imageio.stream.ImageOutputStream-">write</a></span>(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> im, <a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName, <a href="../../javax/imageio/stream/ImageOutputStream.html" title="interface in javax.imageio.stream">ImageOutputStream</a> output)</code>
<div class="block">
              使用支持给定格式的任意 
             <code>ImageWriter</code>写入图像到 
             <code>ImageOutputStream</code> 。 
            </div> </td>
</tr>
<tr class="altColor" id="i30">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/ImageIO.html#write-java.awt.image.RenderedImage-java.lang.String-java.io.OutputStream-">write</a></span>(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> im, <a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName, <a href="../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> output)</code>
<div class="block">
              使用支持给定格式的任意 
             <code>ImageWriter</code>写入图像到 
             <code>OutputStream</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">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="scanForPlugins--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>scanForPlugins</h4> <pre>public static void scanForPlugins()</pre>
<div class="block">
<span>扫描应用程序类路径上的插件，加载其服务提供程序类，并为每个发现的<code>IIORegistry</code>注册一个服务提供程序实例。</span>
<p> <span>需要这种方法，因为应用程序类路径在理论上可以改变，或者额外的插件可能变得可用。</span> <span>API的每次调用不会重新扫描类路径，而是仅在第一次调用时自动扫描类路径。</span> <span>客户端可以调用此方法来提示重新扫描。</span> <span>因此，该方法只需要由复杂的应用程序调用，这些应用程序可以在运行时动态创建新的插件。</span> </p>
<p> <span>所述<code>getResources</code>上下文的方法<code>ClassLoader</code>被用于定位包含文件的JAR文件名为<code>META-INF/services/javax.imageio.spi.</code> <i>类名</i> ， <i>类名</i> ，其中是一个<code>ImageReaderSpi</code> ， <code>ImageWriterSpi</code> ， <code>ImageTranscoderSpi</code> ， <code>ImageInputStreamSpi</code> ，或<code>ImageOutputStreamSpi</code> ，沿着应用程序类路径。</span> </p>
<p> <span>找到的文件的内容指示实现上述服务提供商接口的实际实现类的名称;</span> <span>然后使用默认的类加载器来加载这些类中的每一个，并实例化每个类的实例，然后将其放入注册表中以备以后检索。</span> </p>
<p> <span>搜索的位置的确切位置取决于Java运行时环境的实现。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../java/lang/ClassLoader.html#getResources-java.lang.String-"><code>ClassLoader.getResources(java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="setUseCache-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setUseCache</h4> <pre>public static void setUseCache(boolean useCache)</pre>
<div class="block">
<span>设置一个标志，指示在创建<code>ImageInputStream</code>和<code>ImageOutputStream</code>时是否应使用基于磁盘的缓存文件。</span>
<p> <span>当从标准<code>InputStream</code>读取时，可能需要将先前读取的信息保存在缓存中，因为底层流不允许重新读取数据。</span> <span>类似地，当写入标准<code>OutputStream</code>时，可以使用高速缓存来允许改变先前写入的值，然后将其刷新到最终目的地。</span> </p>
<p> <span>高速缓存可能驻留在主内存或磁盘上。</span> <span>将此标志设置为<code>false</code>不允许将磁盘用于未来的流，这在使用小图像时可能是有利的，因为删除了创建和销毁文件的开销。</span> </p>
<p> <span>启动时，值设置为<code>true</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>useCache</code> - 一个 
            <code>boolean</code>指示是否应使用缓存文件，如果是可选的。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageIO.html#getUseCache--"><code>getUseCache()</code></a>
</dd>
</dl> </li>
</ul> <a name="getUseCache--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getUseCache</h4> <pre>public static boolean getUseCache()</pre>
<div class="block">
            返回当前值设置由 
           <code>setUseCache</code> ，或 
           <code>true</code> ，如果没有明确的设定已经取得进展。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             如果基于磁盘的缓存可用于 
            <code>ImageInputStream</code> s和 
            <code>ImageOutputStream</code> s， 
            <code>ImageOutputStream</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageIO.html#setUseCache-boolean-"><code>setUseCache(boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="setCacheDirectory-java.io.File-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setCacheDirectory</h4> <pre>public static void setCacheDirectory(<a href="../../java/io/File.html" title="class in java.io">File</a> cacheDirectory)</pre>
<div class="block">
<span>设置要创建缓存文件的目录。</span>
<span>值为<code>null</code>表示要使用系统相关的默认临时文件目录。</span>
<span>如果<code>getUseCache</code>返回false，则忽略此值。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>cacheDirectory</code> - 一个 
            <code>File</code>目录的File。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</a></code> - 如果安全管理员拒绝对目录的访问。 
           </dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>cacheDir</code>是非 
            <code>null</code>但不是一个目录。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../java/io/File.html#createTempFile-java.lang.String-java.lang.String-java.io.File-"><code>File.createTempFile(String, String, File)</code></a> ， 
            <a href="../../javax/imageio/ImageIO.html#getCacheDirectory--"><code>getCacheDirectory()</code></a>
</dd>
</dl> </li>
</ul> <a name="getCacheDirectory--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCacheDirectory</h4> <pre>public static <a href="../../java/io/File.html" title="class in java.io">File</a> getCacheDirectory()</pre>
<div class="block">
            返回当前值设置由 
           <code>setCacheDirectory</code> ，或 
           <code>null</code> ，如果没有明确的设定已经取得进展。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>File</code>指示将创建高速缓存文件的目录，或 
            <code>null</code>以指示系统相关的默认临时文件目录。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageIO.html#setCacheDirectory-java.io.File-"><code>setCacheDirectory(java.io.File)</code></a>
</dd>
</dl> </li>
</ul> <a name="createImageInputStream-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createImageInputStream</h4> <pre>public static <a href="../../javax/imageio/stream/ImageInputStream.html" title="interface in javax.imageio.stream">ImageInputStream</a> createImageInputStream(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input)
                                               throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个<code>ImageInputStream</code> ，它将从给定的<code>Object</code>输入。</span>
<span>对<code>IIORegistry</code>类<code>ImageInputStreamSpi</code>一组<code>ImageInputStreamSpi</code> s进行了查询，第一个能够从提供的对象输入的数据用于创建返回的<code>ImageInputStream</code> 。</span>
<span>如果没有合适的<code>ImageInputStreamSpi</code> ，返回<code>null</code> 。</span>
<p> <span><code>getUseCache</code>和<code>getCacheDirectory</code>的当前缓存设置将用于控制缓存。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>input</code> -一个 
            <code>Object</code>被用作输入源，如 
            <code>File</code> ，可读 
            <code>RandomAccessFile</code> ，或 
            <code>InputStream</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>ImageInputStream</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>input</code>是 
            <code>null</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/spi/ImageInputStreamSpi.html" title="javax.imageio.spi中的类"><code>ImageInputStreamSpi</code></a></span>
</dd>
</dl> </li>
</ul> <a name="createImageOutputStream-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createImageOutputStream</h4> <pre>public static <a href="../../javax/imageio/stream/ImageOutputStream.html" title="interface in javax.imageio.stream">ImageOutputStream</a> createImageOutputStream(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> output)
                                                 throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回一个<code>ImageOutputStream</code> ，将其输出发送给给定的<code>Object</code> 。</span>
<span>该组<code>ImageOutputStreamSpi</code>与注册的小号<code>IIORegistry</code>类查询和对应的第一个是能够从所提供的对象发送输出被用来创建返回的<code>ImageOutputStream</code> 。</span>
<span>如果没有合适的<code>ImageOutputStreamSpi</code> ，返回<code>null</code> 。</span>
<p> <span><code>getUseCache</code>和<code>getCacheDirectory</code>的当前缓存设置将用于控制缓存。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>output</code> -一个 
            <code>Object</code>被用作输出目的地，如 
            <code>File</code> ，可写 
            <code>RandomAccessFile</code> ，或 
            <code>OutputStream</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>ImageOutputStream</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>output</code>是 
            <code>null</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/spi/ImageOutputStreamSpi.html" title="javax.imageio.spi中的类"><code>ImageOutputStreamSpi</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getReaderFormatNames--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getReaderFormatNames</h4> <pre>public static <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getReaderFormatNames()</pre>
<div class="block">
            返回一个 
           <code>String</code>的数组， 
           <code>String</code>列出了当前注册读者集所理解的所有非正式格式名称。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>String</code>的阵列。 
           </dd>
</dl> </li>
</ul> <a name="getReaderMIMETypes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getReaderMIMETypes</h4> <pre>public static <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getReaderMIMETypes()</pre>
<div class="block">
            返回一个 
           <code>String</code>的数组，列出了当前注册读者集所理解的所有MIME类型。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>String</code>的数组。 
           </dd>
</dl> </li>
</ul> <a name="getReaderFileSuffixes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getReaderFileSuffixes</h4> <pre>public static <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getReaderFileSuffixes()</pre>
<div class="block">
            返回一个 
           <code>String</code>的数组，列出与当前注册读者集合所理解的格式相关联的所有文件后缀。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>String</code>的阵列。 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             1.6 
           </dd>
</dl> </li>
</ul> <a name="getImageReaders-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageReaders</h4> <pre>public static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a>&gt; getImageReaders(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> input)</pre>
<div class="block">
<span>返回一个<code>Iterator</code>包含所有当前注册的<code>ImageReader</code> s，声称能够解码提供的<code>Object</code> ，通常为<code>ImageInputStream</code> 。</span>
<p> <span>在从该方法退出时，流位置保留在其先前位置。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>input</code> - 包含编码图像数据的 
            <code>ImageInputStream</code>或其他 
            <code>Object</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Iterator</code>包含 
            <code>ImageReader</code> s。 
           </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>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/spi/ImageReaderSpi.html#canDecodeInput-java.lang.Object-"><code>ImageReaderSpi.canDecodeInput(java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="getImageReadersByFormatName-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageReadersByFormatName</h4> <pre>public static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a>&gt; getImageReadersByFormatName(<a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName)</pre>
<div class="block">
            返回一个 
           <code>Iterator</code>包含所有当前注册的 
           <code>ImageReader</code> s，声称能够解码命名格式。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>formatName</code> - 一个 
            <code>String</code>格式的非正式名称（ 
            <i>例如</i> “jpeg”或“tiff”）的 
            <code>String</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Iterator</code>包含 
            <code>ImageReader</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>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/spi/ImageReaderWriterSpi.html#getFormatNames--"><code>ImageReaderWriterSpi.getFormatNames()</code></a>
</dd>
</dl> </li>
</ul> <a name="getImageReadersBySuffix-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageReadersBySuffix</h4> <pre>public static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a>&gt; getImageReadersBySuffix(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fileSuffix)</pre>
<div class="block">
            返回一个 
           <code>Iterator</code>所有当前注册的ImageReader的 
           <code>ImageReader</code> ，声称能够使用给定的后缀解码文件。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>fileSuffix</code> - 包含文件后缀（ 
            <i>例如</i> “jpg”或“tiff”）的 
            <code>String</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Iterator</code>包含 
            <code>ImageReader</code> s。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>fileSuffix</code>是 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/spi/ImageReaderWriterSpi.html#getFileSuffixes--"><code>ImageReaderWriterSpi.getFileSuffixes()</code></a>
</dd>
</dl> </li>
</ul> <a name="getImageReadersByMIMEType-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageReadersByMIMEType</h4> <pre>public static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a>&gt; getImageReadersByMIMEType(<a href="../../java/lang/String.html" title="class in java.lang">String</a> MIMEType)</pre>
<div class="block">
            返回一个 
           <code>Iterator</code>包含所有当前注册的 
           <code>ImageReader</code> s，声称能够解码具有给定MIME类型的文件。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>MIMEType</code> - 包含文件后缀（ 
            <i>例如</i> “image / jpeg”或“image / x-bmp”）的 
            <code>String</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Iterator</code>包含 
            <code>ImageReader</code> s。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>MIMEType</code>是 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/spi/ImageReaderWriterSpi.html#getMIMETypes--"><code>ImageReaderWriterSpi.getMIMETypes()</code></a>
</dd>
</dl> </li>
</ul> <a name="getWriterFormatNames--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getWriterFormatNames</h4> <pre>public static <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getWriterFormatNames()</pre>
<div class="block">
            返回一个 
           <code>String</code>的数组， 
           <code>String</code>列出了当前注册作者集所理解的所有非正式格式名称。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>String</code>的数组。 
           </dd>
</dl> </li>
</ul> <a name="getWriterMIMETypes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getWriterMIMETypes</h4> <pre>public static <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getWriterMIMETypes()</pre>
<div class="block">
            返回一个 
           <code>String</code>的数组， 
           <code>String</code>列出了当前注册作者集所理解的所有MIME类型。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>String</code>的数组。 
           </dd>
</dl> </li>
</ul> <a name="getWriterFileSuffixes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getWriterFileSuffixes</h4> <pre>public static <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getWriterFileSuffixes()</pre>
<div class="block">
            返回一个 
           <code>String</code>的数组， 
           <code>String</code>列出了与当前注册的作者集合所理解的格式相关联的所有文件后缀。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>String</code>的数组。 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             1.6 
           </dd>
</dl> </li>
</ul> <a name="getImageWritersByFormatName-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageWritersByFormatName</h4> <pre>public static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a>&gt; getImageWritersByFormatName(<a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName)</pre>
<div class="block">
            返回一个 
           <code>Iterator</code>包含所有当前已注册的 
           <code>ImageWriter</code> ，声称能够对命名格式进行编码。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>formatName</code> - 一个 
            <code>String</code>格式的非正式名称（ 
            <i>例如</i> “jpeg”或“tiff”）的 
            <code>String</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Iterator</code>包含 
            <code>ImageWriter</code> s。 
           </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>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/spi/ImageReaderWriterSpi.html#getFormatNames--"><code>ImageReaderWriterSpi.getFormatNames()</code></a>
</dd>
</dl> </li>
</ul> <a name="getImageWritersBySuffix-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageWritersBySuffix</h4> <pre>public static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a>&gt; getImageWritersBySuffix(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fileSuffix)</pre>
<div class="block">
            返回一个 
           <code>Iterator</code>所有当前注册的ImageWriter的 
           <code>ImageWriter</code> ，声称能够使用给定的后缀对文件进行编码。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>fileSuffix</code> - 包含文件后缀（ 
            <i>例如</i> “jpg”或“tiff”）的 
            <code>String</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Iterator</code>包含 
            <code>ImageWriter</code> s。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>fileSuffix</code>是 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/spi/ImageReaderWriterSpi.html#getFileSuffixes--"><code>ImageReaderWriterSpi.getFileSuffixes()</code></a>
</dd>
</dl> </li>
</ul> <a name="getImageWritersByMIMEType-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageWritersByMIMEType</h4> <pre>public static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a>&gt; getImageWritersByMIMEType(<a href="../../java/lang/String.html" title="class in java.lang">String</a> MIMEType)</pre>
<div class="block">
            返回一个 
           <code>Iterator</code>包含所有当前已注册的 
           <code>ImageWriter</code> ，声称能够使用给定的MIME类型对文件进行编码。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>MIMEType</code> - 包含文件后缀的 
            <code>String</code> （ 
            <i>例如</i> ，“image / jpeg”或“image / x-bmp”）。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Iterator</code>包含 
            <code>ImageWriter</code> s。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>MIMEType</code>是 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/spi/ImageReaderWriterSpi.html#getMIMETypes--"><code>ImageReaderWriterSpi.getMIMETypes()</code></a>
</dd>
</dl> </li>
</ul> <a name="getImageWriter-javax.imageio.ImageReader-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageWriter</h4> <pre>public static <a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a> getImageWriter(<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a> reader)</pre>
<div class="block">
<span>返回<code>ImageWriter</code>对应于给定的<code>ImageReader</code> ，如果有一个，或<code>null</code>如果这个<code>ImageReader</code>的插件没有指定相应的<code>ImageWriter</code> ，或者如果给定的<code>ImageReader</code>没有注册。</span>
<span>该机制可用于获得<code>ImageWriter</code> ，该<code>ImageWriter</code>将了解由ImageReader生成的非像素元数据（由<code>IIOMetadata</code>对象编码）的内部<code>ImageReader</code> 。</span>
<span>通过从获得该数据<code>ImageReader</code>并将其传递到<code>ImageWriter</code>用这种方法获得的，客户端程序可以读取图像，修改它以某种方式，再写回同时保留所有的元数据，而无需了解有关任何结构的元数据，甚至关于图像格式。</span>
<span>请注意，此方法返回“首选”作者，它是由<code>javax.imageio.spi.ImageReaderSpi.getImageWriterSpiNames()</code>返回的列表中的第一个。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reader</code> - 注册的一个实例 
            <code>ImageReader</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>ImageWriter</code> ，或null。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>reader</code>是 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageIO.html#getImageReader-javax.imageio.ImageWriter-"><code>getImageReader(ImageWriter)</code></a> ， 
            <a href="../../javax/imageio/spi/ImageReaderSpi.html#getImageWriterSpiNames--"><code>ImageReaderSpi.getImageWriterSpiNames()</code></a>
</dd>
</dl> </li>
</ul> <a name="getImageReader-javax.imageio.ImageWriter-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageReader</h4> <pre>public static <a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a> getImageReader(<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a> writer)</pre>
<div class="block">
<span>返回一个<code>ImageReader</code>对应于给定的<code>ImageWriter</code> ，如果有一个，或<code>null</code>如果这个<code>ImageWriter</code>的插件没有指定相应的<code>ImageReader</code> ，或者如果给定的<code>ImageWriter</code>没有注册。</span>
<span>该方法主要用于与<code>getImageWriter(ImageReader)</code>对称。</span>
<span>请注意，此方法返回“首选”阅读器，它是javax.imageio.spi.ImageWriterSpi返回的列表中的第一个。</span>
<span><code>getImageReaderSpiNames()</code> 。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>writer</code> - 注册的一个实例 
            <code>ImageWriter</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>ImageReader</code> ，或null。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>writer</code>是 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/ImageIO.html#getImageWriter-javax.imageio.ImageReader-"><code>getImageWriter(ImageReader)</code></a> ， 
            <a href="../../javax/imageio/spi/ImageWriterSpi.html#getImageReaderSpiNames--"><code>ImageWriterSpi.getImageReaderSpiNames()</code></a>
</dd>
</dl> </li>
</ul> <a name="getImageWriters-javax.imageio.ImageTypeSpecifier-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageWriters</h4> <pre>public static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a>&gt; getImageWriters(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> type,
                                                    <a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName)</pre>
<div class="block">
            返回一个 
           <code>Iterator</code>包含所有当前已注册的 
           <code>ImageWriter</code> ，声称能够以给定格式对给定布局（使用 
           <code>ImageTypeSpecifier</code> ）的图像进行编码。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>type</code> - 
            <code>ImageTypeSpecifier</code>要写入的图像的布局的ImageTypeSpecifier。 
           </dd>
<dd>
<code>formatName</code> - 非正式名称的 
            <code>format</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Iterator</code>包含 
            <code>ImageWriter</code> s。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果任何参数是 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/spi/ImageWriterSpi.html#canEncodeImage-javax.imageio.ImageTypeSpecifier-"><code>ImageWriterSpi.canEncodeImage(ImageTypeSpecifier)</code></a>
</dd>
</dl> </li>
</ul> <a name="getImageTranscoders-javax.imageio.ImageReader-javax.imageio.ImageWriter-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImageTranscoders</h4> <pre>public static <a href="../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../javax/imageio/ImageTranscoder.html" title="interface in javax.imageio">ImageTranscoder</a>&gt; getImageTranscoders(<a href="../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a> reader,
                                                            <a href="../../javax/imageio/ImageWriter.html" title="class in javax.imageio">ImageWriter</a> writer)</pre>
<div class="block">
            返回一个 
           <code>Iterator</code>包含所有当前注册的 
           <code>ImageTranscoder</code> s，声称能够在给定的 
           <code>ImageReader</code>和 
           <code>ImageWriter</code>的元数据之间进行 
           <code>ImageReader</code>
<code>ImageWriter</code> 。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reader</code> - 
            <code>ImageReader</code> 。 
           </dd>
<dd>
<code>writer</code> - 一个 
            <code>ImageWriter</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Iterator</code>包含 
            <code>ImageTranscoder</code> s。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>reader</code>或 
            <code>writer</code>是 
            <code>null</code> 。 
           </dd>
</dl> </li>
</ul> <a name="read-java.io.File-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>read</h4> <pre>public static <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> read(<a href="../../java/io/File.html" title="class in java.io">File</a> input)
                          throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回<code>BufferedImage</code>作为供给的解码结果<code>File</code>与<code>ImageReader</code>选自目前登记的那些自动选择。</span>
<span><code>File</code>被包裹在一个<code>ImageInputStream</code> 。</span>
<span>如果没有注册的<code>ImageReader</code>声称能够读取结果流，则返回<code>null</code> 。</span>
<p> <span><code>getUseCache</code>和<code>getCacheDirectory</code>的当前缓存设置将用于在创建的<code>ImageInputStream</code>中控制缓存。</span> </p>
<p> <span>请注意，没有<code>read</code>方法将文件名称为<code>String</code> ;</span> <span>在从文件名创建<code>File</code>后，使用此方法。</span> </p>
<p> <span>此方法不试图定位<code>ImageReader</code> s表示可直接从读<code>File</code> ;</span> <span>这可以使用<code>IIORegistry</code>和<code>ImageReaderSpi</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>input</code> - a 
            <code>File</code>要阅读。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>BufferedImage</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>input</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-java.io.InputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>read</h4> <pre>public static <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> read(<a href="../../java/io/InputStream.html" title="class in java.io">InputStream</a> input)
                          throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回<code>BufferedImage</code>作为供给的解码结果<code>InputStream</code>与<code>ImageReader</code>选自目前登记的那些自动选择。</span>
<span><code>InputStream</code>包裹在一个<code>ImageInputStream</code> 。</span>
<span>如果没有注册的<code>ImageReader</code>声称能够读取结果流，则返回<code>null</code> 。</span>
<p> <span><code>getUseCache</code>和<code>getCacheDirectory</code>的当前缓存设置将用于在创建的<code>ImageInputStream</code>中控制缓存。</span> </p>
<p> <span>此方法不试图定位<code>ImageReader</code> s表示可以直接从读取<code>InputStream</code> ;</span> <span>这可以使用<code>IIORegistry</code>和<code>ImageReaderSpi</code> 。</span> </p>
<p> <span>读取操作<code>InputStream</code>后，此方法<em>不</em>关闭提供的InputStream;</span> <span>如果需要，呼叫者有责任关闭流。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>input</code> - 一个 
            <code>InputStream</code>读取。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>BufferedImage</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>input</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-java.net.URL-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>read</h4> <pre>public static <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> read(<a href="../../java/net/URL.html" title="class in java.net">URL</a> input)
                          throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回<code>BufferedImage</code>作为供给的解码结果<code>URL</code>与<code>ImageReader</code>选自目前登记的那些自动选择。</span>
<span>一个<code>InputStream</code>从得到的<code>URL</code> ，其被包裹在一个<code>ImageInputStream</code> 。</span>
<span>如果没有注册的<code>ImageReader</code>声称能够读取结果流，则返回<code>null</code> 。</span>
<p> <span><code>getUseCache</code>和<code>getCacheDirectory</code>的当前缓存设置将用于在创建的<code>ImageInputStream</code>中控制缓存。</span> </p>
<p> <span>此方法不试图定位<code>ImageReader</code> s表示可直接从读<code>URL</code> ;</span> <span>这可以使用<code>IIORegistry</code>和<code>ImageReaderSpi</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>input</code> - a 
            <code>URL</code>读取。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>BufferedImage</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>input</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-javax.imageio.stream.ImageInputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>read</h4> <pre>public static <a href="../../java/awt/image/BufferedImage.html" title="class in java.awt.image">BufferedImage</a> read(<a href="../../javax/imageio/stream/ImageInputStream.html" title="interface in javax.imageio.stream">ImageInputStream</a> stream)
                          throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回<code>BufferedImage</code>作为供给的解码结果<code>ImageInputStream</code>与<code>ImageReader</code>选自目前登记的那些自动选择。</span>
<span>如果没有注册<code>ImageReader</code>声称能够读取流，则返回<code>null</code> 。</span>
<p> <span>与此类中的大多数其他的方法，这种方法<em>并</em>关闭提供<code>ImageInputStream</code>读操作完成后，除非<code>null</code>返回，在这种情况下，该方法<em>不会</em>关闭该流。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</code> - 一个 
            <code>ImageInputStream</code>要阅读。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>BufferedImage</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>stream</code>是 
            <code>null</code> 。 
           </dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 读取时是否发生错误。 
           </dd>
</dl> </li>
</ul> <a name="write-java.awt.image.RenderedImage-java.lang.String-javax.imageio.stream.ImageOutputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>write</h4> <pre>public static boolean write(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> im,
                            <a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName,
                            <a href="../../javax/imageio/stream/ImageOutputStream.html" title="interface in javax.imageio.stream">ImageOutputStream</a> output)
                     throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>使用支持给定格式的任意<code>ImageWriter</code>写入图像到<code>ImageOutputStream</code> 。</span>
<span>图像将从当前流指针开始写入<code>ImageOutputStream</code> ，如果存在，则从该点向前覆盖现有流数据。</span>
<p> <span>此方法<em>不会</em>关闭提供<code>ImageOutputStream</code>写操作后已完成;</span> <span>如果需要，呼叫者有责任关闭流。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>im</code> - a 
            <code>RenderedImage</code>待写。 
           </dd>
<dd>
<code>formatName</code> - 一个 
            <code>String</code>格式的非正式名称的String。 
           </dd>
<dd>
<code>output</code> - 
            <code>ImageOutputStream</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>false</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>null</code> 。 
           </dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。 
           </dd>
</dl> </li>
</ul> <a name="write-java.awt.image.RenderedImage-java.lang.String-java.io.File-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>write</h4> <pre>public static boolean write(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> im,
                            <a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName,
                            <a href="../../java/io/File.html" title="class in java.io">File</a> output)
                     throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>使用支持给定格式的任意<code>ImageWriter</code>写入图像到<code>File</code> 。</span>
<span>如果已经存在<code>File</code> ，其内容将被丢弃。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>im</code> - a 
            <code>RenderedImage</code>待写。 
           </dd>
<dd>
<code>formatName</code> - 一个 
            <code>String</code>格式的非正式名称的String。 
           </dd>
<dd>
<code>output</code> - 
            <code>File</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>false</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>null</code> 。 
           </dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。 
           </dd>
</dl> </li>
</ul> <a name="write-java.awt.image.RenderedImage-java.lang.String-java.io.OutputStream-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>write</h4> <pre>public static boolean write(<a href="../../java/awt/image/RenderedImage.html" title="interface in java.awt.image">RenderedImage</a> im,
                            <a href="../../java/lang/String.html" title="class in java.lang">String</a> formatName,
                            <a href="../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> output)
                     throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>使用支持给定格式的任意<code>ImageWriter</code>写入图像到<code>OutputStream</code> 。</span>
<p> <span>此方法<em>不会</em>关闭提供<code>OutputStream</code>写操作后已完成;</span> <span>如果需要，呼叫者有责任关闭流。</span> </p>
<p> <span><code>getUseCache</code>和<code>getCacheDirectory</code>的当前缓存设置将用于控制缓存。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>im</code> - a 
            <code>RenderedImage</code>待写。 
           </dd>
<dd>
<code>formatName</code> - 一个 
            <code>String</code>格式的非正式名称的String。 
           </dd>
<dd>
<code>output</code> - 
            <code>OutputStream</code> 。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>false</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>null</code> 。 
           </dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 写入时是否发生错误。 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>