IIOMetadata (Java 2 플랫폼 SE v1. 4.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2
Platform
Std. Ed. v1. 4.0

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | constructor | 메소드

상세: 필드 | constructor | 메소드

javax.imageio.metadata
클래스 IIOMetadata

java.lang.Object 
  |
  +--javax.imageio.metadata.IIOMetadata

public abstract class IIOMetadata
extends Object

이미지와 스트림에 관련한 메타데이타 (이미지 이외의 데이터)를 나타내는 오브젝트에 의해 확장되는 추상 클래스입니다. 플러그 인은 불투명한, 플러그 인 고유의 오브젝트를 사용하는 메타데이타를 나타냅니다. 다만, 이러한 오브젝트는 XML DOM 인터페이스를 서포트하는 IIOMetadataNode 오브젝트의 트리로서 내부 정보에 액세스 하는 기능과 텍스트 이외의 데이터를 저장해, 정당한 데이터치에 관한 정보를 꺼내기 위한 추가의 인터페이스를 제공합니다. 이러한 트리의 형식은 플러그 인에 의존합니다만, 플러그 인은 아래와 같은 플러그 인에 의존하지 않는 형식을 서포트할 수 있습니다. 1 개의 플러그 인으로 복수의 메타데이타 형식을 서포트할 수가 있어 그 이름은 getMetadataFormatNames 를 호출하는 것으로 판정할 수 있습니다. 그 플러그 인은 메타데이타를 손실없이 encode 하도록(듯이) 설계된 「네이티브」형식으로 불리는 1 개의 특수한 형식도 서포트합니다. 통상, 이 형식은 특정의 파일 형식과 함께 동작하도록(듯이) 특별히 설계되어 메타데이타의 손실이 없는 같은 형식에서 이미지를 로드 및 저장할 수가 있습니다만, 이미지 형식이 다른 ImageReader 와 ImageWriter 의 사이에 메타데이타를 전송 하기에는 불편한 경우가 있습니다. 2 개의 네이티브 형식의 사이에 이미지의 파일 형식의 경우와 같은 정도로 손실없이 변환하려면 ,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 메소드를 호출할 때, 이 IIOMetadata 오브젝트의 설정을 제공하는데 사용하는 IIOMetadataController 입니다.

protected IIOMetadataController defaultController
          이 IIOMetadata 오브젝트의 콘트롤러로서 사용하도록(듯이) 추천 되고 있는 IIOMetadataController 입니다.

protected String [] extraMetadataFormatClassNames
          null 에 초기화되어 constructor를 개입시켜 설정된,IIOMetadataFormat 를 구현해, 이 플러그 인으로 서포트되는 표준 및 네이티브 형식 이외의 메타데이타 형식을 나타내는 클래스의 이름의 배열입니다.

protected String [] extraMetadataFormatNames
          null 에 초기화되어 constructor를 개입시켜 설정된, 이 플러그 인으로 서포트되는 표준 및 네이티브 형식 이외의 형식의 이름의 배열입니다.

protected String nativeMetadataFormatClassName
          null 에 초기화되어 constructor를 개입시켜 설정된,IIOMetadataFormat 를 구현해, 네이티브메타데이타 형식을 나타내는 클래스의 이름입니다.

protected String nativeMetadataFormatName
          null 에 초기화되어 constructor를 개입시켜 설정된, 이 오브젝트의 네이티브메타데이타 형식의 이름입니다.

protected boolean standardFormatSupported
          구상 서브 클래스가, constructor를 개입시켜 설정된 표준의 메타데이타 형식을 서포트할지 어떨지를 나타내는 boolean 치입니다.

생성자의 개요

protected IIOMetadata ()
          하늘의 IIOMetadata 오브젝트를 구축합니다.

protected IIOMetadata (boolean standardMetadataFormatSupported, String nativeMetadataFormatName, String nativeMetadataFormatClassName, String [] extraMetadataFormatNames, String [] extraMetadataFormatClassNames)
          지정된 형식명과 형식의 클래스명, 및 표준의 형식을 서포트할지 어떨지를 나타내는 boolean 치를 사용해,IIOMetadata 오브젝트를 구축합니다.

메소드의 개요

boolean activateController ()
          이 IIOMetadata 오브젝트에 대해서 인스톨 되고 있는 IIOMetadataController 를 액티브하게 해, 결과의 값을 돌려줍니다.

abstract Node getAsTree (String formatName)
          지정된 메타데이타 형식에서 정의되는 규칙에 따라, 이 오브젝트내에 포함되는 메타데이타의 트리의 루트를 나타내는 XML DOM Node 오브젝트를 돌려줍니다.

IIOMetadataController getController ()
          현재 인스톨 되고 있는 IIOMetadataController 를 돌려줍니다.

IIOMetadataController getDefaultController ()
          디폴트가 존재하는 경우는 현재 인스톨 되고 있는 콘트롤러에 관계없이, 디폴트의 IIOMetadataController 를 돌려줍니다.

String [] getExtraMetadataFormatNames ()
          이 플러그 인의 getAsTree,setFromTree, 및 mergeTree 메소드로 인식되는 네이티브와 표준의 형식 이외의, 추가의 메타데이타 형식의 이름이 저장된 String 의 배열을 돌려줍니다.

IIOMetadataFormat getMetadataFormat (String formatName)
          지정된 메타데이타 형식을 기술하는 IIOMetadataFormat 오브젝트를 돌려줍니다.

String [] getMetadataFormatNames ()
          이 플러그 인의 getAsTree,setFromTree, 및 mergeTree 메소드로 인식되는 네이티브와 표준의 형식을 포함한, 모든 메타데이타 형식의 이름이 저장된 String 의 배열을 돌려줍니다.

String getNativeMetadataFormatName ()
          이 플러그 인의 「네이티브」메타데이타 형식의 이름을 돌려줍니다.

protected IIOMetadataNode getStandardChromaNode ()
          표준의 javax_imageio_1. 0 메타데이타 형식의 채도 정보를 나타내는 IIOMetadataNode 를 돌려줍니다.

protected IIOMetadataNode getStandardCompressionNode ()
          표준의 javax_imageio_1. 0 메타데이타 형식의 압축 정보를 나타내는 IIOMetadataNode 를 돌려줍니다.

protected IIOMetadataNode getStandardDataNode ()
          표준의 javax_imageio_1. 0 메타데이타 형식의 데이터 형식 정보를 나타내는 IIOMetadataNode 를 돌려줍니다.

protected IIOMetadataNode getStandardDimensionNode ()
          표준의 javax_imageio_1. 0 메타데이타 형식의 치수 정보를 나타내는 IIOMetadataNode 를 돌려줍니다.

protected IIOMetadataNode getStandardDocumentNode ()
          표준의 javax_imageio_1. 0 메타데이타 형식의 문서 정보를 나타내는 IIOMetadataNode 를 돌려줍니다.

protected IIOMetadataNode getStandardTextNode ()
          표준의 javax_imageio_1. 0 메타데이타 형식의 텍스트 정보를 나타내는 IIOMetadataNode 를 돌려줍니다.

protected IIOMetadataNode getStandardTileNode ()
          표준의 javax_imageio_1. 0 메타데이타 형식의 타일링 정보를 나타내는 IIOMetadataNode 를 돌려줍니다.

protected IIOMetadataNode getStandardTransparencyNode ()
          표준의 javax_imageio_1. 0 메타데이타 형식의 투과성 정보를 나타내는 IIOMetadataNode 를 돌려줍니다.

protected IIOMetadataNode getStandardTree ()
          표준의 javax_imageio_1. 0 메타데이타 형식의 규칙에 따라, 이 오브젝트내에 포함되는 메타데이타를 나타내는 IIOMetadataNode 의 트리를 돌려주는 유틸리티 메소드입니다.

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 메소드를 호출해, 모든 디폴트 콘트롤러를 오버라이드(override) 할 경우에, 이 IIOMetadata 오브젝트의 설정치를 지정하는데 사용하는 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

구상 서브 클래스가, constructor를 개입시켜 설정된 표준의 메타데이타 형식을 서포트할지 어떨지를 나타내는 boolean 치입니다.

nativeMetadataFormatName

protected String  nativeMetadataFormatName

null 에 초기화되어 constructor를 개입시켜 설정된, 이 오브젝트의 네이티브메타데이타 형식의 이름입니다.

nativeMetadataFormatClassName

protected String  nativeMetadataFormatClassName

null 에 초기화되어 constructor를 개입시켜 설정된,IIOMetadataFormat 를 구현해, 네이티브메타데이타 형식을 나타내는 클래스의 이름입니다.

extraMetadataFormatNames

protected String [] extraMetadataFormatNames

null 에 초기화되어 constructor를 개입시켜 설정된, 이 플러그 인으로 서포트되는 표준 및 네이티브 형식 이외의 형식의 이름의 배열입니다.

extraMetadataFormatClassNames

protected String [] extraMetadataFormatClassNames

null 에 초기화되어 constructor를 개입시켜 설정된,IIOMetadataFormat 를 구현해, 이 플러그 인으로 서포트되는 표준 및 네이티브 형식 이외의 메타데이타 형식을 나타내는 클래스의 이름의 배열입니다.

defaultController

protected IIOMetadataController  defaultController

이 IIOMetadata 오브젝트의 콘트롤러로서 사용하도록(듯이) 추천 되고 있는 IIOMetadataController 입니다. getDefaultController 를 사용해 꺼낼 수가 있습니다. 디폴트의 콘트롤러를 인스톨 하려면 ,setController(getDefaultController()) 를 호출합니다. 이 인스턴스 변수는 파라미터를 설정하기 위해서 독자적인 디폴트 콘트롤러 (통상은 GUI)를 제공하는 서브 클래스에서 설정할 필요가 있습니다.

관련 항목:: IIOMetadataController , getDefaultController()

controller

protected IIOMetadataController  controller

activateController 메소드를 호출할 때, 이 IIOMetadata 오브젝트의 설정을 제공하는데 사용하는 IIOMetadataController 입니다. 이 값은 null 의 경우에서도, 디폴트의 콘트롤러를 모두 오버라이드(override) 합니다.

관련 항목:: IIOMetadataController , setController(IIOMetadataController) , hasController() , activateController()

생성자의 상세

IIOMetadata

protected IIOMetadata()

하늘의 IIOMetadata 오브젝트를 구축합니다. 서브 클래스는 오버라이드(override) 되지 않는 디폴트의 메소드 구현이 그 규약을 채우도록(듯이) 하는 모든 보호된 인스턴스 변수의 값을 지정합니다. 예를 들어,extraMetadataFormatNames 의 길이는 0 이어 되지 않습니다.

IIOMetadata

protected IIOMetadata(boolean standardMetadataFormatSupported,
                      String  nativeMetadataFormatName,
                      String  nativeMetadataFormatClassName,
                      String [] extraMetadataFormatNames,
                      String [] extraMetadataFormatClassNames)

지정된 형식명과 형식의 클래스명, 및 표준의 형식을 서포트할지 어떨지를 나타내는 boolean 치를 사용해,IIOMetadata 오브젝트를 구축합니다.

이 constructor 은 클래스명의 유효성은 판정하지 않습니다. 클래스명이 무효인 경우는 getMetadataFormat 의 그 후의 호출로 예외가 발생하는 경우가 있습니다.

파라미터:

standardMetadataFormatSupported - 이 오브젝트가 표준의 메타데이타 형식을 사용해 DOM 트리를 돌려줄까 받을 수가 있는 경우는 true

nativeMetadataFormatName - 네이티브의 메타데이타 형식의 String 명. 네이티브의 형식이 없는 경우는 null

nativeMetadataFormatClassName - 네이티브메타데이타 형식의 클래스의 이름. 네이티브의 형식이 없는 경우는 null

extraMetadataFormatNames - 이 오브젝트로 서포트되는 추가의 형식을 나타내는 String 의 배열. 존재하지 않는 경우는 null

extraMetadataFormatClassNames - 이 오브젝트로 서포트되는 모든 추가 형식의 클래스명을 나타내는 String 의 배열. 존재하지 않는 경우는 null

예외:

IllegalArgumentException - extraMetadataFormatNames 의 길이가 0 의 경우

IllegalArgumentException - extraMetadataFormatNames 및 extraMetadataFormatClassNames 가 null 에서도 같은 길이도 아닌 경우

메소드의 상세

isStandardMetadataFormatSupported

public boolean isStandardMetadataFormatSupported()

표준의 메타데이타 형식이 getMetadataFormat,getAsTree,setFromTree, 및 mergeTree 로 서포트되는 경우는 true 를 돌려줍니다.

디폴트의 구현은 standardFormatSupported 인스턴스 변수의 값을 돌려줍니다.

반환값:: 표준의 메타데이타 형식이 서포트되고 있는 경우는 true
관련 항목:: getAsTree(java.lang.String) , setFromTree(java.lang.String, org.w3c.dom.Node) , mergeTree(java.lang.String, org.w3c.dom.Node) , getMetadataFormat(java.lang.String)

isReadOnly

public abstract boolean isReadOnly()

이 오브젝트가 mergeTree,setFromTree, 및 reset 메소드를 서포트하지 않는 경우는 true 를 돌려줍니다.

반환값:: 이 IIOMetadata 오브젝트를 변경할 수 없는 경우는 true

getNativeMetadataFormatName

public String  getNativeMetadataFormatName()

이 플러그 인의 「네이티브」메타데이타 형식의 이름을 돌려줍니다. 통상, 이 형식을 사용하면(자), 이 플러그 인으로 처리되는 형식에서 저장되고 있는 메타데이타를 손실없이 encode 및 전송 할 수 있습니다. 그러한 형식이 서포트되어 있지 않은 경우는 null 가 돌려주어집니다.

「네이티브」메타데이타 형식의 구조와 내용은 이 IIOMetadata 오브젝트를 작성한 플러그 인으로 정의됩니다. 통상, 단순한 형식의 플러그 인은 루트에 더미 노드를 작성하고 나서, 개개의 태그, 체크, 또는 키워드와 값의 페어를 나타내는 일련의 아이 노드를 작성합니다. 플러그 인은 네이티브 형식을 문서화할지 어떨지를 선택할 수가 있습니다.

디폴트의 구현은 nativeMetadataFormatName 인스턴스 변수의 값을 돌려줍니다.

반환값:: 네이티브 형식의 이름, 또는 null
관련 항목:: getExtraMetadataFormatNames() , getMetadataFormatNames()

getExtraMetadataFormatNames

public String [] getExtraMetadataFormatNames()

이 플러그 인의 getAsTree,setFromTree, 및 mergeTree 메소드로 인식되는 네이티브와 표준의 형식 이외의, 추가의 메타데이타 형식의 이름이 저장된 String 의 배열을 돌려줍니다. 그러한 추가의 형식이 없는 경우는 null 가 돌려주어집니다.

디폴트의 구현은 extraMetadataFormatNames 인스턴스 변수의 복제를 돌려줍니다.

반환값:: 적어도 길이 1 의 String 의 배열, 또는 null
관련 항목:: getAsTree(java.lang.String) , setFromTree(java.lang.String, org.w3c.dom.Node) , mergeTree(java.lang.String, org.w3c.dom.Node) , getNativeMetadataFormatName() , getMetadataFormatNames()

getMetadataFormatNames

public String [] getMetadataFormatNames()

이 플러그 인의 getAsTree,setFromTree, 및 mergeTree 메소드로 인식되는 네이티브와 표준의 형식을 포함한, 모든 메타데이타 형식의 이름이 저장된 String 의 배열을 돌려줍니다. 그러한 형식이 없는 경우는 null 가 돌려주어집니다.

디폴트의 구현은 getNativeMetadataFormatName,isStandardMetadataFormatSupported, 및 getExtraMetadataFormatNames 를 호출해, 결합된 결과를 돌려줍니다.

반환값:: String 의 배열
관련 항목:: getNativeMetadataFormatName() , isStandardMetadataFormatSupported() , getExtraMetadataFormatNames()

getMetadataFormat

public IIOMetadataFormat  getMetadataFormat(String  formatName)

지정된 메타데이타 형식을 기술하는 IIOMetadataFormat 오브젝트를 돌려줍니다. 기술을 사용할 수 없는 경우는 null 를 돌려줍니다. 지정하는 이름은 getMetadataFormatNames 로부터 돌려주어진 이름의 1 개가 아니면 안됩니다 (즉, 네이티브의 형식명, 표준의 형식명, 또는 getExtraMetadataFormatNames 로부터 돌려주어진 이름의 1 개).

디폴트의 구현에서는 글로벌 표준 메타데이타 형식명에 대해서 이름을 판정해, 서포트되고 있는 경우는 그 형식을 돌려줍니다. 그렇지 않은 경우는 나중에 추가의 형식명이 계속되는 네이티브의 형식명에 대해서 판정합니다. 일치가 발견되었을 경우는 해당하는 nativeMetadataFormatClassName 또는 extraMetadataFormatClassNames 로부터 IIOMetadataFormat 클래스의 이름을 꺼내,getInstance 메소드를 사용해 그 클래스의 인스턴스를 구축합니다.

파라미터:: formatName - 목적의 메타데이타 형식
반환값:: IIOMetadataFormat 오브젝트
예외:: IllegalArgumentException - formatName 가 null 인지 플러그 인으로 인식된 이름이 아닌 경우; IllegalStateException - 형식명에 대응하는 클래스를 로드할 수 없는 경우

getAsTree

public abstract Node  getAsTree(String  formatName)

지정된 메타데이타 형식에서 정의되는 규칙에 따라, 이 오브젝트내에 포함되는 메타데이타의 트리의 루트를 나타내는 XML DOM Node 오브젝트를 돌려줍니다.

사용 가능한 메타데이타 형식의 이름은 getMetadataFormatNames 메소드를 사용해 조회할 수가 있습니다.

파라미터:: formatName - 목적의 메타데이타 형식
반환값:: 트리의 루트를 형성하는 XML DOM Node 오브젝트
예외:: IllegalArgumentException - formatName 가 null 인지 getMetadataFormatNames 로부터 돌려주어진 이름이 아닌 경우
관련 항목:: getMetadataFormatNames() , setFromTree(java.lang.String, org.w3c.dom.Node) , mergeTree(java.lang.String, org.w3c.dom.Node)

mergeTree

public abstract void mergeTree(String  formatName,
                               Node  root)
                        throws IIOInvalidTreeException

지정된 메타데이타 형식에서 구문이 정의되는 XML DOM Node 의 트리로부터, 이 IIOMetadata 오브젝트의 내부 상태를 변경합니다. 이전 상태는 지정된 트리에 존재하는 노드에 적합하기 위해서 필요한 경우에만 변경됩니다. 트리의 구조 또는 내용이 무효인 경우는 IIOInvalidTreeException 가 슬로우 됩니다.

트리 또는 서브 트리를 다른 트리와 merge 하는 방법의 시멘틱스는 완전하게 형식 고유해서, 플러그 인의 작성자는 그 형식에 가장 적절한 방법으로 이 메소드를 구현할 수가 있습니다. 기존의 모든 상태가 지정된 트리의 내용에 옮겨놓을 뿐(만큼)등의 방법이 있습니다.

파라미터:: formatName - 목적의 메타데이타 형식; root - 트리의 루트를 형성하는 XML DOM Node 오브젝트
예외:: IllegalStateException - 이 오브젝트가 읽어들여 전용의 경우; IllegalArgumentException - formatName 가 null 인지 getMetadataFormatNames 로부터 돌려주어진 이름이 아닌 경우; IllegalArgumentException - root 가 null 의 경우; IIOInvalidTreeException - 지정된 형식의 규칙을 사용해 트리를 정상적으로 구문 분석 할 수 없는 경우
관련 항목:: getMetadataFormatNames() , getAsTree(java.lang.String) , setFromTree(java.lang.String, org.w3c.dom.Node)

getStandardChromaNode

protected IIOMetadataNode  getStandardChromaNode()

표준의 javax_imageio_1. 0 메타데이타 형식의 채도 정보를 나타내는 IIOMetadataNode 를 돌려줍니다. 그러한 정보를 사용할 수 없는 경우는 null 를 돌려줍니다. 이 메소드는 유틸리티루틴 getStandardTree 로부터 호출하는 것을 상정하고 있습니다.

디폴트 구현은 null 를 돌려줍니다.