|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
javax.imageio.metadata
类 IIOMetadata
java.lang.Object javax.imageio.metadata.IIOMetadata
-
public abstract class IIOMetadata
- extends Object
将由表示与图像和流关联的元数据(非图像数据)的对象扩展的抽象类。插件表示使用不透明、特定于插件的对象的元数据。但是这些对象提供以 IIOMetadataNode
对象的树的形式访问其内部信息的能力,IIOMetadataNode
对象支持 XML DOM 接口以及用于存储非文本数据和检索关于合法数据值的信息的其他接口。这种树的格式是依赖于插件的,但插件可以选择支持下述插件无关的格式。单个插件可能支持多个元数据格式,这些格式的名称可以通过调用 getMetadataFormatNames
确定。插件还可支持单个特殊格式(叫做“本机”格式),设计用于无损耗地编码其元数据。通常,此格式专门设计用于与特定文件格式一起使用,以便以同一种格式加载和保存图像而不丢失元数据,但是对于在不同图像格式的 ImageReader
和 ImageWriter
之间传输元数据没有多大用途。要像图像文件格式所允许的那样无损耗地在两个本机格式之间转换元数据,必须使用 ImageTranscoder
对象。
- 另请参见:
-
ImageReader.getImageMetadata(int)
,ImageReader.getStreamMetadata()
,ImageReader.readAll(int, javax.imageio.ImageReadParam)
,ImageWriter.getDefaultStreamMetadata(javax.imageio.ImageWriteParam)
,ImageWriter.getDefaultImageMetadata(javax.imageio.ImageTypeSpecifier, javax.imageio.ImageWriteParam)
,ImageWriter.write(javax.imageio.metadata.IIOMetadata, javax.imageio.IIOImage, javax.imageio.ImageWriteParam)
,ImageWriter.convertImageMetadata(javax.imageio.metadata.IIOMetadata, javax.imageio.ImageTypeSpecifier, javax.imageio.ImageWriteParam)
,ImageWriter.convertStreamMetadata(javax.imageio.metadata.IIOMetadata, javax.imageio.ImageWriteParam)
,IIOImage
,ImageTranscoder
字段摘要 | |
---|---|
protected IIOMetadataController |
controller 调用 activateController 方法时,将用来为此 IIOMetadataController 对象提供设置值的 IIOParamController 。 |
protected IIOMetadataController |
defaultController 建议用作此 IIOMetadata 对象的控制器的 IIOMetadataController 。 |
protected String[] |
extraMetadataFormatClassNames 实现 IIOMetadataFormat 和表示此插件支持的元数据格式(标准格式和本机格式除外)的类的名称所组成的数组,初始化为 null ,通过构造方法设置。 |
protected String[] |
extraMetadataFormatNames 此插件支持的格式(标准格式和本机格式除外)的名称所组成的数组,初始化为 null ,通过构造方法设置。 |
protected String |
nativeMetadataFormatClassName 实现 IIOMetadataFormat 和表示本机元数据格式的类的名称,初始化为 null ,通过构造方法设置。 |
protected String |
nativeMetadataFormatName 此对象本机元数据格式的名称,初始化为 null ,通过构造方法设置。 |
protected boolean |
standardFormatSupported 指示具体子类是否支持标准元数据格式的 boolean 值,通过构造方法设置。 |
构造方法摘要 | |
---|---|
protected |
IIOMetadata() 构造一个空的 IIOMetadata 对象。 |
protected |
IIOMetadata(boolean standardMetadataFormatSupported, String nativeMetadataFormatName, String nativeMetadataFormatClassName, String[] extraMetadataFormatNames, String[] extraMetadataFormatClassNames) 构造一个 IIOMetadata 对象,使其带有给定格式名称和格式类名称,以及指示是否支持标准格式的 boolean 值。 |
方法摘要 | |
---|---|
boolean |
activateController() 激活为此 IIOMetadata 对象安装的 IIOMetadataController ,并返回所得到的值。 |
abstract Node |
getAsTree(String formatName) 返回 XML DOM Node 对象,该对象表示此对象所包含的元数据树的根(根据给定元数据格式定义的约定)。 |
IIOMetadataController |
getController() 返回当前已安装的所有 IIOMetadataController 。 |
IIOMetadataController |
getDefaultController() 返回默认 IIOMetadataController (如果有),不考虑当前安装的控制器。 |
String[] |
getExtraMetadataFormatNames() 返回一个 String 数组,包含此插件的 getAsTree 、setFromTree 和 mergeTree 方法可识别的其他元数据格式(本机格式和标准格式除外)的名称。 |
IIOMetadataFormat |
getMetadataFormat(String formatName) 返回描述给定元数据格式的 IIOMetadataFormat 对象,如果没有可用的描述,则返回 null 。 |
String[] |
getMetadataFormatNames() 返回一个 String 数组,包含包括此插件的 getAsTree 、setFromTree 和 mergeTree 方法可识别的所有元数据格式(包括本机格式和标准格式)的名称。 |
String |
getNativeMetadataFormatName() 返回此插件的“本机”元数据格式的名称,该格式通常允许无损失地编码和传输以此插件处理的格式存储的元数据。 |
protected IIOMetadataNode |
getStandardChromaNode() 返回表示标准 javax_imageio_1.0 元数据格式的色度信息的 IIOMetadataNode ;如果没有可用的此类信息,则返回 null 。 |
protected IIOMetadataNode |
getStandardCompressionNode() 返回表示标准 javax_imageio_1.0 元数据格式的压缩信息的 IIOMetadataNode ;如果没有可用的此类信息,则返回 null 。 |
protected IIOMetadataNode |
getStandardDataNode() 返回表示标准 javax_imageio_1.0 元数据格式的数据格式信息的 IIOMetadataNode ;如果没有可用的此类信息,则返回 null 。 |
protected IIOMetadataNode |
getStandardDimensionNode() 返回表示标准 javax_imageio_1.0 元数据格式的维度信息的 IIOMetadataNode ;如果没有可用的此类信息,则返回 null 。 |
protected IIOMetadataNode |
getStandardDocumentNode() 返回表示标准 javax_imageio_1.0 元数据格式的文档信息的 IIOMetadataNode ;如果没有可用的此类信息,则返回 null 。 |
protected IIOMetadataNode |
getStandardTextNode() 返回表示标准 javax_imageio_1.0 元数据格式的文本信息的 IIOMetadataNode ;如果没有可用的此类信息,则返回 null 。 |
protected IIOMetadataNode |
getStandardTileNode() 返回表示标准 javax_imageio_1.0 元数据格式的平铺信息的 IIOMetadataNode ;如果没有可用的此类信息,则返回 null 。 |
protected IIOMetadataNode |
getStandardTransparencyNode() 返回表示标准 javax_imageio_1.0 元数据格式的透明度信息的 IIOMetadataNode ;如果没有可用的此类信息,则返回 null 。 |
protected IIOMetadataNode |
getStandardTree() 返回表示此对象中所包含元数据的 IIOMetadataNode 的树(根据标准 javax_imageio_1.0 元数据格式的约定)的实用方法。 |
boolean |
hasController() 如果存在为此 IIOMetadata 对象安装的控制器,则返回 true 。 |
abstract boolean |
isReadOnly() 如果此对象不支持 mergeTree 、setFromTree 和 reset 方法,则返回 true 。 |
boolean |
isStandardMetadataFormatSupported() 如果 getMetadataFormat 、getAsTree 、setFromTree 和 mergeTree 支持标准元数据格式,则返回 true 。 |
abstract void |
mergeTree(String formatName, Node root) 根据 XML DOM Node 树(其语法由给定元数据格式定义)改变此 IIOMetadata 对象的内部状态。 |
abstract void |
reset() 将此对象中存储的所有数据重置为默认值,通常为此对象构造后立即处于的状态,尽管精确的语义是特定于插件的。 |
void |
setController(IIOMetadataController controller) 设置在调用 activateController 方法时用来为此 IIOParam 对象提供设置值的 IIOMetadataController ,重写任何默认控制器。 |
void |
setFromTree(String formatName, Node root) 根据 XML DOM Node 的树(其语法由给定元数据格式定义)设置此 IIOMetadata 对象的内部状态。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
字段详细信息 |
---|
standardFormatSupported
protected boolean standardFormatSupported
-
指示具体子类是否支持标准元数据格式的 boolean 值,通过构造方法设置。
nativeMetadataFormatName
protected String nativeMetadataFormatName
-
此对象本机元数据格式的名称,初始化为
null
,通过构造方法设置。
nativeMetadataFormatClassName
protected String nativeMetadataFormatClassName
-
实现
IIOMetadataFormat
和表示本机元数据格式的类的名称,初始化为null
,通过构造方法设置。
extraMetadataFormatNames
protected String[] extraMetadataFormatNames
-
此插件支持的格式(标准格式和本机格式除外)的名称所组成的数组,初始化为
null
,通过构造方法设置。
extraMetadataFormatClassNames
protected String[] extraMetadataFormatClassNames
-
实现
IIOMetadataFormat
和表示此插件支持的元数据格式(标准格式和本机格式除外)的类的名称所组成的数组,初始化为null
,通过构造方法设置。
defaultController
protected IIOMetadataController defaultController
-
建议用作此
IIOMetadata
对象的控制器的IIOMetadataController
。它可以通过getDefaultController
检索。要安装默认控制器,请调用setController(getDefaultController())
。此实例变量应该由子类设置,这些子类可以选择提供自己的默认控制器(通常是一个 GUI)来设置参数。
controller
protected IIOMetadataController controller
-
调用
activateController
方法时,将用来为此IIOMetadataController
对象提供设置值的IIOParamController
。此值重写任何默认控制器,即使为null
时也是如此。
构造方法详细信息 |
---|
IIOMetadata
protected IIOMetadata()
-
构造一个空的
IIOMetadata
对象。子类负责为所有受保护的实例变量提供值,这将使方法的未重写默认实现符合其协定。例如,extraMetadataFormatNames
的长度不应为 0。