Module java.desktop

Package javax.imageio.plugins.tiff

Class TIFFImageReadParam

java.lang.Object

javax.imageio.IIOParam

javax.imageio.ImageReadParam

javax.imageio.plugins.tiff.TIFFImageReadParam

       public final class TIFFImageReadParam extends ImageReadParam
      

一个继承自ImageReadParam的子类，允许控制TIFF读取过程。

由于TIFF是一种可扩展格式，读取器需要关于TIFF扩展使用的任何标签的信息，以便发出有意义的元数据。此接口可以提供有关扩展的两种信息：标签和压缩类型。

额外的TIFF标签必须组织到TIFFTagSet中。可以通过addAllowedTagSet方法将TIFFTagSet提供给读取器。默认情况下，包括标签集BaselineTIFFTagSet、FaxTIFFTagSet、ExifParentTIFFTagSet和GeoTIFFTagSet。

可以通过setReadUnknownTags来强制读取与任何允许的TIFFTagSet不匹配的TIFFTag对应的字段。

自：

9

Field Summary

Fields declared in class javax.imageio.ImageReadParam

canSetSourceRenderSize, destination, destinationBands, minProgressivePass, numProgressivePasses, sourceRenderSize

Fields declared in class javax.imageio.IIOParam

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

Constructor Summary

Constructors

Constructor	Description
TIFFImageReadParam()	构造一个TIFFImageReadParam。

Method Summary

Modifier and Type	Method	Description
void	addAllowedTagSet(TIFFTagSet tagSet)	将一个TIFFTagSet对象添加到允许的标签集列表中。
List<TIFFTagSet>	getAllowedTagSets()	返回一个包含允许的TIFFTagSet对象的List。
boolean	getReadUnknownTags()	检索是否读取与未知TIFFTag对应的字段的设置。
void	removeAllowedTagSet(TIFFTagSet tagSet)	从允许的标签集列表中移除一个TIFFTagSet对象。
void	setReadUnknownTags(boolean readUnknownTags)	设置是否读取与未知TIFFTag对应的字段，而不在允许的TIFFTagSet中。

Methods declared in class javax.imageio.ImageReadParam

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

Methods declared in class javax.imageio.IIOParam

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

Methods declared in class java.lang.Object

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

Constructor Details

TIFFImageReadParam

             public TIFFImageReadParam()
            

构造一个TIFFImageReadParam。由TIFFTagSet定义的标签集BaselineTIFFTagSet、FaxTIFFTagSet、ExifParentTIFFTagSet和GeoTIFFTagSet将被支持。

参见：

• BaselineTIFFTagSet
• FaxTIFFTagSet
• ExifParentTIFFTagSet
• GeoTIFFTagSet

Method Details

addAllowedTagSet

             public void addAllowedTagSet(TIFFTagSet tagSet)
            

将一个TIFFTagSet对象添加到允许的标签集列表中。尝试添加重复对象到列表不会产生任何效果。

参数：

tagSet - 一个TIFFTagSet。

抛出：

IllegalArgumentException - 如果tagSet为null。

removeAllowedTagSet

             public void removeAllowedTagSet(TIFFTagSet tagSet)
            

从允许的标签集列表中移除一个TIFFTagSet对象。移除基于TIFFTagSet的equals方法，通常定义为引用相等。

参数：

tagSet - 一个TIFFTagSet。

抛出：

IllegalArgumentException - 如果tagSet为null。

getAllowedTagSets

             public List<TIFFTagSet> getAllowedTagSets()
            

返回一个包含允许的TIFFTagSet对象的List。

返回：

一个TIFFTagSet的List。

setReadUnknownTags

             public void setReadUnknownTags(boolean readUnknownTags)
            

设置是否读取与未知TIFFTag对应的字段，而不在允许的TIFFTagSet中。默认设置为false。如果TIFF ImageReader正在忽略元数据，则设置为true会被覆盖，除了对读取图像本身至关重要的元数据外，所有元数据都将被忽略。

参数：

readUnknownTags - 是否读取未知标签的字段

getReadUnknownTags

             public boolean getReadUnknownTags()
            

检索是否读取与未知TIFFTag对应的字段的设置。

返回：

是否读取未知标签的字段