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

580 lines
39 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.plugins.jpeg
</div>
<h2 class="title" title="Class JPEGImageWriteParam">Class JPEGImageWriteParam</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../../javax/imageio/IIOParam.html" title="class in javax.imageio">javax.imageio.IIOParam</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">javax.imageio.ImageWriteParam</a></li>
<li>
<ul class="inheritance">
<li>javax.imageio.plugins.jpeg.JPEGImageWriteParam</li>
</ul> </li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public class <span class="typeNameLabel">JPEGImageWriteParam</span>
extends <a href="../../../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a></pre>
<div class="block">
<span>该类增加了在使用内置JPEG writer插件时设置JPEG量化和霍夫曼表的能力，并请求为图像计算优化的霍夫曼表。</span>
<span>该类的一个实例将从内置JPEG <code>ImageWriter</code>的<code>getDefaultImageWriteParam</code>方法返回。</span>
<p> <span>这些添加的主要目的是允许表的规范用于编码缩写的流。</span> <span>内置的JPEG作者也将接受普通的<code>ImageWriteParam</code> ，在这种情况下，作者将在内部构建必要的表格。</span> </p>
<p> <span>在任一种情况下， <code>ImageWriteParam</code>中的质量设置与底层库具有相同的含义：1.00表示全1的量化表，0.75表示“标准”，视觉无损量化表，0.00表示全部255的浓缩表。</span> </p>
<p> <span>虽然缩写流的表格通常首先编写仅包含表格的缩写流来指定，但在某些应用程序中，表格提前固定。</span> <span>该类允许从客户端代码直接指定表。</span> </p>
<p> <span>通常，这些表在传递给写入程序的<code>IIOMetadata</code>对象中指定，并且这些对象中包含的任何表都将写入流中。</span> <span>如果在元数据中没有指定表，则会写入一个缩写的流。</span> <span>如果没有表包括在元数据和没有表在指定的<code>JPEGImageWriteParam</code> ，则缩写流使用的“标准”视觉无损表编码。</span> <span>当必须写入缩写流，而不首先向流中写入任何表时，必须使用此类来指定表。</span> <span>为了使用这个类，传递给写入程序的元数据对象不能包含任何表，也不能提供流元数据。</span> <span>有关默认表的更多信息，请参阅<a href="../../../../javax/imageio/plugins/jpeg/JPEGQTable.html" title="javax.imageio.plugins.jpeg中的类"><code>JPEGQTable</code></a>和<a href="../../../../javax/imageio/plugins/jpeg/JPEGHuffmanTable.html" title="javax.imageio.plugins.jpeg中的类"><code>JPEGHuffmanTable</code></a> 。</span> </p>
<p> <span>默认<code>JPEGImageWriteParam</code>由返回<code>getDefaultWriteParam</code>作家的方法不包含表。</span> <span>默认表包含在作者返回的默认<code>IIOMetadata</code>对象中。</span> </p>
<p> <span>如果元数据包含表，则忽略<code>JPEGImageWriteParam</code>中给出的表。</span> <span>此外，一旦写入了一组表，只有元数据中的表可以覆盖它们以用于后续写入，无论是相同的流还是不同的。</span> <span>为了使用这个类指定新的表，必须调用写入器的<a href="../../../../javax/imageio/ImageWriter.html#reset--"><code>reset</code></a>方法。</span> </p>
<p> <span>有关内置JPEG插件的操作的更多信息，请参阅<a href="../../metadata/doc-files/jpeg_metadata.html">JPEG metadata format specification and usage notes</a> 。</span> </p>
</div> </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>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.imageio.ImageWriteParam">
<!-- --> </a> <h3>Fields inherited from class javax.imageio.<a href="../../../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a></h3> <code><a href="../../../../javax/imageio/ImageWriteParam.html#canOffsetTiles">canOffsetTiles</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#canWriteCompressed">canWriteCompressed</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#canWriteProgressive">canWriteProgressive</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#canWriteTiles">canWriteTiles</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#compressionMode">compressionMode</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#compressionQuality">compressionQuality</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#compressionType">compressionType</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#compressionTypes">compressionTypes</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#locale">locale</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#MODE_COPY_FROM_METADATA">MODE_COPY_FROM_METADATA</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#MODE_DEFAULT">MODE_DEFAULT</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#MODE_DISABLED">MODE_DISABLED</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#MODE_EXPLICIT">MODE_EXPLICIT</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#preferredTileSizes">preferredTileSizes</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#progressiveMode">progressiveMode</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#tileGridXOffset">tileGridXOffset</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#tileGridYOffset">tileGridYOffset</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#tileHeight">tileHeight</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#tileWidth">tileWidth</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#tilingMode">tilingMode</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#tilingSet">tilingSet</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.imageio.IIOParam">
<!-- --> </a> <h3>Fields inherited from class javax.imageio.<a href="../../../../javax/imageio/IIOParam.html" title="class in javax.imageio">IIOParam</a></h3> <code><a href="../../../../javax/imageio/IIOParam.html#controller">controller</a>, <a href="../../../../javax/imageio/IIOParam.html#defaultController">defaultController</a>, <a href="../../../../javax/imageio/IIOParam.html#destinationOffset">destinationOffset</a>, <a href="../../../../javax/imageio/IIOParam.html#destinationType">destinationType</a>, <a href="../../../../javax/imageio/IIOParam.html#sourceBands">sourceBands</a>, <a href="../../../../javax/imageio/IIOParam.html#sourceRegion">sourceRegion</a>, <a href="../../../../javax/imageio/IIOParam.html#sourceXSubsampling">sourceXSubsampling</a>, <a href="../../../../javax/imageio/IIOParam.html#sourceYSubsampling">sourceYSubsampling</a>, <a href="../../../../javax/imageio/IIOParam.html#subsamplingXOffset">subsamplingXOffset</a>, <a href="../../../../javax/imageio/IIOParam.html#subsamplingYOffset">subsamplingYOffset</a></code></li>
</ul> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#JPEGImageWriteParam-java.util.Locale-">JPEGImageWriteParam</a></span>(<a href="../../../../java/util/Locale.html" title="class in java.util">Locale</a> locale)</code>
<div class="block">
构造一个
<code>JPEGImageWriteParam</code> 。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#areTablesSet--">areTablesSet</a></span>()</code>
<div class="block">
如果表当前设置，则返回
<code>true</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../../javax/imageio/plugins/jpeg/JPEGHuffmanTable.html" title="class in javax.imageio.plugins.jpeg">JPEGHuffmanTable</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#getACHuffmanTables--">getACHuffmanTables</a></span>()</code>
<div class="block">
返回在最近一次调用设置阿克·哈弗曼表的数组的副本
<code>setEncodeTables</code> ，或
<code>null</code>如果表当前没有设置。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<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/plugins/jpeg/JPEGImageWriteParam.html#getCompressionQualityDescriptions--">getCompressionQualityDescriptions</a></span>()</code>
<div class="block">
返回一个可以与
<code>getCompressionQualityValues</code>一起使用的
<code>String</code> s数组，作为设置或显示压缩质量级别的用户界面的一部分。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>float[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#getCompressionQualityValues--">getCompressionQualityValues</a></span>()</code>
<div class="block">
返回一个
<code>float</code>的数组，可以与
<code>getCompressionQualityDescriptions</code>一起使用，作为设置或显示压缩质量级别的用户界面的一部分。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../../javax/imageio/plugins/jpeg/JPEGHuffmanTable.html" title="class in javax.imageio.plugins.jpeg">JPEGHuffmanTable</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#getDCHuffmanTables--">getDCHuffmanTables</a></span>()</code>
<div class="block">
返回在最近一次调用设置为德克·哈弗曼表的数组的副本
<code>setEncodeTables</code> ，或
<code>null</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/plugins/jpeg/JPEGImageWriteParam.html#getOptimizeHuffmanTables--">getOptimizeHuffmanTables</a></span>()</code>
<div class="block">
如果
<code>setOptimizeHuffmanTables</code>从未被调用，则返回传递给最近调用
<code>setOptimizeHuffmanTables</code>的值或
<code>false</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../../javax/imageio/plugins/jpeg/JPEGQTable.html" title="class in javax.imageio.plugins.jpeg">JPEGQTable</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#getQTables--">getQTables</a></span>()</code>
<div class="block">
返回在最近一次调用设置的量化表所组成数组的一个副本
<code>setEncodeTables</code> ，或
<code>null</code>如果表当前没有设置。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#isCompressionLossless--">isCompressionLossless</a></span>()</code>
<div class="block">
返回
<code>false</code>因为JPEG插件仅支持有损压缩。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#setEncodeTables-javax.imageio.plugins.jpeg.JPEGQTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-">setEncodeTables</a></span>(<a href="../../../../javax/imageio/plugins/jpeg/JPEGQTable.html" title="class in javax.imageio.plugins.jpeg">JPEGQTable</a>[] qTables, <a href="../../../../javax/imageio/plugins/jpeg/JPEGHuffmanTable.html" title="class in javax.imageio.plugins.jpeg">JPEGHuffmanTable</a>[] DCHuffmanTables, <a href="../../../../javax/imageio/plugins/jpeg/JPEGHuffmanTable.html" title="class in javax.imageio.plugins.jpeg">JPEGHuffmanTable</a>[] ACHuffmanTables)</code>
<div class="block">
设置用于编码缩写流的量化和霍夫曼表。
</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/plugins/jpeg/JPEGImageWriteParam.html#setOptimizeHuffmanTables-boolean-">setOptimizeHuffmanTables</a></span>(boolean optimize)</code>
<div class="block">
告诉作者为写入过程的一部分，为图像生成优化的霍夫曼表。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#unsetCompression--">unsetCompression</a></span>()</code>
<div class="block">
删除任何以前的压缩质量设置。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#unsetEncodeTables--">unsetEncodeTables</a></span>()</code>
<div class="block">
删除当前设置的任何量化和霍夫曼表。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.imageio.ImageWriteParam">
<!-- --> </a> <h3>Methods inherited from class javax.imageio.<a href="../../../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a></h3> <code><a href="../../../../javax/imageio/ImageWriteParam.html#canOffsetTiles--">canOffsetTiles</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#canWriteCompressed--">canWriteCompressed</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#canWriteProgressive--">canWriteProgressive</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#canWriteTiles--">canWriteTiles</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getBitRate-float-">getBitRate</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionMode--">getCompressionMode</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionQuality--">getCompressionQuality</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionType--">getCompressionType</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionTypes--">getCompressionTypes</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getLocale--">getLocale</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getLocalizedCompressionTypeName--">getLocalizedCompressionTypeName</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getPreferredTileSizes--">getPreferredTileSizes</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getProgressiveMode--">getProgressiveMode</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getTileGridXOffset--">getTileGridXOffset</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getTileGridYOffset--">getTileGridYOffset</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getTileHeight--">getTileHeight</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getTileWidth--">getTileWidth</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#getTilingMode--">getTilingMode</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#setCompressionMode-int-">setCompressionMode</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#setCompressionQuality-float-">setCompressionQuality</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#setCompressionType-java.lang.String-">setCompressionType</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#setProgressiveMode-int-">setProgressiveMode</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#setTiling-int-int-int-int-">setTiling</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#setTilingMode-int-">setTilingMode</a>, <a href="../../../../javax/imageio/ImageWriteParam.html#unsetTiling--">unsetTiling</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.imageio.IIOParam">
<!-- --> </a> <h3>Methods inherited from class javax.imageio.<a href="../../../../javax/imageio/IIOParam.html" title="class in javax.imageio">IIOParam</a></h3> <code><a href="../../../../javax/imageio/IIOParam.html#activateController--">activateController</a>, <a href="../../../../javax/imageio/IIOParam.html#getController--">getController</a>, <a href="../../../../javax/imageio/IIOParam.html#getDefaultController--">getDefaultController</a>, <a href="../../../../javax/imageio/IIOParam.html#getDestinationOffset--">getDestinationOffset</a>, <a href="../../../../javax/imageio/IIOParam.html#getDestinationType--">getDestinationType</a>, <a href="../../../../javax/imageio/IIOParam.html#getSourceBands--">getSourceBands</a>, <a href="../../../../javax/imageio/IIOParam.html#getSourceRegion--">getSourceRegion</a>, <a href="../../../../javax/imageio/IIOParam.html#getSourceXSubsampling--">getSourceXSubsampling</a>, <a href="../../../../javax/imageio/IIOParam.html#getSourceYSubsampling--">getSourceYSubsampling</a>, <a href="../../../../javax/imageio/IIOParam.html#getSubsamplingXOffset--">getSubsamplingXOffset</a>, <a href="../../../../javax/imageio/IIOParam.html#getSubsamplingYOffset--">getSubsamplingYOffset</a>, <a href="../../../../javax/imageio/IIOParam.html#hasController--">hasController</a>, <a href="../../../../javax/imageio/IIOParam.html#setController-javax.imageio.IIOParamController-">setController</a>, <a href="../../../../javax/imageio/IIOParam.html#setDestinationOffset-java.awt.Point-">setDestinationOffset</a>, <a href="../../../../javax/imageio/IIOParam.html#setDestinationType-javax.imageio.ImageTypeSpecifier-">setDestinationType</a>, <a href="../../../../javax/imageio/IIOParam.html#setSourceBands-int:A-">setSourceBands</a>, <a href="../../../../javax/imageio/IIOParam.html#setSourceRegion-java.awt.Rectangle-">setSourceRegion</a>, <a href="../../../../javax/imageio/IIOParam.html#setSourceSubsampling-int-int-int-int-">setSourceSubsampling</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../../java/lang/Object.html#toString--">toString</a>, <a href="../../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="JPEGImageWriteParam-java.util.Locale-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>JPEGImageWriteParam</h4> <pre>public JPEGImageWriteParam(<a href="../../../../java/util/Locale.html" title="class in java.util">Locale</a> locale)</pre>
<div class="block">
<span>构造一个<code>JPEGImageWriteParam</code> 。</span>
<span>不支持平铺。</span>
<span>支持逐行编码。</span>
<span>默认逐行模式为MODE_DISABLED。</span>
<span>支持单一形式的压缩，名为“JPEG”。</span>
<span>默认压缩质量为0.75。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>locale</code> -一个
<code>Locale</code>由超类用于本地化压缩类型名称和质量描述，或
<code>null</code> 。
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="unsetCompression--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>unsetCompression</h4> <pre>public void unsetCompression()</pre>
<div class="block">
<span>删除任何以前的压缩质量设置。</span>
<p> <span>默认实现将压缩质量重置为<code>0.75F</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../../../javax/imageio/ImageWriteParam.html#unsetCompression--">unsetCompression</a></code>在
<code><a href="../../../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a></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>MODE_EXPLICIT</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/imageio/ImageWriteParam.html#setCompressionType-java.lang.String-"><code>ImageWriteParam.setCompressionType(java.lang.String)</code></a> ，
<a href="../../../../javax/imageio/ImageWriteParam.html#setCompressionQuality-float-"><code>ImageWriteParam.setCompressionQuality(float)</code></a>
</dd>
</dl> </li>
</ul> <a name="isCompressionLossless--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isCompressionLossless</h4> <pre>public boolean isCompressionLossless()</pre>
<div class="block">
返回
<code>false</code>因为JPEG插件仅支持有损压缩。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../../../javax/imageio/ImageWriteParam.html#isCompressionLossless--">isCompressionLossless</a></code>在
<code><a href="../../../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a></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/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果压缩模式不是
<code>MODE_EXPLICIT</code> 。
</dd>
</dl> </li>
</ul> <a name="getCompressionQualityDescriptions--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCompressionQualityDescriptions</h4> <pre>public <a href="../../../../java/lang/String.html" title="class in java.lang">String</a>[] getCompressionQualityDescriptions()</pre>
<div class="block">
<span class="descfrmTypeLabel">描述从类别复制： <code><a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionQualityDescriptions--">ImageWriteParam</a></code></span>
</div>
<div class="block">
<span>返回的数组<code>String</code>可与被用于沿小号<code>getCompressionQualityValues</code>作为用户接口，用于设置或显示压缩质量级别的一部分。</span>
<span><code>String</code> ，索引<code>i</code>提供了<code>getCompressionQualityValues[i]</code>和<code>getCompressionQualityValues[i + 1]</code>之间的质量范围的<code>getCompressionQualityValues[i + 1]</code> 。</span>
<span>需要注意的是阵列的长度从返回<code>getCompressionQualityValues</code>将始终是一个大于从返回<code>getCompressionQualityDescriptions</code> 。</span>
<p> <span>作为一个例子，字符串“好”，“较好”和“最佳”可与范围相关<code>[0, .33)</code> ， <code>[.33, .66)</code>和<code>[.66, 1.0]</code> 。</span> <span>在这种情况下， <code>getCompressionQualityDescriptions</code>将返回<code>{ "Good", "Better", "Best" }</code>和<code>getCompressionQualityValues</code>将返回<code>{ 0.0F, .33F, .66F, 1.0F }</code> 。</span> </p>
<p> <span>如果没有可用的描述，则返回<code>null</code> 。</span> <span>如果<code>null</code>从<code>getCompressionQualityValues</code>返回，此方法也必须返回<code>null</code> 。</span> </p>
<p> <span>这些描述应该是本地化的<code>Locale</code>返回的<code>getLocale</code> ，如果它是非<code>null</code> 。</span> </p>
<p> <span>如果有多种压缩类型，但没有设置，则会抛出<code>IllegalStateException</code> 。</span> </p>
<p> <span>默认实现检查压缩是否受支持，压缩模式是<code>MODE_EXPLICIT</code> 。</span> <span>如果是，如果<code>getCompressionTypes()</code>是<code>null</code>或<code>getCompressionType()</code>是非<code>null</code> ，它返回<code>null</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionQualityDescriptions--">getCompressionQualityDescriptions</a></code>在
<code><a href="../../../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一组
<code>String</code> s包含压缩质量等级的本地化描述。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionQualityValues--"><code>ImageWriteParam.getCompressionQualityValues()</code></a>
</dd>
</dl> </li>
</ul> <a name="getCompressionQualityValues--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCompressionQualityValues</h4> <pre>public float[] getCompressionQualityValues()</pre>
<div class="block">
<span class="descfrmTypeLabel">描述从类别复制： <code><a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionQualityValues--">ImageWriteParam</a></code></span>
</div>
<div class="block">
<span>返回的数组<code>float</code>可与被用于沿小号<code>getCompressionQualityDescriptions</code>作为用户接口，用于设置或显示压缩质量级别的一部分。</span>
<span>见<a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionQualityDescriptions--"><code>getCompressionQualityDescriptions</code></a>以获取更多信息。</span>
<p> <span>如果没有可用的描述，则返回<code>null</code> 。</span> <span>如果<code>null</code>从<code>getCompressionQualityDescriptions</code>返回，此方法也必须返回<code>null</code> 。</span> </p>
<p> <span>如果有多种压缩类型，但没有设置，则会抛出一个<code>IllegalStateException</code> 。</span> </p>
<p> <span>默认实现检查压缩是否受支持，压缩模式是<code>MODE_EXPLICIT</code> 。</span> <span>如果是，如果<code>getCompressionTypes()</code>是<code>null</code>或<code>getCompressionType()</code>是非<code>null</code> ，它返回<code>null</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionQualityValues--">getCompressionQualityValues</a></code>在
<code><a href="../../../../javax/imageio/ImageWriteParam.html" title="class in javax.imageio">ImageWriteParam</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>float</code>的数组表示压缩质量水平之间的界限，如String的
<code>String</code>
<code>getCompressionQualityDescriptions</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/imageio/ImageWriteParam.html#getCompressionQualityDescriptions--"><code>ImageWriteParam.getCompressionQualityDescriptions()</code></a>
</dd>
</dl> </li>
</ul> <a name="areTablesSet--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>areTablesSet</h4> <pre>public boolean areTablesSet()</pre>
<div class="block">
如果表当前设置，则返回
<code>true</code> 。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果表存在。
</dd>
</dl> </li>
</ul> <a name="setEncodeTables-javax.imageio.plugins.jpeg.JPEGQTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setEncodeTables</h4> <pre>public void setEncodeTables(<a href="../../../../javax/imageio/plugins/jpeg/JPEGQTable.html" title="class in javax.imageio.plugins.jpeg">JPEGQTable</a>[] qTables,
<a href="../../../../javax/imageio/plugins/jpeg/JPEGHuffmanTable.html" title="class in javax.imageio.plugins.jpeg">JPEGHuffmanTable</a>[] DCHuffmanTables,
<a href="../../../../javax/imageio/plugins/jpeg/JPEGHuffmanTable.html" title="class in javax.imageio.plugins.jpeg">JPEGHuffmanTable</a>[] ACHuffmanTables)</pre>
<div class="block">
<span>设置用于编码缩写流的量化和霍夫曼表。</span>
<span>每种类型最多可能有4个表。</span>
<span>如果在元数据中指定了表，则忽略这些表。</span>
<span>所有参数必须为非<code>null</code> 。</span>
<span>霍夫曼表的两个阵列必须具有相同数量的元素。</span>
<span>假定元数据中的帧和扫描头中的表格符号等同于这些数组中的索引。</span>
<span>参数数组由此方法复制。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>qTables</code> - 量化表对象数组。
</dd>
<dd>
<code>DCHuffmanTables</code> - 一个霍夫曼表对象数组。
</dd>
<dd>
<code>ACHuffmanTables</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>或有超过4个元素，或者DC和AC表的数量不同。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#unsetEncodeTables--"><code>unsetEncodeTables()</code></a>
</dd>
</dl> </li>
</ul> <a name="unsetEncodeTables--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>unsetEncodeTables</h4> <pre>public void unsetEncodeTables()</pre>
<div class="block">
删除当前设置的任何量化和霍夫曼表。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#setEncodeTables-javax.imageio.plugins.jpeg.JPEGQTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-"><code>setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])</code></a>
</dd>
</dl> </li>
</ul> <a name="getQTables--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getQTables</h4> <pre>public <a href="../../../../javax/imageio/plugins/jpeg/JPEGQTable.html" title="class in javax.imageio.plugins.jpeg">JPEGQTable</a>[] getQTables()</pre>
<div class="block">
返回在最近一次调用设置的量化表所组成数组的一个副本
<code>setEncodeTables</code> ，或
<code>null</code>如果表当前没有设置。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一组
<code>JPEGQTable</code>对象，或
<code>null</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#setEncodeTables-javax.imageio.plugins.jpeg.JPEGQTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-"><code>setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])</code></a>
</dd>
</dl> </li>
</ul> <a name="getDCHuffmanTables--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDCHuffmanTables</h4> <pre>public <a href="../../../../javax/imageio/plugins/jpeg/JPEGHuffmanTable.html" title="class in javax.imageio.plugins.jpeg">JPEGHuffmanTable</a>[] getDCHuffmanTables()</pre>
<div class="block">
返回在最近调用
<code>setEncodeTables</code>或
<code>null</code>如果表当前未设置）时设置的DC Huffman表数组的副本。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一组
<code>JPEGHuffmanTable</code>对象，或
<code>null</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#setEncodeTables-javax.imageio.plugins.jpeg.JPEGQTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-"><code>setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])</code></a>
</dd>
</dl> </li>
</ul> <a name="getACHuffmanTables--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getACHuffmanTables</h4> <pre>public <a href="../../../../javax/imageio/plugins/jpeg/JPEGHuffmanTable.html" title="class in javax.imageio.plugins.jpeg">JPEGHuffmanTable</a>[] getACHuffmanTables()</pre>
<div class="block">
返回在最近一次调用设置阿克·哈弗曼表的数组的副本
<code>setEncodeTables</code> ，或
<code>null</code>如果表当前没有设置。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一组
<code>JPEGHuffmanTable</code>对象，或
<code>null</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#setEncodeTables-javax.imageio.plugins.jpeg.JPEGQTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-javax.imageio.plugins.jpeg.JPEGHuffmanTable:A-"><code>setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])</code></a>
</dd>
</dl> </li>
</ul> <a name="setOptimizeHuffmanTables-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setOptimizeHuffmanTables</h4> <pre>public void setOptimizeHuffmanTables(boolean optimize)</pre>
<div class="block">
<span>告诉作者为写入过程的一部分，为图像生成优化的霍夫曼表。</span>
<span>默认值为<code>false</code> 。</span>
<span>如果此标志设置为<code>true</code> ，它将覆盖元数据中指定的任何表。</span>
<span>请注意，这意味着使用此标志设置为<code>true</code>任何图像将始终包含霍夫曼表。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>optimize</code> - 一个布尔值，表示写入时是否生成优化的霍夫曼表。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/imageio/plugins/jpeg/JPEGImageWriteParam.html#getOptimizeHuffmanTables--"><code>getOptimizeHuffmanTables()</code></a>
</dd>
</dl> </li>
</ul> <a name="getOptimizeHuffmanTables--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getOptimizeHuffmanTables</h4> <pre>public boolean getOptimizeHuffmanTables()</pre>
<div class="block">
返回传递到最近一次调用的值
<code>setOptimizeHuffmanTables</code> ，或
<code>false</code>如果
<code>setOptimizeHuffmanTables</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/plugins/jpeg/JPEGImageWriteParam.html#setOptimizeHuffmanTables-boolean-"><code>setOptimizeHuffmanTables(boolean)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink