所有类


javax.imageio.metadata
类 IIOMetadata

java.lang.Object
  继承者 javax.imageio.metadata.IIOMetadata

public abstract class IIOMetadata
   
   
   
   
   
extends Object

将由表示与图像和流关联的元数据(非图像数据)的对象扩展的抽象类。插件表示使用不透明、特定于插件的对象的元数据。但是这些对象提供以 IIOMetadataNode 对象的树的形式访问其内部信息的能力,IIOMetadataNode 对象支持 XML DOM 接口以及用于存储非文本数据和检索关于合法数据值的信息的其他接口。这种树的格式是依赖于插件的,但插件可以选择支持下述插件无关的格式。单个插件可能支持多个元数据格式,这些格式的名称可以通过调用 getMetadataFormatNames 确定。插件还可支持单个特殊格式(叫做“本机”格式),设计用于无损耗地编码其元数据。通常,此格式专门设计用于与特定文件格式一起使用,以便以同一种格式加载和保存图像而不丢失元数据,但是对于在不同图像格式的 ImageReaderImageWriter 之间传输元数据没有多大用途。要像图像文件格式所允许的那样无损耗地在两个本机格式之间转换元数据,必须使用 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 数组,包含此插件的 getAsTreesetFromTreemergeTree 方法可识别的其他元数据格式(本机格式和标准格式除外)的名称。
 IIOMetadataFormat getMetadataFormat(String formatName)
          返回描述给定元数据格式的 IIOMetadataFormat 对象,如果没有可用的描述,则返回 null
 String[] getMetadataFormatNames()
          返回一个 String 数组,包含包括此插件的 getAsTreesetFromTreemergeTree 方法可识别的所有元数据格式(包括本机格式和标准格式)的名称。
 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()
          如果此对象不支持 mergeTreesetFromTreereset 方法,则返回 true
 boolean isStandardMetadataFormatSupported()
          如果 getMetadataFormatgetAsTreesetFromTreemergeTree 支持标准元数据格式,则返回 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)来设置参数。

另请参见:
IIOMetadataController, getDefaultController()

controller

protected IIOMetadataController controller
调用 activateController 方法时,将用来为此 IIOMetadataController 对象提供设置值的 IIOParamController。此值重写任何默认控制器,即使为 null 时也是如此。

另请参见:
IIOMetadataController, setController(IIOMetadataController), hasController(), activateController()
构造方法详细信息

IIOMetadata

protected IIOMetadata()
构造一个空的 IIOMetadata 对象。子类负责为所有受保护的实例变量提供值,这将使方法的未重写默认实现符合其协定。例如,extraMetadataFormatNames 的长度不应为 0。

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部