javax.imageio.plugins.jpeg

Class JPEGImageReadParam

java.lang.Object

javax.imageio.IIOParam

javax.imageio.ImageReadParam

javax.imageio.plugins.jpeg.JPEGImageReadParam

public class JPEGImageReadParam
extends ImageReadParam

这类增加时，使用内置的JPEG阅读器插件设置JPEG量化表和赫夫曼的能力。这个类的一个实例将从内置的JPEG ImageReader的 getDefaultImageReadParam方法返回。

这些增加的唯一目的是允许在解码缩写流中使用的表的规范。内置的JPEG的读者也会接受一个普通的ImageReadParam，这是足够的非缩写流解码。

虽然缩写流的表通常是通过先读另一个仅包含表的缩写流来获得的，但在某些应用中，表是固定在时间前面的。这个类允许直接从客户代码中指定的表。如果没有表指定在流中或在JPEGImageReadParam，然后流时使用“标准”视觉无损表。见的默认表的更多信息JPEGQTable和JPEGHuffmanTable。

JPEGImageReadParam返回默认的内置JPEG读者getDefaultReadParam方法不包含任何表。默认的表可以从表类JPEGQTable和JPEGHuffmanTable获得。

如果流不包含表中给出的表格，JPEGImageReadParam忽略。此外，如果流中的第一个图像中包含的表和随后的不包含表，那么在第一图像中给出的表用于所有的缩写图像。一旦表已经从流中读取的，他们可以被重写，只有表从相同的流随后读。为了指定新表，读者的setInput方法来改变流。

请注意，这个类不提供获取流中的表的一种方法。这些可以从流中提取的咨询iiometadata对象由读者返回。

关于内置JPEG插件的操作的更多信息，见JPEG metadata format specification and usage notes。

Field Summary

Fields inherited from class javax.imageio.ImageReadParam

canSetSourceRenderSize, destination, destinationBands, minProgressivePass, numProgressivePasses, sourceRenderSize

Fields inherited from class javax.imageio.IIOParam

controller, defaultController, destinationOffset, destinationType, sourceBands, sourceRegion, sourceXSubsampling, sourceYSubsampling, subsamplingXOffset, subsamplingYOffset

构造方法摘要

构造方法

Constructor and Description
JPEGImageReadParam() 构建了一个 JPEGImageReadParam。

方法摘要

Modifier and Type	Method and Description
boolean	areTablesSet() 返回 true如果表的当前设置。
JPEGHuffmanTable[]	getACHuffmanTables() 返回一个交流赫夫曼的桌子放在地 setDecodeTables最近调用的数组，或 null如果表没有当前设置。
JPEGHuffmanTable[]	getDCHuffmanTables() 返回一个直流赫夫曼表上设置的 setDecodeTables最近调用的数组，或 null如果表没有当前设置。
JPEGQTable[]	getQTables() 返回一个量化表上设置的 setDecodeTables最近调用的数组，或 null如果表没有当前设置。
void	setDecodeTables(JPEGQTable[] qTables, JPEGHuffmanTable[] DCHuffmanTables, JPEGHuffmanTable[] ACHuffmanTables) 设置用于解码流的量化和赫夫曼表略。
void	unsetDecodeTables() 删除任何量化和赫夫曼表的当前设置。

Methods inherited from class javax.imageio.ImageReadParam

canSetSourceRenderSize, getDestination, getDestinationBands, getSourceMaxProgressivePass, getSourceMinProgressivePass, getSourceNumProgressivePasses, getSourceRenderSize, setDestination, setDestinationBands, setDestinationType, setSourceProgressivePasses, setSourceRenderSize

Methods inherited from class javax.imageio.IIOParam

activateController, getController, getDefaultController, getDestinationOffset, getDestinationType, getSourceBands, getSourceRegion, getSourceXSubsampling, getSourceYSubsampling, getSubsamplingXOffset, getSubsamplingYOffset, hasController, setController, setDestinationOffset, setSourceBands, setSourceRegion, setSourceSubsampling

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JPEGImageReadParam

public JPEGImageReadParam()

构建了一个 JPEGImageReadParam。

方法详细信息

areTablesSet

public boolean areTablesSet()

返回 true如果表的当前设置。

结果

true如果表现。

setDecodeTables

public void setDecodeTables(JPEGQTable[] qTables,
                            JPEGHuffmanTable[] DCHuffmanTables,
                            JPEGHuffmanTable[] ACHuffmanTables)

设置用于解码流的量化和赫夫曼表略。可能有一个最大的每个类型的4个表。一旦在流中遇到表，这些表将被忽略。所有参数必须是非 null。两阵赫夫曼表必须有相同数量的元素。在帧表说明符和扫描头在流被认为是相当于索引到这些阵列。该方法复制的参数数组。

参数

qTables -一系列的量化表对象。

DCHuffmanTables -赫夫曼表对象数组。

ACHuffmanTables -赫夫曼表对象数组。

异常

IllegalArgumentException如果任一参数是 null，已超过4元，或者DC和AC表数量不同。

另请参见：

unsetDecodeTables()

unsetDecodeTables

public void unsetDecodeTables()

删除任何量化和赫夫曼表的当前设置。

另请参见：

setDecodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

getQTables

public JPEGQTable[] getQTables()

返回一个量化表上设置的 setDecodeTables最近调用的数组，或 null如果表没有当前设置。

结果

对 JPEGQTable对象的数组，或 null。

另请参见：

setDecodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

getDCHuffmanTables

public JPEGHuffmanTable[] getDCHuffmanTables()

返回一个直流赫夫曼表上设置的 setDecodeTables最近调用的数组，或 null如果表没有当前设置。

结果

对 JPEGHuffmanTable对象的数组，或 null。

另请参见：

setDecodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

getACHuffmanTables

public JPEGHuffmanTable[] getACHuffmanTables()

返回一个交流赫夫曼的桌子放在地 setDecodeTables最近调用的数组，或 null如果表没有当前设置。

结果

对 JPEGHuffmanTable对象的数组，或 null。

另请参见：

setDecodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])